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

# Tipos de documento y datos de referencia

> Cómo obtener los tipos de documento válidos y los catálogos de referencia por país.

Los documentos que emites (facturas, boletas, notas de crédito y débito, documentos de exportación) y los datos que los componen dependen del **país** de la empresa emisora. Emify expone endpoints de referencia que devuelven los valores válidos para cada país, y son la fuente que debes usar para construir un documento correcto.

Actualmente el único país disponible es **Chile** (`CL`). Los endpoints de referencia ya reciben el país como parámetro, de modo que tu integración seguirá funcionando cuando Emify sume nuevos países.

## Consultar por país

Los endpoints de referencia reciben el país como parámetro. Por ejemplo, para listar los tipos de documento válidos en Chile:

```bash theme={null}
curl "https://api.emify.co/api/document-types?country=CL" \
  -H "X-Api-Key: tu_api_key"
```

Consulta los países disponibles con `GET /api/countries`.

## Catálogos de referencia

Usa estos endpoints para poblar y validar los campos de un documento antes de emitirlo:

| Catálogo                      | Endpoint                                 | Para qué sirve                                         |
| ----------------------------- | ---------------------------------------- | ------------------------------------------------------ |
| Tipos de documento            | `GET /api/document-types`                | Factura, boleta, notas, exportación válidos en el país |
| Monedas                       | `GET /api/currencies`                    | Monedas admitidas                                      |
| Unidades de medida            | `GET /api/measurement-units`             | Unidades para los ítems                                |
| Actividades / giros           | `GET /api/legal_activities`              | Giro de la empresa                                     |
| Tipos de persona              | `GET /api/legal-entities`                | Persona jurídica / natural                             |
| Documentos de identificación  | `GET /api/tax-identification-documents`  | RUT, CUIT, etc.                                        |
| Tipos de impuesto             | `GET /api/tax-types`                     | Impuestos aplicables                                   |
| Formas de pago                | `GET /api/payment-types`                 | Métodos de pago                                        |
| Razones de anulación          | `GET /api/document-cancellation-reasons` | Motivos para anular                                    |
| Info adicional de exportación | `GET /api/additional-export-info`        | Campos para exportación                                |

<Tip>
  No hardcodees estos valores. Cámbialos según el país de la empresa consultando el endpoint correspondiente; así tu integración sigue funcionando cuando Emify agrega tipos o países nuevos.
</Tip>

## Tipos de documento en Chile

El endpoint `document-types?country=CL` devuelve los tipos vigentes. Los más habituales, y el `invoice_type` que usas al emitir:

| Documento                   | `invoice_type` |
| --------------------------- | -------------- |
| Factura electrónica         | `FCE`          |
| Factura electrónica exenta  | `FCEE`         |
| Boleta electrónica          | `BOL`          |
| Nota de crédito electrónica | `NCV`          |
| Nota de débito electrónica  | `NDV`          |

## Impuestos en Chile

Los ítems y totales llevan impuestos identificados por `type`, tomados del catálogo `tax-types`. Ejemplos frecuentes en Chile:

| `type`        | Descripción            |
| ------------- | ---------------------- |
| `CL_GRAV_BAS` | Gravado con IVA (19%). |
| `CL_EX_IVA`   | Exento de IVA.         |

## Razones de anulación

Al emitir una nota de crédito o débito que anula o corrige otro documento, indica el motivo en `reason_code`:

| `reason_code` | Descripción                       |
| ------------- | --------------------------------- |
| `MON`         | Corrige montos.                   |
| `TEX`         | Corrige texto de la referencia.   |
| `ANU`         | Anula el documento de referencia. |

## Consultar un contribuyente

Puedes verificar los datos de un contribuyente por su documento tributario:

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