Rechnungszustellung prüfen

Übersicht

Nach dem Versand einer Rechnung können Sie den Zustellungsstatus überprüfen, um sicherzustellen, dass die Rechnung beim Empfänger angekommen ist. Faktoora verfolgt Zustellversuche für E-Mail-, Peppol- und manuelle Zustellungen nach.

Zustellstatus in der Web-Oberfläche prüfen

1. Öffnen Sie die Rechnungsdetails in Ihrer faktoora-Instanz
2. Scrollen Sie zum Bereich "Zustellungen" (Delivery)
3. Sie sehen eine Liste aller Zustellversuche mit folgenden Informationen:
   • Typ: Art der Zustellung (E-Mail, Peppol, manuell)
   • Empfänger: E-Mail-Adresse oder Peppol-Kennung
   • Status: Aktueller Zustellstatus
   • Aktualisiert am: Zeitstempel der letzten Statusänderung

Zustellstatus per API abrufen

Verwenden Sie den API-Endpunkt GET /invoices/{faktooraId}/status um den Zustellungsstatus abzurufen:

GET https://api.faktoora.com/api/v1/invoices/{faktooraId}/status

Die Antwort enthält das Feld delivery, das ein Array mit allen Zustellversuchen enthält:

{
  "delivery": [
    {
      "type": "email",
      "recipient": "rechnung@beispielkunde.de",
      "carbonCopy": "cc1@example.com",
      "blindCarbonCopy": "bcc@example.com"
    }
  ]
}

Zustellstatus-Werte

E-Mail-Zustellung

E-Mail-Zustellungen speichern die Empfängeradressen, ohne einen laufenden Zustellstatus zu verfolgen. Sie können die Zustellung anhand der Abwesenheit von Fehlerberichten oder Bounce-Benachrichtigungen beurteilen.

Peppol-Zustellung

Peppol-Zustellungen haben laufende Zustellstatus:

• PENDING_GENERATION: Das Rechnungs-XML wird noch generiert; die Peppol-Zustellung wurde noch nicht angefordert.
• ACTIVE: Übertragung ist laufend.
• READY: Wartet auf den nächsten Wiederholungsversuch (tritt nach einem Fehler bei der Wiederholung auf).
• DELIVERED: Zustellung bestätigt durch den Empfangspunkt.
• REJECTED: Vom Empfangspunkt abgelehnt.
• FAILED: Dauerhaft fehlgeschlagen (z. B. aufgrund eines Validierungsfehlers).
• SUSPENDED: Aufgegeben nach Ausschöpfung der Wiederholungsversuche oder angehalten — kann über POST /invoices/{faktooraId}/dispatch/peppol/resend neu gestartet werden.

Fehlerberichte

Bei fehlgeschlagenen Peppol-Zustellungen (Status FAILED, REJECTED, SUSPENDED) enthält die Antwort möglicherweise ein Feld messages mit Fehler- oder Warnmeldungen:

{
  "type": "peppol",
  "recipient": "9930:DE123456789",
  "state": "REJECTED",
  "attempts": 3,
  "messages": [
    {
      "level": "ERROR",
      "code": "BR-S-02",
      "text": "Ein Fehler bei der Geschäftsregel-Validierung"
    }
  ]
}

Häufige Probleme

Keine Zustellbestätigung

E-Mail-Zustellungen speichern standardmäßig keine Zustellbestätigungen von Mail-Servern. Wenn Sie prüfen möchten, ob eine E-Mail-Zustellung erfolgreich war:

1. Prüfen Sie die Zustellungshistorie in der Web-Oberfläche
2. Überprüfen Sie Ihre Mailserver-Protokolle (falls Sie einen eigenen SMTP-Server verwenden)
3. Bitten Sie den Empfänger zu bestätigen, dass die Rechnung eingegangen ist
4. Prüfen Sie auf Bounce-Benachrichtigungen von Ihrem Mail-Service

Peppol-Zustellung fehlgeschlagen

Wenn eine Peppol-Zustellung fehlschlägt:

1. Überprüfen Sie die Fehlermeldungen im messages-Feld
2. Korrigieren Sie das Problem (z. B. ungültige Daten, fehlende Informationen)
3. Verwenden Sie POST /invoices/{faktooraId}/dispatch/peppol/resend um den Versand zu wiederholen
4. Kontaktieren Sie den faktoora-Support, falls das Problem bestehen bleibt

Keine Zustellversuche sichtbar

Wenn das delivery-Array leer ist:

1. Die Rechnung wurde möglicherweise noch nicht versendet
2. Prüfen Sie, ob die Rechnung noch im Entwurfsstatus ist (draftOnly: true)
3. Vergewissern Sie sich, dass Sie den Versand korrekt angefordert haben

Zustellverlauf überwachen

Für automatisierte Überwachung oder Integration mit Ihrem System können Sie regelmäßig den Zustellstatus abfragen:

1. Speichern Sie die faktooraId nach der Rechnungserstellung
2. Fragen Sie GET /invoices/{faktooraId}/status ab
3. Prüfen Sie auf Statusänderungen im delivery-Array
4. Implementieren Sie Fehlerbehandlung für REJECTED, FAILED oder SUSPENDED Status