Errores

La API usa códigos HTTP para indicar éxito o error. El detalle se informa en el cuerpo de la respuesta.

Códigos comunes

Código	Descripción
200	Respuesta exitosa.
400	La solicitud tiene un error. Revisar el cuerpo de la respuesta.
401	No autenticado o token expirado.
500	Error no controlado.

Error de request inválido

{
  "tipo": "invalid_request",
  "tipo_codigo": 400,
  "detalle": "Los campos username y password no pueden estar vacíos."
}

Error con detalle por parámetro

{
  "tipo": "invalid_request",
  "tipo_codigo": 400,
  "detalle": {
    "parametro": "refresh_token_expire_time",
    "errores": [
      "Debe ser igual o mayor a 10 minutos."
    ]
  }
}

Creación rechazada por empresa suspendida

Este error corresponde a nuevas creaciones mediante POST /comprobantes/crear cuando la empresa emisora está suspendida. La respuesta conserva el formato de reportes de ese endpoint: un array de objetos, sin campos nuevos. No debe confundirse con los ejemplos de invalid_request anteriores.

HTTP/1.1 400 Bad Request

[
  {
    "tipo": "Error",
    "tipo_codigo": 2,
    "detalle": "Empresa suspendida, comuníquese con Cuentas Corrientes, 091 777 774 o al correo cuentascorrientes@surtec.com.uy"
  }
]

• detalle contiene el mensaje configurado para la suspensión y puede variar. Si no hay un mensaje configurado, devuelve La empresa está suspendida y no puede crear comprobantes.
• tipo_codigo = 2 indica severidad de error: no es el código HTTP ni un identificador exclusivo de suspensión. No se agrega un código de negocio específico.
• Mostrá el mensaje al usuario y evitá reintentar automáticamente la creación mientras continúe la suspensión. El texto de detalle no es un identificador estable para automatizar decisiones.

Los reintentos con un id_externo que corresponde a un comprobante existente de la misma empresa emisora conservan su respuesta, sin crear otro comprobante. Consultá la regla de suspensión e idempotencia.

Errores de autenticación

• 401 suele indicar token expirado, inválido o ausente.
• Si el token pertenece a otro ambiente, la solicitud también va a fallar.
• Verificá Authorization y X-Emisor antes de asumir un problema funcional del endpoint.