Tipos de documento y datos de referencia

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 habilitado en producción es Chile (CL); Argentina está en camino (ver más abajo). 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:

curl "https://api.emify.co/api/document-types?country=CL" \
  -H "X-Api-Key: tu_api_key"

Consulta los países donde opera Emify con GET /api/countries. Esa lista no sirve para completar una dirección: los códigos de país, región y comuna que acepta un comprobante salen de los catálogos list-countries, list-regions y list-cities de la tabla siguiente.

Catálogos de referencia

Usa estos endpoints para poblar y validar los campos de un documento antes de emitirlo:

Catálogo	Endpoint	Para qué sirve
Tipos de documento	`GET /api/document-types`	Factura, boleta, notas, exportación válidos en el país
Monedas	`GET /api/currencies`	Monedas admitidas
Unidades de medida	`GET /api/measurement-units`	Unidades para los ítems
Actividades / giros	`GET /api/legal_activities`	Giro de la empresa
Tipos de persona	`GET /api/legal-entities`	Persona jurídica / natural
Documentos de identificación	`GET /api/tax-identification-documents`	RUT, CUIT, etc.
Tipos de impuesto	`GET /api/tax-types`	Impuestos aplicables, con su tasa y de dónde sale (`rate_source`)
Formas de pago	`GET /api/payment-types`	Métodos de pago
Razones de anulación	`GET /api/document-cancellation-reasons`	Motivos para anular
Info adicional de exportación	`GET /api/additional-export-info`	Campos para exportación
Países de dirección	`GET /api/list-countries`	Códigos válidos de `address.country` del emisor y del receptor
Regiones / provincias	`GET /api/list-regions`	Códigos ISO 3166-2 válidos de `address.state`
Ciudades / comunas	`GET /api/list-cities`	Comunas de Chile, con la región a la que pertenecen (`id_list_region` es el `id` de `list-regions`)

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:

Documento	`invoice_type`
Factura electrónica	`FCE`
Factura electrónica exenta	`FCEE`
Boleta electrónica	`BOL`
Nota de crédito electrónica	`NCV`
Nota de débito electrónica	`NDV`
Factura de compra electrónica	`FCO`

Impuestos en Chile

Los ítems y totales llevan impuestos identificados por type, tomados del catálogo tax-types. Ejemplos frecuentes en Chile:

`type`	Descripción
`CL_GRAV_BAS`	Gravado con IVA (19%).
`CL_EX_IVA`	Exento de IVA.

En los dos la tasa sale del catálogo: rate es opcional y, si la envías, se ignora (ver la tasa de cada impuesto). Una factura, nota de crédito o nota de débito (FCE, NCV, NDV) puede combinar ítems gravados y exentos. Cada ítem CL_EX_IVA viaja al SII como exento, y los totales separan el monto exento del neto gravado. Una nota de crédito o de débito con todos sus ítems exentos no lleva neto ni IVA, como la que anula una factura exenta. La factura no: el SII rechaza una FCE sin ítems gravados. Si todo lo que vendes es exento, emite una factura exenta (FCEE). Tres reglas:

Un ítem lleva a lo sumo un impuesto de IVA: es gravado o es exento. Si lleva dos, ITEM_MULTIPLE_VAT_TAXES.
Los ítems gravados de un documento comparten la misma tasa de IVA. Si no, MULTIPLE_VAT_RATES.
Una FCE lleva al menos un ítem gravado. Si todos son exentos, TAXED_INVOICE_WITHOUT_TAXED_ITEMS.

Retenciones de IVA en la factura de compra

La factura de compra (FCO) la emite quien compra, no quien vende: el issuer es tu empresa y el recipient es el vendedor. Se usa cuando el vendedor no puede documentar la venta, o cuando tu empresa es agente retenedor de un producto con cambio de sujeto. En los dos casos retienes el IVA: cada ítem gravado lleva su IVA y, además, exactamente una retención en items[].taxes.

`type`	Código SII	Retención	Tasa
`CL_IVA_RET`	15	Total. El vendedor no tiene documentación tributaria.	Catálogo (19)
`CL_RET_SILV`	31	Total. Productos silvestres.	Catálogo (19)
`CL_RET_CHAT`	38	Total. Chatarra.	Catálogo (19)
`CL_RET_PPA`	39	Total. Pequeño productor agrícola.	Catálogo (19)
`CL_RET_CONS`	41	Total. Construcción.	Catálogo (19)
`CL_RET_CART`	47	Total. Cartones.	Catálogo (19)
`CL_RET_MAD_TOT`	331	Total, en el régimen parcial de la madera.	Catálogo (19)
`CL_RET_LEG`	30	Parcial. Legumbres.	La informas tú
`CL_RET_GAN`	32	Parcial. Ganado.	La informas tú
`CL_RET_MAD`	33	Parcial. Madera.	La informas tú
`CL_RET_TRI`	34	Parcial. Trigo.	La informas tú
`CL_RET_ARR`	36	Parcial. Arroz.	La informas tú
`CL_RET_HID`	37	Parcial. Especies hidrobiológicas.	La informas tú
`CL_RET_BER`	48	Parcial. Berries.	La informas tú

En una retención parcial, la tasa es la que fija tu resolución de agente retenedor: mayor que 0 y menor que el IVA del ítem.

Los montos

total es bruto, igual que en una factura de venta: sub_total + IVA − descuento. La retención no suma ni resta en el request, y no va en totals.taxes ni en global_taxes: va solo en el ítem.
Emify calcula lo retenido por código, con la regla del SII: la tasa por la suma de los ítems de ese código. En el documento que recibe el SII, el total es el monto que le pagas al vendedor: neto + exento + IVA − retenido.
No admite descuento de cabecera (totals.discount): aplícalo en los ítems.
Un ítem exento (CL_EX_IVA) no lleva retención.

Agente retenedor

Toda retención salvo CL_IVA_RET corresponde a un producto con cambio de sujeto, y el ítem tiene que identificarlo:

code de tipo cpcs, con el código de producto del SII. Sus dos primeros dígitos son los del código de la retención: 3201 es ganado bovino (32), 3304 son trozos aserrables de madera (33).
code_unit_of_measure con la unidad que el SII pide para ese producto: KG, TON, QTAL, M3, MR, TBDM, TBDU, PP, PM o UNID. En construcción y en los servicios de maquila no es obligatoria.
En ganado, además, reference_quantity con la cantidad de cabezas.

{
  "invoice_type": "FCO",
  "items": [
    {
      "quantity": 1000,
      "code_unit_of_measure": "KG",
      "unit_price": 2000,
      "description": "Novillos en pie",
      "code": { "type": "cpcs", "value": "3201" },
      "reference_quantity": 3,
      "taxes": [
        { "type": "CL_GRAV_BAS", "amount": 380000 },
        { "type": "CL_RET_GAN", "rate": 8, "amount": 160000 }
      ]
    }
  ],
  "totals": {
    "sub_total": 2000000,
    "taxes": [{ "type": "CL_GRAV_BAS", "amount": 380000 }],
    "total": 2380000
  }
}

El SII recibe un IVA de 380.000, lo retenido (160.000) y un total de 2.220.000.

Notas sobre una factura de compra

Una nota de crédito (NCV) o de débito (NDV) que referencia una FCO lleva las mismas reglas: cada ítem gravado lleva su retención. NCV es el tipo con el que se anula una FCO.

Tipos de documento en Argentina

Argentina todavía no está habilitada en producción. Esta sección describe cómo quedan los comprobantes cuando se habilite.

La letra del comprobante depende de la condición frente al IVA del emisor y del receptor:

Clase	Quién emite	A quién	`invoice_type`
A	Responsable Inscripto	Responsable Inscripto o monotributista (`RI`, `MT`, `MTS`, `MTIP`), identificado con CUIT	`FCA` factura, `NDA` nota de débito, `NCA` nota de crédito
B	Responsable Inscripto	Cualquier otro receptor (`EX`, `CF`, `SNC`, `PEX`, `NR`, `LIB`, `NAL`), con cualquier documento	`FCB`, `NDB`, `NCB`
C	Monotributista o exento	Cualquier receptor	`FCC`, `NDC`, `NCC`

La condición del emisor es la de la empresa en Emify: una FCA o una FCB de una empresa que no está dada de alta como RI queda en INV y no se envía a ARCA. Las notas de crédito y débito exigen billing_reference, con branch_office, y apuntan a un comprobante de su misma letra. NCA anula una FCA y NCB anula una FCB.

Modalidades de la Clase A

ARCA asigna a cada Responsable Inscripto una de tres modalidades para emitir la Clase A (RG 5762/2025). No las elige el emisor: ARCA las revisa cada cuatrimestre, y la vigente se consulta en el servicio “Regímenes de Facturación y Registración (REAR/RECE/RFI)”. En el request se declaran en issuer.tax_information:

Modalidad	En el request	Código en ARCA	En el PDF
A estándar	sin `cbu` ni `subject_to_retention`	1, 2, 3	—
A con leyenda “PAGO EN CBU INFORMADA”	`cbu`: la CBU de 22 dígitos que el emisor informó a ARCA	1, 2, 3	La leyenda y la CBU, junto a la letra.
A con leyenda “OPERACIÓN SUJETA A RETENCIÓN”	`subject_to_retention: true`	51, 52, 53	La leyenda junto a la letra, y `COD. 051`, `052` o `053`.

El invoice_type sigue siendo FCA, NDA o NCA en las tres. La modalidad “sujeta a retención” usa los códigos de la ex-Factura M, y su numeración continúa esa serie, no la de la A estándar. Una nota con esta modalidad referencia comprobantes de esa misma serie. Emify no puede saber qué modalidad te asignó ARCA. Si declaras otra, ARCA rechaza la autorización y el comprobante termina rechazado, informado por el webhook. Errores de validación:

cbu sin 22 dígitos o con un dígito verificador incorrecto: INVALID_ISSUER_CBU.
cbu y subject_to_retention: true juntos: ISSUER_PAYMENT_MODALITIES_EXCLUSIVE.
Cualquiera de los dos en un comprobante que no es Clase A: ISSUER_PAYMENT_MODALITY_NOT_VALID_FOR_DOCUMENT_TYPE.

"issuer": {
  "tax_information": {
    "tax_condition": "RI",
    "subject_to_retention": true
  }
}

Ley 27.618: Clase A a un monotributista

Cuando el receptor de un comprobante Clase A es monotributista (MT, MTS o MTIP), el PDF imprime, a la derecha del QR, la leyenda de la Ley 27.618: “El crédito fiscal discriminado en el presente comprobante, solo podrá ser computado a efectos del Régimen de Sostenimiento e Inclusión Fiscal para Pequeños Contribuyentes de la Ley Nº 27.618”. No hace falta enviar nada: sale de la condición del receptor.

Impuestos en Argentina

En las clases A y B, cada ítem lleva exactamente un impuesto de IVA en items[].taxes, y ese impuesto indica cómo trata el IVA a ese ítem:

`type`	Tratamiento
`AR_IVA_21`, `AR_IVA_10_5`, `AR_IVA_27`, `AR_IVA_5`, `AR_IVA_2_5`, `AR_IVA_0`	Gravado a esa alícuota. El `amount` es neto × alícuota del catálogo (se admite ±0,01). La `rate` es opcional y, si la envías, se ignora.
`AR_IVA_EX`	Exento. `amount` en 0.
`AR_IVA_NG`	No gravado. `amount` en 0.

Las percepciones y otros tributos van en global_taxes, cada uno con base_amount, rate y amount. Acá la rate es obligatoria: depende de la operación y el catálogo no la tiene (rate_source: CLIENT). Cada type se informa a ARCA con su código de tributo:

`type`	Código ARCA	Tributo	Renglón del PDF
`AR_PER_IVA`	6	Percepción de IVA (p. ej. RG 2408)	`Per./Ret. de IVA`
`AR_PER_IIBB`	7	Percepción de Ingresos Brutos	`Per./Ret. Ingresos Brutos`
`AR_IMP_INT`	4	Impuestos internos	`Impuestos Internos`
`AR_IMP_MUN`	3	Impuestos municipales	`Impuestos Municipales`
`AR_IMP_PROV`	2	Impuestos provinciales	`Impuestos Provinciales`
`AR_PER_IMP_NAC`	1	Impuestos nacionales	`Impuestos Nacionales`
`AR_OTROS_TRIB`	99	Otros tributos. Exige `description`	`Otros Tributos`

La percepción de IVA es AR_PER_IVA, no AR_PER_IMP_NAC. AR_PER_IMP_NAC se informa a ARCA como “Impuestos nacionales” (código 1): una percepción de IVA enviada con ese tipo queda registrada en ARCA como otro tributo.

Puedes enviar varios tributos del mismo tipo, por ejemplo una percepción de IIBB por jurisdicción: cada uno se informa y se imprime por separado. La description de cada tributo se imprime como su detalle. La Clase C no discrimina IVA ni admite tributos con importe.

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:

`reason_code`	Descripción
`MON`	Corrige montos.
`TEX`	Corrige texto de la referencia.
`ANU`	Anula el documento de referencia.

Consultar un contribuyente

Puedes verificar los datos de un contribuyente por su documento tributario:

curl "https://api.emify.co/api/taxpayers/CL/{documentNumber}" \
  -H "X-Api-Key: tu_api_key"

Cómo funciona

Configuración de la empresa

Emisión y recepción

Tipos de documento y datos de referencia

Consultar por país

Catálogos de referencia

Tipos de documento en Chile

Impuestos en Chile

Retenciones de IVA en la factura de compra

Los montos

Agente retenedor

Notas sobre una factura de compra

Tipos de documento en Argentina

Modalidades de la Clase A

Ley 27.618: Clase A a un monotributista

Impuestos en Argentina

Razones de anulación

Consultar un contribuyente

​Consultar por país

​Catálogos de referencia

​Tipos de documento en Chile

​Impuestos en Chile

​Retenciones de IVA en la factura de compra

​Los montos

​Agente retenedor

​Notas sobre una factura de compra

​Tipos de documento en Argentina

​Modalidades de la Clase A

​Ley 27.618: Clase A a un monotributista

​Impuestos en Argentina

​Razones de anulación

​Consultar un contribuyente

Consultar por país

Catálogos de referencia

Tipos de documento en Chile

Impuestos en Chile

Retenciones de IVA en la factura de compra

Los montos

Agente retenedor

Notas sobre una factura de compra

Tipos de documento en Argentina

Modalidades de la Clase A

Ley 27.618: Clase A a un monotributista

Impuestos en Argentina

Razones de anulación

Consultar un contribuyente