Integración de ERPNext con el SII de Chile

ERPNext SII facturación electrónica Chile Google Drive

Este proyecto fue desarrollado para automatizar completamente el ingreso de facturas electrónicas (DTE) desde los archivos XML del SII de Chile hacia el ERP ERPNext, reduciendo al mínimo el trabajo manual en el área contable.

🧩 ¿Qué problema resuelve?

Las facturas llegan como archivos XML al correo (desde el proveedor o el propio SII)
El proceso de descarga, clasificación y carga en el ERP es lento, repetitivo y propenso a errores
Muchas facturas deben enlazarse a órdenes de compra, centros de costo, bodegas o proyectos

⚙️ ¿Qué hace esta integración?

Lee correos con XML adjuntos en bandejas compartidas
Detecta automáticamente a qué empresa y mes corresponde el documento
Sube el XML a Google Drive en una ruta organizada por empresa/mes
Extrae los datos del XML y crea una PreInvoice en ERPNext
Aplica reglas definidas por empresa para convertir automáticamente la PreInvoice en una Purchase Invoice
Identifica duplicados y maneja referencias a órdenes de compra
Adjunta el XML original al documento contable creado

🧠 Tecnologías usadas

ERPNext (Custom App con DocTypes, hooks, scripts Python)
Google Drive API y Gmail API
Logs centralizados en Google Sheets

En el futuro se espera incorporar componentes de IA como FAISS y LLMs para sugerir ítems contables en base a descripciones. Esto se encuentra en evaluación para una versión posterior.

📌 Resultados

Procesamiento automático de cientos de facturas mensuales
Cero intervención humana en el 90% de los casos
Trazabilidad completa: desde el XML recibido hasta el asiento contable en el ERP

💡 Código fuente

Este proyecto está disponible públicamente en GitHub:

👉 Repositorio en GitHub: tonicanada/erpnext_chile_factura

Incluye documentación técnica, ejemplos de configuración y todo el código necesario para desplegar la integración en un entorno ERPNext.

🛡️ Licencia:
Este software está licenciado bajo Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0).

Esto significa que puedes ver, compartir y clonar este repositorio, pero no puedes usarlo con fines comerciales ni crear versiones modificadas sin autorización expresa.

¿Necesitas ayuda para adaptarlo a tu empresa? ¿Quieres colaborar en su evolución?
💬 Contáctame y estaré encantado de conversar.