====== iX-Haus plus Schnittstellen - Wie mache ich es? ======
[[ix-haus_plus:ix-haus_import:start|home]]
===== Bearbeiten der Excel-Vorlage =====
++++|

Bitte beachten Sie folgende Punkte:

  * Zeilen am Anfang der Vorlage zwischen den  ''ParamStart''- und  ''ParamEnd''-Platzhaltern werden automatisch generiert und dürfen nicht gelöscht bzw. geändert werden.
  * Rot markierte Spalten sind  ''Muss-Spalten''  und müssen vor dem Import gefüllt sein.
  * Für **fett**-markierte Spalten ist nur eine Erstversorgung, also Neuanlage, möglich. Bei anderen Feldern können über den Import auch Daten aktualisiert werden. 
  * Für einen aktualisierenden Stammdatenimport können Sie in Feldern mit dem Schlüsselwort ''#delete#'' ein Feld leeren, also durch Import einen in der Datenbank vorhandenen Feldinhalt entfernen. Dies gilt verständlicherweise nicht für Pflichtfelder.
  * Eine zusätzliche Information über dem Kopf jeder Spalte dient Ihnen mit der Angabe des jeweiligen Feldtypen, seiner Länge und möglicher Eingabewerte als Unterstützung.
++++

===== Erstellen einer Excel-Importvorlage =====
++++|
Um den Import von Daten im Excelformat zu starten, benötigen Sie eine Importvorlage.

So erstellen Sie eine neue Excel-Importvorlage:

  - Wählen Sie eine Zeile aus der Importliste aus.
  - Rufen Sie über die Schaltfläche  ''Excel-Vorlage erstellen''  in der Menüleiste den Dialog  '''…-Import' Excel-Vorlage''  auf.
  - Wählen Sie die Feldtypen aus, die Sie in der Vorlage abbilden möchten. Nutzen Sie hierzu die Checkboxen in der Spalte  ''Ausgeben''.  ''Muss-Felder''  können nicht deaktiviert werden. Die Bezeichnung deaktivierter Felder erscheint in der Spalte  ''Spalte''  durchgestrichen. Unterhalb der Auswahl stehen Ihnen die Schalter  ''alle Spalten aktivieren''  und  ''alle Spalten deaktivieren''  zur Verfügung. Neben der Tabelle finden Sie mehrere Schalter zum Strukturieren der Tabelle. Der oberste Schalter stellt die Tabelle wieder auf den Originalzustand ein (Struktur-Reset). Die weiteren Schalter erlauben das Verschieben einer Zeile (an den Anfang, eine Position zurück, eine Position weiter, an das Ende). Die Ziffern in der Spalte  ''Anordnung''  werden automatisch angepasst.
  - Im letzten Schritt generieren Sie die Vorlage mit dem Schalter  ''Vorlage generieren''.

**Hinweise**: 

  * Wenn Sie eine Excel-Importvorlage für  ''Flächenbeschrieb-Import''  bzw.  ''TO-Import''  erstellen wollen, müssen Sie zunächst eine Flächenart-Klasse bzw. TO-Definition auswählen.
  * Für einen Beschriebimport müssen Beschriebfelder mit Variable definiert sein. 
  *  Sie können eine früher erstellte Excel-Importvorlage verwenden, wobei die Pflichtfelder erhalten bleiben müssen. 
++++


=====Importieren von Daten=====
++++|
So importieren Sie im Anschluss an die Erstellung der Importvorlage die gewünschten Daten:

  - Wählen Sie eine Zeile aus der Importliste aus. 
  - Rufen Sie über die Schaltfläche  ''Daten importieren''  in der Menüleiste den Import-Dialog auf.
  - Öffnen Sie die von Ihnen erstellte Importvorlage über die Schaltfläche  ''Datei öffnen''. 
  - Klicken Sie die Schaltfläche  ''Daten prüfen''. Das Programm überprüft automatisch, ob die Daten aus der Vorlage korrekt sind. Falls nicht, wird eine Fehlermeldung im  ''Import-Log''  ausgegeben und im Grid entsprechend markiert. \\ <WRAP center round tip>
Beim Durchführen eines fehlerfreien Prüflaufs wird eine Information angezeigt, dass es trotz Prüfung beim Import zu Fehlern kommen kann. Der Prüflauf benutzt zur Validierung der Eingabedaten immer die aktuellen Daten in der Datenbank. Zu beachten ist, dass sich durch vorausgehende Zeilen der Status eines Datensatz zwischen Prüflauf und Import verändern kann.
</WRAP>
  - Bereinigen Sie vor dem Start des Imports alle Fehler in der Vorlage und starten Sie den Import. 
  - Drucken Sie ggfs. per Schaltfläche  ''Import-Log drucken'', um den Importbericht zu drucken. 
++++

=====Import per Batch ansteuern=====
++++|
====Batch-Import als Aufgabe====

Der iX-Haus Stammdatenimport kann als geplanter Task unter Windows eingestellt werden, um in der Nacht ausgeführt zu werden. Für den geplanten Task kann z. B. die Datei  ''ImportStart.bat''  mit dem Aufruf zum Starten des Imports angelegt werden.

====Batch Datei erzeugen====

Eine Batch-Datei erzeugen Sie, indem Sie einen Texteditor öffnen und eine neue Datei speichern unter dem Namen  ''Beliebig.cmd''  (es kann als Endung auch  ''.bat''  verwendet werden). Es wird eine leere Datei erzeugt, deren Name entsprechend Ihrer Vorgabe lautet (hier  ''Beliebig'' ) und die die Endung  ''.cmd''  oder  ''.bat''  aufweist. 

In die leere Datei können Sie die Befehle mit Hilfe des Texteditors eingeben. Wenn die Datei ausgeführt wird, werden die enthaltenen Kommandos ausgeführt.
====Befehle====
Um den Stammdatenimport per Script zu steuern, steht eine Vielzahl von Befehlen bereit, welche Sie in der Batch-Datei verwenden können.

===Syntax===

 ''..\nuris\NCrem.Prozess.Win.exe '' [-t|task Aufgabenummer] [ [-u|user Benutzername] | [-uid|userid Benutzer-Id] ] [-up|pass Benutzerkennwort] [-it|importtype Importtyp] [-iu|update Update] [-ip|profil Profilname] [-p|path Quelldatei] [-o|output Ausgabedatei]
===Optionen===

| ''-t'' | Aufgabenummer | Legt die Aufgabe über die Aufgabennummer fest (tasknumber).''1''  = Stammdatenimport\\  ''2''  = Serien-Import\\  ''3''  = Mapping-Import |
| ''-u'' | Benutzername | iX-Haus bzw. iX-Haus<sup>plus</sup> Benutzername. Der Benutzer muss in der iX-Haus-Benutzerverwaltung mit iX-Haus<sup>plus</sup> gekoppelt sein. (user) |
| ''-uid'' | Benutzer-Id | iX-Haus UserId (s. Benutzerverwaltung [../08-fachadministration/02-systemprogramme/benutzerverwaltung.html]) (userid) |
| ''-up'' | Benutzerkennwort | iX-Haus bzw. IHS Benutzerkennwort (userpassword) |
| ''-o'' | Ausgabedatei | Berichtausgabedateipfad (output)|

===1. Stammdatenimport ===

| ''-it'' | Importtyp | Importtypnummer (siehe Importtypliste) |
| ''-iu'' | Update | Vorhandene Daten aktualisieren ( ''0''  = Nein (Standard),  ''1''  = Ja ). |
| ''-p'' | Quelldatei | Template-Dateipfad. |

Beispiel:  ''c:\ixhaus\nuris\NCrem.Prozess.Win.exe -t 1 -u ixhaus -up xxxx -it 2 -iu 1 -p c:\template.xlsx -o c:\import.log'' 

**Hinweis**: Flächenbeschrieb-Import (Importtyp = ''15'' ) und Objektbeschrieb-Import (Importtyp =  ''10'' ) werden im batchgestützten Stammdatenimport nicht unterstützt!

===2. Serien-Import ===

| ''-iu'' | Update | Vorhandene Daten aktualisieren ( ''0''  = Nein (Standard),  ''1''  = Ja ). |
| ''-p'' | Quelldatei | Template-Verzeichnis. |
| ''-sftp'' |   | Templates von SFTP-Verzeichnis nach Template-Verzeichnis runterladen |
| ''-sp'' | SFTP-Verzeichnis | Pfad zu dem SFTP-Verzeichnis |

Beispiel:  ''c:\ixhaus\nuris\NCrem.Prozess.Win.exe -t 2 -u ixhaus -up xxxx -iu 1 -p c:\Template -o c:\Template\\import.log'' 

===3. Mapping-Import===

| ''-ip'' | Profilname | Profilname |
| ''-iu'' | Update | Vorhandene Daten aktualisieren ( ''0''  = Nein (Standard),  ''1''  = Ja ). |
| ''-p'' | Quelldatei | Template-Dateipfad. |

Beispiel:  ''c:\ixhaus\nuris\NCrem.Prozess.Win.exe -t 3 -u ixhaus -up xxxx -ip myprofil -iu 1 -p c:\template.xlsx -o c:\import.log'' 
++++


=====Log-Daten kontrollieren und kopieren=====
++++|
Nach Auswahl eines Importtyps werden die letzten Importvorgänge angezeigt. Mit Doppelklick kann hier pro Lauf das Log aufgerufen werden. <wrap tip>In der Anicht des Protokolls können Sie mit ''Strg + F'' eine Suche aufrufen. Der gefundene Duchbegriff wird im Protokoll markiert dargestellt.</wrap>

Mit dem Modul [[ix-haus_plus:ix-haus_import:start#modul_schnittstellenadministration|Schnittstellenadministration]] können Sie zu einigen Schnittstellen Einstellungen vornehmen und Detailinformation zu den Logfiles abfragen. Mit einem Doppelklick auf den Schalter ''Filter anwenden'' können Sie alle Details für die ausgewählten Log-Daten automatisch in die Zwischenablage übernehmen. Bei Problemen können damit die benötigten Details leichter ausgewertet werden.

++++
===== Mapping-Import =====
++++|

Das Mapping für den Import dient der Funktion, alle zu importierenden Stammdaten in einer Excel-Datei zusammenfassen zu können. Über die einzelnen Stammdatenimportvorlagen wird schließlich zu jedem einzelnen Parameter der korrekte Wert übertragen. Diese 1 zu n Beziehung vereinfacht den Prozess des Datenimports und beugt Fehlern vor. 

Die Importdaten werden aus einer Excel-Datei ausgelesen und anhand von gespeicherten Mapping-Profilen in iX-Haus plus importiert. Verwenden Sie den Mapping-Import in Fällen, wenn die Spalten der Importdatei sich von den Spalten der Importvorlage unterscheiden und/oder die Importdatei Daten für mehrere iX-Haus-Importe beinhaltet (z. B. Personenimport und Vertragsmanagementimport). 

Eine Importdatei kann wie folgt aufgebaut sein (Beispiel 1):

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ | G\\ |
|  1| ParamStart|  |  |  |  |  |   |
|  2|  |  |  |  |  |  |   |
|  3|  |  |  |  |  |  |   |
|  4| ParamEnd|  |  |  |  |  |   |
|  5| **Wohnobjekt-\\ Nummer**| **Wohneinheit-\\ Nummer**| **Mieter-\\ Nummer\\ **| **Ist MwSt-\\ pflichtig\\ **| **Kurzname\\ **| **Mietername\\ **|\\ |
|  6| 1| 1000| 001| 0\\ | Mayer\\ | Max Mayer\\ |\\ |
|  7| 1| 1001| 002| 0| Mustermann\\ | Max Mustermann\\ |   |
|  8|\\ |\\ |\\ |\\ |\\ |\\ |\\ |

Bevor Sie mit dem Daten-Import per Mapping starten können, benötigen Sie eine Mapping-Datei. 

====Aufbau einer Mapping-Datei====

  * Überschriftzeile
  * In die erste Spalte werden die erwünschten Importbereiche eingetragen (entsprechen der Überschriftzeile aus dem jeweiligen Import). Folgende Importe werden unterstützt.

 ''ImportType: 16|Objekt-Import\\ ImportType: 9|Flächenart-Import\\ ImportType: 8|Umlageschlüssel-Import\\ ImportType: 2|Flächenstamm-Import\\ ImportType: 3|Personenstamm-Import\\ ImportType: 11|Personenbeschrieb-Import\\ ImportType: 4|Vertrag-Import\\ ImportType: 12|Vertragbeschrieb-Import\\ ImportType: 5|Sachkonten-Import\\ ImportType: 13|Sachkontenbeschrieb-Import\\ ImportType: 7|Gewerke-Import\\ ImportType: 6|Kreditorenstamm-Import\\ ImportType: 14|Kreditorenbeschrieb-Import'' 

  * Die Mapping-Spalte wird an der Stelle, wo sich Importbereich und Überschrift überschneiden, eingetragen.

Das passende Mapping für das erste Importdatei-Beispiel sieht somit wie folgt aus:

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ | G\\ |
|  1|\\ | Wohnobjekt-\\ Nummer| Wohneinheit-\\ Nummer| Mieter-\\ Nummer\\ | Ist MwSt-\\ pflichtig | Kurzname\\ | Mietername\\ |
|  2| ImportType: 3|Personenstamm-Import| ObjNr\\ |  | PersonNr\\ |  | Suchbegriff\\ | Name1(1)\\  |
|  3| ImportType: 4|Vertrag-Import| ObjNr\\ | FlstmNr\\ | PersonNr\\ | MwstTyp\\ |  |   |
|  4|\\ |\\ |\\ |\\ |\\ |\\ |\\ |

Importbereich und Mapping-Spalte können Sie aus der Import-Vorlage entnehmen. 

Sie können zusätzlich feste Werte oder z. B. die Daten aus dem Parameterkopf übergeben. Das erfolgt über die Mapping-Schlüsselwörter  ''#fixValue()#''  bzw.  ''#fixCell()#''. 

Wäre im oberen Beispiel die Spalte ''Ist MwSt pflichtig'' in der Importdatei nicht vorhanden und somit alle Mieter nicht mehrwertsteuerpflichtig, dann kann dies wie folgt gemappt werden.

Importdatei Beispiel 1 

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ |
|  1| ParamStart|  |  |  |  |   |
|  2|  |  |  |  |  |   |
|  3|  |  |  |  |  |   |
|  4| ParamEnd|  |  |  |  |   |
|  5| **Wohnobjekt-\\ Nummer**| **Wohneinheit-\\ Nummer**| **Mieter-\\ Nummer\\ **| **Kurzname\\ **| **Mietername\\ **|\\ |
|  6| 1| 1000| 001| Mayer\\ | Max Mayer\\ |\\ |
|  7| 1| 1001| 002| Mustermann\\ | Max Mustermann\\ |   |
|  8|\\ |\\ |\\ |\\ |\\ |\\ |

Die Datei beinhaltet keine Spalte für das Muss-Feld  ''MwstTyp''  im Vertrags-Import! Dieses Feld kann mit dem Mapping-Schlüsselwort  ''#fixValue()#''  für den Vertragsimport generiert werden - es soll hier den Wert  ''0''  erhalten. 

Mapping:

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ | G\\ |
|  1|\\ | Wohnobjekt-\\ Nummer| Wohneinheit-\\ Nummer| Mieter-\\ Nummer\\ | **#fixValue(0)#**| Kurzname\\ | Mietername\\ |
|  2| ImportType: 3|Personenstamm-Import| ObjNr\\ |  | PersonNr\\ |  | Suchbegriff\\ | Name1(1)\\  |
|  3| ImportType: 4|Vertrag-Import| ObjNr\\ | FlstmNr\\ | PersonNr\\ | **MwstTyp**\\ |  |   |
|  4|\\ |\\ |\\ |\\ |\\ |\\ |\\ |

Somit hat die Import-Spalte  ''MwstTyp''  den Festwert  ''0''.

Eine andere Möglichkeit ist, bestimmte Werte global in den Parameterkopf der Importdatei zu schreiben – z. B. wie im Fall oben, ob die Mieter mehrwertsteuerpflichtig sind. In diesem Fall können Sie diese Information anhand des  ''#fixCell()#''  Mapping-Schlüsselwort mappen.

Importdatei Beispiel 2

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ |
|  1| ParamStart|  |  |  |  |   |
|  2|  **Mwst-pflichtig**| **0**\\ |  |  |  |   |
|  3|  |  |  |  |  |   |
|  4| ParamEnd|  |  |  |  |   |
|  5| **Wohnobjekt-Nummer**| **Wohneinheit-Nummer**| **Mieter-Nummer\\ **| **Kurzname\\ **| **Mietername\\ **|\\ |
|  6| 1| 1000| 001| Mayer\\ | Max Mayer\\ |\\ |
|  7| 1| 1001| 002| Mustermann\\ | Max Mustermann\\ |   |
|  8|\\ |\\ |\\ |\\ |\\ |\\ |

Mapping zu Beispiel 2

|  | A\\ | B\\ | C\\ | D\\ | E\\ | F\\ | G\\ |
|  1|\\ | Wohnobjekt-\\ Nummer| Wohneinheit-\\ Nummer| Mieter-\\ Nummer\\ | **#fixCell(B2)#**| Kurzname\\ | Mietername\\ |
|  2| ImportType: 3|Personenstamm-Import| ObjNr\\ |  | PersonNr\\ |  | Suchbegriff\\ | Name1(1)\\  |
|  3| ImportType: 4|Vertrag-Import| ObjNr\\ | FlstmNr\\ | PersonNr\\ | **MwstTyp**\\ |  |   |
|  4|\\ |\\ |\\ |\\ |\\ |\\ |\\ |

Anschließend wird aus der erstellten Mapping-Datei ein Import-Profil erstellt.

====Import-Profil für Mapping erstellen====

  - Wählen Sie im Navigationsmenü  ''Import-Profil''  aus.
  - Erstellen Sie über die Schaltfläche  ''Neu''  in der Menüleiste ein neues Import-Profil.
  - Im Register  ''Mapping-Imports''  werden die Importbereiche angezeigt, die in der Mapping-Datei definiert sind. Bestimmte Importbereiche können Sie per Doppellklick sperren.
  - Im Register  ''Filter''  tragen Sie kommagetrennt Kriterien für Import-Datei Spalten ein (z. B. wenn nur Daten für Objekte 99001 und 99002 importiert werden dürfen, dann sollte der Filter in etwa so aussehen:  ''‚Spalte‘ = ObjektNr, ‚Zeilen mit folgenden Werten Importieren‘ = 99001,99002'').
  - Für jedes Profil wird gespeichert, wann der letzte Import durchgeführt wurde. So haben Sie die Möglichkeit, bei einem umfangreichen Import nur die seit dem letzten Import Zeilen geänderten Daten zu importieren. Voraussetzung ist, dass Ihre Importdatei je Zeile einen Zeitstempel mit dem letzten Änderungsdatum enthält. Falls in einer Zeile kein Zeitstempel eingetragen ist, so wird diese immer importiert. Wählen Sie die Option  ''nur veränderte Daten importieren''  aus und definieren Sie den  ''Spaltenname für Zeitstempel''.
  - Wenn der Import Fehler aufweist, können Sie die fehlerhaften Zeilen in eine separate Excel-Datei kopieren, indem Sie  ''Fehlerhafte Zeilen in Excel-Datei umkopieren''  auswählen und den Pfad sowie Namen der  ''Excel-Datei''  festlegen. Wird diese Funktion für mehrere Profile genutzt, sollten Sie im Dateinamen auch den Profilnamen aufnehmen. Systemseitig wird der Dateiname um einen Zeitstempel ergänzt, damit die Datei einen eindeutigen Namen aufweist und nicht mit weiteren Fehlerdateien kollidiert. Ein evtl. vorhandener Zeitstempel wird beim Umkopieren entfernt. Beachten Sie bitte, in der Fehlerdatei nach der Datenkorrektur den Fehlerstatus zu löschen, damit ein erneuter Import möglich wird.
  - Wenn alle Daten korrekt eingetragen sind, können Sie das Import-Profil speichern.

<wrap tip>Gesperrte Imports werden nicht durchgeführt.</wrap> 

====Mapping-Import durchführen====

  - Wählen Sie im Navigationsmenü  ''Mapping-Import''  aus.
  - Rufen Sie über die Schaltfläche  ''Mapping-Import''  in der Menüleiste das Dialogfenster  ''Mapping-Import''  auf. In diesem Dialogfenster wählen Sie das  ''Profil''  und anschließend das  ''Template''  als zu exportierende Excel-Datei aus. Mit dem Recycling-Symbol lesen Sie die Dateistruktur erneut ein, z. B. nachdem Sie Dateien in den verwendeten Pfad nachträglich hineinkopiert haben und diese anschließend als Template auswählen möchten. 
  - Drücken Sie auf die Schaltfläche  ''Daten prüfen und importieren''. Das Programm überprüft und importiert geladene Daten. Wenn die Vorlage bzw. Daten fehlerhaft sind, wird eine Fehlermeldung im  ''Import-Log''  ausgegeben und im Grid entsprechend markiert.
  - Über die Schaltfläche  ''Import-Log  drucken''  (Druckersymbol) können Sie den Import-Log ausdrucken.
++++

=====Serienimport von Daten=====
++++|
So importieren Sie beliebig viele Vorlagen gleichzeitig: 

  - Kopieren Sie alle zu importierenden Vorlagen in einen Ordner.
  - Wählen Sie im Navigationsmenü  ''Serien-Import''  aus.
  - Rufen Sie über die Schaltfläche  ''Serien-Import''  in der Menüleiste den Import-Dialog auf.
  - Öffnen Sie den Ordner mit den Import-Vorlagen über die Schaltfläche  ''Template-Verzeichnis öffnen''  in der Import-Ansicht.
  - Drücken Sie auf die Schaltfläche  ''Daten prüfen und importieren''. Das Programm überprüft und importiert geladene Vorlagen automatisch in vorgegebener Reihenfolge. Wenn die Vorlage bzw. Daten fehlerhaft sind, wird eine Fehlermeldung im Import-Log ausgegeben und im Grid entsprechend markiert.


Für folgende Module ist ein Serienimport möglich. Die Daten werden in nachfolgender Reihenfolge importiert:
 
|  1.| Objekt-Import |
|  2.| Objektbeschrieb-Import |
|  3.| Objektstruktur-Import |
|  4.| Flächenart-Import |
|  5.| Umlageschlüssel-Import |
|  6.| Flächenstamm-Import |
|  7.| Flächenbeschrieb-Import |
|  8.| Personenstamm-Import |
|  9.| Personenbeschrieb-Import |
|  10.| Vertrag-Import |
|  11.| Vertragbeschrieb-Import |
|  12.| Sachkonten-Import |
|  13.| Sachkontenbeschrieb-Import |
|  14.| Gewerke-Import |
|  15.| Kreditorenstamm-Import |
|  16.| Kreditorenbeschrieb-Import |
|  17.| Intercompany Regel-Import |
|  18.| Mitgliederstamm-Import |
|  19.| Partner-Import |
|  20.| Mitarbeiter-Import |
|  21.| Senso-Import |
|  22.| Anlagen-Import |
|  23.| Vertragsvorerfassung-Basisdaten-Import |
|  24.| Projekt-Import |
|  25.| Aufträge-Import |

==== Automatisierter Serienimport ====

Der Serienimport kann per Batch (s. u.) oder per [[ix-haus_plus:scheduler:start|Scheduler]] ausgeführt werden. 

Die Option Importabbruch für den Serienimport per Batch-/Schedulerjob wird über den Parameter -ia gesteuert. Standardmäßig ist die Option aktiv, so dass der Import bei Fehlern abgebrochen wird. 

Weitere Parameter für den automatisierten Serienimport sind:

  * - p: Quellordner > Template-Verzeichnis
  * - ia: Importabbruch > Importabbruch bei Fehlern (0 = Nein, 1 = Ja (Standard))
  * - iu: Update > Vorhandene Daten aktualisieren (0 = Nein (Standard), 1 = Ja)
  * - sftp: Templates über SFTP nach Quellordner runterladen
  * - sp: SFTP-Verzeichnis > Pfad zum SFTP-Verzeichnis mit Templates

Beispiel für eine Anweisung:
NCrem.Prozess.Win -t 2 -u ixhaus -up xxxx -iu 1 -ia 0 -p c:\\Template -o c:\\Template\\import.log

Weitere Infos zum Serienimport per Scheduler finden Sie im Abschnitt [[ix-haus_plus:scheduler:start|Scheduler]].
++++

===== EIBE-Portal konfigurieren =====
++++|
Lizenz: [[featurepakete:start|Featurepaket 20.23]]

Die Anwendung EIBE ist im Internet unter der URL: https://eibe.bff-online.de/eibe/ zu erreichen. Nach einer Registrierung haben Sie die Möglichkeit, hierüber Freistellungsbescheinigungen (FSB), welche Sie im [[stammdaten:kreditoren_debitoren:start|Kreditorenstamm]] hinterlegt haben, auch direkt über iX-Haus plus als Massenprozess zu prüfen. EIBE stellt hierzu eine Abfragemöglichkeit via XML-RPC-Schnittstelle bereit (s. auch EIBE-Handbuch). In iX-Haus plus stellen Sie unter Schnittstellen > [[ix-haus_plus:ix-haus_import:start#modul_schnittstellenadministration|Schnittstellenadministration]] für ''EIBE Portal'' im Register ''Einstellungen'' die Zugangsdaten für Echt- bzw. Testsystem ein. Hierzu dienen drei Felder.

| ''EIBE Portal'' | URL der EIBE-Anwendung im Internet für die Abfrage via XML-RPC-Schnittstelle. <wrap center round tip>
Bei Neuanlage einer Konfiguration im EIBE-Portal wird die Internetadresse für den Abruf der Daten vor belegt.
</wrap> |
| ''EIBE XML-RPC Schlüssel'' | XML-RPC-Schlüssel aus den Benutzerdaten des Benutzerkontos bei EIBE. |
| ''EIBE User'' | Benutzerkennung aus den Benutzerdaten des Benutzerkontos bei EIBE. Username für die Anmeldung an der XML-RPC-Schnittstelle von EIBE. |
| ''Portalzugang prüfen'' | Mit der Aktivierung dieses Kontrollfeldes wird eine Testabfrage gestartet, um die Benutzerzugangsdaten zu validieren. |

Beachten Sie hierzu bitte auch die Dokumentation von EIBE, Abschnitt ''XML-RPC-Schnittstelle'', welche Sie online abrufen oder auch als PDF von der eingangs benannten URL downloaden können. 

Ist die Schnittstelle ''EIBE-Portal'' eingerichtet, können Sie an verschiedenen Stellen im Programm EIBE-Abfragen durchführen, um die Aktualität einer oder mehrerer FSB zu prüfen oder auch das Datum der Gültigkeit einer FSB zu aktualisieren. Eine Aktualisierungsabfrage ist auch zeitgesteuert als [[ix-haus_plus:hintergrundprozesse:start|Hintergrundprozess]] über den Scheduler möglich.
++++