Vorlage für Finance-Schnittstelle erstellen
In diesem Dokument wird beschrieben, wie in "FIM-Schnittstelle. Öffnen" (GLS850) eine Schnittstellenvorlage zum Importieren von Finanztransaktionen in M3 Business Engine (BE) erstellt wird. Mit der Schnittstellenlösung können Hauptbuch-, Kreditoren- und Debitorentransaktionen in das Hauptbuch importiert werden.
Die Schnittstelle wird als Tool verwendet, um Anfangssalden oder offene Artikel (AR/AP) oder periodisch, Hauptbuchtransaktionen wie Lohntransaktionen zu übertragen. Außerdem können über diese Funktion Kundenrechnungen, die von einem anderen System ausgestellt wurden, importiert werden. Die Schnittstelle ist nur in Ausnahmefällen mit bestimmten Einschränkungen für die Verarbeitung von Debitoren-Zahlungstransaktionen zu verwenden. Sie ist auch nicht dafür gedacht, regelmäßig Lieferantenrechnungen zu übertragen.
Für die Verarbeitung von Kundenzahlungen empfehlen wir stattdessen die Verwendung von "Bankauszug. Öffnen" (ABS100). Für die Verarbeitung von Lieferantenrechnungen empfehlen wir, dass möglichst "Lieferantenrechnungsbatch. Öffnen" (APS450) mit Positionstyp 8 ("Buchungszeile") verwendet wird.
Für jede in (GLS850) eingerichtete Schnittstelle muss eine Verwendungsart ausgewählt werden. Die Verwendungsart steuert, wie die Transaktionen in M3 BE hochgeladen und verarbeitet werden, sowie den Typ der Transaktionen, die über die Schnittstelle (Schnittstellentyp) importiert werden können. Für die Schnittstellenvorlagen sind in (GLS850) drei Verwendungsarten verfügbar.
| Verwendungsart | Schnittstellentyp | Methode zum Importieren der Transaktionen |
|---|---|---|
| 0-MvxFileTransfer |
Hauptbuchbelege Kundenrechnungen Kundenzahlungen (nicht empfohlen, siehe Erklärung oben) Lieferantenrechnungen (nicht empfohlen, siehe Erklärung oben) |
Die Transaktionen werden über (GLS850) und eine positionsbasierte Textdatei in den für die Dateiübertragung verwendeten Ordner hochgeladen. |
| 1-Positionsbasierte API |
Hauptbuchbelege Kundenrechnungen Kundenzahlungen (nicht empfohlen, siehe Erklärung oben) Lieferantenrechnungen (nicht empfohlen, siehe Erklärung oben) |
Die Transaktionen werden in (GLS840)/(GLS841) über die positionsbasierte API-Transaktion GLS840MI/AddBatchLine hochgeladen. |
| 2-Feldbasierte API | Hauptbuchbelege | Die Transaktionen werden in (GLS840)/(GLS842) über die feldbasierte API-Transaktion GLS840MI/AddBatchLineFld hochgeladen. |
Verwendungsart 0 und 1 verwenden eine positionsbasierte Lösung. Dafür müssen in der Schnittstellenvorlage für die einzelnen Dateneingabetypen Ausgangs- und Zielpositionen festgelegt werden. Die Daten für die jeweilige Belegposition werden in der Textdatei als lange Zeichenkette (long string) oder in der API-Transaktion in ein Eingabefeld mit 900 Zeichen eingegeben. Bei Verwendungsart 2 müssen in der Vorlage keine Ausgangs- und Zielpositionen definiert werden, da die API-Transaktion für jeden Datentyp über ein zugewiesenes Eingabefeld verfügt.
Erstellen Sie eine Schnittstellenvorlage für Verwendungsart 2-"Feldbasierte API".
Verwendungsart 2-"Feldbasierte API" wird zum Hochladen von Hauptbuchbelegen (HB-Belegen) über GLS840MI (generische HB-Schnittstelle) verwendet. Die API-Transaktion, die zum Hochladen der Positionen für diese Verwendungsart verwendet wird, verfügt über ein zugewiesenes Eingabefeld für jeden Datentyp, im Gegensatz zu Verwendungsart 1, bei der die Daten für jede Position in ein 900 Zeichen fassendes Eingabefeld eingegeben werden.
Bevor Sie beginnen
- Definieren Sie die Schnittstellenanforderungen.
- Das Finanzsystem muss konfiguriert sein. Weitere Informationen dazu finden Sie unter Finanzmanagement aktivieren.
- In "Journalnummernserie. Öffnen" (CRS400) werden Journalnummernserien für das aktuelle Jahr definiert.
- FAM-Funktion GL01 ist in "FAM-Funktion. Öffnen" (CRS405) mit mindestens einem Detaildatensatz definiert. Der Detaildatensatz steuert folgende Buchungsfunktionen für Schnittstellen mit Verwendungsart 2:
- Von-Datum/Bis-Datum, falls Buchungen erlaubt sind
- Belegnummernserie und Belegname
- Abgrenzungsbuchung, wenn der Hauptbuchbeleg ein provisorischer Rückbuchungsbeleg ist, d. h., ob er automatisch an einem festgelegten Rückbuchungsdatum rückgebucht wird
- Wechselkurstyp
- Bildlayout, für Layout 20 und 21 kann eine Währung definiert werden.
Führen Sie folgende Schritte aus
-
Geben Sie einen Schnittstellennamen an, und wählen Sie in (GLS850/B) die Option 1-"Erstellen" aus. Drücken Sie dann die Eingabetaste.
-
Geben Sie eine Beschreibung an, und wählen Sie in Bild E die Verwendungsart 2-"Feldbasierte API" aus. Dann wird der "Schnittstellentyp" auf 01-"Hauptbuchbelege" gesetzt, was der einzige Transaktionstyp ist, die für diese Verwendungsart verfügbar ist. Geben Sie die FAM-Funktion "GL01" und einen detaillierten FAM-Funktionsdatensatz ein. Drücken Sie die Eingabetaste, um den Vorlagenkopf zu erstellen.
-
Nachdem der Kopf in (GLS850) erstellt wurde, wird automatisch eine Standardvorlage für die Felder generiert. Bei der Erstellung des Feld-Vorlagenkopfes ist "Eingabedatensatz-ID" in "FIM-Schnittstelle. Eingabe-DS definieren" (GLS855) auf "I1" gesetzt. Für Verwendungsart 2 müssen nur die Ausgabefelder definiert werden, da die Eingabefelder nur im Hintergrund vorhanden sind.
-
In "FIM-Schnittstelle. Ausgabe-DS definieren" (GLS857) wird der Ausgabefeldkopf erstellt. Bei Verwendungsart 2 ist nur FCR040 als Ausgabetabelle gültig, die auch nur einmal angegeben werden kann.
-
In "FIM-Schnittstelle. Ausgabefelder defin. "(GLS858) werden die Ausgabefelder definiert. Jedes Ausgabefeld ist mit einem Eingabefeld in der API-Transaktion verbunden. Im Auswahlfeld "Befüllungsmethode" werden abhängig von der gewählten Befüllungsmethode verschiedene Ausgabefelder angezeigt. Diese Methode steuert, wie Ausgabedatensätze in der Schnittstelle generiert werden und gegebenenfalls für die entsprechenden Felder geändert werden können, damit sie der jeweiligen Schnittstelle entsprechen.
Die folgende Tabelle zeigt die verfügbaren Befüllungsmethoden und wie diese verwendet werden:
Befüllungsmethode Beschreibung 0-"Nicht befüllt" Felder, die in der Schnittstelle nicht verwendet werden 1-"Befüllt aus Eingabedatei" Felder, die über die API-Transaktion eingegeben werden sollen 2-"Befüllt mittels Standardwerten" Felder, die mit einem festen Wert für alle Buchungszeilen in der Schnittstelle befüllt werden sollen. Der Wert wird in (GLS858/E) in Feld "StWert AusgFeld" eingegeben. 3-"Schnittstellen-Batchjob befüllt Feld" Felder, die mit einem Wert aus dem System befüllt werden sollen. Dies wird während der Aktualisierung des Hauptbuchs im Programm verarbeitet. Befüllungsmethode 3 kann nur für Felder verwendet werden, die in (GLS858/B) in Spalte "Feld" mit einem Sternchen (*) markiert sind.
Vorlage für Standard-Ausgabefelder in (GLS858)
In der nachfolgenden Tabelle sind die Vorlagen für Standard-Ausgabefelder für Verwendungsart 2 und die für jedes Feld definierte Standard-Befüllungsmethode angegeben.
Die Spalte "Befüllungsmethode" in dieser Tabelle zeigt die anwendbaren Befüllungsmethoden an, die für jedes Ausgabefeld ausgewählt werden können. In der Spalte "Kommentar" werden alle zusätzlichen Regeln oder Logiken für das Feld angegeben.
Ausgabefelder für Befüllungsmethode 0-"Nicht befüllt":
| Sequenznummer | Feldname | Beschreibung | Befüllungsmethode | Kommentar |
|---|---|---|---|---|
| 007 | EICD | Externe/interne Transaktion | 0-2 | Dieses Feld muss nur für interne Transaktionen definiert werden. Wert 1 = Interne Transaktion. |
| 023 | ACQT | Menge | 0-2 | |
| 033 | VTCD | USt-Code | 0-2 | Muss ein gültiger USt-Code aus "USt-Code. Öffnen" (CRS030) sein. |
| 049 | VRNO | USt-Identifikationsnummer | 0-2 | |
| 050 | EXN1 | HB-Informationsnummer | 0-2 | Die Felder für die HB-Informationen werden verwendet, um in der Hauptbuch-Erweiterungstabelle FGLEDX (GLS250) zusätzliche Informationen zu generieren. Weitere Informationen zu den verfügbaren Informationsnummern finden Sie unter den Funktionen in "Hauptbuch Zusatz-Infos. Aktualisieren" (GLS950). |
| 051 | EXI1 | Hauptbuchzusatznummer | 0-2 | |
| 052 | EXN2 | HB-Informationsnummer | 0-2 | |
| 053 | EXI2 | HB-Informationsnummer | 0-2 |
Ausgabefelder für Befüllungsmethode 1-"Befüllt aus Eingabedatei" (API-Transaktion):
| Sequenznummer | Feldname | Beschreibung | Befüllungsmethode | Kommentar |
|---|---|---|---|---|
| 013 | AIT1 | Dimension 1 | 1-2 | |
| 014 | AIT2 | Dimension 2 | 0-2 | |
| 015 | AIT3 | Dimension 3 | 0-2 | |
| 016 | AIT4 | Dimension 4 | 0-2 | |
| 017 | AIT5 | Dimension 5 | 0-2 | |
| 018 | AIT6 | Dimension 6 | 0-2 | |
| 019 | AIT7 | Dimension 7 | 0-2 | |
| 020 | VTXT | Belegtext | 0-2 | |
| 025 | CUCD | Währung | 1-3 | Befüllungsmethode 3 kann für CUCD nur ausgewählt werden, wenn in (GLS850/E) eine FAM-Funktion mit einer Währung (Bildlayout 20/21) ausgewählt ist. Die Währung aus der FAM-Funktion wird bei der Erstellung der Belegposition abgerufen und kann in (GLS840)/(GLS842) angezeigt werden. |
| 028 | CUAM | Fremdwährungsbetrag | 1 | Bei negativen Beträgen sollte vor den Zahlen in der API-Transaktion das Minuszeichen "-" stehen, z. B. -2.500,00. |
| 029 | DBCR | Soll-/Habencode | 1 oder 3 | Befüllungsmethode (PMET) für DBCR wird auf Basis der Einstellung des Soll/Haben-Codes (DCNY) für die Division in "Settings - Hauptbuch" (CRS750) festgelegt. Wenn DCNY=0 ist, wird PMET auf 3 gesetzt, und wenn DCNY=1 ist, wird PMET auf 1 gesetzt und muss über die API-Transaktion erfasst werden. Diese Einstellung kann nicht geändert werden. |
| 030 | ACDT | Buchungsdatum | 1-2 | Pro Gruppennummer (GRNR) kann nur ein Buchungsdatum vorhanden sein. |
| 054 | SHDT | Rückbuchungsdatum | 1 | SHDT wird nur als Ausgabefeld erstellt, wenn für die in (GLS850/E) erfasste FAM-Funktion der Parameter "Abgrenzungsbuchung" ausgewählt ist. Weitere Informationen zum Beleg für Abgrenzungsbuchungen finden Sie weiter unten. |
Ausgabefelder für Befüllungsmethode 3-"Schnittstellen-Batchjob befüllt Feld":
| Sequenznummer | Feldname | Beschreibung | Befüllungsmethode | Kommentar |
|---|---|---|---|---|
| 024 | ACAM | Gebuchter Betrag | 1 oder 3 | Bei negativen Beträgen sollte vor den Zahlen in der API-Transaktion das Minuszeichen "-" stehen, z. B. -2.500,00. |
| 026 | CRTP | Wechselkurstyp | 1-3 | |
| 027 | ARAT | Wechselkurs | 1-3 | |
| 041 | BSCD | Basisland | 1-3 | |
| 042 | FTCO | Von Land/Nach Land | 1-3 |
Schnittstelle für Abgrenzungsbuchungsbeleg einrichten
Dieselbe Abgrenzungsbuchungsfunktionalität, die in "Hauptbuchbeleg. Eingeben" (GLS100) für Belege zur Verfügung steht, kann für Schnittstellen der Verwendungsart 2 verwendet werden. Die Belegpositionen, die in "FIM-Schnittstelle. Öffnen" (GLS840) oder "FIM-Schnittstelle. Positionen öffnen" (GLS842) eingegeben wurden, werden bei der Erfassung im Hauptbuch an einem festgelegten Rückbuchungsdatum automatisch storniert. Dieses Datum muss größer sein als das Buchungsdatum des Belegs. Das Rückbuchungsdatum muss pro Gruppennummer (Beleg) eindeutig sein.
Um dies einzurichten, muss in "FAM-Funktion. Öffnen" (CRS405) die FAM-Funktion GL01 mit einem Detaildatensatz definiert sein, für den der Parameter "Abgrenzungsbuchung" ausgewählt ist. Eine Schnittstellenvorlage muss in (GLS850) für Verwendungsart 2 erstellt werden, und die FAM-Funktion für Abgrenzungsbuchung muss in (GLS850/E) ausgewählt sein. Dann wird in (GLS858) das Feld "Rückbuchungsdatum" (SHDT) als Ausgabefeld für Befüllungsmethode 1 (aus der Eingabedatei) erstellt und kann über die API-Transaktion eingegeben werden.