Finance-Schnittstellentransaktionen verwalten

AddBatchHead - Kopf hinzufügen

Die Transaktion "AddBatchHead" erstellt einen Kopfdatensatz in der Tabelle FGLINH für einen Batch von Finanztransaktionen. Der Kopf kann in (GLS840) angezeigt werden. Diese Transaktion wird für Schnittstellen der Verwendungsart 1 und 2 verwendet.

Obligatorische Felder in der API-Transaktion:


Feldname	Beschreibung	Länge/Typ	Kommentar
CONO	Firma	3 (Numerisch)
DIVI	Division	3 (Zeichenkette)	Obligatorisch, wenn Divisionen für die Firma verwendet werden.
KEY1	Schlüsselwert	15 (Zeichenkette)	Dies ist eine eindeutige ID für jeden Batchkopf. Dies kann beispielsweise eine Kombination aus einem Datum und einer Seriennummer sein.
DESC	Beschreibung	40 (Zeichenkette)
INTN	Schnittstelle	15 (Zeichenkette)	Dies ist der Schnittstellenname aus (GLS850) für die Verknüpfung des Batches der Transaktionen mit der betreffenden Vorlage.

AddBatchLine - Positionen für Schnittstellen mit Verwendungsart 1 hinzufügen

Mit "AddBatchLine" werden in (GLS850) in der Tabelle FGLINL Transaktionspositionen für Schnittstellen mit Verwendungsart 1-"Positionsbasierte API" erstellt. Die Positionen werden in (GLS840) über den eindeutigen "Schlüsselwert" mit einem Kopfdatensatz verbunden. Die Transaktionsdaten für jede Position werden als lange Zeichenkette (maximale Länge 900) im Feld "Parameterwert" (PARM) eingegeben. Eine Schnittstellenvorlage muss in (GLS850) erstellt werden, wobei für jeden Typ von Eingabedaten in der Zeichenkette Ausgangs- und Zielpositionen definiert werden. Das Programm "FIM-Schnittstelle. Positionen öffnen" (GLS841)" wird zum Anzeigen der Positionen verwendet.

Diese Tabelle zeigt alle obligatorischen Felder in der API-Transaktion:


Feldname	Beschreibung	Länge/Typ	Kommentar
CONO	Firma	3 (Numerisch)
DIVI	Division	3 (Zeichenkette)	Obligatorisch, wenn Divisionen für die Firma verwendet werden.
KEY1	Schlüsselwert	15 (Zeichenkette)	Dies ist eine eindeutige ID für jeden Batchkopf und muss für jede mit dem Kopf verbundene Position identisch sein.
LINE	Positionsnummer	7 (Numerisch)	Sequenznummer, die jeder Position zugeordnet wird.
PARM	Parameterwert	900 (Zeichenkette)	Eine lange Zeichenkette mit den Transaktionsdaten.

AddBatchLineFld - Positionen für Schnittstellen mit Verwendungsart 2 hinzufügen

Die Transaktion "AddBatchLineFld" erstellt in der Tabelle FGLINF Belegpositionen für Schnittstellen, denen in (GLS850) Verwendungsart 2-"Feldbasierte API" zugewiesen ist. Diese Transaktion verfügt über ein zugewiesenes Eingabefeld für jeden Datentyp. Die Belegpositionen können im Programm "FIM-Schnittstelle. Positionen öffnen" (GLS842) angezeigt werden, und sie sind in (GLS840) über den eindeutigen "Schlüsselwert "mit einem Kopfdatensatz verbunden.

Nur Felder, die in (GLS850)/(GLS858) in der Vorlage für die Befüllungsmethode 1-"Befüllt aus Eingabedatei" definiert sind, sind in der API-Transaktion zulässig. Folgende Felder sind Ausnahmen, da sie nicht in der Vorlage enthalten sind:


Feldname	Beschreibung	Länge/Typ	Kommentar
DIVI	Division	3 (Zeichenkette)	Obligatorisch, wenn Divisionen für die Firma verwendet werden.
KEY1	Schlüsselwert	15 (Zeichenkette)	Dies ist eine eindeutige ID für jeden Batchkopf und muss für jede mit dem Kopf verbundene Position identisch sein. Obligatorisches Feld.
LINE	Positionsnummer	7 (Numerisch)	Sequenznummer, die jeder Position zugeordnet wird. Obligatorisches Feld.
INRI	Eingabedatensatz-ID	2 (Zeichenkette)	Dieses Feld sollte immer auf "I1" gesetzt sein. Obligatorisches Feld.
GRNR	Gruppennummer	10 (Zeichenkette)	Dies ist eine eindeutige Nummer für Transaktionen, die bei der Aktualisierung des Hauptbuchs zusammen einen Beleg bilden. Die Belegnummer wird automatisch aus der Belegnummernserie entnommen, die in der für die Schnittstelle in (GLS850/E) eingegebenen FAM-Funktion angegeben ist. Wenn die Gruppennummer für alle Positionen in einem Batch leer ist, werden alle Buchungszeilen in einer einzelnen Belegnummer verbucht. Optionales Feld.

Die folgende Tabelle zeigt ein Beispiel dafür, wie Positionen mit derselben Gruppennummer dieselbe Belegnummer erhalten:


Positionsnummer	Gruppennummer	Belegnummer (im Hauptbuch)
1	1	10002130
2	1	10002130
3	2	10002131
4	2	10002131
5	3	10002132
6	3	10002132

CtrlBatch - Option 6 in (GLS840) ausführen

Die Transaktion "CtrlBatch" startet die Validierung der hochgeladenen Daten in (GLS840) und die Einrichtung der Schnittstelle. Diese Transaktion startet einen Batchjob, und das Ergebnis der Validierung kann durch Navigieren zu (GLS840) ermittelt werden. Diese Transaktion wird für Schnittstellen der Verwendungsart 1 und 2 verwendet.

LstBatchLineFld - Listenpositionen, die über die API-Transaktion GLS840MI.AddBatchLineFld hochgeladen wurden

Die Transaktion "LstBatchLineFld" listet die in (GLS840)/(GLS842) über die feldbasierte API GLS840MI, AddBatchLineFld (Verwendungsart 2) hochgeladenen Positionen auf.

UpdBatch - Option 9 in (GLS840) ausführen

Die Transaktion "UpdBatch" startet dieselbe Validierung wie "CtrlBatch", aktualisiert aber auch das Hauptbuch (HB) mit den hochgeladenen Daten, wenn keine Fehler gefunden wurden. Das Ergebnis der Validierung oder Aktualisierung kann durch Navigieren zu (GLS840) ermittelt werden. Diese Transaktion wird für Schnittstellen der Verwendungsart 1 und 2 verwendet.

Hochgeladene Daten in (GLS840)/(GLS842) für Schnittstellen mit Verwendungsart 2 verwalten

Um die hochgeladenen Daten für eine Schnittstelle mit Verwendungsart 2 anzuzeigen und zu verwalten, wählen Sie in (GLS840) im Feld für die Verwendungsart Eingabe 2-"Feldbasierte API" aus. Die Auswahlfelder für den Status können verwendet werden, um Batches mit einem bestimmten Status aufzulisten.

Eine Validierung des Batches muss durchgeführt werden, um nach ungültigen oder fehlenden Daten zu suchen. Dies erfolgt in (GLS840) durch Auswahl der verknüpften Option 6 = Prüfen für den Batch oder 9 = Prüfen und Aktualisieren, um den Batch zu validieren und zu aktualisieren, falls keine Fehler gefunden wurden. Diese beiden Optionen können auch über (GLS840MI)-Transaktionen gestartet werden.

Das Feld "Status" in (GLS840/B) überwacht den aktuellen Status des Batches. Die folgenden Batchstatus sind für Verwendungsart 2 gültig:

10 = Neu
13 = Geprüft mit Fehlern
14 = Geprüft
15 = Validierung oder Aktualisierung läuft
20 = Im Hauptbuch aktualisiert

Die Felder "Fehler im Kopf" und "Positionsfehler" zeigen an, ob sich Fehler auf den gesamten Batch oder die Positionen beziehen. Jeder Fehler muss korrigiert werden, bevor der Batch im Hauptbuch aktualisiert werden kann. Wenn ein Fehler im Kopf in der Batchvalidierung gefunden wird, wird eine Fehlermeldung in der Listenansicht von (GLS840) angezeigt, um anzugeben, was falsch ist. Nachdem der Fehler korrigiert wurde, muss für den Batch die verknüpfte Option 6 oder 9 ausgewählt werden. Der gesamte Batch kann auch aus (GLS840) gelöscht und erneut hochgeladen werden, wenn es leichter ist, den Fehler in der Datenquelle zu korrigieren.

Für Schnittstellen der Verwendungsart 2 wird die verknüpfte Option 15 = Historie zum Öffnen von "FIM-Schnittstelle. Historie verarbeiten" (GLS865) nur verwendet, um das Datum und die Zeit anzuzeigen, zu der ein Batch im Hauptbuch aktualisiert wurde.

Die Option 11 = Positionen wird in (GLS840) ausgewählt, um die Belegpositionen in (GLS842) anzuzeigen und etwaige Positionsfehler zu korrigieren. Bild B verfügt über konfigurierbare Ansichten, und die meisten Felder können direkt in der Listenansicht bearbeitet werden, wenn sie in der Vorlage für die Befüllungsmethode 1 (aus Eingabedatei) definiert wurden. Positionen mit Fehlerstatus können ausgewählt werden, und in der Listenansicht wird eine Fehlermeldung für den ersten gefundenen Fehler angezeigt (wenn mehr als einer vorhanden ist). Wenn für dieselbe Position ein zweiter Fehler vorhanden ist, wird interaktiv eine neue Meldung angezeigt, nachdem der erste Fehler korrigiert und die Eingabetaste gedrückt wurde. Wenn in (GLS840) ein Batch den Status 15 oder 20 hat, können die Positionen in (GLS842) nicht geändert werden.

Im Detailbild (GLS842/E) werden alle Eingabefelder angezeigt, aber nur Felder, die für die Befüllungsmethode 1 definiert wurden, können bei Auswahl von Option 2 = Ändern bearbeitet werden. Andere Felder sind geschützt. Bei Feldern, die für die Befüllungsmethode 2 definiert sind, wird der in der Vorlage festgelegte Standardwert angezeigt, kann jedoch nicht geändert werden. Wenn dieser Wert falsch ist, muss er in (GLS858) geändert werden, und der Batch muss in (GLS840) gelöscht und dann erneut hochgeladen werden. Der Grund dafür ist, dass der Standardwert abgerufen wird, wenn die Positionen in der Tabelle FGLINF (GLS842) erstellt werden.

Hinweis

Als Alternative kann die API-Transaktion LstBatchLineFld verwendet werden, um die hochgeladenen Daten für eine Schnittstelle mit Verwendungsart 2 anzuzeigen und zu verwalten.

Aktualisierte Hauptbuchbelegnummer in (GLS842)

Belegnummer (VONO), Buchungskreis (VSER) und Jahr (YEA4) werden in der Tabelle FGLINF aktualisiert, wenn der Batch im Hauptbuch aktualisiert und der Beleg in der Tabelle FGLEDG erstellt wird. Dadurch soll eine Verknüpfung zwischen den Positionen in (GLS842) und dem Hauptbuch erstellt werden. Die Felder können in der Listenansicht in (GLS842) angezeigt werden.

Beispiele für Validierungsfehler

Es gibt viele mögliche Fehler, daher ist nicht jeder einzelne Fehler in diesem Dokument aufgeführt. Jedem Fehler wird eine Meldung beigefügt, in der der Fehler beschrieben wird. Diese sollte Ihnen genügend Informationen zur Behebung des Fehlers liefern. Im Folgenden finden Sie Beispiele für Kopf- und Positionsfehler. Die Fehler im Kopf beziehen sich auf den gesamten Batch von Transaktionen oder eine Gruppennummer innerhalb eines Batches, bei dem sich keine einzelne Position ausmachen lässt.

Fehler im Batchkopf (GLS840)


Fehlermeldung	Kommentar
Gruppennr. x ist nicht ausgeglichen	Der "Fremdwährungsbetrag" (CUAM) für die angezeigte Gruppennummer (GRNR) ist unausgeglichen (zwischen Haben/Soll oder negativ/positiv), oder wenn "Gebuchter Betrag" (ACAM) über Befüllungsmethode 1 verfügt, wird stattdessen der Saldo des ACAM überprüft und ist unausgeglichen. ACAM darf nicht 0 sein, sondern nur CUAM (dies kann bei Kursabweichungen der Fall sein).
Gruppennr. x enthält mehrere Buchungsdaten	Pro Gruppennummer kann nur ein Buchungsdatum vorhanden sein.
Keine Datensätze gefunden	In (GLS842) sind keine Positionen vorhanden, die mit dem Batchkopf in (GLS840) verbunden sind.

Batchpositionsfehler (GLS842)


Fehlermeldung	Kommentar
Buchungsdatum xxxxxx liegt außerhalb des gültigen Bereichs	Das Datum liegt nicht innerhalb des Buchungsdatumsbereichs, der für die von der Schnittstelle verwendete FAM-Funktion festgelegt wurde.
Buchungsdatum xxxxxx ist ungültig	Es wurde ein Datum eingegeben, das vom System nicht erkannt werden kann. Dies kann passieren, wenn das Datum in der API-Transaktion in einem falschen Format eingegeben wurde. Das Format sollte als JJJJMMT gesendet werden. Ein weiterer Grund könnte sein, dass das Datum außerhalb des Datumsbereichs des Systemkalenders liegt.
<Feldname> muss eingegeben werden	Einige Felder sind obligatorisch, wenn sie in der Schnittstellenvorlage für die Befüllungsmethode 1 definiert wurden. Wenn eines davon fehlt, zeigt die Fehlermeldung den Namen des Feldes an und dass dieses ausgefüllt werden muss. Obligatorische Felder bei Befüllungsmethode = 1: Dimension 1 (AIT1) Buchungsdatum (ACDT) Währung (CUCD) Fremdwährungsbetrag (CUAM) Soll-/Haben-Code (DBCR)* Gebuchter Betrag (ACAM) Wechselkurstyp (CRTP) Wechselkurs (ARAT) Basisland (BSCD) Von-/Nach-Land (FTCO) Rückbuchungsdatum (SHDT) Nur wenn für die Division verwendet, eingerichtet in (CRS750). *BSCD und FTCO sind obligatorisch, wenn die Befüllungsmethode = 1 und das Konto mit einem "USt-Kontotyp" (AT04) > 0 definiert ist.
Konto x ist ein Debitorenkonto. Die Buchung ist nicht erlaubt.	Debitorenkonten für manuelle Belege sind nicht zulässig.
Konto x ist ein Kreditorenkonto. Die Buchung ist nicht erlaubt.	Die Verwendung von Kreditorenkonten für manuelle Belege ist nicht erlaubt.
Ein Abgrenzungskonto ist nicht erlaubt.	Die Verwendung von Abgrenzungskonten für manuelle Belege ist nicht zulässig.
Bei Konto x kann es sich nicht um ein Anlagenkonto handeln.	Die Verwendung von Anlagenkonten (AT08 = 1 in (CRS630)) für manuelle Buchungen ist nicht zulässig.
Das Rückbuchungsdatum liegt außerhalb der erlaubten Grenzen	Das Datum liegt nicht innerhalb des Buchungsdatumsbereichs, der für die von der Schnittstelle verwendete FAM-Funktion festgelegt wurde.