FAQ: Taxdoo-API

Das Wichtigste in Kürze:

In diesem Artikel findet Ihr Antworten auf die häufigsten Fragen zu unserer offenen Programmierschnittstelle, der Taxdoo API. Ihr habt eine Frage, zu der Ihr keine Antwort in diesem Artikel gefunden habt? Lasst uns gerne eine Nachricht über das Hilfezentrum zukommen.

Was kann ich mit der Taxdoo API übermitteln / abfragen?

Ihr könnt Daten zu Bestellungen, Gutschriften, innergemeinschaftlichen Verbringungen, Produkten und Warenlagern übermitteln und abrufen. Zudem sind Informationen zu Eurem Taxdoo-Account, Euren bei uns hinterlegten umsatzsteuerlichen Registrierungen und gewisse Berichte wie Transaktionslisten und DATEV-Exporte abrufbar. Die jeweils zu verwendenden Endpunkte sind in unserer Dokumentation ausführlich beschrieben.

Welche Daten muss ich mindestens übermitteln?

Der Umfang der zu übermittelten Daten ist für alle Endpunkte detailliert in unserer Dokumentation aufgelistet.

Beispiel: Add Transactions-Endpunkt

Eine detaillierte Beschreibung der zu übertragenden Inhalte (Payload) findet Ihr, wenn Ihr auf den unter Type aufgeführten Link klickt (hier Transaction[]).

Alle fett gedruckten Felder sind verpflichtend anzugeben, während nicht fett gedruckte Felder optional sind. Bitte beachtet zusätzlich die allgemeine Beschreibung, die in diesem Fall darauf hinweist, inwiefern die Felder paymentDate und sentDate angegeben werden müssen, obwohl diese nicht fett gedruckt sind.

Worauf muss ich besonders achten?

Bitte lest Euch die Beschreibungen der jeweiligen Endpunkte (z.B. Transactions) sorgfältig durch, da es einige Besonderheiten zu beachten gilt. Hierzu zählen:

• übertragt für alle monetären Felder (z.B. itemPrice) immer Bruttowerte
• für B2B-Transaktionen muss im Feld buyerVatNumber die Umsatzsteuer-ID des Käufers angegeben werden
• stellt sicher, dass für Transaktionen, die über einen Marktplatz abgewickelt wurden, der korrekte identifier angegeben wird (die Werte findet Ihr hier)
• gebt für Gutschriften negative Werte an (z.B. itemPrice und shipping sind negativ, discount wäre in diesem Fall positiv)
• es erfolgt keine Multiplikation der quantity mit monetären Feldern wie itemPrice oder shipping, daher müsst Ihr in diesen Feldern bereits den Gesamtwert der Position angeben

Was ist der Unterschied zwischen Transactions, Orders und Refunds?

Ihr könnt Verkäufe und Gutschriften komplett über den Transactions-Endpunkt übermitteln, wobei eine Zeile immer einer Position der Bestellung / Gutschrift entspricht. Für Bestellungen mit mehreren Positionen empfehlen wir die Nutzung des Orders-Endpunktes, da Daten wie z.B. der identifier oder die transactionNumber nur einmalig angegeben werden müssen und für alle Bestellpositionen übernommen werden.

Der Refunds-Endpunkt ist das Gegenstück zum Orders-Endpunkt und kann von Euch genutzt werden, wenn Gutschriften mit mehreren Positionen übertragen werden sollen.