HandlebarsPDF
Kündigungsbestätigung mit bedingten Absätzen
Ein schlichter Geschäftsbrief, dessen Absätze von den Daten abhängen: Mit Erstattung nennt er Betrag und Termin, ohne sagt er, dass nichts mehr offen ist, und der Absatz zum Datenexport erscheint nur, wenn es eine Frist gibt. Datumsangaben sind auf Deutsch ausgeschrieben.
Kostenloser Plan, keine Kreditkarte. Sie erhalten eine eigene Kopie im Editor, veröffentlicht und bereit für die API.
Gerendertes Ergebnis
Was dieses Beispiel zeigt
{{#if contract.refund}} … {{else}} … {{/if}}wählt zwischen dem Absatz zur Erstattung und dem Satz, dass nichts mehr offen ist; dieselbe Vorlage dient beiden Fällen.- Der Absatz zum Datenexport steht in einem eigenen
{{#if contract.export_until}}und entfällt, wenn der Vertrag keine solche Frist hat. {{date contract.ends "d. MMMM yyyy"}}schreibt31. Dezember 2026; die Tabelle oben nutzt die kurze Formdd.MM.yyyy.- Brieflayout, Adressfenster und Pflichtangaben in der Fußzeile sind die der anderen deutschen Briefe: dieselben Regeln am Anfang der
style.cssund dieselbe Fußzeile, im eigenen Ordner dieser Vorlage.
Verwendete Helfer
Vorlagenordner
<p class="sender">{{company.name}} · {{company.street}} · {{company.city}}</p>
<address class="recipient">
<strong>{{customer.name}}</strong><br>
{{customer.contact}}<br>
{{customer.street}}<br>
{{customer.city}}
</address>
<table class="facts">
<tr><td>Datum</td><td>{{date letter.date "dd.MM.yyyy"}}</td></tr>
<tr><td>Kundennummer</td><td>{{customer.number}}</td></tr>
<tr><td>Vertrag</td><td>{{contract.number}}</td></tr>
</table>
<h1>Bestätigung Ihrer Kündigung</h1>
<p>Guten Tag {{customer.contact}},</p>
<p>
Ihre Kündigung des Vertrags <strong>{{contract.name}}</strong> ({{contract.number}}) ist am
{{date contract.received "d. MMMM yyyy"}} bei uns eingegangen. Wir bestätigen Ihnen hiermit, dass der Vertrag zum
<strong>{{date contract.ends "d. MMMM yyyy"}}</strong> endet.
</p>
<p>Bis zu diesem Tag können Sie alle Leistungen wie gewohnt nutzen.
{{#if contract.refund}}
Den bereits gezahlten Betrag für die Zeit nach Vertragsende, {{money contract.refund}}, erstatten wir Ihnen bis zum {{date contract.refund_by "dd.MM.yyyy"}} auf das bekannte Konto.
{{else}}
Es sind keine Beträge mehr offen, und es werden keine weiteren Abbuchungen vorgenommen.
{{/if}}
</p>
{{#if contract.export_until}}
<p>Ihre Daten können Sie bis zum {{date contract.export_until "dd.MM.yyyy"}} exportieren. Danach löschen wir sie endgültig.</p>
{{/if}}
<p>Wir bedauern Ihre Entscheidung und danken Ihnen für die Zusammenarbeit.</p>
<p>Mit freundlichen Grüßen<br>{{company.director}}</p>body { font-family: 'Inter', sans-serif; font-size: 9.5pt; line-height: 1.45; color: #1e293b; }
.sender {
display: inline-block;
margin: 10mm 0 3mm;
padding-bottom: 1mm;
border-bottom: 1px solid #cbd5e1;
font-size: 7pt;
color: #64748b;
}
.recipient { min-height: 27mm; font-style: normal; line-height: 1.5; }
.facts { float: right; margin-top: -27mm; font-size: 8.5pt; color: #475569; }
.facts td { padding: 0.4mm 0 0.4mm 5mm; }
.facts td:last-child { text-align: right; color: #1e293b; }
h1 { clear: both; margin: 14mm 0 4mm; font-size: 16pt; color: #312e81; }
table.lines { width: 100%; margin-top: 6mm; border-collapse: collapse; }
.lines th {
padding: 2mm 1.5mm;
border-bottom: 1.5px solid #1e293b;
text-align: left;
font-size: 7.5pt;
letter-spacing: 0.05em;
text-transform: uppercase;
color: #64748b;
}
.lines td { padding: 2.3mm 1.5mm; border-bottom: 1px solid #e2e8f0; vertical-align: top; }
.lines tr { break-inside: avoid; }
.num { text-align: right !important; white-space: nowrap; }
.totals { width: 78mm; margin: 5mm 0 0 auto; border-collapse: collapse; }
.totals td { padding: 1.2mm 1.5mm; }
.totals .grand td { border-top: 1.5px solid #1e293b; font-weight: 700; font-size: 11pt; }
.muted { color: #64748b; }
p { margin: 0 0 4mm; }<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&display=swap"><div style="box-sizing:border-box;width:100%;display:flex;justify-content:space-between;gap:6mm;padding:0 18mm;font-size:7px;line-height:1.5;color:#555">
<span>{{ company.name }} · {{ company.street }} · {{ company.city }}<br>{{ company.register }} · Geschäftsführung: {{ company.director }}</span>
<span>USt-IdNr. {{ company.vat_id }}<br>IBAN {{ company.iban }} · BIC {{ company.bic }}</span>
<span style="white-space:nowrap">Seite <span class="pageNumber"></span> von <span class="totalPages"></span></span>
</div>{
"paper": {
"format": "A4"
},
"margin": {
"top": "20mm",
"right": "18mm",
"bottom": "26mm",
"left": "22mm"
},
"locale": "de-DE",
"timezone": "Europe/Berlin",
"currency": "EUR",
"pdf": {
"metadata": {
"title": "Bestätigung Ihrer Kündigung"
}
},
"footer": {
"height": "16mm"
}
}{
"company": {
"name": "Fennlor Studio GmbH",
"street": "Musterstraße 1",
"city": "12345 Musterstadt",
"phone": "+49 000 0000000",
"email": "hallo@fennlor.example",
"iban": "DE36000000000000000000",
"bic": "XXXXDEXXXXX",
"vat_id": "DE000000000",
"register": "Amtsgericht Musterstadt, HRB 00000",
"director": "Erika Mustermann"
},
"customer": {
"name": "Olvarest GmbH",
"contact": "Max Mustermann",
"street": "Beispielweg 2",
"city": "54321 Beispielstadt",
"number": "K-10482"
},
"letter": {
"date": "2026-09-21"
},
"contract": {
"name": "Wartungsvertrag Kundenportal",
"number": "V-2024-0088",
"received": "2026-09-18",
"ends": "2026-12-31",
"refund": 480,
"refund_by": "2027-01-15",
"export_until": "2027-01-31"
}
}Über die API rendern
Speichern Sie die Beispieldaten als data.json und senden Sie sie mit dem Namen der Vorlage. TypeScript und Python nutzen die SDKs; jede andere Sprache schickt dasselbe JSON mit ihrer Standardbibliothek an die REST-API. Renderings mit einem Schlüssel, der mit ff_test_ beginnt, werden nicht gezählt; im Free-Tarif tragen sie ein kleines Wasserzeichen.
jq '{template: "kuendigungsbestaetigung", data: ., filename: "kuendigung-V-2024-0088.pdf"}' data.json \
| curl https://api-eu.formfeed.dev/v1/renders \
-H "Authorization: Bearer ff_test_..." \
-H "Content-Type: application/json" \
--data-binary @-import { Formfeed } from '@formfeed/sdk';
import data from './data.json' with { type: 'json' };
const formfeed = new Formfeed({ apiKey: process.env.FORMFEED_API_KEY! });
const render = await formfeed.renders.create({
template: 'kuendigungsbestaetigung',
data,
filename: 'kuendigung-V-2024-0088.pdf',
});
console.log(render.status, render.download_url);import json
import os
from formfeed import Formfeed
formfeed = Formfeed(api_key=os.environ["FORMFEED_API_KEY"])
with open("data.json", encoding="utf-8") as file:
data = json.load(file)
render = formfeed.renders.create(
template="kuendigungsbestaetigung",
data=data,
filename="kuendigung-V-2024-0088.pdf",
)
print(render.status, render.download_url)<?php
$body = [
'template' => 'kuendigungsbestaetigung',
'data' => json_decode(file_get_contents('data.json'), true),
'filename' => 'kuendigung-V-2024-0088.pdf',
];
$curl = curl_init('https://api-eu.formfeed.dev/v1/renders');
curl_setopt_array($curl, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('FORMFEED_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($body),
]);
$render = json_decode(curl_exec($curl), true);
echo $render['status'], ' ', $render['download_url'], PHP_EOL;package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
data, err := os.ReadFile("data.json")
if err != nil {
panic(err)
}
body, _ := json.Marshal(map[string]any{
"template": "kuendigungsbestaetigung",
"data": json.RawMessage(data),
"filename": "kuendigung-V-2024-0088.pdf",
})
request, _ := http.NewRequest("POST", "https://api-eu.formfeed.dev/v1/renders", bytes.NewReader(body))
request.Header.Set("Authorization", "Bearer "+os.Getenv("FORMFEED_API_KEY"))
request.Header.Set("Content-Type", "application/json")
response, err := http.DefaultClient.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
var render struct {
Status string `json:"status"`
DownloadURL string `json:"download_url"`
}
json.NewDecoder(response.Body).Decode(&render)
fmt.Println(render.Status, render.DownloadURL)
}using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;
var body = new
{
template = "kuendigungsbestaetigung",
data = JsonDocument.Parse(File.ReadAllText("data.json")).RootElement,
filename = "kuendigung-V-2024-0088.pdf",
};
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("FORMFEED_API_KEY"));
var response = await http.PostAsJsonAsync("https://api-eu.formfeed.dev/v1/renders", body);
var render = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine($"{render.GetProperty("status")} {render.GetProperty("download_url")}");import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Files;
import java.nio.file.Path;
public class Render {
public static void main(String[] args) throws Exception {
String data = Files.readString(Path.of("data.json"));
String body = """
{
"template": "kuendigungsbestaetigung",
"filename": "kuendigung-V-2024-0088.pdf",
"data": %s
}
""".formatted(data);
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-eu.formfeed.dev/v1/renders"))
.header("Authorization", "Bearer " + System.getenv("FORMFEED_API_KEY"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body()); // status, download_url, page_count, units …
}
}require "json"
require "net/http"
body = {
template: "kuendigungsbestaetigung",
data: JSON.parse(File.read("data.json")),
filename: "kuendigung-V-2024-0088.pdf",
}
response = Net::HTTP.post(
URI("https://api-eu.formfeed.dev/v1/renders"),
JSON.generate(body),
"Authorization" => "Bearer #{ENV.fetch("FORMFEED_API_KEY")}",
"Content-Type" => "application/json"
)
render = JSON.parse(response.body)
puts render["status"], render["download_url"]Heute mit dem Rendern beginnen
Der kostenlose Plan enthält 100 Einheiten im Monat und kostenlose Testrenderings. Wechseln Sie den Plan, wenn Sie mehr brauchen.
