> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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

## Rechnung als Brief versenden

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

```bash theme={null}
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:

```json theme={null}
{
  "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](/guide/webhooks/introduction).