Erste Schritte mit Postscale Invoices

Mit Postscale Invoices können Sie strukturierte E-Rechnungen (XRechnung, ZUGFeRD) über eine einfache API validieren, versenden und empfangen. Ob Sie die Konformität vor der Einreichung prüfen oder Rechnungen direkt per E-Mail zustellen möchten — dieser Leitfaden deckt alles ab, um loszulegen.

Voraussetzungen

Ein Postscale-Konto mit einem aktiven Tarif
Ein API-Schlüssel (erstellen Sie einen unter Dashboard > API-Schlüssel)
Eine verifizierte Domain (erforderlich für den Rechnungsversand)

Schnellübersicht

Funktion	Endpunkt	Beschreibung
Validieren	`POST /v1/invoices/validate`	Prüft eine XML-Rechnung gegen EN 16931 / XRechnung-Regeln
Senden	`POST /v1/invoices/send`	Erzeugt und versendet eine konforme E-Rechnung per E-Mail
Empfangen	Inbound-Webhook	Erkennt und extrahiert E-Rechnungen aus eingehenden E-Mails automatisch

Ihr erster Validierungsaufruf

Der schnellste Weg, die API auszuprobieren, ist die Validierung einer vorhandenen Rechnungs-XML:

curl -X POST https://api.postscale.io/v1/invoices/validate \
  -H "Authorization: Bearer ps_live_..." \
  -H "Content-Type: application/xml" \
  -d @invoice.xml

Eine erfolgreiche Antwort sieht so aus:

{
  "valid": true,
  "format": "xrechnung-ubl",
  "standard": "EN 16931",
  "errors": [],
  "warnings": []
}

Bei Problemen enthält das errors-Array detaillierte Beschreibungen mit Feldpfaden und Regel-IDs, sodass Sie diese programmatisch beheben können.

Nächste Schritte

Validierungs-API-Referenz — vollständige Anfrage-/Antwortdetails, Fehlercodes und Beispiele
E-Rechnungen versenden — XRechnung-Rechnungen über die API erzeugen und zustellen
Eingangsverarbeitung — E-Rechnungen in eingehenden E-Mails automatisch erkennen
XRechnung-Referenz — Formate, Feldzuordnung und Konformitätshinweise