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>

draft_sap.py

@@ -72,7 +72,7 @@ def build_sap_draft(factura: dict, resultados_val: list[dict]) -> dict:
             ``guias_remision[]``, ``tiene_detraccion``, etc.).
         resultados_val: Lista de resultados de ``validate_prices``,
             uno por línea de factura. Cada elemento contiene
-            ``guias_lt[]``, ``ok``, ``use_sap_prices``, etc.
+            ``guias_lt[]``, ``ok``, etc.
 
     Returns:
         Dict con la estructura completa del draft SAP B1 lista para
@@ -226,9 +226,9 @@ def validate_prices(factura: dict) -> tuple[bool, list[dict]]:
           ``warehouse_code`` y ``zona``.
     3. Determina si los precios coinciden (``ok``):
        ``abs(total_linea - sap_total) < 0.01``.
-    4. Decide si se deben usar precios de SAP en el draft
-       (``use_sap_prices``):
-       ``ok and int(cantidad) == 1 and int(total_sap_qty) != 1``.
+    4. Fija ``draft_quantity`` y ``draft_price`` de cada guía:
+       si ``ok``, usa SAP (``int(quantity)`` y ``price_after_vat_sum``);
+       si no, usa el XML (``int(cantidad)`` y ``total_linea / cantidad``).
 
     Args:
         factura: Diccionario con los datos de la factura (debe contener
@@ -241,8 +241,8 @@ def validate_prices(factura: dict) -> tuple[bool, list[dict]]:
               ``ok=True``.
             - ``resultados``: Lista de resultados por línea, cada uno
               con claves: ``grflete``, ``ok``, ``draft_price``,
-              ``sap_price``, ``warehouse_code``, ``draft_cantidad``,
-              ``use_sap_prices``, ``guias_lt[]``.
+              ``sap_price``, ``label``, ``warehouse_code``, ``guias_lt[]``
+              (y ``draft_cantidad`` en las líneas sin validar).
 
     Example:
         Factura con guía ``T001-127773`` y SAP devuelve