Skip to content
HALOWERK

Datenwerk

sepa batch split

Parses the ISO 20022 XML (pain.001 credit transfers, pain.008 direct debits; any version using the standard element names) order-preservingly with fast-xml-parser, checks the declared NbOfTxs/CtrlSum of the group header and payment blocks against the transactions, then packs transactions in their original order into files: a new file starts for each requested execution or collection date (optional) and whenever a limit would be exceeded. Payment blocks keep all header elements.

POST https://daten.halowerk.com/v1/sepa-batch-split

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
xmlstringYesComplete pain.001 or pain.008 document.
split_by_datebooleanNoOne output file per requested execution/collection date.
max_transactions_per_fileintegerNo
max_amount_per_filestringNoUpper limit of CtrlSum per file, e.g. 1000000.00.
max_transactions_per_payment_infointegerNo
msg_id_prefixstringNoReplaces the original MsgId as base for the new MsgIds.
include_xmlbooleanNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "xml"
  ],
  "properties": {
    "xml": {
      "type": "string",
      "minLength": 50,
      "maxLength": 8000000,
      "description": "Complete pain.001 or pain.008 document."
    },
    "split_by_date": {
      "type": "boolean",
      "default": true,
      "description": "One output file per requested execution/collection date."
    },
    "max_transactions_per_file": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "max_amount_per_file": {
      "type": "string",
      "pattern": "^\\d{1,12}(\\.\\d{1,2})?$",
      "description": "Upper limit of CtrlSum per file, e.g. 1000000.00."
    },
    "max_transactions_per_payment_info": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "msg_id_prefix": {
      "type": "string",
      "maxLength": 30,
      "pattern": "^[A-Za-z0-9/\\-?:().,'+ ]+$",
      "description": "Replaces the original MsgId as base for the new MsgIds."
    },
    "include_xml": {
      "type": "boolean",
      "default": true
    }
  }
}

Open original schema

Published input example

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pain.001.001.09\"><CstmrCdtTrfInitn><GrpHdr><MsgId>MSG-2026-11-001</MsgId><CreDtTm>2026-11-02T10:00:00</CreDtTm><NbOfTxs>5</NbOfTxs><CtrlSum>1401.00</CtrlSum><InitgPty><Nm>Lagertechnik Nord GmbH</Nm></InitgPty></GrpHdr><PmtInf><PmtInfId>PI-1</PmtInfId><PmtMtd>TRF</PmtMtd><NbOfTxs>3</NbOfTxs><CtrlSum>351.49</CtrlSum><PmtTpInf><SvcLvl><Cd>SEPA</Cd></SvcLvl></PmtTpInf><ReqdExctnDt><Dt>2026-11-05</Dt></ReqdExctnDt><Dbtr><Nm>Lagertechnik Nord GmbH</Nm></Dbtr><DbtrAcct><Id><IBAN>DE16000000002345678901</IBAN></Id></DbtrAcct><DbtrAgt><FinInstnId><BICFI>BYLADEM1001</BICFI></FinInstnId></DbtrAgt><ChrgBr>SLEV</ChrgBr><CdtTrfTxInf><PmtId><EndToEndId>E2E-1</EndToEndId></PmtId><Amt><InstdAmt Ccy=\"EUR\">100.00</InstdAmt></Amt><Cdtr><Nm>A &amp; B KG</Nm></Cdtr><CdtrAcct><Id><IBAN>DE79000000001234567890</IBAN></Id></CdtrAcct><RmtInf><Ustrd>RE E2E-1</Ustrd></RmtInf></CdtTrfTxInf><CdtTrfTxInf><PmtId><EndToEndId>E2E-2</EndToEndId></PmtId><Amt><InstdAmt Ccy=\"EUR\">250.50</InstdAmt></Amt><Cdtr><Nm>Beispiel AG</Nm></Cdtr><CdtrAcct><Id><IBAN>DE79000000001234567890</IBAN></Id></CdtrAcct><RmtInf><Ustrd>RE E2E-2</Ustrd></RmtInf></CdtTrfTxInf><CdtTrfTxInf><PmtId><EndToEndId>E2E-3</EndToEndId></PmtId><Amt><InstdAmt Ccy=\"EUR\">0.99</InstdAmt></Amt><Cdtr><Nm>Probe eG</Nm></Cdtr><CdtrAcct><Id><IBAN>DE79000000001234567890</IBAN></Id></CdtrAcct><RmtInf><Ustrd>RE E2E-3</Ustrd></RmtInf></CdtTrfTxInf></PmtInf><PmtInf><PmtInfId>PI-2</PmtInfId><PmtMtd>TRF</PmtMtd><NbOfTxs>2</NbOfTxs><CtrlSum>1049.51</CtrlSum><PmtTpInf><SvcLvl><Cd>SEPA</Cd></SvcLvl></PmtTpInf><ReqdExctnDt><Dt>2026-11-06</Dt></ReqdExctnDt><Dbtr><Nm>Lagertechnik Nord GmbH</Nm></Dbtr><DbtrAcct><Id><IBAN>DE16000000002345678901</IBAN></Id></DbtrAcct><DbtrAgt><FinInstnId><BICFI>BYLADEM1001</BICFI></FinInstnId></DbtrAgt><ChrgBr>SLEV</ChrgBr><CdtTrfTxInf><PmtId><EndToEndId>E2E-4</EndToEndId></PmtId><Amt><InstdAmt Ccy=\"EUR\">1000.00</InstdAmt></Amt><Cdtr><Nm>Stahlhandel Nord OHG</Nm></Cdtr><CdtrAcct><Id><IBAN>DE79000000001234567890</IBAN></Id></CdtrAcct><RmtInf><Ustrd>RE E2E-4</Ustrd></RmtInf></CdtTrfTxInf><CdtTrfTxInf><PmtId><EndToEndId>E2E-5</EndToEndId></PmtId><Amt><InstdAmt Ccy=\"EUR\">49.51</InstdAmt></Amt><Cdtr><Nm>Muster KG</Nm></Cdtr><CdtrAcct><Id><IBAN>DE79000000001234567890</IBAN></Id></CdtrAcct><RmtInf><Ustrd>RE E2E-5</Ustrd></RmtInf></CdtTrfTxInf></PmtInf></CstmrCdtTrfInitn></Document>",
  "split_by_date": true,
  "max_transactions_per_file": 2
}

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

All endpoints in this hub โ†’