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

# Cómo funciona Emify

> Modelo conceptual de la plataforma: empresas, documentos, entes tributarios y emisión asíncrona.

Emify actúa como intermediario entre tu sistema y el ente tributario de cada país (el SII en Chile, entre otros). Tu sistema envía un documento a la API; Emify lo transforma al formato tributario oficial, lo firma con el certificado digital de la empresa emisora, lo remite al ente tributario y te devuelve el resultado.

## Modelo de recursos

Todo en la API cuelga de una **empresa** (`company`). Una empresa es la entidad que emite documentos ante el ente tributario, e identifica al contribuyente por su documento tributario (RUT en Chile, CUIT en Argentina, RUT en Uruguay).

```
Empresa (company)
├── Certificado digital        → firma los documentos
├── Folios / CAF               → numeración autorizada por el ente tributario
├── Configuración (settings)   → parámetros de emisión
├── Webhooks                   → notificaciones de eventos
└── Documentos (invoices)      → facturas, boletas, notas emitidas
```

Casi todas las rutas de la API incluyen el `company_id` en el path, por ejemplo
`/api/companies/{company_id}/invoices`. Tu API key determina a qué empresas puedes acceder.

## Requisitos para emitir

Antes de emitir un documento, la empresa necesita tres cosas configuradas:

<Steps>
  <Step title="Certificado digital">
    El certificado con el que Emify firma los documentos en nombre de la empresa. Ver [Certificados digitales](/guias/certificados-digitales).
  </Step>

  <Step title="Folios (CAF)">
    El rango de numeración autorizado por el ente tributario para cada tipo de documento. Ver [Folios](/guias/folios).
  </Step>

  <Step title="Configuración de emisión">
    Los parámetros operativos de la empresa (`settings`).
  </Step>
</Steps>

## La emisión es asíncrona

Emitir un documento **no es instantáneo**. Cuando llamas a `POST /api/companies/{company_id}/invoices`, Emify acepta el documento y comienza a procesarlo: lo genera, lo firma y lo envía al ente tributario. Ese envío y su respuesta ocurren en segundo plano.

<Info>
  La respuesta inmediata confirma que el documento fue **recibido** y te da su identificador. El estado final (aceptado o rechazado por el ente tributario) llega después.
</Info>

Tienes dos formas de conocer el resultado:

<Columns cols={2}>
  <Card title="Webhooks (recomendado)" icon="webhook" href="/esenciales/webhooks">
    Emify te notifica cuando el documento cambia de estado. No necesitas consultar.
  </Card>

  <Card title="Consulta por estado (polling)" icon="rotate-cw" href="/guias/ciclo-de-vida-documento">
    Consultas el documento periódicamente hasta que alcanza un estado final.
  </Card>
</Columns>

El [ciclo de vida de un documento](/guias/ciclo-de-vida-documento) explica los estados por los que pasa.

## Cobertura por país

Actualmente Emify opera en **Chile** (SII). Nuevos países se incorporarán más adelante.

La API abstrae las diferencias entre entes tributarios detrás de un modelo común, pero las reglas, los tipos de documento y los datos requeridos varían según el país de la empresa emisora. Los endpoints de referencia (tipos de documento, monedas, actividades, unidades de medida, etc.) devuelven los valores válidos **para un país determinado**, identificado con su código ISO (`CL` para Chile).

<Tip>
  Consulta siempre los endpoints de referencia del país de la empresa antes de construir un documento. Cuando Emify sume nuevos países, un tipo de documento o una unidad de medida válidos en Chile pueden no existir en otro país.
</Tip>