# pipeline.py — run_pipeline

## Estructura general

```
pipeline.py
├── CONSTANTES: CUADRO_VALOR_REFERENCIAL
├── HELPERS: _ruta_carpeta()
├── PASO 1: step_authenticate() → token | None
├── PASO 2: step_fetch_emails() → list[dict]
├── _procesar_un_correo() → None  (core)
└── run_pipeline() → None
```

---

## Proceso de `run_pipeline()`

```mermaid
flowchart TD
    A[run_pipeline] --> B[init_db]
    B --> C[Calcular rango fechas: ayer-dias → hoy]
    C --> D[step_authenticate]
    D --> E{Token obtenido?}
    E -- No --> F[❌ Abortar]
    E -- Sí --> G[step_fetch_emails]
    G --> H{Hay correos?}
    H -- No --> I[Fin]
    H -- Sí --> J[Bucle: por cada email]
    J --> K[_procesar_un_correo]:::highlight
    K --> J

    classDef highlight fill:#fff3e0,stroke:#e65100,stroke-width:3px;
```

---

## Proceso de `_procesar_un_correo()`

```mermaid
flowchart TD
    A[_procesar_un_correo] --> B[1-2. BD: ¿ya procesado?]
    B -- Sí --> C[⏭️ Saltar]
    B -- No --> D[Guardar en BD]
    D --> E[3. _descargar_adjuntos]
    E --> F{Hay adjuntos?}
    F -- No --> C
    F -- Sí --> G[4. _descomprimir ZIPs]
    G --> H[5. _filtrar_y_limpiar]
    H --> I{Hay PDF/XML?}
    I -- No --> C
    I -- Sí --> J[6. _procesar_pdfs]:::highlight
    J --> K[7. _procesar_xmls]:::highlight
    K --> L{Hay documentos?}
    L -- No --> C
    L -- Sí --> M[8. _guardar_resultado]
    M --> N[9. Filtrar facturas tipo 01]
    N --> O{Hay facturas?}
    O -- No --> C
    O -- Sí --> P[Bucle: por cada factura]

    P --> Q[10. _validate_prices]:::highlight
    Q --> R[11. _build_sap_draft]:::highlight
    R --> S[12. _guardar_draft_json]
    S --> T{Todas coinciden?}
    T -- Sí --> U[13. sapb1_manager.create_draft]
    T -- No --> V[⏭️ Draft NO creado]
    U --> W[14. outlook_utilities.send_email]
    V --> W
    W --> P

    classDef highlight fill:#fff3e0,stroke:#e65100,stroke-width:3px;
```

---

## Funciones internas de `_procesar_un_correo`

| Función | Línea | Propósito |
|---------|-------|-----------|
| `_descargar_adjuntos()` | 107 | Descarga adjuntos vía Microsoft Graph |
| `_descomprimir()` | 136 | Descomprime archivos ZIP |
| `_filtrar_y_limpiar()` | 151 | Filtra solo PDF/XML, elimina el resto |
| **`_procesar_pdfs()`** | **193** | **Extrae datos de PDFs, renombra, genera cache** |
| **`_procesar_xmls(pdf_cache)`** | **248** | **Procesa XMLs, cruza con PDF, asigna guías** |
| `_guardar_resultado(documentos)` | 372 | Guarda JSON con datos extraídos |
| **`_build_sap_draft(factura, resultados_val)`** | **403** | **Construye payload del draft SAP B1** |
| **`_validate_prices(factura)`** | **564** | **Valida precios contra DeliveryNotes SAP** |
| `_build_validation_html(resultados)` | 741 | Genera tabla HTML para notificación |
| `_build_notification_body(status, factura, validation_table)` | 771 | Arma cuerpo del email de notificación |
| `_guardar_draft_json(draft, serie, numero)` | 810 | Guarda draft JSON para depuración |

---

## Flujo de llamadas

```
run_pipeline
  ├── step_authenticate
  ├── step_fetch_emails
  └── _procesar_un_correo (por cada email)
        ├── _descargar_adjuntos
        ├── _descomprimir
        ├── _filtrar_y_limpiar
        ├── _procesar_pdfs
        ├── _procesar_xmls
        ├── _guardar_resultado
        ├── _validate_prices (por factura)
        │     └── sapb1_manager.get_delivery_notes
        ├── _build_sap_draft
        ├── _guardar_draft_json
        ├── sapb1_manager.create_draft
        └── outlook_utilities.send_email
```