Códigos de Error

Lista de códigos de error y su significado para ayudarte a diagnosticar problemas.

400 Bad Request

La solicitud contiene datos inválidos o incompletos.

{
  "status": "error",
  "msg": "Campo requerido: id"
}
401 Unauthorized

Token de autenticación inválido o ausente.

{
  "status": "error",
  "msg": "Invalid token"
}
403 Forbidden

No tienes permisos para acceder a este recurso.

{
  "status": "error",
  "msg": "Scope read requerido"
}
404 Not Found

El recurso solicitado no existe.

{
  "status": "error",
  "msg": "Partner not found"
}
500 Internal Server Error

Error interno del servidor. Contacta soporte si persiste.

{
  "status": "error",
  "msg": "DB error: internal detail"
}

Notas

PuntoDetalle
EnvelopeLa API v1 usa status/msg para errores, no un campo error aislado
ScopesLos errores 403 suelen venir de scopes insuficientes: read, write o admin
ValidaciónLos campos requeridos se validan por endpoint y suelen devolver 400 con un mensaje directo
RecursosLos detalles de estaciones, socios, certificados y mensajes devuelven 404 si el recurso no existe en el sitio actual
Message IDsUse numeric id for /messages/detail and /messages/download. The business message_as2_id is not accepted there.
Station / partner match{"status":"error","msg":"Station does not match partner"} if you send a station context that does not belong to the selected partner.

Soporte

Si encuentras errores no documentados o necesitas ayuda:

  • Email: soporte@as2expert.com
  • Portal: https://www.as2expert.com
  • Dashboard: https://free.as2expert.com