> ## 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 en SUNAT por RUC, documento de identidad o nombre: datos de registro, estado, domicilio y condición.

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": "12345678" }'
```

## 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. |
| `name` | Razón social o nombre completo. |
| `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 (`yyyy-mm-dd`). |
| `status` | Estado (por ejemplo, `ACTIVO`, `BAJA DE OFICIO`). |
| `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>
  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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.