Errores
caracterizacion_refused
La compuerta de caracterización rechazó la escritura.
La compuerta de caracterización rechazó la escritura.
| Código | caracterizacion_refused |
| Tipo | unprocessable_error — Bien formado, pero viola una regla del dominio |
| HTTP | 422 |
| ¿Reintentable? | No |
Qué hacer
error.details.refusals explica. Manda la guardia SQL, no la ruta.
Reintentar el mismo request va a fallar igual. Cambia el request, no la frecuencia.
El sobre
{
"error": {
"type": "unprocessable_error",
"code": "caracterizacion_refused",
"message": "…",
"hint": "`error.details.refusals` explains. The SQL guard is authoritative, not the route.",
"retriable": false,
"doc_url": "https://docs.facturia.cl/errors/caracterizacion_refused",
"request_id": "req_01K2R7Q9M4T2VB"
}
}Programa contra code, nunca contra message — la prosa se puede reescribir, el código no (§5.8).
hint y retriable llegan en la respuesta, con estos mismos valores: son función del code y salen del mismo diccionario que sirve GET /v1/error_codes, así que el sobre y el diccionario no pueden discrepar. hint va en inglés a propósito — el español de este código es esta ficha. Más en El sobre de error.
También
Todos los códigos
La tabla completa, agrupada por dónde te la vas a encontrar.
El sobre de error
Los nueve tipos, el request_id y cómo manejarlos en la práctica.
La copia legible por máquina de esta ficha vive en GET /v1/error_codes, sin autenticación.