Errores

Qué significa cada código, qué devuelve la API y cuándo merece la pena reintentar.

Cuando algo falla, errorCode y el estado HTTP lo indican, y errorMsg describe el motivo (los errores de los endpoints llegan como "Error on service call: …"):

Código	Cuándo
`400`	Cuerpo JSON malformado o parámetro inválido.
`401`	Credenciales inválidas: token inexistente, secret incorrecta o clave revocada. `errorMsg` = "Invalid API credentials".
`403`	El plan de la cuenta ya no da acceso a la API: hace falta Advanced o Premium con el extra de IA (Tier 1 o superior). Ver Límites de uso.
`404`	El endpoint no existe. `errorMsg` = "Service does not exist".
`422`	Validación de negocio (por ejemplo, "Cliente no encontrado.").
`429`	Ritmo excedido. La petición no se ha ejecutado: espera lo que diga la cabecera `Retry-After` y reintenta. Ver Límites de uso.
`500`	Error interno o validación genérica del endpoint (el detalle llega en `errorMsg`).

Además, algunos endpoints devuelven errores de negocio dentro del propio data (una cadena que empieza por Error: o un objeto {"msg": "…", "error": "error"}). Cada ficha de endpoint documenta sus casos.

401 · application/json

{
  "errorCode": 401,
  "errorMsg": "Invalid API credentials",
  "data": null
}