Eingangsverarbeitung von Rechnungen

Wenn eine E-Mail bei Ihrer von Postscale verwalteten Domain eingeht, scannt der Eingangsprocessor automatisch nach eingebetteten E-Rechnungen. Wird eine strukturierte Rechnung erkannt — als XML-Anhang oder eingebettetes ZUGFeRD-PDF — werden die Rechnungsdaten extrahiert und zusammen mit dem Standard-Inbound-E-Mail-Payload an Ihren Webhook geliefert.

So funktioniert es

1. E-Mail trifft ein bei Ihrer Domain über die Postscale-Inbound-Pipeline
2. Anhang-Scan prüft auf XML-Dateien, die UBL/CII-Schemas entsprechen, und PDFs mit eingebetteten ZUGFeRD-Daten
3. Validierung prüft die erkannte Rechnung gegen EN 16931 / XRechnung-Regeln
4. Webhook-Zustellung enthält den Original-E-Mail-Payload plus ein invoice-Objekt mit strukturierten Daten

Rechnungserkennung aktivieren

Die Rechnungserkennung wird pro Domain in Ihrem Dashboard aktiviert:

1. Gehen Sie zu Dashboard > Domains > [Ihre Domain]
2. Unter Eingangseinstellungen schalten Sie E-Rechnungserkennung ein
3. Konfigurieren Sie Ihre Webhook-URL, falls noch nicht geschehen

Es sind keine API-Änderungen erforderlich — die Rechnungsdaten werden an Ihren bestehenden Inbound-Webhook-Payload angehängt.

Webhook-Payload

Wenn eine E-Rechnung erkannt wird, erhält Ihr Inbound-Webhook ein zusätzliches invoice-Feld:

{
  "event": "inbound.received",
  "email": {
    "from": "lieferant@example.de",
    "to": ["buchhaltung@ihredomain.com"],
    "subject": "Rechnung #2026-0042",
    "attachments": [
      {
        "filename": "rechnung-2026-0042.xml",
        "content_type": "application/xml",
        "size": 8432
      }
    ]
  },
  "invoice": {
    "detected": true,
    "format": "xrechnung-ubl",
    "valid": true,
    "data": {
      "invoice_number": "2026-0042",
      "issue_date": "2026-03-15",
      "due_date": "2026-04-14",
      "currency": "EUR",
      "total_net": "1250.00",
      "total_tax": "237.50",
      "total_gross": "1487.50",
      "seller": {
        "name": "Lieferant GmbH",
        "tax_id": "DE123456789",
        "address": "Musterstr. 1, 10115 Berlin, DE"
      },
      "buyer": {
        "name": "Ihre Firma GmbH",
        "leitweg_id": "991-12345-67"
      },
      "line_items": [
        {
          "description": "Beratungsleistungen Q1 2026",
          "quantity": 50,
          "unit": "HUR",
          "unit_price": "25.00",
          "net_amount": "1250.00",
          "tax_rate": "19.00"
        }
      ]
    },
    "validation": {
      "errors": [],
      "warnings": []
    }
  }
}

Unterstützte Formate

E-Mails ohne Rechnung

Wenn keine E-Rechnung erkannt wird, wird der Webhook-Payload wie gewohnt ohne das invoice-Feld zugestellt. Ihre bestehende Eingangsverarbeitungslogik bleibt unberührt.