se actualiza la documentación: sapb1_manager, nombres de funciones y cifras

- Nueva página docs/sapb1_manager.md: sesión, funciones, clasificación de
  errores (SapNoDisponible frente a rechazo de SAP), búsqueda de facturas
  existentes y cómo se ubica una guía.
- procesar_pdfs.md y procesar_xmls.md usaban los nombres anteriores a la
  división de pipeline.py (_procesar_pdfs, _ruta_carpeta...) y números de
  línea que envejecen; ahora apuntan a documentos.py.
- inventario.md: árbol de dependencias con los módulos nuevos.
- pipeline.md: _procesar_factura, importes_coinciden, hana_disponible y
  buscar_factura_existente; validar_precios.md, hana_manager.md, main.md y
  procesar_xmls.md con las notas que faltaban; README sin la cifra de pruebas
  vieja.

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

docs/procesar_xmls.md

@@ -1,9 +1,9 @@
-# _procesar_xmls — Extracción y cruce de datos desde XML
+# procesar_xmls — Extracción y cruce de datos desde XML
 
 ## Ubicación
 
-- **Archivo:** `pipeline.py` (línea 310-463, función anidada en `_procesar_un_correo`)
-- **Librería:** `sunat_schema.py` (línea 1-720)
+- **Archivo:** `documentos.py`, función `procesar_xmls(email, download_folder, pdf_cache)`; la llama `pipeline._procesar_un_correo`
+- **Librería:** `sunat_schema.py`
 
 ---
 
@@ -11,7 +11,7 @@
 
 ```mermaid
 flowchart TD
-    A[_procesar_xmls] --> B[Iterar adjuntos del email]
+    A[procesar_xmls] --> B[Iterar adjuntos del email]
     B --> C{Es .xml?}
     C -- No --> B
     C -- Sí --> D[extraer_datos_xml]:::highlight
@@ -23,7 +23,7 @@ flowchart TD
     CDR2 --> B
     CDR -- No --> G[Renombrar XML a nombre canónico]
     G --> H[Construir nombre PDF canónico y buscarlo]
-    H --> RED[_copiar_a_red]:::highlight
+    H --> RED[copiar_a_red]:::highlight
     RED --> I[Cruzar documentos_referencia desde PDF si faltan]:::highlight
     I --> J[Asignar guías de remisión por línea]:::highlight
     J --> K[Agregar a lista de documentos]
@@ -40,9 +40,9 @@ flowchart TD
 ## Paso a paso
 
 ```
-_procesar_xmls(pdf_cache) → list[dict]
+procesar_xmls(email, download_folder, pdf_cache) → list[dict]
 │
-├── carpeta = _ruta_carpeta(download_folder)
+├── carpeta = ruta_carpeta(download_folder)
 │
 ├── Por cada adjunto en email["adjuntos"]:
 │   │
@@ -67,7 +67,7 @@ _procesar_xmls(pdf_cache) → list[dict]
 │   │   └── 2. Fallback: mismo nombre que el XML renombrado, con extensión .pdf
 │   │   └── data["ruta_pdf"] = ruta encontrada o None
 │   │
-│   ├── _copiar_a_red(data, _log)
+│   ├── copiar_a_red(data)
 │   │   └── Copia PDF/XML a la ruta de red (RUTA_RED_FACTURACION), si está configurada.
 │   │       Guarda data["ruta_red_pdf"] / data["ruta_red_xml"] (ver docs/pipeline.md).
 │   │
@@ -215,7 +215,7 @@ pdf_cache[nombre_canonico].items[] → extraer_referencias()
       └── guia_transportista → ref tipo 31
 ```
 
-### 2. Asignar guías por línea (dentro de `_procesar_xmls`)
+### 2. Asignar guías por línea (dentro de `procesar_xmls`)
 
 Prioridad para asignar `guias_remision` y `guia_transportista` a cada línea de la factura, en el orden en que realmente se aplican en el código:
 
@@ -228,9 +228,9 @@ Prioridad para asignar `guias_remision` y `guia_transportista` a cada línea de
 
 Después de procesar todos los XML del correo, si una factura referencia una **guía transportista (31)** y esa guía (presente como documento independiente en el mismo correo) referencia a su vez una o más **GRE (09)**, esas GRE se propagan a las líneas de la factura que aún no tengan `guias_remision` asignadas.
 
-### 4. `_completar_guias` (paso posterior, fuera de `_procesar_xmls`)
+### 4. `completar_guias` (paso posterior, fuera de `procesar_xmls`)
 
-Si tras los pasos anteriores alguna línea sigue sin `guias_remision`, `_completar_guias` (ver `docs/pipeline.md`) las copia desde los `items[]` del PDF cache, parseando el texto con regex (`{T/V/E}{serie}-{numero}`).
+Si tras los pasos anteriores alguna línea sigue sin `guias_remision`, `completar_guias` (ver `docs/pipeline.md`) las copia desde los `items[]` del PDF cache, parseando el texto con regex (`{T/V/E}{serie}-{numero}`).
 
 ---
 
@@ -276,4 +276,4 @@ Si tras los pasos anteriores alguna línea sigue sin `guias_remision`, `_complet
 ]
 ```
 
-`ruta_red_pdf`/`ruta_red_xml` solo aparecen si `RUTA_RED_FACTURACION` está configurada en `.env` y la copia fue exitosa; se usan luego en `_build_sap_draft` para llenar `U_VS_ANEXO_PDF`/`U_VS_ANEXO_XML` (ver `docs/pipeline.md`).
+`ruta_red_pdf`/`ruta_red_xml` solo aparecen si `RUTA_RED_FACTURACION` está configurada en `.env`, es una ruta absoluta en el sistema operativo (una ruta UNC fuera de Windows no lo es: no se copia) y la copia fue exitosa; se usan luego en `draft_sap.build_sap_draft` para llenar `U_VS_ANEXO_PDF`/`U_VS_ANEXO_XML` (ver `docs/pipeline.md`).