Erzeugt eine Rechnung aus Empfänger und Positionen

Erzeugt eine Rechnung aus Empfänger und Positionen. Absenderangaben, Nummer und Zahlungsziel kommen aus dem Betrieb – der Aufruf liefert sie nicht mit. Pflicht ist lines; buyer, buyerReference, note, paymentTerms und issueDate (Vorgabe heute) sind optional. Idempotent über Idempotency-Key. Eine Anlage dauert rund sechs Sekunden (Prüfung, PDF, ZUGFeRD); der Prüfdienst nimmt drei gleichzeitig, weitere warten bis 20 s und bekommen sonst 503 mit Retry-After – dann später wiederholen, mit demselben Key.

post/api/v1/rechnungen

Request

  • Base URL: https://rechnungslotse.de
  • URL: https://rechnungslotse.de/api/v1/rechnungen
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://rechnungslotse.de/authorize, token URL https://rechnungslotse.de/api/oauth/token, scopes: schreiben)

Headers

Idempotency-Keystring

Eindeutig je Vorgang, z. B. die Bestellnummer des Shops. Ein zweiter Aufruf mit demselben Key gibt 30 Tage lang die ERSTE Antwort zurück (Kopfzeile Idempotent-Replay: true). Ohne Key entstehen bei Wiederholung zwei Belege.

Request body

buyerobject

Empfänger; Felder wie GET /api/v1/kunden sie liefert.

buyerReferencestring

Leitweg-ID bei öffentlichen Auftraggebern (BT-10).

notestring
paymentTermsstring
issueDatestring date

Vorgabe: heute (Europe/Berlin).

Response

201 mit Nummer, Beträgen und den Abhol-Adressen der drei Dateien.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.