Skip to content
HALOWERK

Formatwerk

sepa charset clean

Target sets per DK Appendix 3 V3.9, 2.1: EPC basic Latin (a-z A-Z 0-9 / - ? : ( ) . , ' + blank) or the DK set with Ä Ö Ü ä ö ü ß & * $ %. Conversions follow the DK table: umlauts kept, expanded (AE, OE, UE, ss - "alternatively permitted") or stripped (A, O, U, s - EPC best practice); & becomes +, * $ % become a period in EPC mode. Further steps, each reported per character: typographic quotes, dashes, ellipsis, euro sign and underscore to ASCII equivalents (own mapping), Unicode canonical.

POST https://format.halowerk.com/v1/sepa-charset-clean

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textsarrayYesTexts to clean.
modestringNoTarget character set.
umlautsstringNokeep (dk mode only; in epc mode keep acts like expand), expand = AE/OE/UE/ss, strip = A/O/U/s.
fieldstringNoidentifier = MsgId/EndToEndId/mandate id rules.
max_lengthintegerNoTruncate to this length (e.g. 140 remittance, 70 names, 35 identifiers).
replacementstringNoReplacement for characters that cannot be converted.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "texts"
  ],
  "properties": {
    "texts": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "string",
        "maxLength": 2000
      },
      "description": "Texts to clean."
    },
    "mode": {
      "type": "string",
      "enum": [
        "dk",
        "epc"
      ],
      "default": "dk",
      "description": "Target character set."
    },
    "umlauts": {
      "type": "string",
      "enum": [
        "keep",
        "expand",
        "strip"
      ],
      "default": "keep",
      "description": "keep (dk mode only; in epc mode keep acts like expand), expand = AE/OE/UE/ss, strip = A/O/U/s."
    },
    "field": {
      "type": "string",
      "enum": [
        "text",
        "identifier"
      ],
      "default": "text",
      "description": "identifier = MsgId/EndToEndId/mandate id rules."
    },
    "max_length": {
      "type": "integer",
      "minimum": 1,
      "maximum": 140,
      "description": "Truncate to this length (e.g. 140 remittance, 70 names, 35 identifiers)."
    },
    "replacement": {
      "type": "string",
      "enum": [
        " ",
        ".",
        ""
      ],
      "default": " ",
      "description": "Replacement for characters that cannot be converted."
    }
  }
}

Open original schema

Published input example

{
  "texts": [
    "Müller & Söhne – Café"
  ],
  "mode": "epc",
  "umlauts": "expand"
}

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 →