se agrega README y se completa y corrige la documentación

README en la raíz con instalación, uso, estructura e índice de docs. Nuevos
docs/hana_manager.md y docs/outlook_utilities.md. Se renombran los .mkd a .md
y se corrigen construir_draft y validar_precios, que describían lógica ya
inexistente (CUADRO_VALOR_REFERENCIAL, use_sap_prices). Se actualizan los
docstrings obsoletos y las cifras de líneas del inventario.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs/validar_precios.mkd

@@ -1,41 +0,0 @@
-# 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{"abs(diff) < 0.01?"}
-    T -->|Sí| U["ok = True<br>use_sap_prices si qty==1<br>y total_sap_qty≠1"]
-    T -->|No| V["ok = False"]
-
-    U --> W["Resultado por línea:<br>ok, draft_price, sap_price,<br>draft_cantidad, guias_lt[]"]
-    V --> W
-    W --> C
-    C --> X["todas_coinciden = all(ok)"]
-```