Fynn generiert PDFs für verschiedene Belegtypen. Jede Vorlage unterstützt Platzhalter, die beim Erstellen des Dokuments automatisch durch die tatsächlichen Werte ersetzt werden.
Dokumenttypen
Fynn unterstützt folgende Belegtypen mit eigenen PDF-Vorlagen:
| Dokumenttyp | Beschreibung | Verfügbare Platzhalter |
|---|
| Rechnung | Standardrechnung | Beleg, Organisation, Abonnement |
| Gutschrift | Gutschrift / Erstattung | Beleg, Organisation, Abonnement |
| Storno | Stornierung einer Rechnung | Beleg, Organisation, Abonnement |
| Mahnung | Mahnschreiben | Mahnung, Organisation |
| Kündigungsbestätigung | Bestätigung einer Abonnement-Kündigung | Abonnement, Organisation |
Rechnungen, Gutschriften und Stornos verwenden dieselben Platzhalter — sie basieren alle auf dem Belegmodell. Die Referenzfelder (z.B. referencedInvoiceNumber) sind nur bei Gutschriften und Stornos gefüllt.
Vorlagen bearbeiten
Vorlage auswählen
Klicke auf Bearbeiten bei der gewünschten Vorlage (Rechnung, Storno, Gutschrift oder Mahnung) und wähle die Sprache.
Platzhalter einfügen
Verwende die unten aufgeführten Platzhalter in den Feldern Titel, Einleitung, Abschlusstext und Informationsfelder. Platzhalter werden in doppelten geschweiften Klammern geschrieben: {{ platzhalter }}.
Platzhalter nach Kategorie
Verfügbar für: Rechnung, Gutschrift, Storno
| Platzhalter | Beschreibung | Beispielwert |
|---|
documentNumber | Belegnummer | RE-2026-0001 |
documentDate | Belegdatum | 15.02.2026 |
totalGrossAmount | Gesamtbetrag (brutto) | 119,00 € |
dueDate | Fälligkeitsdatum | 01.03.2026 |
dueDateInDays | Tage bis Fälligkeit | 14 |
servicePeriod | Leistungszeitraum | 01.02.2026 - 28.02.2026 |
customerNumber | Kundennummer | KD-10042 |
dunningLevel | Mahnstufe | 1 |
Referenz-Beleg
Verfügbar für: Gutschrift, Storno (Felder der ursprünglichen Rechnung)
| Platzhalter | Beschreibung | Beispielwert |
|---|
referencedInvoiceNumber | Nummer der Ursprungsrechnung | RE-2026-0001 |
referencedInvoiceDate | Datum der Ursprungsrechnung | 01.02.2026 |
referencedInvoiceDueDate | Fälligkeitsdatum der Ursprungsrechnung | 15.02.2026 |
referencedInvoiceTotalGrossAmount | Bruttobetrag der Ursprungsrechnung | 119,00 € |
Zahlungsmethode
Verfügbar für: Rechnung, Gutschrift, Storno
| Platzhalter | Beschreibung | Beispielwert |
|---|
paymentMethod.displayName | Anzeigename der Zahlungsmethode | SEPA-Lastschrift |
paymentMethod.type | Typ der Zahlungsmethode | sepa_debit |
paymentMethod.gatewayName | Name des Payment-Gateways | stripe |
paymentMethod.name | Interner Name | SEPA Hauptkonto |
SEPA-Lastschrift
Verfügbar für: Rechnung, Gutschrift, Storno (nur bei SEPA-Zahlungsmethode)
| Platzhalter | Beschreibung | Beispielwert |
|---|
isSepa | Ist SEPA-Lastschrift aktiv | true / false |
sepa.iban | IBAN des Kunden | DE89 3704 0044 0532 0130 00 |
sepa.bic | BIC des Kunden | COBADEFFXXX |
sepa.accountHolder | Kontoinhaber | Max Mustermann |
sepa.mandateReference | SEPA-Mandatsreferenz | MNDT-2026-00001 |
sepa.creditorId | Gläubiger-ID | DE98ZZZ09999999999 |
sepa.bankName | Bankname | Commerzbank |
sepa.amount | Einzugsbetrag | 119,00 € |
paymentMethod.sepa.mandateReferenceNumber | Mandatsreferenznummer | MNDT-2026-00001 |
paymentMethod.sepa.mandateReferenceSigningDate | Mandats-Unterschriftsdatum | 2025-01-15 |
paymentMethod.sepa.mandateReferenceSigningDateFormatted | Mandats-Unterschriftsdatum (formatiert) | 15.01.2025 |
paymentMethod.sepa.iban | IBAN (formatiert) | DE89 3704 0044 0532 0130 00 |
paymentMethod.sepa.bic | BIC | COBADEFFXXX |
paymentMethod.sepa.bankName | Bankname | Commerzbank |
paymentMethod.sepa.accountHolder | Kontoinhaber | Max Mustermann |
paymentMethod.sepa.isFirstSepaDebit | Ersteinzug | true / false |
paymentMethod.sepa.creditorIdentificationNumber | Gläubiger-ID | DE98ZZZ09999999999 |
Überweisung
Verfügbar für: Rechnung, Gutschrift, Storno (nur bei Überweisung)
| Platzhalter | Beschreibung | Beispielwert |
|---|
isBankTransfer | Ist Überweisung aktiv | true / false |
bankTransfer.iban | IBAN des Empfängers | DE89370400440532013000 |
bankTransfer.bic | BIC des Empfängers | COBADEFFXXX |
bankTransfer.accountHolder | Kontoinhaber | Fynn GmbH |
bankTransfer.bankName | Bankname | Commerzbank |
bankTransfer.amount | Überweisungsbetrag | 119,00 € |
bankTransfer.usageDescription | Verwendungszweck | RE-2026-0001 |
| Platzhalter | Beschreibung | Beispielwert |
|---|
customer.firstName | Vorname | Max |
customer.lastName | Nachname | Mustermann |
| Platzhalter | Beschreibung | Beispielwert |
|---|
tenant.name | Handelsname | Fynn |
tenant.legalCompanyName | Rechtlicher Firmenname | Fynn GmbH |
tenant.street | Straße | Barthelstr. |
tenant.housenumber | Hausnummer | 4 |
tenant.zip | Postleitzahl | 50823 |
tenant.city | Stadt | Köln |
tenant.countryCode | Ländercode | DE |
tenant.email | E-Mail-Adresse | [email protected] |
tenant.phone | Telefonnummer | 0221 29246377 |
tenant.vatId | USt-IdNr. | DE123456789 |
tenant.website | Website | https://fynn.eu |
tenant.ceo | Geschäftsführer | Giuliano Schindler |
tenant.bankAccount.iban | IBAN | DE89370400440532013000 |
tenant.bankAccount.bic | BIC | COBADEFFXXX |
tenant.bankAccount.bankName | Bankname | Commerzbank |
| Platzhalter | Beschreibung | Beispielwert |
|---|
customerNumber | Kundennummer | KD-10042 |
subscription.number | Abonnementnummer | SUB-2026-00001 |
subscription.poNumber | Bestellnummer (PO) | PO-12345 |
| Platzhalter | Beschreibung | Beispielwert |
|---|
documentNumber | Mahnnummer | MH-2026-0001 |
documentDate | Datum der Mahnung | 15.03.2026 |
referencedInvoiceNumber | Nummer der gemahnten Rechnung | RE-2026-0001 |
referencedInvoiceDate | Datum der gemahnten Rechnung | 01.02.2026 |
referencedInvoiceDueDate | Fälligkeitsdatum der gemahnten Rechnung | 15.02.2026 |
referencedInvoiceTotalGrossAmount | Bruttobetrag der gemahnten Rechnung | 119,00 € |
totalGrossAmount | Gesamtbetrag inkl. Mahngebühren | 129,00 € |
dueDate | Fälligkeitsdatum der Mahnung | 29.03.2026 |
customerNumber | Kundennummer | KD-10042 |
dueDateInDays | Tage bis Fälligkeit | 14 |
dunningLevel | Mahnstufe | 2 |
| Platzhalter | Beschreibung | Beispielwert |
|---|
offer.number | Angebotsnummer | AG-2026-0001 |
offer.name | Angebotsname | Enterprise Paket |
{{ documentNumber }}
{{ $documentNumber }}
{{documentNumber}}
{{$documentNumber}}
Alle Datumsangaben werden im Format dd.mm.yyyy (z.B. 15.02.2026) ausgegeben. Geldbeträge werden im deutschen Format mit Währungssymbol formatiert (z.B. 119,00 €).
Platzhalter per API abrufen
Du kannst die verfügbaren Platzhalter auch programmatisch abrufen:
GET /ui/document-placeholder?contexts=invoice,tenant,subscription
invoice, dunning, tenant, subscription
Custom PDF Rendering
Wenn du vollständige Kontrolle über das PDF-Layout benötigst, kannst du mit Custom PDF Rendering deine eigene PDF-Engine verwenden. Alle oben aufgeführten Platzhalter stehen auch im Webhook-Payload zur Verfügung. 
