Error Reference

All errors follow a consistent JSON shape. Validation errors also carry line and path so you can surface them directly in your UI without post-processing.

Error object shape

{
  "valid": false,
  "errors": [
    {
      "code": "BR-01",
      "severity": "error",       // "error" | "warning" | "info"
      "message": "An Invoice shall have a Specification identifier.",
      "path": "/Invoice/CustomizationID",
      "line": 3,
      "suggestion": "Add <cbc:CustomizationID>urn:cen.eu:en16931...</cbc:CustomizationID>"
    }
  ]
}

HTTP status codes

Common validation error codes