Ü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
}
}'
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 |
{
"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 |
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.
