docs/validar_precios.md

# Validar Precios

```mermaid
flowchart TD
    A["factura con lineas[]"] --> B["Obtener maestro zonas<br>SAP U_IDC_ZONAS"]
    B --> C["Por cada línea de factura"]

    C --> D{"cantidad > 0?"}
    D -->|No| E["Resultado: cantidad cero, sin validar"]
    D -->|Sí| F{"¿Hay guías de remisión?"}
    F -->|No| G["Resultado: sin guía de referencia"]

    F -->|Sí| H["Por cada guía en guias[]"]
    H --> I["Consultar SAP B1<br>get_delivery_notes()"]
    I --> I2{"¿Guía encontrada en<br>ODLN o en OWTR?"}
    I2 -->|ODLN| I3["Documento = DeliveryNotes(DocEntry)"]
    I2 -->|OWTR| I4["Documento = StockTransfers(DocEntry)<br>→ leer U_IDC_NUMOV<br>→ Documento = Orders(U_IDC_NUMOV)"]
    I3 --> J["Por cada documento<br>(DeliveryNote u Orden de Venta)"]
    I4 --> J

    J --> K["Obtener zona desde<br>U_IDC_DESTINO"]
    K --> L["Extraer WarehouseCode<br>de DocumentLines[0]"]
    L --> M["Acumular Weight1<br>de DocumentLines[0]"]
    M --> N["Por cada línea FL* en<br>DocumentLines"]


    N --> O["Sumar LineTotal"]
    O --> P["Máx Quantity"]
    P --> Q["Sumar PriceAfterVAT"]
    Q --> R["Construir guias_lt[]<br>para cada guía:<br>line_total, quantity,<br>price_after_vat_sum,<br>warehouse_code, zona, weight1"]

    R --> S["Comparar total_linea (XML)<br>vs sap_total (FL*)"]
    S --> T{"importes_coinciden:<br>diferencia redondeada a 2 decimales ≤ 0.01<br>y ninguna guía falló?"}
    T -->|Sí| U["ok = True<br>draft_quantity = int(Quantity máx FL*)<br>draft_price = suma PriceAfterVAT FL*"]
    T -->|No| V["ok = False<br>draft_quantity = int(cantidad XML)<br>draft_price = total_linea / cantidad"]

    U --> W["Resultado por línea:<br>ok, draft_price, sap_price,<br>label, warehouse_code, guias_lt[]"]
    V --> W
    W --> C
    C --> X["todas_coinciden = all(ok)"]
```

## Notas

- Si la consulta a SAP de una guía lanza error, esa guía queda con ceros y la línea completa se marca `ok = False` (se registra como `WARNING`).
- Si ninguna guía de la línea existe en SAP, el resultado lleva `label = "Sin guías SAP"` y se registra "línea saltada", pero igual queda `ok = False` (salvo que `total_linea` sea 0), por lo que `todas_coinciden` es falso y no se crea el draft.
- `weight1` (peso de la primera línea de cada guía) se sigue calculando y guardando en `guias_lt[]`, pero el draft ya no lo usa.
- Función: `draft_sap.validate_prices(factura)` → `(todas_coinciden, resultados)`.
- **Tolerancia:** `pipeline_utils.importes_coinciden` redondea la diferencia entre el importe de la línea del XML y el de SAP a 2 decimales (lo que muestra un comprobante) y admite hasta 1 céntimo. Comparar la diferencia sin redondear (`abs(a - b) < 0.01`) no era fiable por la coma flotante: 431.41 − 431.40 daba `0.01000000000004775` (se rechazaba) y 624.39 − 624.38 daba `0.00999999999999091` (se aceptaba), así que el mismo céntimo pasaba o no según el importe. Con datos reales de SAP, ninguna línea cambió de resultado al introducir el redondeo. Se usa también para comparar el valor referencial del correo técnico.
- **Caída de SAP vs. guía inexistente:** `validate_prices` deja pasar `SapNoDisponible` (timeout, sin conexión, HTTP 5xx) en vez de convertirla en un error de la guía; el pipeline la trata como servicio fuera de línea. Otros errores de consulta quedan en `guias_lt[].error` (ver `draft_sap.hay_error_de_consulta`) y se tratan como error interno. Una guía sin datos en SAP solo se reporta como "no encontrada" si HANA responde (`draft_sap.hana_disponible`).