Errores

Envía siempre Accept: application/json. Los mensajes pueden variar; identifica el tipo de error por su código HTTP.

Código	Significado	Acción
401	Credenciales ausentes o incorrectas.	Verifica ambas cabeceras.
403	Acceso o autorización denegados.	Revisa la credencial, IP, empresa y permisos de la operación.
404	Ruta o recurso no encontrado.	Revisa la URL y los identificadores.
422	Datos que no superan la validación.	Corrige los campos indicados.
429	Límite de solicitudes excedido.	Respeta Retry-After.
500	Error del servidor.	Conserva el contexto de la solicitud para reportarlo; evita duplicar ventas.

Credenciales ausentes

Ejemplo de respuesta 401:

{
  "message": "Missing credentials. Please provide X-Api-Key and X-Api-Secret headers."
}

Validación

Ejemplo ilustrativo de respuesta 422, una vez autorizada la operación:

{
  "message": "The issue date field is required.",
  "errors": {
    "issue_date": ["The issue date field is required."]
  }
}

Los textos dependen del idioma configurado en el servidor y las reglas de cada campo. No todos los errores incluyen errors.