Saltar al contenido

Referencia / SUNAT

Deuda coactiva

Deuda en cobranza coactiva registrada para un RUC.

GET /api/sunat/consulta-deuda-coactiva/{ruc}

Para qué sirve: Evaluar el riesgo de un proveedor nuevo antes de darle crédito.

Autenticación

X-API-Key string cabecera requerido
X-API-Key: tu_token
Authorization string cabecera
Authorization: Bearer tu_token

Cualquiera de las dos sirve. El token se genera desde el panel de cliente. Ir al panel →

Parámetros de ruta

ruc string requerido
RUC de 11 dígitos. Ejemplo: 20123456789

Respuesta

Campos principales que devuelve esta consulta:

  • razon_social
  • mensaje
  • deudas[]

Códigos de estado

200 OK
Consulta resuelta. Descuenta una petición del plan.
401 Token inválido o vencido
Falta la cabecera de autenticación o el token no es válido.
403 Sin acceso
El plan no cubre este servicio o la suscripción no está activa.
404 No encontrado
La consulta se ejecutó pero no hubo resultados. También descuenta.
429 Límite alcanzado
Se agotaron las consultas del período.
500 Error del servicio
Fallo al consultar la fuente oficial. No se guarda en caché.