Docs

1 Einstieg1.3

1.3

Wie eine Rechnung läuft

Eine Rechnung, vom ERP-Export bis zu den Statusereignissen.

  • In der Sandbox
  • Noch nicht in der Sandbox

In einfachen Worten

Diese Seite verfolgt eine Rechnung vom ERP des Kunden bis zur Liste der fehlgeschlagenen Rechnungen. Was für das Unternehmen zählt: Ist eine Rechnung fehlerhaft, nennt die Antwort das Feld im Export des Kunden und sagt, wer den Fehler behebt, bevor irgendetwas gesendet wird. In der gehosteten Sandbox hat der letzte Schritt noch keine Verbindung zu einem Land.

Eine Rechnung, vom Export des ERP bis zur Betreuungsliste. Der gelbe Zettel ist die Antwort, die das Feld im Export des Kunden nennt. Der gestrichelte Kasten ist das Netz. Die gehostete Sandbox hat noch keines eingerichtet.

Wie eine Rechnung läuftAcht Schritte vom ERP-Export bis zur Betreuungsliste. Nach den Regeln des Übermittlungswegs ist die Antwort 202 mit einer ID oder 422 mit einem Katalogcode. Der Schritt „Netz“ sendet die Rechnung dorthin, wo ein Übermittlungsweg Zugangsdaten hat; die gehostete Sandbox hat noch keine.1ERP-ExportBusiness Central,JSON oder XML2EingangAPI-Aufruf oder Dateiablage3SchemaprüfungKanonisches Modell4Regeln des WegsKoSIT, Schematron,FA(3)-Schema202 + ID5WarteschlangeSchnelle Spur: KSeF, Peppol,Frankreich, DeutschlandLangsame Spur: ANAFErgebnis des Adapters6NetzSendet, wo ein Netz angebunden ist7StatusereignisseEines je Schritt, geordnetendgültige Ablehnung8BetreuungslisteEndgültige Ablehnungen422Katalogcodenennt das Feldzurück zum Partner
  1. Die Rechnung verlässt das ERP des Kunden als ERP-Export (Business Central oder SAP Business One), kanonisches JSON oder fertige XML-Datei.
  2. Sie kommt über POST /invoices, POST /invoices/xml oder als Datei im Ablageordner an.
  3. Das kanonische Modell prüft die Struktur. Ein Fehler nennt das Feld.
  4. Die eigenen Validatoren des Übermittlungswegs laufen: KoSIT für Deutschland, Schematron für Peppol, Frankreich und Rumänien, das FA(3)-Schema für Polen. Die Antwort ist 202 mit einer ID oder 422 mit einem Katalogcode, der das Feld nennt, sagt, wer handelt, und einen Hinweis zur Behebung gibt.
  5. Eine Rechnung, die alle Prüfungen besteht, wartet in einer Warteschlange. KSeF, Peppol, Frankreich und Deutschland teilen sich die schnelle Spur. ANAF hat eine eigene langsame Spur.
  6. Ein Übermittlungsweg mit Zugangsdaten für ein Netz sendet die Rechnung. Deutschland hat kein Netz: Seine Rechnung endet bei ready, und der Partner stellt die Datei zu. Ein Übermittlungsweg ohne Zugangsdaten, wie heute in der gehosteten Sandbox, sendet nichts.
  7. Jedes Ergebnis wird zu einem Statusereignis und der Reihe nach gespeichert. Siehe Status.
  8. Eine endgültige Ablehnung landet auf der Betreuungsliste. Vorübergehende Fehler lösen Wiederholungsversuche aus und landen erst dort, wenn alle Versuche aufgebraucht sind.

Hinweis

Eine fertige XML-Datei nimmt eine Abkürzung. Sie erhält eine Sicherheitsprüfung und die Validatoren des Übermittlungswegs (Schritt 4), aber keine kanonische Prüfung und kein Mapping, und reiht sich bei Schritt 5 in die Warteschlange ein.

POST /validate führt nur die Schritte 3 und 4 aus. Der Aufruf speichert nichts, sendet nichts und antwortet immer mit 200 und einem Bericht. Siehe Probelauf.