Facturiadocs

mandato_required

The empresa has no accepted mandato, so we may not act before the SII for it.

The empresa has no accepted mandato, so we may not act before the SII for it.

Codemandato_required
Typeunprocessable_error — Well formed, but breaks a domain rule
HTTP422
Retriable?No

What to do

Present GET /v1/mandato_terms and POST .../mandato, or omit the body for a hosted signing_url.

Retrying the same request will fail the same way. Change the request, not the frequency.

The envelope

{
  "error": {
    "type": "unprocessable_error",
    "code": "mandato_required",
    "message": "…",
    "hint": "Present `GET /v1/mandato_terms` and `POST .../mandato`, or omit the body for a hosted `signing_url`.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/mandato_required",
    "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.

On this page