Zentto Digital Print returns errors with a uniform structure. This page documents the
error structure, HTTP codes, service-specific codes (with the suggested action for each)
and the recommended error-handling strategy.
{ "codigo" : " string " , "mensaje" : " string " , "validaciones" : [ " string " ] }
Code Description 400 Bad Request The request contains a syntax error or incorrect parameters. 401 Unauthorized Authentication is required and has failed or was not provided. 403 Forbidden The server understood the request but refuses to authorize it. 404 Not Found The requested resource could not be found. 405 Method Not Allowed The HTTP method used is not allowed for this endpoint.
Code Description 500 Internal Server Error An unexpected error occurred on the server. 502 Bad Gateway The server received an invalid response from the upstream server. 503 Service Unavailable The server is temporarily unavailable (maintenance or overload). 504 Gateway Timeout The gateway/proxy did not receive a timely response.
Code Description Suggested action 100 Document processing error (database insertion) Retry after a delay; report to support if it persists. 200 Document processed successfully Continue; persist control number and consultUrl. 201 Duplicate document Do not resend; query the existing document status. 202 Check the billing-point information for automatic assignment Review billing-point/series configuration. 203 Document not processed (validation rejection: missing required field / wrong format / etc.) Fix the payload per the returned validations. 204 Error generating control number Retry; verify numbering availability. 205 Does not meet minimal validations (Art. 28) Complete the required minimal information. 210 Minimal information recorded correctly Continue. 211 The minimal information had already been recorded (duplicate) Do not resend. 400 Error in the Request structure Validate the JSON structure before resending. 401 Unauthorized (token/credentials error or absence) Renew token/credentials (valid 12 h). 500 Internal processing error Retry after a delay; report to support if it persists.
Reenvío: on error, retry with a minimum 30-second delay (only for already-sent documents).Validación previa: verify that minimal required fields contain data to avoid 400 Bad Request.Autenticación: on 401, verify the token is valid. Do not request a token on every call; tokens are valid for 12 hours.Logging: log all received errors (code + message) for debugging and monitoring.Mensajes al usuario: show clear, useful error messages (contact support or retry). 
