Formatwerk
retention periods
For each document the service applies the legal categories of § 147 Abs. 1 AO and § 257 Abs. 1 HGB and, for invoices, § 14b UStG: books, inventories, annual statements, management reports, opening balance sheets and organisational documents 10 years; booking vouchers and invoices 8 years; business letters and other tax-relevant documents 6 years; customs documents (Art. 15/163 UCC) 10 years; delivery notes that are not booking vouchers until the invoice is received or sent. The period starts.
POST https://format.halowerk.com/v1/retention-periodsInputs
| Field | Type | Required | Description |
|---|---|---|---|
| documents | array | Yes | Documents to evaluate. |
| entity | string | No | credit_or_financial_institution = institutions under § 1 Abs. 1b KWG, insurers under § 1 Abs. 1 VAG, investment firms under § 2 Abs. 1 WpIG. |
| merchant | boolean | No | Merchant (Kaufmann) under the HGB; false = only tax law applies. |
| reference_date | string | No | Date for the "may be destroyed" answer, default today (UTC). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"documents"
],
"properties": {
"documents": {
"type": "array",
"minItems": 1,
"maxItems": 5000,
"description": "Documents to evaluate.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"category",
"date"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"description": "Your reference."
},
"category": {
"type": "string",
"enum": [
"books_and_records",
"inventories",
"opening_balance_sheet",
"annual_financial_statements",
"management_report",
"consolidated_statements",
"work_instructions_and_organisation_documents",
"booking_vouchers",
"invoices",
"received_business_letters",
"sent_business_letter_copies",
"customs_documents",
"other_tax_relevant_documents",
"delivery_notes_not_vouchers"
],
"description": "Legal category: books_and_records, inventories, opening_balance_sheet, annual_financial_statements, management_report, consolidated_statements, work_instructions_and_organisation_documents, booking_vouchers, invoices, received_business_letters, sent_business_letter_copies, customs_documents, other_tax_relevant_documents, delivery_notes_not_vouchers."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Event date: last entry, preparation/adoption, receipt or dispatch, creation of the voucher, invoice date."
},
"invoice_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Delivery notes only: date the related invoice was received or sent."
}
}
}
},
"entity": {
"type": "string",
"enum": [
"general",
"credit_or_financial_institution"
],
"default": "general",
"description": "credit_or_financial_institution = institutions under § 1 Abs. 1b KWG, insurers under § 1 Abs. 1 VAG, investment firms under § 2 Abs. 1 WpIG."
},
"merchant": {
"type": "boolean",
"default": true,
"description": "Merchant (Kaufmann) under the HGB; false = only tax law applies."
},
"reference_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date for the \"may be destroyed\" answer, default today (UTC)."
}
}
}Published input example
{
"documents": [
{
"id": "ER-2026-118",
"category": "invoices",
"date": "2026-03-15"
},
{
"category": "annual_financial_statements",
"date": "2025-04-30"
}
]
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Formatwerk0.004 USDC
accounting csv unify
POSThttps://format.halowerk.com/v1/accounting-csv-unifyDATEV booking batch files (EXTF/DTVF, category 21) are read by their documented field positions: amount and S/H become a signed amount relative to the account, Belegdatum TTMM is resolved within the fiscal year from the header. Other export
- Formatwerk0.005 USDC
avv checklist
POSThttps://format.halowerk.com/v1/avv-checklistChecklist after Art. 28 GDPR (Regulation (EU) 2016/679 Art. 28 (GDPR), https://eur-lex.europa.eu/eli/reg/2016/679/oj, German and English text retrieved from the EU Publications Office 2026-11-01): Art. 28(3) sentence 1 (subject-matter, dura
- Formatwerk0.004 USDC
bagit package
POSThttps://format.halowerk.com/v1/bagit-packageCreate: files go to data/, manifest-<alg>.txt and tagmanifest-<alg>.txt are written for SHA-256 (default), SHA-512 or legacy SHA-1/MD5, bag-info.txt gets your metadata plus Bagging-Date, Bag-Size and Payload-Oxum; paths are checked (no abso