Postversand (Briefe)

Versende Rechnungen als physischen Brief, mit automatischem Fallback von E-Mail auf Brief und voller Nachverfolgung des Zustellstatus.

​

Übersicht

Mit dem Postversand versendest du Rechnungen, Stornos und Gutschriften als physischen Brief. Fynn übergibt das fertige Dokument an einen Druckdienstleister, der es druckt, kuvertiert und verschickt. Den Versand- und Zustellstatus siehst du direkt an der Rechnung und in einer eigenen Übersicht.

Der Brief nutzt dieselbe PDF wie der E-Mail-Versand. Die Empfängeradresse wird aus dem Adressfenster des Dokuments gelesen, du musst also keine Adresse separat pflegen. Sobald der Postversand für deine Organisation aktiv ist, blendet Fynn die Absenderzeile im Adressfenster automatisch aus, damit die Empfängeradresse sauber erkannt wird.

Der Postversand wird für deine Organisation freigeschaltet. Wende dich an uns, wenn du ihn nutzen möchtest.

​

Rechnung als Brief versenden

Eine finalisierte Rechnung versendest du über die API auf dem Kanal letter:

curl -X POST https://coreapi.io/api/invoices/{id}/send \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "letter",
    "options": {
      "isColor": true,
      "isDuplex": false,
      "isInternational": false
    }
  }'

Mit channel: "email" versendest du dieselbe Rechnung stattdessen per E-Mail.

​

Druckoptionen

Die Optionen werden an den Druckdienstleister durchgereicht:

Option	Bedeutung	Standard
isColor	Farbdruck statt Graustufen	true
isDuplex	Beidseitiger Druck	false
isInternational	Internationaler Versand	false

Die Antwort enthält den Kanal, den aktuellen Status und, sofern verfügbar, die Sendungsnummer:

{
  "channel": "letter",
  "status": "submitted",
  "letterId": "…",
  "trackingNumber": "…"
}

​

Automatischer Fallback von E-Mail auf Brief

Ist ein Kunde per E-Mail nicht erreichbar, kann Fynn die Rechnung automatisch als Brief versenden. Der Fallback greift, wenn die letzte Rechnungs-E-Mail an den Kunden als unzustellbar zurückgekommen ist (Bounce) oder keine nutzbare E-Mail-Adresse hinterlegt ist, und wenn die Rechnung eine gültige Postadresse trägt.

Der automatische Fallback ist konfigurierbar und wird zusätzlich zum Postversand freigeschaltet. So behältst du die Kontrolle darüber, ob nicht zustellbare E-Mails auf Papier ausweichen sollen.

​

Zustellstatus nachverfolgen

Jeder Brief durchläuft die folgenden Status:

Status	Bedeutung
submitted	Vom Druckdienstleister angenommen und eingeplant
dispatched	Gedruckt und der Post übergeben
delivered	Zustellung bestätigt (nur bei nachverfolgbaren Produkten)
undeliverable	Nicht zustellbar (falsche oder unbekannte Adresse)
failed	Vom Druckdienstleister abgelehnt
cancelled	Vor dem Versand storniert

In der Rechnungsdetailansicht siehst du zu jeder Rechnung den aktuellen Briefstatus, die Sendungsnummer und das Versand- sowie Zustelldatum.

Unter Einstellungen → Versendete Briefe findest du alle versendeten Briefe deiner Organisation, filterbar nach Status, Datum und Kunde.

​

Fehlgeschlagene Zustellung

Kommt ein Brief nicht an (undeliverable oder failed), legt Fynn automatisch eine Aufgabe an, die dir den betroffenen Kunden und die Rechnung anzeigt. So siehst du direkt, wo Handlungsbedarf besteht, und kannst die Adresse prüfen und den Versand erneut anstoßen.

​

Webhooks

Für die Anbindung eigener Systeme stehen zwei Ereignisse bereit:

• invoice.letter.dispatched wird ausgelöst, sobald der Brief an den Druckdienstleister übergeben wurde.
• invoice.letter.delivered wird ausgelöst, sobald die Zustellung bestätigt ist.

Beide Ereignisse enthalten die Rechnung sowie die Briefdaten mit Status und Sendungsnummer. Mehr zur Einrichtung von Webhooks findest du in der Webhooks-Übersicht.