Erpnext Chile Factura

bench get-app https://github.com/tonicanada/erpnext_chile_factura

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=tonicanada%2Ferpnext_chile_factura)](https://frappegems.com/gems/apps/tonicanada/erpnext_chile_factura)

# 🧾 ERPNext Chile Factura Este módulo extiende ERPNext para integrar automáticamente la recepción de facturas desde el SII de Chile, gestionar los XML de respaldo y generar facturas de compra (`Purchase Invoice`) a partir de reglas personalizables. --- ## ⚙️ Instalación ```bash # Clona el repositorio dentro del directorio de apps de tu sitio ERPNext cd ~/frappe-bench/apps git clone https://github.com/tonicanada/erpnext_chile_factura.git # Instala la app en tu sitio cd ~/frappe-bench bench --site tu_sitio install-app erpnext_chile_factura ``` Esto instalará todos los Doctypes necesarios. --- ## 🛠 Configuración inicial ### 1. Ajustes globales de integración Configura el Doctype **`ERPNext SII - Ajustes Generales`** (singleton). Aquí se definen opciones clave que afectan el comportamiento de toda la app: - `campo_rut_proveedor`: define si el campo usado para buscar proveedores será `tax_id` o un campo personalizado como `rut`. - `naming_supplier`: define si el nombre del proveedor se genera con el **RUT** o con la **Razón Social**. ### 2. Conexión a SimpleAPI (SII) Configura el Doctype `SimpleAPI RCV Setup` para cada empresa, con los siguientes datos: - Token API (header `Authorization`) - RUT Certificado (Representante Legal) - Password Certificado - Certificado digital `.pfx` - Ambiente (`certificado`, `producción`, etc.) - URL del endpoint por período (`{month}` y `{year}`) ### 3. Sincronización con Google Drive Configura los siguientes Doctypes: - `SII Google Drive Sync Config`: indica empresa y tipo de sincronización (`preinvoice`). - `SII Google Drive Carpeta`: define la carpeta Drive de cada empresa (puede incluir subcarpetas por mes). ### 4. Procesamiento externo de correos XML Debes clonar y configurar este repositorio: 👉 [dte_email_xml_processor_chile](https://github.com/tonicanada/dte_email_xml_processor_chile) Este cron externo realiza: - Lectura de correos desde `dte@tecton.cl`. - Clasificación por empresa y guardado en la carpeta correspondiente de Google Drive. - Reenvío a las casillas de los contadores de cada empresa. --- ## 🔁 Automatización La app incluye 2 crons principales: 1. **Sincronización de DTE desde el SII:** - Pregunta por nuevas facturas electrónicas usando SimpleAPI. - Crea o actualiza registros `PreInvoice` por empresa y por mes. 2. **Importación automática de XML desde Google Drive:** - Recorre las carpetas de Drive y busca nuevos XMLs. - Si encuentra una `PreInvoice` correspondiente (por RUT + folio + tipo DTE), importa los detalles y marca como `tiene_xml_importado`. ### Concurrencia multi-sitio (SimpleAPI) Cuando varios sitios del mismo bench disparan `sync_all_companies` al mismo tiempo, SimpleAPI puede responder con errores de concurrencia o cuota (`429` / errores transitorios). Para mitigar esto, la integración implementa: - **Lock global Redis** compartido entre sitios, usando la key: - `erpnext_chile_factura:simpleapi_rcv_global_lock` - **Espera de lock** antes de llamar a SimpleAPI: - `blocking_timeout = 360` segundos - `lock_timeout = 900` segundos - **Reintentos automáticos** si el lock está ocupado: - `LOCK_RETRY_DELAYS_SECONDS = [300, 600]` (5 y 10 minutos) Esto evita que dos sitios llamen a SimpleAPI en paralelo. Notas operativas: - El lock se aplica alrededor de la llamada HTTP a SimpleAPI. - El cron puede dispararse en varios sitios a la vez; el lock serializa el acceso al proveedor. - Si quieres pausar pruebas, puedes desactivar scheduler por sitio con: - `bench --site disable-scheduler` --- ## 🧠 Reglas de Autoingreso PINV Define reglas por empresa en el Doctype `Reglas de Autoingreso PINV`. Las condiciones permiten evaluar: - Proveedor (RUT) - Contenido del ítem (nombre + descripción) - Y más... Y como acción puedes definir: - Cuenta contable - Centro de costo - Proyecto - Bodega - Ítem sugerido --- ## ⚡ Ejecución del Autoingreso Existen 2 formas de ejecutar el ingreso automático de facturas de compra desde `PreInvoice`: 1. **Masiva** desde el Doctype `Ejecutor Autoingreso PINV`, que entrega un reporte detallado de resultados. 2. **Individual**, desde el botón de cada `PreInvoice`. --- ## 🧪 Ejecución manual de otras funciones 1. **Actualizar Preinvoices desde el SII manualmente:** Usa el Doctype `PreInvoice Sync`. 2. **Importar ZIP de XML manualmente:** Usa el Doctype `XML Importer`. --- ## 🧭 Diagrama de flujo general (Mermaid) ```mermaid flowchart TD A[Consulta periodica
casilla email XML] --> B[Guardar XML en
Google Drive por empresa y mes] B --> C[Consulta periodica
Google Drive XML] C --> D[Parsear XML
y extraer detalle] E[Consulta periodica SII
por documentos recibidos] --> F[Crear PreInvoice si no existe
por RUT, tipo_dte y folio] D --> G[Buscar PreInvoice existente
por RUT, tipo_dte y folio] F --> G G --> H[Agregar detalle del XML
a la PreInvoice] H --> I[Adjuntar XML como archivo
a la PreInvoice] I --> J{Coincide con regla
de autoingreso} J -- Si --> K[Crear automaticamente
Purchase Invoice - PINV] J -- No --> L[PreInvoice pendiente
revision manual] K --> M{Proveedor existe} M -- No --> N[Crear proveedor
con datos del XML] M -- Si --> O[Usar proveedor existente] K --> P[Registrar log
en tabla interna] ``` ## Documentación técnica adicional Para detalles técnicos y notas específicas sobre funcionalidades como el autocompletado del campo `tipo_dte` desde `tipo_factura`, consulta el archivo [NOTAS.md](erpnext_chile_factura/erpnext_chile_sii_integration/docs/NOTAS.md). Este archivo contiene información importante para desarrolladores sobre compatibilidades y configuraciones específicas para entornos como Constructora Tecton. ## 🛡️ Licencia Este proyecto 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 derivadas sin autorización expresa del autor. Para más detalles, puedes consultar la licencia completa en: [https://creativecommons.org/licenses/by-nc-nd/4.0/](https://creativecommons.org/licenses/by-nc-nd/4.0/) © 2025 Antonio Cañada Momblant