Kontoauszug-PDF-API für Konto- und Abrechnungsexporte
Erzeugen Sie Konto-, Abrechnungs- und Aktivitätsauszüge als PDF mit mehrseitigen Zeilen, Summen, Metadaten und optionalen PDF/A-Archivierungseinstellungen.
/api/v1/pdf/render Kunden-, Konto- oder Abrechnungsauszüge aus Periodendaten, Anfangssalden, Zeilenpositionen, Korrekturen und Summen rendern, damit Nutzer einen konsistenten Datensatz zur Prüfung oder Aufbewahrung herunterladen können.
Wann diese API passt
- Ihr System besitzt Salden, Auszugsperioden, Transaktionszeilen und Summen bereits.
- Sie benötigen einen PDF-Export für Kontohistorie, Abrechnungsübersichten oder Finanz-Workflows.
- Sie benötigen wiederholbare mehrseitige Ausgabe mit Kopfzeilen, Fußzeilen und Zusammenfassungen.
- Sie benötigen möglicherweise PDF/A-Ausgabe für Archivierungs-Workflows.
Was sie nicht ersetzt
- Sie benötigen Bankanbindung, Ledger-Abgleich oder Finanzberatung.
- Sie benötigen verschlüsselte Auszüge und PDF/A im selben Render-Request. Die öffentliche Render API behandelt Sicherheitseinstellungen und PDF/A-Profileinstellungen als gegenseitig ausschließend.
- Sie benötigen E-Rechnungs-XML-Paketierung. Nutzen Sie dafür den E-Invoice Render-Endpunkt.
Welchen Endpoint aufrufen
/api/v1/pdf/render
JSON Render ist der Standardpfad für diesen Workflow.
/api/v1/template-render
Nutzen Sie dies, wenn der Workflow den zugehörigen API-Pfad, einen Template-Vertrag oder eine Capability-Abfrage braucht.
Minimaler Request
POST /api/v1/pdf/render - Deckblatt eines Auszugs mit Periodensummen.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Was gPdf übernimmt
- DocumentRequest-Rendering für Auszugsseiten.
- Textblöcke, Tabellen, Summenbereiche, Seitennummerierung, Metadaten und PDF/A-Profileinstellungen.
- Template Render für ein stabiles Auszugslayout und einen Feldvertrag.
- Binäre PDF-Ausgabe, die Ihr System herunterladen oder speichern kann.
Was Ihr System verantwortet
- Logik der Auszugsperiode, Kontosalden, Transaktionsdaten, Währungsregeln und Kundenidentität.
- Archivierungs-Policy, Zugriffskontrolle, Dateinamen und sichere Zustellung.
- Jeden Abgleich, jede Audit-Freigabe und jede regulierte Finanzdarstellung.
Produktions-Checkliste
- Testen Sie lange Transaktionsbeschreibungen, hohe Zeilenzahlen, leere Perioden und negative Salden.
- Erzeugen Sie für jedes Auszugs-Rendering eine Request-ID.
- Entscheiden Sie, ob Auszüge on demand gerendert oder nach Periodenabschluss gespeichert werden.
- Nutzen Sie PDF/A nur, wenn die Archivierungs-Policy des Auszugs es verlangt.
- Halten Sie Zugriffskontrolle und Kundenauthentifizierung außerhalb der Render API.
Aussagegrenzen
- gPdf berechnet keine Kontosalden und gleicht keine Ledger ab.
- Die API rendert Kontoauszug-PDFs; Ihr System verantwortet die finanzielle Korrektheit.
- PDF/A-Ausgabe ist eine Render-Einstellung, kein Ersatz für eine Aufbewahrungs-Policy.
Auszüge sind Periodendokumente
Eine Auszugsseite sollte mit einem geschlossenen Satz an Geschäftsfakten beginnen: Konto, Periode, Anfangssaldo, Bewegungszeilen, Korrekturen und Schlusssaldo. gPdf entscheidet diese Fakten nicht. Es rendert sie in ein PDF-Layout, das Nutzer herunterladen oder Ihr System speichern kann.
Große Zeilenmengen verarbeiten
Bei hohen Zeilenzahlen gestalten Sie den Auszug als wiederholbares Layout mit Tabellenbereichen, Zusammenfassungen und Seitennummern. Nutzen Sie JSON Render, während Sie das Layout abstimmen. Wechseln Sie zu Template Render, wenn der Feldvertrag stabil ist.
FAQ
- Kann gPdf Auszugssalden berechnen?
- Nein. Ihr System sendet Periode, Salden, Zeilen und Summen. gPdf rendert das PDF.
- Können Kontoauszug-PDFs PDF/A nutzen?
- Ja, JSON Render unterstützt PDF/A-Profileinstellungen. Ihre Archivierungs-Policy entscheidet, ob PDF/A erforderlich ist.
- Sollten Auszüge Template Render nutzen?
- Nach Stabilisierung des Layouts meist ja. Template Render erlaubt Aufrufern, Periodendaten zu senden, ohne Seitenkoordinaten zu wiederholen.
- Speichert gPdf Auszüge?
- Nein. Standard-Render-Requests geben die PDF-Antwort zurück. Ihr System verantwortet Speicherung und Zugriffskontrolle.