Skip to main content

​
Introducción a la API de Facturación

La API de Facturación está integrada directamente al facturador gratuito del SII y permite emitir documentos de forma masiva usando Batch Documents. El sistema emite por ti y además recibe automáticamente el PDF y XML final de cada factura a través de webhooks. La integración se apoya en un flujo simple:
  1. obtener tu API Key
  2. partir en modo Sandbox (recomendado)
  3. enrolar empresas y crear credenciales
  4. crear batches para emitir documentos
  5. configurar webhooks por empresa para recibir los resultados
  6. (opcional) usar campos avanzados como direcciones y actividades económicas personalizadas
  7. monitorear todo desde la plataforma

​
1) API Key (por usuario)

La API Key es por usuario y sirve para operar sobre todas las empresas enroladas bajo ese usuario. Existe operación en Sandbox y en Producción. Se recomienda comenzar en Sandbox para validar el flujo completo sin riesgos.

​
2) Enrolamiento y credenciales

Antes de emitir, cada empresa debe estar enrolada y contar con su credencial. Puedes hacerlo de dos maneras: Este paso deja a la empresa lista para emitir documentos.

​
3) Emisión: crear el Batch Document

Una vez que la empresa está lista, basta con:
  • Crear un Batch Document con el detalle de las facturas a emitir.
  • Usar el flag use_default (o equivalente) para que el sistema utilice la configuración/credencial por defecto de esa empresa.
Con eso, el batch queda procesándose y la emisión ocurre de forma automática.

​
4) Webhooks: un webhook por empresa

Para recibir el resultado de cada emisión, debes configurar un webhook por empresa. También puedes hacerlo: El webhook es clave porque es el canal donde se envía el estado final y los archivos asociados.

​
5) Recepción de resultados (XML y PDF)

Una vez configurado el webhook, el sistema recibe automáticamente del SII el PDF y XML final de cada factura emitida. Vas a recibir las notificaciones del procesamiento del batch, incluyendo:
  • Estado / respuesta de emisión desde el SII
  • XML final generado por el SII
  • PDF final generado por el SII

​
6) Opciones avanzadas (direcciones y actividades económicas personalizadas)

Si necesitas direcciones o actividades económicas personalizadas, el flujo es:
  1. Pedir la entidad (master entity) usando Buscar Entidad por RUT para obtener los datos disponibles (direcciones/actividades).
  2. Incluir esos identificadores/campos en el Batch Document al crear el batch.
Esto te permite controlar con precisión qué dirección/actividad se usa al emitir.

​
7) Monitoreo y trazabilidad en la plataforma

Además de operar por API, puedes revisar todo en la plataforma:
  • Vista detallada de empresas enroladas, credenciales, batches y estados.
  • Modo Sandbox en la plataforma para ver exclusivamente lo que entra por Sandbox.
  • Modo Producción para ver lo que está en operación real.
Puedes activar/usar Sandbox o Producción según el entorno que estés integrando.

​
Endpoints relacionados