How to Pass the Booking Line via API
API-Übergabe Buchung / Extended our API to get a full and finally commited booking line with the JSON info: “ The accounting items can be uploaded through the invoice.json during file upload now. See updated the "file upload" section in the domonda/api to reflect this. Furthermore, the possible VATs in the domonda/api are in the repo too, see here.”
Implementation Details
Upload Doku: https://github.com/domonda/api#file-uploads
Beispiel invoice.json: https://github.com/domonda/api/blob/master/example/invoice.jsonc
Q&A
Q: Welche VAT-Codes können übergeben werden?
A: domonda liefert eine Liste, es sind die IDs (Spalte A als Umsatzsteuerart) zu übergeben. Zusätzlich die Prozentsatz für die ausgewählte Umsatzsteuerart.
https://github.com/domonda/api/blob/master/vat-codes-and-percentages.csv
Q: Wie geschieht die Übergabe der Sachkonten?
A: Adressiert über die Sachkontonummer
Q: Wie geschieht die Übergabe der BC (Booking Codes)?
A: BC muss nicht übergeben werden, dieser ergibt sich aus Auswahl der Dokumentenkategorie (lt API Beschreibung), die ihrerseits eine konfigurierten BC hat.
Q: Übergabe des Buchungstexts?
A: Über Invoice.JSON per Upload, im Feld title von accountingItems
Q: Kann die Buchungszeile nur 1 Eintrag, oder aus mehreren bestehen? Oder geschieht dies automatisch anhand der übergebenen Steuersätze, welche ja einer, oder mehrere sein könnten? (vatPercent vs. vatPercentages mit vatAmounts).
Für uns gibt es derzeit nur einen Steuersatz, aber da mehrere möglich sind in der API die Frage, ob das dann nicht anhand der bereits möglichen Steuersätze, die übergeben werden, auch gebucht wird. Die restlichen Daten bleiben ja gleich (Steuercode, Konto, Text).
A: Siehe Doku, es ist ein Array von accountingItems möglich
Q: bookingText ist dann ein Array, wo man Kontonummer, SteuerID und Buchungstext übergibt, womit der Autosuggester überschrieben wird?
A: BookingText ist nur der Buchungstext (Title). Siehe Doku für die anderen Felder. Wenn die Buchungszeile mit dem Dokument erzeugt wird, wird der AutoSuggester nicht aktiv