HandlebarsPDF
German cancellation confirmation (Kündigungsbestätigung)
A plain business letter whose paragraphs depend on the data: with a refund it names the amount and the date, without one it says that nothing is open, and the data export paragraph appears only when there is a deadline. Dates are written out in German.
Free plan, no card. You get your own copy in the editor, published and ready for the API.
Rendered result
What this example shows
{{#if contract.refund}} … {{else}} … {{/if}}chooses between the refund paragraph and the sentence that nothing is open; the same template serves both cases.- The data export paragraph sits in its own
{{#if contract.export_until}}and disappears when the contract has no such deadline. {{date contract.ends "d. MMMM yyyy"}}writes31. Dezember 2026; the table at the top uses the shortdd.MM.yyyyform.- Letter layout, address window and legal footer are the ones of the other German letters: the same rules at the top of
style.cssand the same footer, in this template’s own folder.
Helpers used
Template folder
<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"
}
}Render it through the API
Save the sample data as data.json and send it with the template’s name. TypeScript and Python use the SDKs; every other language posts the same JSON to the REST API with its standard library. Renders with a key that starts with ff_test_ are not metered; on the Free plan they carry a small watermark.
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"]Start rendering today
The free plan includes 100 units a month and free test renders. Change plans when you need more.
