SUNAT

Resuelve información de contribuyentes peruanos desde SUNAT. Tres consultas reflejan las pestañas de búsqueda de la propia SUNAT: por RUC, por documento de identidad y por nombre (razón social). Las dos primeras devuelven el registro completo de un contribuyente; la búsqueda por nombre devuelve una lista de coincidencias.

Por RUC

POST /pe/sunat/ruc/v1

Campo	Tipo	Notas
`ruc`	string	Obligatorio. RUC de 11 dígitos.

curl https://api.croma.run/pe/sunat/ruc/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruc": "20100070970" }'

Por documento

POST /pe/sunat/document/v1

Campo	Tipo	Notas
`document_type`	string	Uno de `dni`, `ce` (carné de extranjería), `passport`, `diplomatic`. Por defecto es `dni`.
`document_number`	string	Obligatorio. De 6 a 16 caracteres alfanuméricos.

curl https://api.croma.run/pe/sunat/document/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "dni", "document_number": "74849152" }'

Por nombre

POST /pe/sunat/name/v1

Campo	Tipo	Notas
`name`	string	Obligatorio. Nombre o razón social, de 3 a 100 caracteres.

curl https://api.croma.run/pe/sunat/name/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "INVERSIONES GENERALES" }'

La búsqueda por nombre devuelve hasta 30 coincidencias (el límite de SUNAT). Cuando capped es true los resultados están incompletos: afina la consulta o consulta directamente el RUC elegido.

Respuesta

Las consultas por RUC y por documento devuelven un registro de contribuyente.

Campo	Notas
`found`	`true` cuando coincide un contribuyente; `false` cuando SUNAT no tiene ninguno (los demás campos quedan entonces en null/vacío).
`ruc`	El RUC de 11 dígitos.
`taxpayer_name`	Razón social o nombre completo.
`taxpayer_type`	Por ejemplo, `SOCIEDAD ANONIMA`, `PERSONA NATURAL SIN NEGOCIO`.
`document_type`, `document_number`	Documento de identidad subyacente (personas naturales).
`trade_name`	Nombre comercial, si lo hay.
`registration_date`, `activities_start_date`	Fecha de inscripción / inicio de actividades (`dd/mm/yyyy`).
`taxpayer_status`	Estado (por ejemplo, `ACTIVO`, `BAJA DE OFICIO`).
`taxpayer_condition`	Condición (por ejemplo, `HABIDO`).
`fiscal_address`	Domicilio fiscal.
`emission_system`, `accounting_system`	Sistema de emisión / contabilidad.
`foreign_trade_activity`	Actividad de comercio exterior.
`economic_activities`	Lista de actividades CIIU (principal y secundarias).
`payment_vouchers`	Comprobantes de pago autorizados.
`electronic_emission_systems`, `electronic_vouchers`, `electronic_emitter_since`	Detalles de facturación electrónica.
`ple_affiliated_since`	Afiliado al PLE desde.
`registries`	Padrones a los que pertenece el contribuyente.

La consulta por nombre devuelve query, count, capped y contributors[], cada uno con ruc, name, location y status.

El antiguo POST /pe/sunat/taxpayers/v1 (RUC/DNI combinados según la longitud del documento) todavía funciona, pero está obsoleto. Prefiere /pe/sunat/ruc o /pe/sunat/document.

Estas consultas pueden tardar más que una solicitud típica. Son trabajos asíncronos. Por defecto la solicitud espera en línea y devuelve { data }, o puedes hacer polling / usar un callback_url.

Referencia completa

Esquemas, campos de respuesta y un playground interactivo.

Primeros pasos

Colombia

Perú

Global

Por RUC

Por documento

Por nombre

Respuesta

Referencia completa

​Por RUC

​Por documento

​Por nombre

​Respuesta

Referencia completa

Por RUC

Por documento

Por nombre

Respuesta