Integración con SII: guía técnica para boleta y factura electrónica en Chile 2026

Toda empresa chilena que vende bienes o presta servicios debe emitir documentos tributarios electrónicos (DTE) autorizados por el Servicio de Impuestos Internos (SII). Desde 2017 la boleta electrónica es obligatoria para casi todos los contribuyentes del régimen general, y la factura electrónica lo es desde 2014. Esta guía cubre la integración técnica con el SII para desarrolladores que están construyendo software a medida en Chile y necesitan emitir documentos tributarios desde su plataforma.

No es una guía legal. Es una guía técnica que cubre el flujo real de integración: certificación, ambientes, formatos XML, esquema de firma digital, control de folios, envíos, acuse de recibo y los errores más comunes. Si estás evaluando la opción de integrar via proveedor (Bsale, Defontana, Nubox, etc.) vs construir tu propia integración, también la cubrimos.

Documentos tributarios electrónicos relevantes

El SII define más de 30 tipos de DTE. Los más usados en software a medida son:

• Tipo 33 — Factura Electrónica: venta a contribuyente con derecho a crédito fiscal IVA.
• Tipo 34 — Factura Electrónica Exenta: ventas exentas o no afectas a IVA.
• Tipo 39 — Boleta Electrónica: venta a consumidor final con IVA.
• Tipo 41 — Boleta Electrónica Exenta: boleta para ventas exentas.
• Tipo 56 — Nota de Débito: aumenta el monto de un DTE previo.
• Tipo 61 — Nota de Crédito: anula o disminuye el monto de un DTE previo.
• Tipo 52 — Guía de Despacho: documenta el traslado de mercaderías sin necesariamente emitir factura.

Pre-requisitos antes de integrar

Para emitir DTE autorizados por SII tu sistema necesita cinco elementos:

1. RUT del contribuyente habilitado en SII como emisor electrónico (obtenido desde el portal MIPYME o autorización formal).
2. Certificado digital emitido por una autoridad certificadora autorizada por SII (E-Sign Latam, E-Cert Chile, Acepta, Toc Biometrics, etc.). Es un archivo PFX/P12 con contraseña.
3. Folios autorizados (CAF): códigos de autorización de folios solicitados al SII por tipo de documento. Sin CAF vigente no puedes emitir.
4. Acceso al portal de mantenedor en SII para gestionar configuración de la empresa, sucursales y casillas de intercambio.
5. Casilla de intercambio registrada en SII (típicamente una dirección de correo electrónico) para recibir DTE de proveedores.

Ambientes: Certificación vs Producción

El SII opera dos ambientes que tu integración debe contemplar:

• Ambiente de Certificación (Maullin): para pruebas antes de obtener autorización oficial. Endpoint:palena.sii.cl (versión actual). Permite emitir DTE de prueba, validar XML, simular envíos.
• Ambiente de Producción: real, con valor tributario. Endpoint: palena.sii.cl en producción. Solo accesible tras superar el proceso de certificación.

Antes de pasar a producción, el SII exige completar un set de pruebas básico donde tu sistema emite y envía una serie de DTE de tipos específicos sin errores. Una vez aprobado, el contribuyente queda habilitado.

Estructura del DTE: XML firmado

Cada DTE es un documento XML que debe cumplir el esquema XSD publicado por SII. Los campos obligatorios incluyen:

• Encabezado: tipo de DTE, folio, fecha, RUT emisor, RUT receptor, totales, IVA.
• Detalle: líneas de productos/servicios con cantidad, precio unitario, descuento, monto.
• Referencias: si es nota de crédito o débito, debe referenciar el DTE original.
• Timbre Electrónico (TED): firma del SII sobre los datos del documento usando el CAF correspondiente. Es la prueba criptográfica que el folio es válido.
• Firma Digital del emisor: firma XML-DSig sobre el documento completo usando el certificado digital del contribuyente.

Implementar correctamente la firma XML-DSig es uno de los puntos donde más se traba la integración. Las librerías recomendadas son xmlsec (C/Python), SignedXml (.NET), xml-crypto (Node.js), y nokogiri-xmlsec (Ruby). El hash debe ser SHA1 (SII no soporta SHA256 al momento de esta guía) y la canonicalización C14N exclusiva.

Flujo de envío y acuse

Una vez generado y firmado el XML, el flujo es:

1. Empaquetar el DTE en un sobre EnvioDTE firmado.
2. Subir el EnvioDTE al SII vía endpoint /cgi_dte/UPL/DTEUpload con autenticación por certificado digital y token (obtenido vía /DTEWS/CrSeed.jws y /DTEWS/GetTokenFromSeed.jws).
3. Recibir track_id de respuesta.
4. Consultar estado del envío con /DTEWS/QueryEstUp.jws (puede tomar minutos hasta horas).
5. Si hay error, corregir y reenviar. Si está aprobado, distribuir el DTE al receptor (correo, portal, EDI).
6. Recibir acuse de recibo y respuesta del receptor sobre aceptación/rechazo del DTE.

Boleta electrónica: caso especial

Las boletas electrónicas (tipo 39 y 41) tienen un flujo distinto a las facturas:

• Se emiten en tiempo real (point-of-sale, app, e-commerce).
• Se reportan al SII vía RCV (Registro de Compras y Ventas) de forma diaria mediante archivo CSV consolidado.
• Para alto volumen existe el modo caja en línea donde cada boleta se envía individualmente al SII en tiempo real.
• Deben mostrar QR del TED en la representación impresa o digital para que el cliente pueda validar.

Build vs buy: ¿integración propia o vía proveedor?

Esta es la decisión arquitectónica clave. Las opciones son:

1. Integración directa con SII: tu sistema firma, envía y consulta documentos directamente. Pros: control total, sin dependencias terceras, sin costo recurrente por documento. Contras: complejidad técnica significativa, mantenimiento de certificados/CAF, manejo de cambios de esquema SII.
2. Vía proveedor (Bsale, Nubox, Defontana, Toc, BlueOcean, Acepta, OpenFactura): tu sistema llama API del proveedor y este se encarga del XML, firma, envío y acuse. Pros: rápido (días vs meses), menos mantenimiento, soporte. Contras: costo por documento o suscripción, dependencia, latencia adicional.
3. Híbrido: integración directa para volumen alto + proveedor de respaldo. Más complejo pero óptimo para alto volumen.

Para empresas que emiten menos de 5.000 DTE/mes, casi siempre conviene un proveedor. Para volúmenes mayores o sistemas que requieren control total (banca, retail enterprise, marketplace regulados), la integración directa empieza a justificarse.

Errores más comunes en integraciones SII

• Hash SHA256 en lugar de SHA1 → SII rechaza la firma.
• Canonicalización C14N inclusiva en lugar de exclusiva → error de firma.
• Encoding UTF-8 sin BOM en algunos campos críticos → schema validation falla.
• No mantener CAF vigentes → error 105 al emitir.
• Discrepancias en redondeo de IVA (SII redondea por línea con regla específica) → totales no cuadran.
• No registrar correctamente la fecha de emisión vs fecha de recepción del receptor → discrepancias en RCV.

Compliance y obligaciones tributarias adicionales

Más allá de emitir, tu sistema debe contemplar:

• Libro de Compras y Ventas (RCV): declaración mensual al SII con resumen de DTE emitidos y recibidos.
• F29: declaración de IVA mensual basada en RCV.
• Almacenamiento de DTE: el contribuyente debe guardar copia legible y auditable de todos los DTE por 6 años.
• Acuse de recibo de DTE de proveedores: aceptar o rechazar dentro de plazo legal.
• Cesión de facturas: si la empresa hace factoring electrónico, el sistema debe soportar Acuse de Recibo + DTE de cesión.

Recursos oficiales útiles

• Portal de Documentos Electrónicos del SII: instructivos, esquemas XSD y set de pruebas.
• Manual de Especificaciones de DTE publicado por SII (versión vigente al momento de integrar).
• Servicios web de autenticación, envío y consulta: documentación oficial en palena.sii.cl.

Conclusión

Integrar con SII es un proyecto técnico serio: típicamente 4 a 10 semanas de trabajo focalizado para una integración directa, o 1 a 2 semanas si se hace vía proveedor. La decisión correcta depende del volumen, la criticidad y el control que necesite tu producto sobre el flujo tributario.

Si estás evaluando una integración SII como parte de un proyecto de software a medida, o necesitas un diagnóstico técnico previo para decidir build vs buy, podemos revisar tu caso y darte un plan ejecutable. Si además necesitas gestionar otros medios de pago (Webpay, Mercado Pago, Khipu, OpenFactura), revisa nuestro servicio de integraciones de pagos en Chile, que suele ir de la mano con la integración SII en plataformas de e-commerce y marketplaces.