Saltar al contenido principal

Códigos de Error

Códigos HTTP​

CódigoNombreDescripción
200OKPetición exitosa
400Bad RequestDatos inválidos en la petición
401UnauthorizedToken JWT inválido o expirado
403ForbiddenSin permiso para la acción
404Not FoundRecurso no encontrado
500Internal Server ErrorError interno del servidor

Formato de Error​

Todas las respuestas de error siguen este formato:

{
  "response": "ERROR",
  "message": "Descripción del error"
}

Errores Comunes​

Autenticación​

MensajeCausaSolución
Se requieren los headers X-Username y X-PasswordFaltan credencialesAgrega los headers en login
Usuario o contrasena incorrectosCredenciales inválidasVerifica usuario y contraseña
Token expiradoJWT vencióSolicita nuevo token con login

Creación de Guías​

MensajeCausaSolución
El campo 'TipoServicio' es requeridoFalta TipoServicioAgrega el campo
TipoServicio solo acepta: Domicilio, OcurreValor incorrectoUsa "Domicilio" o "Ocurre"
Usuario API no tiene sucursal de origen asignadaUsuario mal configuradoContacta a tu administrador
La sucursal de origen no existe o no esta activaSucursal deshabilitadaContacta a tu administrador
DestinoCode no corresponde a sucursal validaCódigo incorrectoVerifica en /api/sucursales/destinos
El JSON no contiene el array 'Guia'Estructura incorrectaRevisa el formato del JSON

Etiquetas​

MensajeCausaSolución
Guia no encontradaNúmero inválidoVerifica el número de guía
Error al generar la etiquetaError internoContacta soporte

Permisos​

MensajeCausaSolución
No tiene permiso para realizar esta accionFalta permisoSolicita el permiso necesario
Acceso denegadoSin autorizaciónVerifica tus permisos asignados

Permisos Requeridos​

EndpointPermiso
POST /guias/crearguias.create
GET /guias/validar-destino/*guias.read
GET /guias/etiqueta/*guias.read
GET /guias/etiqueta-pequena/*guias.read
GET /sucursales/*guias.read
consejo

Si recibes errores de permisos, consulta tus permisos actuales en GET /api/apipermissions/my-permissions