95 lines
4.1 KiB
Markdown
95 lines
4.1 KiB
Markdown
|
# Inventario del código
|
||
|
|
|
||
|
|
## Archivos
|
||
|
|
|
||
|
|
| Archivo | Líneas | Rol |
|
||
|
|
|---------|--------|-----|
|
||
|
|
| `main.py` | 134 | Demonio orquestador (loop de horarios) |
|
||
|
|
| `pipeline.py` | 957 | Pipeline core (procesar un correo completo) |
|
||
|
|
| `sunat_schema.py` | 521 | Parseo de XML SUNAT (Invoice, DespatchAdvice) |
|
||
|
|
| `pdf_utilities.py` | 450 | Parseo de PDFs (factura, guías) |
|
||
|
|
| `sapb1_manager.py` | 322 | Comunicación con SAP B1 Service Layer |
|
||
|
|
| `outlook_utilities.py` | 228 | Comunicación con Microsoft Graph |
|
||
|
|
| `hana_manager.py` | 126 | Comunicación con SAP HANA directa |
|
||
|
|
| `database_utilities.py` | 114 | SQLite local (cache de correos) |
|
||
|
|
| `consulta_rapida.py` | 115 | Script auxiliar para reprocesar correos por ID |
|
||
|
|
| `email_utilities.py` | 93 | Utilitarios de adjuntos (ZIP, filtrado) |
|
||
|
|
| `logger_utilities.py` | 72 | Logging a archivo + consola |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Dependencias entre archivos
|
||
|
|
|
||
|
|
```
|
||
|
|
main.py
|
||
|
|
└── pipeline.py
|
||
|
|
├── sunat_schema.py
|
||
|
|
├── pdf_utilities.py
|
||
|
|
├── sapb1_manager.py
|
||
|
|
│ └── hana_manager.py
|
||
|
|
├── outlook_utilities.py
|
||
|
|
├── email_utilities.py
|
||
|
|
│ └── database_utilities.py
|
||
|
|
└── database_utilities.py
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Flujo de datos
|
||
|
|
|
||
|
|
```
|
||
|
|
main()
|
||
|
|
└── run_pipeline()
|
||
|
|
├── step_authenticate() → token MS Graph
|
||
|
|
├── step_fetch_emails() → emails[]
|
||
|
|
└── _procesar_un_correo() (por cada email)
|
||
|
|
├── BD: verificar duplicado
|
||
|
|
├── _descargar_adjuntos() → archivos
|
||
|
|
├── _descomprimir() ZIPs
|
||
|
|
├── _filtrar_y_limpiar() → solo PDF/XML
|
||
|
|
├── _procesar_pdfs() → pdf_cache
|
||
|
|
│ └── pdf_utilities.extraer_datos_pdf()
|
||
|
|
├── _procesar_xmls(pdf_cache) → documentos[]
|
||
|
|
│ └── sunat_schema.extraer_datos_xml()
|
||
|
|
├── _guardar_resultado(documentos)
|
||
|
|
├── _validate_prices(factura) → (ok, resultados)
|
||
|
|
│ └── sapb1_manager.get_delivery_notes()
|
||
|
|
│ ├── SL (Service Layer) GET /DeliveryNotes
|
||
|
|
│ └── HANA fallback (get_delivery)
|
||
|
|
├── _build_sap_draft(factura, resultados) → draft
|
||
|
|
├── _guardar_draft_json(draft)
|
||
|
|
├── sapb1_manager.create_draft(draft)
|
||
|
|
└── outlook_utilities.send_email(notificación)
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Problemas conocidos hasta ahora
|
||
|
|
|
||
|
|
| # | Problema | Archivo | Estado |
|
||
|
|
|---|----------|---------|--------|
|
||
|
|
| 1 | `_extraer_serie_numero_desde_texto` no limpiaba leading zeros | `sunat_schema.py` | ✅ Corregido |
|
||
|
|
| 2 | Al asignar guías por línea, si hay +refs que líneas, las sobrantes se perdían | `pipeline.py` | ✅ Corregido |
|
||
|
|
| 3 | SL sin fallback a HANA | `sapb1_manager.py` | ✅ Corregido |
|
||
|
|
| 4 | Ctrl+C mostraba traceback | `main.py` | ✅ Corregido |
|
||
|
|
| 5 | `.env.dev` vs `.env` inconsistente | `sapb1_manager.py` | ✅ Corregido |
|
||
|
|
| 6 | `HANA_HOST` vs `HANA_SERVER` en `.env` | `hana_manager.py` | ✅ Corregido |
|
||
|
|
| 7 | Columna `Cancelled` vs `CANCELED` en HANA | `hana_manager.py` | ✅ Corregido |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Funciones internas en `_procesar_un_correo` (pipeline.py)
|
||
|
|
|
||
|
|
| Función | Líneas | Propósito |
|
||
|
|
|---------|--------|-----------|
|
||
|
|
| `_descargar_adjuntos` | 107-134 | Descarga adjuntos vía Graph API |
|
||
|
|
| `_descomprimir` | 136-149 | Descomprime ZIPs |
|
||
|
|
| `_filtrar_y_limpiar` | 151-191 | Filtra PDF/XML, elimina el resto |
|
||
|
|
| `_procesar_pdfs` | 193-246 | Extrae datos de PDFs, renombra, genera cache |
|
||
|
|
| `_procesar_xmls` | 248-377 | Procesa XMLs, cruza con PDF, asigna guías |
|
||
|
|
| `_guardar_resultado` | 379-408 | Guarda JSON con datos extraídos |
|
||
|
|
| `_build_sap_draft` | 410-569 | Construye payload del draft SAP B1 |
|
||
|
|
| `_validate_prices` | 571-745 | Valida precios contra DeliveryNotes SAP |
|
||
|
|
| `_build_validation_html` | 747-775 | Genera tabla HTML para notificación |
|
||
|
|
| `_build_notification_body` | 777-814 | Arma cuerpo del email de notificación |
|
||
|
|
| `_guardar_draft_json` | 816-842 | Guarda draft JSON para depuración |
|