Zentto Imprenta Digital devuelve los errores con una estructura uniforme. Esta página
documenta la estructura de error, los códigos HTTP, los códigos específicos del servicio
(con la acción sugerida para cada uno) y la estrategia recomendada de manejo de errores.
{ "codigo" : " string " , "mensaje" : " string " , "validaciones" : [ " string " ] }
Código Descripción 400 Bad Request La solicitud contiene un error de sintaxis o parámetros incorrectos. 401 Unauthorized La autenticación es requerida y ha fallado o no fue proporcionada. 403 Forbidden El servidor entendió la solicitud pero se niega a autorizarla. 404 Not Found El recurso solicitado no pudo ser encontrado. 405 Method Not Allowed El método HTTP utilizado no está permitido para este endpoint.
Código Descripción 500 Internal Server Error Ocurrió un error inesperado en el servidor. 502 Bad Gateway El servidor recibió una respuesta inválida del servidor upstream. 503 Service Unavailable El servidor no está disponible temporalmente (mantenimiento o sobrecarga). 504 Gateway Timeout El gateway/proxy no recibió una respuesta a tiempo.
Código Descripción Acción sugerida 100 Error en el procesamiento de documentos (inserción en base de datos) Reintentar tras delay; reportar a soporte si persiste. 200 Documento procesado exitosamente Continuar; persistir nº de control y consultUrl. 201 Documento duplicado No reenviar; consultar estado del documento existente. 202 Verifique la información en puntos de facturación para la asignación automática Revisar configuración de puntos de facturación/series. 203 Documento no procesado (rechazo por validación: campo obligatorio faltante / formato incorrecto / etc.) Corregir el payload según validaciones devueltas. 204 Error al generar número de control Reintentar; verificar disponibilidad de numeración. 205 No cumple las validaciones mínimas (Art. 28) Completar la información mínima exigida. 210 Información mínima registrada correctamente Continuar. 211 La información mínima ya había sido registrada previamente (duplicado) No reenviar. 400 Error en la estructura del Request Validar la estructura JSON antes de reenviar. 401 No autorizado (error o ausencia de token o credenciales) Renovar token/credenciales (válido 12 h). 500 Error interno en el procesamiento Reintentar con delay; reportar a soporte si persiste.
Reenvío: ante error, reintentar con delay mínimo de 30 segundos (solo documentos ya enviados).Validación previa: verificar que los campos mínimos obligatorios tengan datos para evitar 400 Bad Request.Autenticación: ante 401, verificar token vigente. No solicitar token en cada petición; los tokens son válidos por 12 horas.Logging: registrar todos los errores recibidos (código + mensaje) para depuración y monitoreo.Mensajes al usuario: mostrar mensajes de error claros y útiles (contactar soporte o reintentar). 
