dispatch_not_available_for_channel

The empresa’s emission channel cannot express this dispatch field.

What to do

Two dispatch fields are refused on emission_channel=sfg and accepted on emission_channel=mercado, both because the SII portal’s guía form has nowhere to put them. dispatch.destination: that form carries a single address — the receptor’s — so a separate destination could not be printed; put the delivery address in receptor.address. dispatch.dispatch_type: the form’s only traslado select is the kind of movement, and it has no TipoDespacho input at all, so on whose account the despacho moves cannot be stated there. On the mercado lane the engine writes them into the DTE’s IdDoc/TipoDespacho and Transporte block. Both are refused rather than silently dropped.

The envelope

{
  "error": {
    "type": "unprocessable_error",
    "code": "dispatch_not_available_for_channel",
    "message": "…",
    "hint": "Two `dispatch` fields are refused on `emission_channel=sfg` and accepted on `emission_channel=mercado`, both because the SII portal’s guía form has nowhere to put them. `dispatch.destination`: that form carries a single address — the receptor’s — so a separate destination could not be printed; put the delivery address in `receptor.address`. `dispatch.dispatch_type`: the form’s only traslado select is the kind of movement, and it has no TipoDespacho input at all, so on whose account the despacho moves cannot be stated there. On the mercado lane the engine writes them into the DTE’s `IdDoc/TipoDespacho` and `Transporte` block. Both are refused rather than silently dropped.",
    "retriable": false,
    "doc_url": "https://docs.facturia.cl/errors/dispatch_not_available_for_channel",
    "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.