Formatwerk
sepa credit transfer xml
Generate mode builds pain.001.001.09 (ISO 20022 2019, current DK version) with xmlbuilder2: group and payment level NbOfTxs/CtrlSum, SvcLvl SEPA, optional INST for instant transfers, ChrgBr SLEV, structured or hybrid addresses, unstructured (max 140) or ISO 11649 structured remittance; texts are converted to the DK or EPC character set and every change is listed. Validate mode parses pain.001.001.09 or the legacy pain.001.001.03 with fast-xml-parser and checks namespace, BOM and prefixes,.
POST https://format.halowerk.com/v1/sepa-credit-transfer-xmlInputs
| Field | Type | Required | Description |
|---|---|---|---|
| xml | string | No | Existing pain.001 file to validate. If given, the generation fields are ignored. |
| debtor | object | No | Ordering party (generate mode). |
| execution_date | string | No | Requested execution date (generate mode). |
| transactions | array | No | Credit transfers (generate mode). |
| message_id | string | No | Message id; default derived from the content. |
| payment_information_id | string | No | Payment information id; default derived from the content. |
| created_at | string | No | Creation timestamp; default now. |
| initiating_party | string | No | Initiating party name; default debtor name. |
| ultimate_debtor | string | No | Ultimate debtor for the whole batch. |
| batch_booking | boolean | No | true = one batch booking, false = single bookings. |
| instant | boolean | No | SEPA instant credit transfer (LclInstrm INST). |
| category_purpose | string | No | Category purpose code, e.g. SALA. |
| charset | string | No | dk = Latin set plus Ä Ö Ü ä ö ü ß & * $ % (German banks, DK Appendix 3); epc = EPC basic Latin set only. |
| reference_date | string | No | Reference date for date checks (submission date), default today (UTC). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"xml": {
"type": "string",
"maxLength": 5000000,
"description": "Existing pain.001 file to validate. If given, the generation fields are ignored."
},
"debtor": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"iban"
],
"description": "Ordering party (generate mode).",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Debtor name (max 70 after cleaning)."
},
"iban": {
"type": "string",
"minLength": 1,
"maxLength": 42,
"description": "Debtor IBAN."
},
"bic": {
"type": "string",
"minLength": 1,
"maxLength": 11,
"description": "Debtor bank BIC (optional, NOTPROVIDED otherwise)."
},
"address": {
"type": "object",
"additionalProperties": false,
"required": [
"town",
"country"
],
"description": "Structured or hybrid postal address (town and country mandatory since 5 October 2025).",
"properties": {
"street": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Street name."
},
"building_number": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Building number."
},
"postal_code": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Postal code."
},
"town": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Town."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166 country code."
},
"address_lines": {
"type": "array",
"maxItems": 2,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Free address line."
},
"description": "At most two free lines (hybrid address)."
}
}
}
}
},
"execution_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Requested execution date (generate mode)."
},
"transactions": {
"type": "array",
"minItems": 1,
"maxItems": 5000,
"description": "Credit transfers (generate mode).",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"creditor"
],
"properties": {
"amount": {
"type": [
"number",
"string"
],
"description": "Amount in EUR, positive, at most two decimal places (number or string such as \"100.50\")."
},
"end_to_end_id": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "End-to-end reference; default NOTPROVIDED."
},
"instruction_id": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Optional instruction id."
},
"creditor": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"iban"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Creditor name (max 70 after cleaning)."
},
"iban": {
"type": "string",
"minLength": 1,
"maxLength": 42,
"description": "Creditor IBAN."
},
"bic": {
"type": "string",
"minLength": 1,
"maxLength": 11,
"description": "Creditor bank BIC (optional)."
},
"address": {
"type": "object",
"additionalProperties": false,
"required": [
"town",
"country"
],
"description": "Structured or hybrid postal address (town and country mandatory since 5 October 2025).",
"properties": {
"street": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Street name."
},
"building_number": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Building number."
},
"postal_code": {
"type": "string",
"minLength": 1,
"maxLength": 16,
"description": "Postal code."
},
"town": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Town."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166 country code."
},
"address_lines": {
"type": "array",
"maxItems": 2,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 70,
"description": "Free address line."
},
"description": "At most two free lines (hybrid address)."
}
}
}
}
},
"remittance_information": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"description": "Unstructured remittance information, max 140 after cleaning."
},
"creditor_reference": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Structured creditor reference, e.g. ISO 11649 RF reference (instead of remittance_information)."
},
"purpose_code": {
"type": "string",
"pattern": "^[A-Z0-9]{4}$",
"description": "ISO 20022 purpose code, e.g. SALA, SUPP."
},
"ultimate_debtor": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Ultimate debtor name."
},
"ultimate_creditor": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Ultimate creditor name."
}
}
}
},
"message_id": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Message id; default derived from the content."
},
"payment_information_id": {
"type": "string",
"minLength": 1,
"maxLength": 35,
"description": "Payment information id; default derived from the content."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Creation timestamp; default now."
},
"initiating_party": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Initiating party name; default debtor name."
},
"ultimate_debtor": {
"type": "string",
"minLength": 1,
"maxLength": 140,
"description": "Ultimate debtor for the whole batch."
},
"batch_booking": {
"type": "boolean",
"description": "true = one batch booking, false = single bookings."
},
"instant": {
"type": "boolean",
"default": false,
"description": "SEPA instant credit transfer (LclInstrm INST)."
},
"category_purpose": {
"type": "string",
"pattern": "^[A-Z0-9]{4}$",
"description": "Category purpose code, e.g. SALA."
},
"charset": {
"type": "string",
"enum": [
"dk",
"epc"
],
"default": "dk",
"description": "dk = Latin set plus Ä Ö Ü ä ö ü ß & * $ % (German banks, DK Appendix 3); epc = EPC basic Latin set only."
},
"reference_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Reference date for date checks (submission date), default today (UTC)."
}
}
}Published input example
{
"debtor": {
"name": "Beispiel Handels GmbH",
"iban": "DE79000000001234567890",
"bic": "COBADEFFXXX"
},
"execution_date": "2026-11-05",
"transactions": [
{
"amount": "100.00",
"end_to_end_id": "RE-2026-0042",
"creditor": {
"name": "Muster Bürobedarf KG",
"iban": "DE16000000002345678901"
},
"remittance_information": "Rechnung RE-2026-0042"
}
],
"reference_date": "2026-11-02"
}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