Skip to main content
Los documentos tributarios llevan una numeración autorizada por el ente tributario. En Chile, esa autorización se materializa en un CAF (Código de Asignación de Folios): un archivo que autoriza a la empresa a emitir un rango de folios para un tipo de documento determinado.

​
Cómo funciona la numeración

Cada tipo de documento (factura, boleta, nota de crédito, etc.) consume folios de su propio rango autorizado. Cuando Emify emite un documento, le asigna el siguiente folio disponible del rango correspondiente. Cuando un rango se agota, necesitas obtener uno nuevo.
Emify puede solicitar los folios (CAF) al ente tributario en nombre de la empresa, o puedes subir un archivo de folios que ya obtuviste.

​
Gestión de folios

​
Anular folios

En Chile, este endpoint solicita la anulación al SII y marca los folios confirmados como anulados en Emify para impedir su uso en futuras emisiones. Necesitas un certificado digital activo asociado a la empresa.
Todos los campos son obligatorios. id_document_type es el código de Emify, por ejemplo FCE, no el código numérico del SII. reason indica el motivo de anulación y no puede estar vacío. El rango incluye ambos extremos; los folios deben ser positivos y from debe ser menor o igual a to. Para anular un solo folio, envía el mismo número en ambos campos. Emify envía al SII únicamente los folios disponibles dentro de los CAF activos cargados. Omite los usados, reservados y previamente anulados. Si el rango cruza varios CAF o contiene huecos, procesa los tramos disponibles; no exige que todo el rango esté cubierto. Esta operación anula folios, no documentos emitidos.
voided_count cuenta los folios anulados en esta solicitud. skipped_count cuenta los folios cargados que ya estaban usados, reservados o anulados; no incluye huecos sin CAF. Si todos los folios cargados del rango están en esos estados, devuelve 200 con cero anulados sin solicitar una nueva anulación al SII.
Si un tramo se confirma y otro falla, las anulaciones confirmadas se conservan en Emify. El campo details de la respuesta de error indica los tramos confirmados y el tramo que no pudo confirmarse. Ante un fallo de comunicación, consulta el SII antes de reintentar: la anulación puede haberse realizado allí aunque Emify no haya recibido la respuesta.
La versión de backoffice usa PUT /backoffice/companies/{company_id}/enumeration/void, recibe el mismo cuerpo y requiere Authorization: Bearer <JWT>. En otros países se conserva la anulación local en Emify.

​
Setear el próximo folio a usar

Si vienes facturando con otro sistema, indica desde qué número debe continuar cada tipo de documento para respetar la correlatividad. Si omites este paso, la numeración arranca en el folio disponible más bajo del rango cargado. El ajuste es global por tipo de documento: al setear el próximo folio, Emify marca como usados todos los folios menores al número enviado a lo largo de todos los CAF activos de ese tipo de documento.
El document_type_id es el id_document_type que devuelve enumeration/list para cada tipo de documento. La respuesta confirma el resultado:
next_number_to_use es el folio que efectivamente se usará en la próxima emisión. Puede ser mayor que el next_folio_number que enviaste cuando ese folio, aunque pertenece a un CAF cargado, ya está usado o anulado: en ese caso Emify resuelve al siguiente folio disponible dentro de los rangos cargados.
El next_folio_number debe caer dentro del rango de algún CAF efectivamente cargado (un CAF activo donde enumeration_from <= N <= enumeration_end). Si queda fuera de todos los rangos cargados, o en un hueco entre CAF no contiguos, la API responde 400 con código ENUMERATION_OUT_OF_RANGE; no se redirige a otro folio. Si el número cae dentro de un rango cargado pero no hay folios disponibles mayores o iguales a él, responde 400 con ENUMERATION_NO_FOLIOS_AVAILABLE_FROM y no modifica nada. Si el tipo de documento no tiene enumeraciones activas, responde 404 con ENUMERATION_NOT_FOUND.

​
Evitar quedarte sin folios

Un rango de folios agotado detiene la emisión de ese tipo de documento. Para evitar interrupciones:
1

Monitorea el consumo

Consulta enumeration/list para ver cuántos folios quedan disponibles por tipo de documento.
2

Solicita con anticipación

Re-solicita o sube nuevos folios antes de agotar el rango vigente.
3

Suscríbete al evento ENU

Configura el webhook del evento ENU para recibir avisos de baja disponibilidad o vencimiento de folios.