E-Rechnungen versenden

Der Sende-Endpunkt erzeugt eine vollständig konforme XRechnung-Rechnung aus strukturierten JSON-Daten und stellt sie als E-Mail mit angehängter XML-Rechnung zu. Der Empfänger erhält eine professionelle E-Mail mit sowohl einem menschenlesbaren HTML-Inhalt als auch dem maschinenlesbaren XML-Anhang.

Endpunkt

POST /v1/invoices/send

Authentifizierung

Authorization: Bearer ps_live_...

Request-Body

{
  "from": "buchhaltung@ihredomain.com",
  "to": "rechnungen@kunde.de",
  "format": "xrechnung-ubl",
  "invoice": {
    "number": "2026-0089",
    "issue_date": "2026-03-18",
    "due_date": "2026-04-17",
    "currency": "EUR",
    "seller": {
      "name": "Ihre Firma GmbH",
      "street": "Hauptstr. 42",
      "city": "München",
      "postal_code": "80331",
      "country": "DE",
      "tax_id": "DE987654321",
      "contact_name": "Buchhaltung",
      "contact_email": "buchhaltung@ihredomain.com",
      "contact_phone": "+49 89 1234567"
    },
    "buyer": {
      "name": "Kunde AG",
      "street": "Berliner Str. 10",
      "city": "Berlin",
      "postal_code": "10115",
      "country": "DE",
      "leitweg_id": "991-12345-67"
    },
    "payment": {
      "means_code": "58",
      "iban": "DE89370400440532013000",
      "bic": "COBADEFFXXX",
      "terms": "Zahlbar innerhalb von 30 Tagen"
    },
    "line_items": [
      {
        "description": "Softwarelizenz Q1 2026",
        "quantity": 1,
        "unit": "C62",
        "unit_price": "2400.00",
        "tax_category": "S",
        "tax_rate": "19.00"
      },
      {
        "description": "Implementierungsunterstützung",
        "quantity": 8,
        "unit": "HUR",
        "unit_price": "150.00",
        "tax_category": "S",
        "tax_rate": "19.00"
      }
    ]
  }
}

Antwort

{
  "id": "inv_a1b2c3d4",
  "email_id": "em_x9y8z7w6",
  "status": "queued",
  "format": "xrechnung-ubl",
  "validation": {
    "valid": true,
    "errors": [],
    "warnings": []
  }
}

Die API validiert die Rechnungsdaten vor der XML-Erzeugung. Bei fehlgeschlagener Validierung gibt die Antwort einen 400-Fehler mit den Validierungsfehlern zurück — die E-Mail wird nicht gesendet.

Zustellungsverfolgung

Verfolgen Sie den Zustellstatus über die Standard-Postscale-E-Mail-Events:

• email.queued — Rechnungs-E-Mail zur Zustellung angenommen
• email.delivered — Rechnungs-E-Mail an den Mailserver des Empfängers zugestellt
• email.bounced — Zustellung fehlgeschlagen (prüfen Sie den Bounce-Grund)

Nutzen Sie Webhooks oder fragen Sie GET /v1/emails/{email_id} für Statusaktualisierungen ab.

Erzeugte E-Mail

Die versendete E-Mail enthält:

• Betreff: Rechnung {number} von {seller.name}
• HTML-Inhalt: professionelle Rechnungszusammenfassung mit Positionen und Summen
• XML-Anhang: vollständig konforme XRechnung/CII-Rechnung (z.B. rechnung-2026-0089.xml)
• DKIM-signiert: mit den konfigurierten DKIM-Schlüsseln Ihrer Domain

Einheitencodes

Gängige UN/ECE Recommendation 20 Einheitencodes:

Fehlerbehandlung