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:

1. Certificado digital

   El certificado con el que Emify firma los documentos en nombre de la empresa. Ver Certificados digitales.

2. Folios (CAF)

   El rango de numeración autorizado por el ente tributario para cada tipo de documento. Ver Folios.

3. Configuración de emisión

   Los parámetros operativos de la empresa (settings).

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.

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.

Tienes dos formas de conocer el resultado:

Webhooks (recomendado)

Emify te notifica cuando el documento cambia de estado. No necesitas consultar.

Consulta por estado (polling)

Consultas el documento periódicamente hasta que alcanza un estado final.

El ciclo de vida de un 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).

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.