Si tu PYME emite facturas o boletas en Chile, hoy estás obligada a hacerlo electrónicamente a través del SII. Y si ya manejas un sistema interno (ERP, CRM, software a medida), tarde o temprano vas a querer integrarlo con el SII para que la emisión de documentos sea automática en vez de manual.
El problema es que la documentación oficial del SII está pensada para desarrolladores con experiencia previa. Si nunca has trabajado con DTE, certificados digitales y firmas XML, el primer contacto puede ser intimidante. Esta guía resume lo que aprendimos integrando sistemas chilenos con el SII durante los últimos años.
¿Qué es un DTE y por qué importa?
DTE significa Documento Tributario Electrónico. Es el formato XML estandarizado en el que el SII recibe facturas, boletas, notas de crédito, notas de débito y guías de despacho.
Los DTE más comunes para PYMEs:
| Código | Documento | Uso típico |
|---|---|---|
| 33 | Factura Electrónica | Venta a otra empresa con derecho a crédito fiscal |
| 34 | Factura Exenta | Venta exenta de IVA |
| 39 | Boleta Electrónica | Venta al consumidor final |
| 41 | Boleta Exenta | Venta al consumidor sin IVA |
| 52 | Guía de Despacho | Traslado de mercaderías |
| 56 | Nota de Débito | Aumentar el monto de un documento previo |
| 61 | Nota de Crédito | Anular o corregir un documento previo |
Cada uno tiene su propio esquema XML, sus reglas de validación y sus propios códigos de error si algo está mal.
Las piezas técnicas que vas a necesitar
1. Certificado digital del representante legal
Sin esto no se hace nada. Lo emiten autoridades certificadoras autorizadas por el SII (E-Sign, Acepta, E-CertChile, entre otras) y se usa para firmar digitalmente cada DTE antes de enviarlo. Dura 1 a 3 años. Si vence, el sistema deja de funcionar — programa un recordatorio para renovarlo con tiempo.
2. Resolución de timbraje y CAF
El CAF (Código de Autorización de Folios) es un archivo XML firmado por el SII que autoriza a tu empresa a emitir un rango de folios para cada tipo de DTE. Por ejemplo: "Facturas Electrónicas folios 1000 al 1499". Cuando se acaban, pides un nuevo CAF.
Esto es importante porque tu sistema debe controlar los folios consumidos. Si pides un CAF y tu sistema duplica un folio, ese DTE será rechazado.
3. Ambiente de certificación
Antes de pasar a producción, tu integración debe certificarse en el ambiente de prueba (maullin.sii.cl). El SII te entrega un set de pruebas obligatorio que debes superar — emisión correcta de cada tipo de DTE, libros, manejo de notas de crédito, etc.
Recién al pasar las pruebas obtienes acceso al ambiente de producción (palena.sii.cl). Este proceso suele tomar 2-6 semanas dependiendo de cuán pulida llegue la integración.
4. Firma XML y envío al SII
Cada DTE debe ser:
- Generado en XML siguiendo el esquema oficial del SII.
- Firmado digitalmente con el certificado del representante legal.
- Empaquetado en un "sobre" (EnvioDTE) que también va firmado.
- Enviado vía SOAP/REST a los webservices del SII.
- Confirmado por el SII con un track ID que tu sistema debe almacenar.
Si alguno de estos pasos falla, el documento no es válido y debes corregir y reenviar.
5. Libros mensuales
Además de los DTE individuales, cada mes debes generar y enviar Libros de Compras, Ventas y Guías. Son archivos XML que consolidan toda la actividad del período. Si tu sistema lleva bien el detalle de cada documento, generar los libros es relativamente directo.
Los libros mensuales tienen plazo del SII para ser enviados (habitualmente hasta el día 12 del mes siguiente). Si tu sistema no automatiza esto, te juegas multas por atraso. Es uno de los puntos donde más PYMEs caen.
Errores comunes que cuestan caro
Duplicar folios
Si tu sistema asigna un folio que ya fue usado, el SII rechaza el documento y te puedes enredar con la numeración. Solución: la generación de folios debe ser atómica a nivel de base de datos (transacción con bloqueo), nunca dependiente de procesos concurrentes mal sincronizados.
Mal cálculo del IVA
El SII valida que el IVA del documento coincida exactamente con el cálculo esperado (19% del neto). Si por un tema de redondeo te queda 1 peso de diferencia, el DTE puede ser rechazado. Solución: maneja todos los cálculos internamente con enteros (centavos) y redondea solo al final, de forma consistente.
Olvidar renovar el certificado digital
El certificado dura entre 1 y 3 años. Si vence, la firma deja de ser válida y todos los DTE se rechazan. Programa alertas 60 días antes del vencimiento.
No manejar respuestas asíncronas del SII
El SII responde inmediatamente con un track ID pero la validación final puede demorar minutos u horas. Si tu sistema asume que envío = aceptado, puedes entregarle al cliente una boleta que el SII rechazó después. Solución: implementa un job que consulta el estado de cada DTE hasta confirmar aceptación.
No respaldar los XML firmados
El SII puede pedirte un DTE específico años después en una fiscalización. Si solo guardas el PDF, tienes un problema. Guarda siempre el XML firmado original.
¿Integración propia o servicio externo?
Hay dos caminos principales para integrar tu sistema con el SII:
Opción A: Integración directa con webservices del SII
- Ventaja: sin costo mensual por documento. Sin dependencias externas.
- Ventaja: control total sobre el flujo y los datos.
- Desventaja: mayor complejidad de desarrollo inicial (2-6 semanas dependiendo del alcance).
- Desventaja: tu equipo debe mantener el código cuando el SII actualice esquemas o reglas.
Opción B: Usar un proveedor de facturación electrónica (Bsale, Nubox, OpenFactura, etc.)
- Ventaja: integración más rápida vía API REST.
- Ventaja: el proveedor se encarga de los cambios del SII.
- Desventaja: costo por documento o suscripción mensual.
- Desventaja: dependes del proveedor y sus tiempos de respuesta.
- Desventaja: algunos limitan funcionalidades en planes baratos.
Para PYMEs que recién parten o tienen poco volumen, un proveedor externo suele ser la opción más eficiente. Para empresas con volumen alto, procesos específicos o requerimientos de control fino, la integración directa termina siendo más conveniente y económica a 2-3 años.
Plazos realistas de un proyecto de integración
Si decides hacer integración directa con el SII, estos son los plazos típicos:
| Etapa | Tiempo aproximado |
|---|---|
| Obtener certificado digital y CAF | 1-2 semanas |
| Desarrollo del módulo de emisión (DTE básicos) | 2-4 semanas |
| Desarrollo de libros mensuales | 1-2 semanas |
| Set de pruebas y certificación SII | 2-6 semanas |
| Paso a producción y estabilización | 2-4 semanas |
En total, planifica entre 2 y 4 meses para tener una integración completa, robusta y certificada. Con un equipo con experiencia previa en SII, los tiempos se reducen significativamente porque ya tienen resueltas las trampas típicas.
Cuándo subcontratar y cuándo no
Sí, puedes intentar la integración con SII con un desarrollador interno o un freelance sin experiencia previa. La documentación está disponible y los esquemas XML son públicos. Pero hay dos consideraciones importantes:
- La curva de aprendizaje es alta. Un equipo nuevo puede tomar el doble de tiempo en la primera integración. Si tu negocio depende de facturar correctamente desde el día 1, ese aprendizaje cuesta caro.
- Los errores tienen impacto tributario. Un DTE mal hecho no es un bug — es un problema tributario que puede generar multas o requerimientos del SII.
Subcontratar a un proveedor que ya hizo integraciones SII para otros clientes te ahorra el aprendizaje y reduce el riesgo. En VheCode hemos integrado sistemas chilenos con SII en múltiples proyectos — si te interesa, podemos revisar tu caso sin compromiso.
Conclusión: prepara la operación antes de programar
La parte técnica de integrar con SII es solucionable. Lo que más bloquea proyectos es no tener resueltos los aspectos operativos: certificado digital al día, CAF disponibles, claridad sobre qué tipos de documento emite la empresa, qué reportes contables necesita y cómo se enlaza todo con el ERP o sistema interno.
Si tu PYME está evaluando esta integración, el orden recomendado es:
- Definir qué documentos emites y en qué volumen mensual.
- Obtener (o renovar) el certificado digital del representante legal.
- Decidir si integras directo o vía proveedor.
- Reservar tiempo para el proceso de certificación SII (no se puede saltar).
- Tener un plan de respaldo (poder emitir manualmente desde el portal SII si la integración falla).
¿Necesitas integrar tu sistema con SII?
En VheCode hemos hecho integraciones SII para PYMEs chilenas. El Plan Empresa incluye proyectos complejos de este tipo. Conversemos sin compromiso.
Ver Plan Empresa Conversemos