> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SUNAT

> Consulta información de contribuyentes peruanos (RUC) por RUC, documento de identidad o nombre.

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

```bash theme={"dark"}
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.                                       |

```bash theme={"dark"}
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. |

```bash theme={"dark"}
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`.

<Note>
  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`.
</Note>

<Note>
  Estas consultas pueden tardar más que una solicitud típica. Son
  [trabajos asíncronos](/es/async-jobs). Por defecto la solicitud espera en línea y devuelve
  `{ data }`, o puedes hacer polling / usar un `callback_url`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>