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:
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:
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.
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:
Impuestos en Chile
Los ítems y totales llevan impuestos identificados por type, tomados del catálogo tax-types. Ejemplos frecuentes en Chile:
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:
Consultar un contribuyente
Puedes verificar los datos de un contribuyente por su documento tributario:
