Ciclo de vida de un documento

Como la emisión es asíncrona, un documento pasa por varios estados desde que lo envías hasta que el ente tributario lo acepta o lo rechaza. Un rechazo no es el final del camino: podés corregir el documento y reemitirlo sobre el mismo folio, sin quemar uno nuevo.

Flujo general

Recepción

Envías el documento con POST /api/companies/{company_id}/invoices. Emify lo valida y lo acepta para procesamiento. La respuesta incluye el id del documento.

Procesamiento

Emify genera el documento tributario, lo firma con el certificado de la empresa y lo remite al ente tributario. Este paso ocurre en segundo plano.

Resolución

El ente tributario acepta o rechaza el documento. Emify actualiza el estado y emite el evento de webhook correspondiente.

Corrección (solo si hubo rechazo)

Si el documento fue rechazado, podés corregirlo y reemitirlo sobre el mismo folio. El documento se vuelve a firmar y a enviar, y el ciclo se repite desde el procesamiento. Ver Corregir un documento rechazado.

Estados

Un documento expone dos estados complementarios:

status — dónde está el documento dentro del procesamiento de Emify.
fiscal_status — el veredicto del ente tributario sobre el documento.

Estado de procesamiento (`status`)

Valor	Significado
`PEN`	Pendiente. El documento fue recibido y aún no se procesa.
`SIG`	Firmado. Emify ya generó y firmó el documento; su XML y PDF ya están disponibles. Todavía no fue enviado al ente tributario.
`RUN`	En proceso. Emify lo está enviando al ente tributario.
`APR`	Aprobado por el ente tributario.
`EML`	Notificación por email enviada al receptor.
`WHK`	Notificación por webhook despachada a tu sistema.
`ERR`	Error o rechazo durante el procesamiento. No siempre es final: un documento rechazado puede corregirse y reemitirse sobre el mismo folio, y ahí vuelve a `SIG` → `RUN`.

En los mercados donde el documento se firma de forma síncrona al crearlo (como Chile), la respuesta de creación ya devuelve SIG y las representaciones (XML/PDF) quedan disponibles de inmediato, sin esperar la respuesta del ente tributario. En otros mercados el documento arranca en PEN.

Estado fiscal (`fiscal_status`)

Refleja la respuesta del ente tributario. Cuando hay un rechazo u objeción, el motivo llega en fiscal_status_reason.

Valor	Significado
`PENDING`	Sin respuesta aún del ente tributario.
`ACCEPTED`	Aceptado por el ente tributario.
`REJECTED`	Rechazado por el ente tributario. Se puede corregir y reemitir.
`OBJECTED`	Aceptado con reparos (objetado). El documento existe y es válido: se corrige con una nota, no reemitiéndolo.

Un documento aceptado incluye además los identificadores que asigna el ente tributario: track_id (seguimiento en el SII), cae y cae_expiration_date (código de autorización y su vencimiento) y qr_code.

La fuente de verdad sobre los cambios de estado son los eventos de webhook. Consulta GET /api/companies/{company_id}/webhooks/events para ver el catálogo de eventos disponibles.

Corregir un documento rechazado

Un documento que el ente tributario rechazó no tiene validez tributaria: el folio que consumió nunca respaldó un documento válido. En vez de emitir de nuevo con un folio nuevo —y dejar el rechazado quemado, con un salto en tu numeración que después hay que justificar—, podés corregir el contenido y reemitirlo sobre el mismo folio.

Reemitir sobrescribe el documento: el contenido corregido reemplaza al anterior bajo el mismo folio, y el XML y el PDF que hayas descargado del intento rechazado quedan obsoletos.Por eso la operación exige confirm_folio_reuse: true. Emify no puede saber si el documento anterior llegó a circular ni si el folio es realmente reutilizable —hay rechazos, como folio no autorizado o folio anulado, donde no lo es—: esa afirmación la hace tu sistema, y queda registrada.

Cuándo se puede

Situación del documento	¿Reemitible?
Rechazado por el ente tributario (`ERR` + `REJECTED`)	Sí
Falló antes de llegar al ente tributario (`ERR`, sin `track_id`)	Sí
Aceptado (`APR` / `EML` / `WHK`)	No — se corrige con una nota de crédito o débito
Aceptado con reparos (`OBJECTED`)	No — el documento existe y es válido
En proceso (`PEN` / `SIG` / `RUN`)	No — todavía puede terminar aceptado
Anulado	No — la anulación es un acto deliberado, no un rechazo

Además, la reemisión es exclusiva de los mercados donde el número sale de un rango de folios autorizado localmente (como Chile). Donde el número lo autoriza el organismo en el momento de emitir, no hay folio que reutilizar.

Cómo se hace

El cuerpo es el documento corregido completo, con la misma forma y las mismas validaciones que la emisión, más confirm_folio_reuse. El documento a reemitir se identifica por la terna company_id + invoice_type (ambos en el cuerpo) + folio (path). Un folio no es único por sí solo: el mismo número puede existir para una boleta y para una factura de la misma empresa, así que el tipo lo define el contenido que enviás.

Un error en invoice_type no da error: apunta a otro documento real con ese mismo folio y lo sobrescribe. Verificá que el tipo del cuerpo sea el del documento que querés corregir.

curl -X POST "https://api.emify.co/api/invoices/1122/reissue" \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "{company_id}",
    "invoice_type": "FCE",
    "confirm_folio_reuse": true,
    "branch_office": 1,
    "invoice_date": "2026-09-14T10:00:00",
    "recipient": { "...": "datos corregidos" },
    "items": [ { "...": "ítems corregidos" } ],
    "totals": { "...": "totales corregidos" }
  }'

La respuesta confirma que el folio no cambió y en qué intento quedó el documento:

{
  "id": "a1b2c3d4e5f67890abcdef1234567890",
  "invoice_type": "FCE",
  "number": 1122,
  "status": "SIG",
  "attempt": 2
}

Qué cambia y qué no

Se conserva	Se reemplaza
El `id` del documento	Emisor, receptor, fechas, moneda y totales
El número de folio	Ítems, impuestos y referencias
El tipo de documento y la empresa	El XML firmado, el `track_id` y el estado fiscal del intento anterior

El folio nunca vuelve a estar disponible: sigue consumido por este mismo documento antes y después de la reemisión. El intento rechazado —con el XML que se firmó y la respuesta del ente tributario— queda archivado. Tras una reemisión el documento vuelve a SIG y arranca un envío nuevo, así que el ciclo de estados y los webhooks se comportan igual que en una emisión normal.

Errores

Todos cortan sin modificar nada: ni el documento, ni el folio, ni el estado.

Código	Qué pasó
`INVOICE_REISSUE_CONFIRMATION_REQUIRED`	Falta `confirm_folio_reuse: true`
`INVOICE_REISSUE_NOT_REJECTED`	El documento fue aceptado, o su emisión sigue en curso
`INVOICE_REISSUE_CANCELLED`	El documento fue anulado
`INVOICE_REISSUE_FOLIO_NOT_USED`	El folio nunca se consumió, o está anulado
`INVOICE_REISSUE_FOLIO_NOT_OWNED`	El folio no corresponde a ese documento
`INVOICE_REISSUE_CAF_UNAVAILABLE`	El rango autorizado que cubre el folio ya no está activo o vigente para firmar
`INVOICE_REISSUE_COUNTRY_INVALID`	El país no numera con folios locales

Saber si un documento fue reemitido

La consulta de estado informa cuántas veces se reemitió el documento y cuándo fue la última vez. Un documento nunca reemitido devuelve reissue_count: 0 y last_reissued_at: null.

{
  "status": "APR",
  "fiscal_status": "ACCEPTED",
  "reissue_count": 1,
  "last_reissued_at": "2026-09-14T10:00:00"
}

Sirve para detectar que la copia del XML o del PDF que tenés guardada corresponde a una versión anterior del mismo folio.

Cómo obtener el resultado

Con webhooks (recomendado)

Configura un webhook y Emify te notificará cada cambio de estado sin que tengas que consultar. Es la forma eficiente de integrar la emisión asíncrona.

Con polling

Si no usas webhooks, consulta el documento periódicamente hasta que alcance un estado final:

curl https://api.emify.co/api/companies/{company_id}/invoices/{invoice_id} \
  -H "X-Api-Key: tu_api_key"

Usa intervalos razonables (por ejemplo, con backoff) para no saturar la API. Los webhooks evitan el polling por completo.

Documentos emitidos

Desde que el documento está firmado (estado SIG en adelante) puedes obtener sus representaciones; no necesitas esperar a que el ente tributario lo acepte:

Recurso	Endpoint
XML firmado	`GET /api/companies/{company_id}/invoices/{invoice_id}/xml`
PDF (A4, 80mm, 58mm)	`POST /api/companies/{company_id}/invoices/{invoice_id}/download-pdf/{formato}`
PDF en Base64	`POST /api/companies/{company_id}/invoices/{invoice_id}/download-base64/{formato}`

Los formatos 80mm y 58mm corresponden a impresión en rollo (ticket); A4 a impresión en hoja.

Si solicitas el PDF o el XML mientras el documento todavía está en PEN (aún no firmado), el endpoint responde 404. Espera al estado SIG — vía webhook o polling — antes de pedir la representación.

Cómo funciona

Configuración de la empresa

Emisión y recepción

Ciclo de vida de un documento

Flujo general

Estados

Estado de procesamiento (`status`)

Estado fiscal (`fiscal_status`)

Corregir un documento rechazado

Cuándo se puede

Cómo se hace

Qué cambia y qué no

Errores

Saber si un documento fue reemitido

Cómo obtener el resultado

Con webhooks (recomendado)

Con polling

Documentos emitidos

​Flujo general

​Estados

​Estado de procesamiento (status)

​Estado fiscal (fiscal_status)

​Corregir un documento rechazado

​Cuándo se puede

​Cómo se hace

​Qué cambia y qué no

​Errores

​Saber si un documento fue reemitido

​Cómo obtener el resultado

​Con webhooks (recomendado)

​Con polling

​Documentos emitidos

Flujo general

Estados

Estado de procesamiento (`status`)

Estado fiscal (`fiscal_status`)

Corregir un documento rechazado

Cuándo se puede

Cómo se hace

Qué cambia y qué no

Errores

Saber si un documento fue reemitido

Cómo obtener el resultado

Con webhooks (recomendado)

Con polling

Documentos emitidos