Einrichten einer externen Finanzschnittstelle

SyteLine stellt eine XML-basierte Schnittstelle bereit, die mit einem externen Finanzsystem wie z. B. Infor SunSystems oder SAP verwendet werden kann. Zusätzlich bietet SyteLine eine Schnittstelle für den direkten Datenzugriff für Infor Global Financials (IGF). Sie können auswählen, welche Arten von Finanzinformationen zwischen SyteLine und dem anderen System exportiert und importiert werden.

Hinweis:

Wenn Sie das Infor SyteLine Enterprise Financials-Paket (SunSystems-Schnittstelle) einrichten möchten, lesen Sie die erforderlichen Konfigurationsschritte im Handbuch Infor SyteLine Enterprise Financials Installation and Implementation Guide nach. Die oben beschriebenen Schritte finden in diesem Fall keine Anwendung.
Wenn Sie die Integration in IGF einrichten möchten, lesen Sie die entsprechenden Informationen im Handbuch Infor SyteLine Integration Guide for Infor Global Financials nach. Die oben beschriebenen Schritte finden in diesem Fall keine Anwendung.
Bei Verwendung eines anderen Finanzpakets führen Sie die nachfolgenden Schritte aus.

Lesen Sie im Zusammenhang mit diesem Thema auch Einrichten einer eingehenden Finanzschnittstelle.

So richten Sie die Schnittstelle zwischen SyteLine und einem externen Finanzsystem ein:

Da die externe Finanzschnittstelle zur Datenübertragung die nicht-transaktionsbezogene Replizierung verwendet, müssen Sie mit der Funktionsweise der Replizierung vertraut sein.

Weitere Informationen erhalten Sie im Dokument Replication Reference Guide, das Sie von der Support-Website herunterladen können.
Machen Sie sich mit dem Unterschied zwischen Datenfluss (Transaktionsdatensätze werden von SyteLine an das externe System übergeben) und Datenverwaltung (Aktualisierung von Codedatensätzen, z. B. Kundencodes, Bedingungscodes oder Wechselkurse, die von SyteLine an das externe System übergeben werden oder umgekehrt) vertraut. Entscheiden Sie, welches System der "Master" für Kreditoren- und Debitorenaufgaben sein soll.
Machen Sie sich sowohl mit der Datenbankstruktur von SyteLine als auch mit der Datenbankstruktur der externen Finanzanwendung vertraut. Ordnen Sie die Finanzdaten zu, die zwischen den Systemen ausgetauscht werden müssen. Halten Sie fest, in welchem System die Daten verwaltet werden sollen.

Die SyteLine-Tabelle der Schemaeigenschaften von DataMap, in der die SyteLine-Datenbanktabellen und -spalten aufgeführt werden, könnte sich als Ausgangspunkt für einen Zuordnungsplan anbieten.
Befassen Sie sich mit der Syntax der XML-Anforderungsdokumente, die zum Austausch von Daten mit SyteLine verwendet werden.

Weitere Informationen finden Sie im Dokument Integrating IDOs with External Applications (insbesondere im Kapitel über XML-IDO-Anforderungsdokumente und -Antwortdokumente), das Sie von unserer Support-Website herunterladen können.
Erstellen Sie in der Maske Systemtypen einen neuen Systemtyp für die externe Finanzanwendung.

Dieser Systemtyp wird verwendet, wenn der Zielstandort für die externe Finanzanwendung in der Maske Standorte/Entitäten definiert wird.

Stellen Sie sicher, dass für Ihre SyteLine-Anwendung ein zusätzlicher Systemtyp definiert ist.

Die Typen der Quell- und Zielsysteme werden in den Namen von XSL-Stylesheets verwendet, die zur Umwandlung der XML-Daten verwendet werden können.
Definieren Sie in der Maske Intranet ein gesondertes Intranet, das nur für Datenanforderungen an und von der externen Finanzanwendung verwendet wird. Geben Sie diesem Intranet einen eindeutigen Namen, z. B. EXTFIN, und aktivieren Sie das Kontrollkästchen Extern.

Geben Sie für dieses Intranet den URL an, an den die XML-Anforderungsdokumente und -Antwortdokumente der Finanzanwendung gesendet werden. Die Angabe erfolgt im Feld URL der Maske Intranet. Bei diesem URL kann es sich um eine ASP-Seite des externen Finanzsystems handeln, das die XML-Dokumente aus der SyteLine-Meldungswarteschlange empfängt und verarbeitet. Die Verarbeitung, die unter diesem URL erfolgt, wird von Ihnen festgelegt. Beispielsweise kann eine ASP-Seite die Daten in ein geeignetes Format für das externe System umwandeln oder die XML-Dokumente zur späteren Verarbeitung an einem Speicherort auf dem zugehörigen Server ablegen.
Definieren Sie in der Maske Standorte/Entitäten einen Quellstandort, von dem Systemdaten exportiert werden:
- Wählen Sie in der Registerkarte System-Info den (zuvor definierten) Systemtyp der SyteLine-Anwendung sowie die Zeitzone aus.
- Geben Sie im Feld Intranet-Name das standardmäßige Intranet an.
- Geben Sie im Feld Datenbankname den Namen der Anwendungsdatenbank an.
Definieren Sie in der Maske Standorte/Entitäten einen Zielstandort für die externe Finanzschnittstelle.
Hinweis: Dieser Standort darf zu keinem anderen Zweck verwendet werden. Um Verwirrungen zu vermeiden, sollte dieser Standort EXTFIN genannt werden.
- Nehmen Sie auf der Registerkarte System-Info die folgenden Eingaben vor:
- Wählen Sie den (zu einem früheren Zeitpunkt definierten) Systemtyp der externen Finanzanwendung sowie die Zeitzone aus.
- Legen Sie das im vorherigen Schritt erstellte Intranet als Intranet-Namen des Standorts fest.
- Geben Sie im Feld Datenbankname die Datenbank der externen Finanzanwendung an.
Nehmen Sie auf der Registerkarte Standort-Anw.Zuord. die folgenden Eingaben vor:
- Geben Sie im Feld Von Standort den SyteLine-Standort an, der Daten an EXTFIN sendet.
- Geben Sie im Feld Anwendername einen lokalen Anwender dieses Standorts an.
Weitere Informationen zu Anforderungen beim Einrichten dieses Anwenders finden Sie in der Online-Hilfe zu dieser Registerkarte und diesem Feld.
Entscheiden Sie, ob Sie Rechnungen, Lastschriften, Gutschriften und/oder Belege und Korrekturen in das externe Finanzsystem exportieren möchten. Geben Sie die folgenden Informationen in die Felder der Maske Externe Finanzschnittstellenparameter in SyteLine ein:
- Wenn Sie die Option Externe Finanzschnittstelle verwenden auswählen, exportiert SyteLine alle gebuchten Hauptbuchtransaktionen in das externe System. Ferner wird davon ausgegangen, dass alle Kunden- und Lieferantendatensätze in SyteLine erstellt werden und die Datensätze in das externe System exportiert werden. Bei Auswahl dieser Option wird auch die Funktion 'Externe Finanzschnittstelle - Daten anfordern' aktiviert.
- Wenn Sie für die Kreditoren ein externes Finanzsystem verwenden möchten, aktivieren Sie zudem die Option Externes Kreditorensystem verwenden. Damit wird SyteLine aufgefordert, alle gebuchten Kreditorenbeleg- und -korrekturtransaktionen in das externe System zu exportieren.
- Wenn Sie für die Debitoren ein externes Finanzsystem verwenden möchten, aktivieren Sie zudem die Option Externes Debitorensystem verwenden. Damit wird SyteLine angewiesen, alle gebuchten Debitorenrechnungs-, -gutschrift- und -lastschrifttransaktionen in das externe System zu exportieren. Bei Auswahl dieser Option wird auch die Registerkarte Gebuchter Kundensaldo der Funktion 'Externe Finanzschnittstelle - Daten anfordern' aktiviert.
- Sowohl für Kreditoren als auch für Debitoren können Sie die maximale Batchgröße für ein einzelnes XML-Dokument festlegen. Bedenken Sie, dass die Verarbeitung großer XML-Dokumente mehr Zeit in Anspruch nimmt.
- Geben Sie den in Schritt 8 angegebenen Standort im Feld Standort an.
Entscheiden Sie, ob Sie die standardmäßige SyteLine-Verarbeitung hinsichtlich der Berechnung von Fälligkeitsterminen, Steuern oder hinsichtlich der Währungsumrechnung ändern möchten. In der Maske Externe Finanzschnittstellenparameter können Sie festlegen, dass diese extern verarbeitet werden. Wenn Sie die externe Verarbeitung auswählen, müssen sie eine dieser gespeicherten Stub-Prozeduren entsprechend bearbeiten:
- ExtFinCurrCnvtCalcSp (Währungsumrechnung)
- ExtFinDueDateCalcSp (Berechnung von Fälligkeitsterminen)
- ExtFinTaxCalcSp (Berechnung von Steuern)
Entscheiden Sie, wie die Kundenkreditprüfung gehandhabt werden soll.
Wenn SyteLine eine Kreditprüfung für einen Kunden durchführt, wird der aktuelle gebuchte Saldo des Kunden benötigt. Wenn SyteLine für Debitorenfunktionen verwendet wird, verfügt die Anwendung über alle Informationen, die zum Berechnen und Speichern der Beträge gebuchter Salden benötigt werden. Wenn jedoch das externe Finanzsystem für Debitorenfunktionen verwendet wird, muss SyteLine den gebuchten Saldo aus dem externen System abrufen. Hierzu bestehen zwei Möglichkeiten:
- Um den gebuchten Saldo zum Zeitpunkt der Kreditprüfung (d. h. synchron) abzurufen, richten Sie das System so ein, dass eine gespeicherte Stub-Prozedur aufgerufen wird, die den gebuchten Saldo des Kunden aus dem externen System abruft.
  Wählen Sie für die Einrichtung das Feld Externen gebuchten Kundensaldo für Kreditprüfung verwenden in der Maske Externe Finanzschnittstellenparameter aus. Aktualisieren Sie dann die gespeicherte Stub-Prozedur ExtFinGetExternalPostedBalSp, sodass sie den gebuchten Saldo aus dem externen System zurückgibt.
- Um einen zuvor (d. h. asynchron) abgerufenen gebuchten Saldo zu verwenden, richten Sie die Anforderungsinformationen auf der Registerkarte Gebuchter Kundensaldo der Funktion 'Externe Finanzschnittstelle - Daten anfordern' ein.
  Bei jeder Ausführung dieser Funktion aktualisiert SyteLine die gebuchten Saldeninformationen für alle Kunden in dem Bereich. Bei einer Kreditprüfung werden dann die letzten gespeicherten Daten verwendet.
Prüfen Sie die standardmäßigen EXTFIN-Kategorien (externen Finanzkategorien) in der Maske Replizierungskategorien, und entscheiden Sie, ob neue Kategorien hinzugefügt werden müssen.

Befinden sich beispielsweise Daten in anderen SyteLine-Tabellen, die das externe Finanzsystem benötigt? Sie sollten die Standardkategorien beibehalten und ggf. neue erstellen. Die standardmäßigen EXTFIN-Kategorien lauten wie folgt:

Hinweis: Ein Tabellenname kann durch den Namen einer Ansicht über der Tabelle dargestellt werden. In diesem Abschnitt werden, wo angebracht, Namen von Ansichten anstelle von Tabellennamen verwendet.

EXTFIN: Wird zum Exportieren der Debitoren-, Kreditoren- und Hauptbuchtransaktionen von SyteLine in das externe Finanzsystem sowie zum Exportieren von Anforderungen für die Aktualisierung der SyteLine-Tabellen durch das externe Finanzsystem verwendet. Diese Kategorie beinhaltet die Funktionen und XML-Dokumente, die zum Exportieren von Finanzinformationen benötigt werden:
- ExtFinAPVoucherPosting: Exportiert Daten aus den SyteLine-Tabellen export_aptrx und export_aptrxd, die Tabellen für aus verschiedenen Kreditorentabellen gesammelte Daten enthalten.
- ExtFinARInvoicePosting: Exportiert Daten aus den SyteLine-Tabellen export_arinv und export_arinvd, die Tabellen für aus verschiedenen Debitorentabellen gesammelte Daten enthalten.
- ExtFinAnaLedgerPosting: Exportiert Daten aus der SyteLine-Tabelle ana_ledger.
- ExtFinLedgerPosting: Exportiert Daten aus der SyteLine-Tabelle ledger.
- ExtFinRequest: Exportiert eine Anforderung für Aktualisierungen einer bestimmten SyteLine-Tabelle in die externe Finanzanwendung. Weitere Informationen zur Funktion 'Externe Finanzschnittstelle - Daten anfordern' finden Sie in der Hilfe.
EXTFIN-Kunde Wird für den Export von SyteLine-Kundeninformationen verwendet. Diese Kategorie beinhaltet die verwandten Datenbanktabellen custaddr und customer.
EXTFIN-Lieferant: Wird für den Export von SyteLine-Lieferanteninformationen verwendet. Diese Kategorie beinhaltet die verwandten Datenbanktabellen vendaddr und vendor.

Verarbeitungshinweis für Kunden- und Lieferantendatensätze: Wenn ein neuer Kunden- oder Lieferantendatensatz in SyteLine hinzugefügt wird, werden die Informationen als einzelnes XML-Dokument mit kombinierten Informationen aus den verwandten Tabellen customer/custaddr bzw. vendor/vendaddr an das externe Finanzsystem gesendet. Die Informationen für custaddr oder vendaddr in dem einzelnen XML-Dokument enthalten lediglich die angegebenen Schlüssel und Standardwerte für die Spalten der Tabelle. Die benutzerspezifizierten Werte werden im Rahmen einer Aktualisierung aufgenommen, die auf die Einfügung folgt. Für Aktualisierungen vorhandener Kunden- oder Lieferantendatensätze ruft das XML-Dokument Datensätze nur aus der geänderten Tabelle ab.

Verwenden Sie über die Maske Replizierungsregeln eine Replizierungsregel für jede EXTFIN-Kategorie.
Dies muss an jedem SyteLine-Standort erfolgen, von dem Daten an den EXTFIN-Standort exportiert werden. Wenn Sie im vorherigen Schritt zusätzliche Kategorien für das externe Finanzsystem erstellt haben, richten Sie ebenfalls Regeln für die neuen Kategorien ein.

Eine Regel könnte beispielsweise die folgenden Informationen enthalten:

Quellstdrt. OH (Standort, von dem Daten extrahiert werden)

Zielstandort: EXTFIN

Kategorie: EXTFIN-Lieferant

Beschreibung: Lieferanteninformationen an EXTFIN übergeben

Intervalltyp Sofort (bis auf "Transaktionsbezogen" kann hier jede Einstellung ausgewählt werden.)

Intervall: (Leer, wenn der Intervalltyp auf Sofort gesetzt ist. Andernfalls wird hier ein Intervallwert angegeben.)

Intervallstart: (Leer, wenn der Intervalltyp auf Sofort gesetzt ist. Andernfalls wird hier ein Zeitintervall angegeben.)

Replizierung deakt.: (Nicht aktiviert - EXTFIN verwendet die Replizierung.)

Alle Spalten aktualisieren: (Nicht aktiviert)
Klicken Sie in der Maske Replizierungsverwaltung auf die Schaltfläche Repl.-Trigger neu generieren, um die Datenbanktabellen-Trigger basierend auf den im vorherigen Schritt erstellten Regeln neu zu erstellen.
Stoppen und starten Sie die Replizierungsdienste auf dem SyteLine-Funktionsserver.
Richten Sie den URL auf dem externen Finanzsystem ein (dieser URL wurde in Schritt 6 angegeben), um die in Schritt 12 erwähnten XML-Dokumente abzurufen und zu verarbeiten.
Auch in diesen Beispielen werden anstelle der tatsächlichen Tabellennamen die Namen der Ansichten verwendet.
- Die EXTFIN-XML-Dokumente zur Sammlungsaktualisierung (Update Collection) werden zur Angabe von Informationen aus SyteLine verwendet, die im externen Finanzsystem aktualisiert werden sollten. Sie beginnen mit einer Gruppe von Tags, die den folgenden ähneln:
  <IDORequest>
  <RequestHeader Type="UpdateCollection">
  <RequestData>
  
  <UpdateCollection Name="EXTFIN.xml_doc_name.table">
  
  Beispiel: <UpdateCollection Name="EXTFIN.ExtFinLedgerPosting.ledger">
  
  Das externe Finanzsystem reagiert auf Anforderungen zur Sammlungsaktualisierung in der Regel mit einer Aktualisierung der Daten in der externen Finanzanwendung.
- Die EXTFIN-XML-Dokumente zum Laden einer Sammlung (Load Collection) werden zur Angabe von Informationen aus dem externen Finanzsystem benötigt, die in SyteLine aktualisiert werden müssen. Sie beginnen mit einer Gruppe von Tags, die den folgenden ähneln: <IDORequest>
  <RequestHeader Type="LoadCollection">
  
  <RequestData>
  
  <LoadCollection Name="EXTFIN.xml_doc_name.table">
  
  Beispiel: <LoadCollection Name="EXTFIN.ExtFinRequestChart.chart">
  
  Eine Ausnahme stellt die Anforderung Gebuchter Kundensaldo dar, die eine Aufrufmethoden-Anforderung (Invoke Method) verwendet:
  
  <Invoke="EXTFIN.ExtFinRequestCustomerPostedBalance">
  
  Die externe Finanzanwendung reagiert in der Regel auf Anforderungen zum Laden einer Sammlung und Aufrufmethoden-Anforderungen, indem sie SyteLine mit einer Sammlungsaktualisierung antwortet, die die angeforderten Daten enthält.
  
  Weitere Informationen hierzu finden Sie unter: Beispiel: Anfordern von Daten aus einer externen Finanzanwendung.
- Die XML-Dokumente EXTFIN-Kunde und EXTFIN-Lieferant enthalten einen Tag, der dem folgenden ähnelt:
  <UpdateCollectionName="Table!replication_category_to_object_name">
  
  Zum Beispiel: <UpdateCollectionName="Table!Customer">
  
  Das externe Finanzsystem reagiert auf diese Anforderungen zur Sammlungsaktualisierung in der Regel mit einer Aktualisierung der Daten in der externen Finanzanwendung.
Das externe Finanzsystem sollte anhand der Informationen in diesen Tags feststellen, wie die Daten in den einzelnen XML-Dokumenten verarbeitet und zugeordnet werden. Im Importvorgang auf dem externen System müssen ebenfalls die batch_seq-Informationen im XML-Dokument verarbeitet werden.

Informationen zu Syntax und Tags in XML-Dokumenten finden Sie im Dokument Integrating IDOs with External Applications (Einbinden von IDOs in externe Anwendungen), insbesondere im Kapitel über XML-IDO-Anforderungsdokumente und -Antwortdokumente.

Beispiele für ausgehende XML-Dokumente, die von SyteLine generiert werden können, stehen als komprimierte Dateien auf unserer Support-Website zur Verfügung.
Richten Sie die Schnittstelle zwischen dem externen System und SyteLine ein.

Lesen Sie das Thema Einrichten einer eingehenden Finanzschnittstelle.