Errores

Las respuestas usan un envelope JSON.

{
  "success": false,
  "error": "Validation Error",
  "errors": {
    "id_external": ["The id external field is required."]
  }
}

Codigos comunes

Status	Significado
200	Recurso existente devuelto o actualizado.
201	Recurso aceptado o creado.
400	La operacion de negocio fallo.
401	Error de autenticacion.
403	La clave autenticada no puede acceder al contexto de negocio.
404	Recurso o endpoint soportado no encontrado.
422	Fallo de validacion o cuota de facturas superada.
500	Error inesperado del servidor.
503	Respuesta temporal de proteccion del servicio. Respeta Retry-After si aparece.

Trata los 422 como errores de negocio que requieren cambiar el payload o la cuenta antes de reintentar.