field_too_long

A field is longer than the SII schema accepts for the element it becomes.

What to do

The message names the length, the XSD element and its cap. Refused rather than truncated on purpose — shortening a razón social or a name of trade would change what the document says. Nothing was emitted and no folio was spent.

The envelope

{
  "error": {
    "type": "invalid_request_error",
    "code": "field_too_long",
    "message": "…",
    "hint": "The message names the length, the XSD element and its cap. Refused rather than truncated on purpose — shortening a razón social or a name of trade would change what the document says. Nothing was emitted and no folio was spent.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/field_too_long",
    "request_id": "req_01K2R7Q9M4T2VB"
  }
}

Program against code, never against message — the prose can be rewritten, the code cannot (§5.8).

hint and retriable arrive in the response with these exact values: they are a function of code and come from the same dictionary GET /v1/error_codes serves, so the envelope and the dictionary cannot disagree. Both are English on the wire by design — one registry, one language. More in The error envelope.

See also

The machine-readable copy of this page lives at GET /v1/error_codes, unauthenticated.