curatedapi

EN 16931 validator (UBL and CII)

Check a UBL or CII invoice against the European e-invoicing standard EN 16931 with CEN's official rules.

Check an invoice now

Free, no sign-up, 5 invoices a day. Files up to 900 KB. The file is checked in memory and is not stored.

What it checks

Runs the UBL 2.1 or UN/CEFACT CII D16B schema and then CEN/TC 434's own validation artefacts: the business rules (BR-…), calculation rules (BR-CO-…), VAT rules and code lists of EN 16931-1. The syntax is detected from the document. Country rules (CIUS) such as XRechnung or Peppol BIS are separate endpoints.

Rules used

A check shows whether the invoice passes the official rule sets listed, at the versions listed. It is not legal or tax advice, and passing does not promise that a tax authority or buyer will accept the invoice. See the terms.

Use it from your code

POST /v1/validate/einvoice/en16931Version 1
jq -Rs '{xml: .}' cen-ubl-tc434-creditnote1.xml |
  curl https://api.curatedapi.com/v1/validate/einvoice/en16931 \
    -H "Authorization: Bearer $CURATEDAPI_KEY" \
    -H "Content-Type: application/json" \
    --data-binary @-
200 OKAn official sample (cen-ubl-tc434-creditnote1.xml)
{
  "validator": "einvoice/en16931@1",
  "result": {
    "valid": true,
    "scenario": "EN 16931 (UBL CreditNote)",
    "document_type": "UBL CreditNote",
    "specification_id": "urn:cen.eu:en16931:2017",
    "errors": 0,
    "warnings": 0,
    "notices": 0,
    "error_rules": [],
    "checks": [
      {
        "check": "XML syntax",
        "passed": true
      },
      {
        "check": "UBL 2.1 CreditNote schema",
        "passed": true
      },
      {
        "check": "EN 16931 rules 1.3.17",
        "passed": true
      }
    ],
    "messages": [],
    "messages_truncated": false
  },
  "rules": [
    {
      "name": "CEN/TC 434 EN 16931 validation artefacts",
      "version": "1.3.17",
      "url": "https://github.com/ConnectingEurope/eInvoicing-EN16931/releases/tag/validation-1.3.17"
    }
  ]
}

MCP tool validate_einvoice_en16931 at https://mcp.curatedapi.com. Inputs, results and errors in the API reference.

Other validators

Check every invoice before it is sent

Run the same check from your invoicing app or ERP, one POST per invoice, before the file goes to the customer or the Peppol network. The answer lists every rule it breaks.

Free for up to 200 invoices checked a month. 10,000 invoices checked a month cost $9.00 on the Starter plan.