Saltar al contenido

Referencia / SUNAT

Consulta de RUC

Ficha completa del contribuyente: razón social, estado, condición, domicilio fiscal, actividades económicas y padrones.

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

Para qué sirve: Rellenar los datos de un cliente nuevo a partir de su RUC, sin que los escriba a mano.

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.

Parámetros de ruta

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

Respuesta

Campos principales que devuelve esta consulta:

  • nombre_o_razon_social
  • estado y condicion
  • direccion y ubigeo
  • actividades_economicas
  • sistema_emision_electronica
  • es_buen_contribuyente
  • es_agente_de_retencion

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é.