Zum Inhalt springen

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

Gerendertes Ergebnis: Kündigungsbestätigung mit bedingten Absätzen
PDF · 1 Seite · 83 KB ↓ herunterladen

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"}} schreibt 31. Dezember 2026; die Tabelle oben nutzt die kurze Form dd.MM.yyyy.
  • Brieflayout, Adressfenster und Pflichtangaben in der Fußzeile sind die der anderen deutschen Briefe: dieselben Regeln am Anfang der style.css und dieselbe Fußzeile, im eigenen Ordner dieser Vorlage.

Verwendete Helfer

Vorlagenordner

templates/kuendigungsbestaetigung/template.htmlHandlebars
<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>
templates/kuendigungsbestaetigung/style.cssCSS
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; }
templates/kuendigungsbestaetigung/head.htmlHTML
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&display=swap">
templates/kuendigungsbestaetigung/footer.htmlHandlebars
<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>
templates/kuendigungsbestaetigung/settings.jsonJSON
{
  "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"
  }
}
templates/kuendigungsbestaetigung/data/default.jsonJSON
{
  "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.

render.shShell
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 @-
render.tsTypeScript
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);
render.pyPython
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)
render.phpPHP
<?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;
main.goGo
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)
}
Program.csC#
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")}");
Render.javaJava
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 …
  }
}
render.rbRuby
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.