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

# Consultar un contribuyente

> Obtén la razón social, los domicilios y los datos fiscales de un contribuyente a partir de su RUT o CUIT.

Antes de emitir, puedes completar los datos del receptor consultándolos en el padrón del ente tributario: el del **SII** en Chile y el **padrón A5 de ARCA** (constancia de inscripción) en Argentina.

```bash theme={null}
curl "https://api.emify.co/api/taxpayers/AR/20111111112" \
  -H "X-Api-Key: tu_api_key"
```

| País | `country` | `documentNumber` |
| - | - | - |
| Chile | `CL` | RUT con guion: `76354771-9` |
| Argentina | `AR` | CUIT con o sin guiones: `20111111112` o `20-11111111-2` |

El código de país es ISO 3166-1 alfa-2 y no distingue mayúsculas. Cualquier otro país responde `400`.

## Qué devuelve

La respuesta tiene la misma forma para todos los países. Lo que el padrón de un país no informa viene en `null`.

| Campo | Chile | Argentina |
| - | - | - |
| `document_number` | RUT tal como está en el padrón | CUIT de 11 dígitos, sin guiones |
| `legal_name` | Razón social | Razón social; en una persona física, `APELLIDO NOMBRE` |
| `primary_activity`, `activities` | Actividades económicas | `null` |
| `email` | Casilla de intercambio de DTE | `null` |
| `address` | Domicilio con los campos de `recipient.address` | El domicilio **fiscal**, con los campos de `recipient.address` |
| `addresses` | `null` | Todos los domicilios que publica el padrón |
| `taxes` | `null` | Impuestos en los que está inscripto hoy |
| `tax_condition` | `null` | Condición IVA: `RI`, `EX`, `MT` o `NAL`, o `null` si no se puede determinar |

`address` tiene los mismos campos que `recipient.address` al [emitir](https://docs.emify.co/guias/emitir-comprobante.md), con el mismo significado:

| Campo | Chile | Argentina |
| - | - | - |
| `address` | Calle y número en una línea; block, departamento y villa siguen separados por coma | Calle, número y unidad, tal como los publica ARCA |
| `city` | **Comuna** | Localidad. En la Ciudad de Buenos Aires el padrón no la informa y viene en `null` |
| `state` | Código ISO 3166-2 de la región (`CL-RM`) | Código ISO 3166-2 de la provincia (`AR-Q`) |
| `country` | `CL` | `AR` |

Si el padrón no permite determinar la región o la provincia, `state` viene en `null`.

```json Chile theme={null}
{
  "document_number": "76354771-9",
  "legal_name": "EMPRESA EJEMPLO SPA",
  "primary_activity": "VENTA AL POR MAYOR NO ESPECIALIZADA",
  "activities": ["VENTA AL POR MAYOR NO ESPECIALIZADA"],
  "email": "FacturacionMIPYME@sii.cl",
  "address": { "address": "AV PROVIDENCIA 1234, OFICINA 501", "city": "LAS CONDES", "state": "CL-RM", "country": "CL" },
  "addresses": null,
  "taxes": null,
  "tax_condition": null
}
```

```json Argentina theme={null}
{
  "document_number": "20111111112",
  "legal_name": "PEREZ JUAN",
  "primary_activity": null,
  "activities": null,
  "email": null,
  "address": { "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "country": "AR" },
  "addresses": [
    { "type": "FISCAL", "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "postal_code": "8371" }
  ],
  "taxes": [
    { "code": "30", "description": "IVA" }
  ],
  "tax_condition": "RI"
}
```

> [!NOTE]
>
> En Argentina, `taxes` lista **solo los impuestos activos**. Un impuesto dado de baja, exento o en trámite no aparece.

> [!WARNING]
>
> En Chile, `email` es la casilla donde el contribuyente **recibe documentos electrónicos**, no un correo de contacto comercial. Suele ser la casilla del portal gratuito del SII o la de su proveedor de facturación, y la comparten miles de contribuyentes. Por eso no está dentro de `address`: `recipient.address.email` es un correo de contacto.

## Usar el resultado para emitir

El resultado se copia al `recipient` de la [factura](https://docs.emify.co/guias/emitir-comprobante.md) sin traducir nombres ni códigos:

* `address` va entero en `recipient.address`.
* En Argentina, `tax_condition` va en `recipient.tax_information.tax_condition`.

```json theme={null}
"recipient": {
  "legal_name": "PEREZ JUAN",
  "document_type": "CUIT",
  "document_number": "20111111112",
  "address": { "address": "LAGUNA LOS SAUCES 2", "city": "JUNIN DE LOS ANDES", "state": "AR-Q", "country": "AR" },
  "tax_information": { "tax_condition": "RI" }
}
```

`tax_condition` se deduce de los impuestos activos del padrón:

| Impuesto activo | `tax_condition` |
| - | - |
| `30` IVA | `RI` |
| `32` IVA EXENTO | `EX` |
| `20` MONOTRIBUTO | `MT` |
| `34` IVA NO ALCANZADO | `NAL` |
| Ninguno de los cuatro, o más de uno | `null` |

> [!NOTE]
>
> `tax_condition` es un punto de partida, no la condición declarada. ARCA la registra junto al CAE y no se puede corregir después, así que confírmala antes de emitir. El padrón no permite distinguir a un monotributista social o promovido: se informan como `MT`. Cuando el padrón no permite deducir la condición, el valor es `null` y no `CF`.

## Antigüedad de los datos

Los datos pueden tener **hasta 7 días de antigüedad**. Emify guarda la respuesta del padrón y no vuelve a consultar al ente tributario por ese contribuyente hasta que pasa una semana. Si un contribuyente cambió su domicilio o se inscribió en un impuesto en los últimos días, puede que todavía no se vea.

## Errores

| Código HTTP | `code` | Qué significa |
| - | - | - |
| `400` | `UNSUPPORTED_COUNTRY` | El país no se puede consultar |
| `404` | `TAXPAYER_NOT_FOUND` | El padrón no tiene ese contribuyente, o el CUIT tiene el dígito verificador mal |
| `503` | `TAXPAYER_LOOKUP_UNAVAILABLE` | El padrón del ente tributario no está disponible. Puedes reintentar más tarde |


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