Emitir un comprobante

Emite un documento tributario electrónico, consulta su estado y descarga el PDF o el XML.

Esta guía cubre el flujo completo de emisión: crear el comprobante, consultar su estado y obtener sus representaciones (PDF y XML). Todas las peticiones usan la API key de tu empresa en el header X-Api-Key.

Prerequisitos

La empresa emisora debe estar dada de alta con certificado y folios cargados.

1. Emitir el comprobante

Envía una petición POST con los datos del comprobante. La emisión es asíncrona: Emify recibe el documento, lo genera, lo firma y lo envía al SII en segundo plano.

curl -X POST https://api.emify.co/api/companies/{company_id}/invoices \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d @factura.json

Ejemplo de cuerpo para una factura electrónica en Chile:

factura.json

{
  "branch_office": 1,
  "invoice_type": "FCE",
  "invoice_date": "2025-01-31 06:00:00",
  "payment_due_date": "2025-01-31",
  "external_reference": "1526815",
  "issuer": {
    "legal_name": "CONTABILIUM CHILE SPA",
    "document_type": "RUT",
    "document_number": "77450199-1",
    "address": {
      "country": "CL",
      "region": "CL-AN",
      "city": "CL-ANF",
      "address": "Napoleon 3200"
    },
    "tax_information": {
      "activity": "OTRAS ACTIVIDADES DE TECNOLOGIA DE LA INFORMACION Y DE SERVICIOS INFORMATICOS",
      "activity_codes": [620200, 620900, 702000],
      "resolution_date": "2014-08-22",
      "resolution_number": "80"
    }
  },
  "recipient": {
    "legal_name": "TUDISTRIBUIDORA.CL SPA",
    "document_type": "RUT",
    "document_number": "76995025-7",
    "address": {
      "country": "CL",
      "region": "CL-LI",
      "city": "CL-QTC",
      "address": "LOS MILITARES 5620 OF 905"
    },
    "tax_information": { "activity": "VENTAS DE PRODUCTOS" }
  },
  "currency": { "code": "CLP", "exchange_rate": 1 },
  "payment_method": { "code": "CON", "description": "Contado" },
  "items": [
    {
      "quantity": 2,
      "code_unit_of_measure": "u",
      "discount_amount": 0,
      "unit_price": 5,
      "description": "PLAN FULL",
      "taxes": [{ "type": "CL_GRAV_BAS", "amount": 2, "rate": 19 }]
    }
  ],
  "totals": {
    "sub_total": 10,
    "discount": 0,
    "taxes": [{ "type": "CL_GRAV_BAS", "amount": 2, "base_amount": 10, "rate": 19 }],
    "total": 12
  }
}

Los campos clave del cuerpo:

Campo	Descripción
branch_office	Sucursal emisora.
invoice_type	Tipo de documento. Ver tipos de documento.
issuer / recipient	Datos del emisor y del receptor, con su dirección e información tributaria.
currency	Moneda (CLP) y tipo de cambio.
items	Ítems con cantidad, precio unitario e impuestos.
totals	Subtotal, descuentos, impuestos y total.

El detalle campo por campo (tipos, obligatoriedad, objetos anidados) está en la referencia de la API. Los valores de tipos de documento, monedas, impuestos y unidades salen de los catálogos de referencia.

La respuesta confirma la recepción e incluye el id del documento y su estado inicial.

2. Consultar el estado

El estado se resuelve de forma asíncrona. Consulta el documento hasta que llegue a un estado final, o mejor, usa webhooks.

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

Los valores de status y fiscal_status, y qué significan, están en Ciclo de vida de un documento.

3. Descargar el PDF

Una vez aprobado, descarga la representación impresa. Formatos: A4, 80mm, 58mm.

curl -X POST https://api.emify.co/api/companies/{company_id}/invoices/{invoice_id}/download-pdf/A4 \
  -H "X-Api-Key: tu_api_key" \
  --output comprobante.pdf

Para obtener el PDF en Base64 (por ejemplo, para incrustarlo en otro sistema), usa download-base64/{formato}.

4. Descargar el XML

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

Anular un comprobante

En Chile, un documento emitido no se “borra”: se anula emitiendo una nota de crédito que lo referencia. Envía un POST a invoices con invoice_type de nota de crédito (NCV), el reason_code correspondiente y billing_reference apuntando al documento original.

{
  "invoice_type": "NCV",
  "reason_code": "ANU",
  "billing_reference": [
    { "branch_office": 1, "number": 65, "invoice_type": "BOL", "invoice_date": "2025-01-30 16:00:00" }
  ]
}

Ver los códigos de anulación en tipos de documento.

El documento referenciado en billing_reference no necesita haber sido emitido por Emify: puedes referenciar un documento emitido por otro proveedor o sistema y Emify lo acepta, enviando la referencia al SII tal cual la informas para que él la valide.

Cuando el documento referenciado sí existe en Emify, se aplican las validaciones habituales: no puedes anularlo dos veces, el tipo referenciado debe ser anulable y el tipo de la nota debe coincidir con el tipo de anulación esperado.