Monatsabschluss aus Belegen statt aus KontoauszügenAlle Beiträge

Monatsabschluss aus Belegen statt aus Kontoauszügen

Ein Kontoauszug zeigt, was geflossen ist, aber nicht wofür. Dieser Fall zeigt, wie die Buchhaltung den Monat aus den Belegen zusammensetzt, aus denen die Zahlungen entstanden sind.

Veröffentlicht: 2026-09-12Lesezeit: 4 mintapinomahub API & Prozesse
API & ProzesseAutomotive AftermarketAPITeilehandelFahrzeughandelLogistik & Lager

Am Monatsende liegt eine Auszahlung des Marktplatzes auf dem Konto. Darin verrechnet: Verkäufe, Versand, Erstattungen und Gebühren. Die Steuerberatung braucht jede dieser Grössen einzeln und mit Beleg — und niemand will sie aus einer Sammelzahlung zurückrechnen.

Monatsabschluss aus Belegen statt aus KontoauszügenEingang: das Monatsende und eine Buchhaltung, die Belege will 1. Rechnungen auflisten (GET /commerce/v1/invoices): documentReference, state, issuedAt und dueAt je Beleg 2. Rechnung lesen (GET /commerce/v1/invoices/{invoiceId}): netAmount, taxAmount und grossAmount je Zeile und in totals 3. Korrekturbeleg lesen (GET /commerce/v1/credit-notes/{creditNoteId}): Bezug auf invoiceId und salesOrderId, dazu reasonCode 4. Gebührenbeleg lesen (GET /commerce/v1/fee-statements/{feeStatementId}): Zeilen mit basis, feeBasisPoints und feeAmount, Korrekturen mit Verweis 5. Erstattungen abgleichen (GET /commerce/v1/refunds): Erstattungen mit state je Auftrag und Rücksendung Ausgang: ein Monat, dessen Umsatz, Korrekturen und Gebühren aus Belegen besteht Vorschau ohne Gebühreneinzug. Die Belege unterstützen die Buchführung; sie ersetzen sie nicht.Monatsabschluss aus Belegen statt aus KontoauszügenEingang: das Monatsende und eine Buchhaltung, die Belege will01Rechnungen auflistenGET /commerce/v1/invoicesdocumentReference, state, issuedAt und dueAt je Beleg02Rechnung lesenGET /commerce/v1/invoices/{invoiceId}netAmount, taxAmount und grossAmount je Zeile und in totals03Korrekturbeleg lesenGET /commerce/v1/credit-notes/{creditNoteId}Bezug auf invoiceId und salesOrderId, dazu reasonCode04Gebührenbeleg lesenGET /commerce/v1/fee-statements/{feeStatementId}Zeilen mit basis, feeBasisPoints und feeAmount, Korrekturen mit Verweis05Erstattungen abgleichenGET /commerce/v1/refundsErstattungen mit state je Auftrag und RücksendungAusgang: ein Monat, dessen Umsatz, Korrekturen und Gebühren aus Belegen bestehtVorschau ohne Gebühreneinzug. Die Belege unterstützen die Buchführung; sie ersetzen sie nicht.
Fünf Aufrufe, die den Monat aus Belegen zusammensetzen. Jeder Betrag hat seinen eigenen Nachweis.

Die Belege des Commerce-Vertrags trennen genau diese Grössen: Rechnungen mit Netto-, Steuer- und Bruttobetrag je Zeile, Korrekturbelege mit Bezug zur Rechnung, Gebührenbelege mit nachrechenbaren Zeilen und Erstattungen je Auftrag. Der Abschluss entsteht aus ihnen, nicht aus der Auszahlung.

FlächeRollen
CommerceTeilehandel, Fahrzeughandel, Softwarehaus

Was dieser Fall voraussetzt

  • Ein angebundenes Verkaufskonto. Belege entstehen aus Aufträgen; ohne Auftrag kein Beleg.
  • Eine Zuordnung zu Ihren Buchungskonten. Die Belege liefern Beträge und Bezüge, nicht Ihren Kontenrahmen.
  • Seitenweises Abholen. Listen kommen mit nextCursor; ein Monatsabschluss liest sie vollständig.
  • Eine Regel für offene Posten. outstandingAmount zeigt, was noch nicht bezahlt ist.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Die Aufrufkette dieses Anwendungsfalls
StufeAufrufWas danach vorliegt
Rechnungen auflistenGET /commerce/v1/invoicesdocumentReference, state, issuedAt und dueAt je Beleg
Rechnung lesenGET /commerce/v1/invoices/{invoiceId}netAmount, taxAmount und grossAmount je Zeile und in totals
Korrekturbeleg lesenGET /commerce/v1/credit-notes/{creditNoteId}Bezug auf invoiceId und salesOrderId, dazu reasonCode
Gebührenbeleg lesenGET /commerce/v1/fee-statements/{feeStatementId}Zeilen mit basis, feeBasisPoints und feeAmount, Korrekturen mit Verweis
Erstattungen abgleichenGET /commerce/v1/refundsErstattungen mit state je Auftrag und Rücksendung

Warum jede Stufe nötig ist

  1. Die Rechnungen auflisten. GET /commerce/v1/invoices liefert seitenweise invoiceId, salesOrderId, documentReference, state, issuedAt und dueAt. Der Cursor ist hier Vollständigkeitsnachweis: Ein Abschluss, der eine Seite auslässt, stimmt nicht.
  2. Die Rechnung lesen. GET /commerce/v1/invoices/{invoiceId} nennt je Zeile netAmount, taxAmount und grossAmount und in totals zusätzlich paidAmount und outstandingAmount. Netto, Steuer und brutto kommen getrennt — die Buchhaltung muss nichts zurückrechnen.
  3. Den Korrekturbeleg lesen. GET /commerce/v1/credit-notes/{creditNoteId} verweist auf invoiceId und salesOrderId und trägt reasonCode. Eine Korrektur ist damit immer einer Rechnung zugeordnet und nicht nur ein negativer Betrag im Monat.
  4. Den Gebührenbeleg lesen. GET /commerce/v1/fee-statements/{feeStatementId} liefert Zeilen mit basis, feeBasisPoints und feeAmount, Korrekturen mit adjustmentOfLineId. Welcher Satz in feeBasisPoints gilt, wird außerhalb des Vertrags festgelegt; aus basis und feeBasisPoints sind die Zeilen nachrechenbar.
  5. Die Erstattungen abgleichen. GET /commerce/v1/refunds listet Erstattungen mit amount, state, salesOrderId, returnId und reasonCode. Jede Erstattung sollte einem Korrekturbeleg gegenüberstehen; wo das nicht so ist, ist es ein Befund für den Abschluss.
Die Rechnungsbelege seitenweise abholen
curl -H 'X-Api-Key: <API_KEY>' \
  'https://commerce-preview.invalid/commerce/v1/invoices?limit=100'

Was am Ende vorliegt

Am Ende besteht der Monat aus Belegen: Umsatz aus Rechnungen, Korrekturen aus Korrekturbelegen, Gebühren aus Gebührenbelegen und Erstattungen samt ihrem Stand aus der Erstattungsliste — jede Grösse einzeln und mit Bezug zum Auftrag.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-commerce). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.

Quellen und Rechtsgrundlagen

Häufige Fragen

Warum nicht einfach die Auszahlung buchen?

Weil darin Umsatz, Erstattungen und Gebühren verrechnet sind. Steuerlich und kaufmännisch sind das verschiedene Vorgänge, die getrennt nachgewiesen werden müssen.

Wie hängt ein Korrekturbeleg an seiner Rechnung?

Über invoiceId. Dazu trägt er salesOrderId und einen reasonCode.

Wer erhebt die Gebühren aus den Gebührenbelegen?

Das legt der Commerce-Vertrag nicht fest; auch der konkrete Satz wird außerhalb des Vertrags bestimmt. In der Vorschau werden keine Gebühren eingezogen.

Passend dazu

API & ProzesseAnwendungsfälle der tapinomahub-APIsEndpunkte einzeln zu lesen erklärt, was ein Aufruf tut. Diese Übersicht erklärt, welche Aufrufe zusammen eine Aufgabe erledigen — und auf welcher der vier Flächen Ihre Aufgabe liegt.API & ProzessePreise setzen, Gebühren nachrechnen, Abweichungen feststellenWer Kanalgebühren nicht nachrechnet, kennt seine Marge nicht. Dieser Fall zeigt die vier Fragen, die ein Verkaufskonto beantworten muss.API & ProzesseStorno, Rücksendung und Erstattung als ein VorgangEine Erstattung ohne erfassten Vorgang ist ein Verlust ohne Beleg. Dieser Fall zeigt die Kette von der Stornierung über Rücksendung und Erstattung bis zum Korrekturbeleg.IntegrationenERP und Warenwirtschaft: Artikel anlegen, Passung prüfen, je Endkunde abrechnenDer Artikelstamm ist die Stelle, an der Teiledaten entweder belegt oder abgetippt sind. Diese Seite zeigt Anbietern von ERP- und Warenwirtschaftssystemen, welcher Aufruf das Abtippen ersetzt und wie sie viele Endkunden mit einer Anbindung bedienen.