Error Codes

HTTP Codes

Code	Name	Description
200	OK	Successful request
400	Bad Request	Invalid data in request
401	Unauthorized	Invalid or expired JWT token
403	Forbidden	No permission for action
404	Not Found	Resource not found
500	Internal Server Error	Internal server error

Error Format

All error responses follow this format:

{
  "response": "ERROR",
  "message": "Error description"
}

Common Errors

Authentication

Message	Cause	Solution
Se requieren los headers X-Username y X-Password	Missing credentials	Add headers in login
Usuario o contrasena incorrectos	Invalid credentials	Verify username and password
Token expirado	JWT expired	Request new token via login

Guide Creation

Message	Cause	Solution
El campo 'TipoServicio' es requerido	Missing TipoServicio	Add the field
TipoServicio solo acepta: Domicilio, Ocurre	Incorrect value	Use "Domicilio" or "Ocurre"
Usuario API no tiene sucursal de origen asignada	Misconfigured user	Contact your administrator
La sucursal de origen no existe o no esta activa	Disabled branch	Contact your administrator
DestinoCode no corresponde a sucursal valida	Incorrect code	Verify at /api/sucursales/destinos
El JSON no contiene el array 'Guia'	Incorrect structure	Check JSON format

Labels

Message	Cause	Solution
Guia no encontrada	Invalid number	Verify guide number
Error al generar la etiqueta	Internal error	Contact support

Permissions

Message	Cause	Solution
No tiene permiso para realizar esta accion	Missing permission	Request needed permission
Acceso denegado	Unauthorized	Verify your assigned permissions

Required Permissions

Endpoint	Permission
POST /guias/crear	guias.create
GET /guias/validar-destino/*	guias.read
GET /guias/etiqueta/*	guias.read
GET /guias/etiqueta-pequena/*	guias.read
GET /sucursales/*	guias.read

tip

If you receive permission errors, check your current permissions at GET /api/apipermissions/my-permissions