se responde al remitente con las plantillas de aceptado/rechazado

El sistema contesta a quien envió el correo con la plantilla que corresponda.
Por defecto (NOTIFICACION_MODO=prueba) la respuesta va solo al equipo con el
asunto "[PRUEBA → remitente]"; en modo real va al remitente con copia oculta
al equipo. El correo técnico (tablas de SAP, JSON) pasa a ir solo al equipo.

- respuesta_proveedor.py: contextos de las plantillas, envío y protecciones
  (remitente desconocido o sin dominio, propio buzón, no-reply, mensajes
  automáticos, respuestas a notificaciones, límite de 3 por remitente/24 h).
- observaciones.py: motivos de rechazo con título, filas y cómo corregir
  (borrador de textos); también para correos sin comprobante válido.
- Un error de SAP/HANA o un fallo inesperado no se le comunica al proveedor y
  ya no tumba el ciclo; "guía no encontrada" exige que HANA responda.
- outlook_utilities: es_mensaje_automatico y copia oculta en send_email.
- seguimiento: notificacion_destinatario (con migración) y
  contar_respuestas_correo.
- config_validator anuncia el modo activo; documentación y pruebas.

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

docs/inventario.md

@@ -5,27 +5,30 @@
 | Archivo | Líneas | Rol |
 |---------|--------|-----|
 | `main.py` | 137 | Demonio orquestador (loop de horarios) |
-| `pipeline.py` | 272 | Orquestador del pipeline (autenticar, descargar correos, procesar un correo) |
+| `pipeline.py` | 344 | Orquestador del pipeline (autenticar, descargar correos, procesar un correo) |
 | `pipeline_utils.py` | 27 | `log()` (logging con indentación de árbol y `severity`) y `ruta_carpeta()` |
 | `adjuntos.py` | 82 | Descarga de adjuntos (Graph) y filtrado PDF/XML |
 | `documentos.py` | 372 | Extracción PDF/XML, asignación de guías, copia a red |
 | `persistencia.py` | 163 | Guardado de JSON de resultados y de drafts |
-| `draft_sap.py` | 414 | Validación de precios contra SAP, valor referencial y construcción del draft |
+| `draft_sap.py` | 442 | Validación de precios contra SAP, valor referencial y construcción del draft |
 | `notificaciones.py` | 117 | Cuerpos HTML de los correos de notificación |
 | `sunat_schema.py` | 722 | Parseo de XML SUNAT (Invoice, DespatchAdvice) |
 | `pdf_utilities.py` | 471 | Parseo de PDFs (factura, guías) |
 | `sapb1_manager.py` | 401 | Comunicación con SAP B1 Service Layer |
-| `outlook_utilities.py` | 249 | Comunicación con Microsoft Graph |
+| `outlook_utilities.py` | 274 | Comunicación con Microsoft Graph |
 | `hana_manager.py` | 141 | Comunicación con SAP HANA directa (fallback de `sapb1_manager` y valor referencial) |
-| `database_utilities.py` | 150 | SQLite local (cache de correos) |
+| `database_utilities.py` | 156 | SQLite local (cache de correos) |
 | `tools/*_prueba.py`, `tools/completar_guias_pipeline.py`, `tools/explorar_notes_xml.py` | — | Scripts manuales sobre `tests/fixtures/correos_prueba/` (anteriores a la suite pytest) |
 | `tools/consulta_rapida.py` | 120 | Script auxiliar para reprocesar correos por ID (sets en `tools/ids_prueba.json`) |
-| `seguimiento.py` | 187 | Códigos de seguimiento y resultado por comprobante (tabla `comprobantes`) |
-| `config_validator.py` | 83 | Valida el `.env` al arrancar (obligatorias, ruta de red, avisos de SSL) |
+| `seguimiento.py` | 206 | Códigos de seguimiento y resultado por comprobante (tabla `comprobantes`) |
+| `respuesta_proveedor.py` | 285 | Respuesta de aceptado/rechazado al remitente (modo prueba/real, protecciones, contextos) |
+| `observaciones.py` | 157 | Catálogo de motivos de rechazo y sus textos |
+| `plantillas.py` | 123 | Renderizador de las plantillas HTML de correo |
+| `config_validator.py` | 98 | Valida el `.env` al arrancar (obligatorias, ruta de red, avisos de SSL) |
 | `email_utilities.py` | 55 | Utilitarios de adjuntos (ZIP, filtrado) |
 | `logger_manager.py` | 150 | Logging a archivo rotado (30 días) + consola + captura de `print()` |
 
-Documentación por módulo: `seguimiento.py` → [seguimiento.md](seguimiento.md), `outlook_utilities.py` → [outlook_utilities.md](outlook_utilities.md), `hana_manager.py` → [hana_manager.md](hana_manager.md), validación y draft → [validar_precios.md](validar_precios.md) y [construir_draft.md](construir_draft.md).
+Documentación por módulo: `respuesta_proveedor.py`/`observaciones.py`/`plantillas.py` → [respuesta_proveedor.md](respuesta_proveedor.md), `seguimiento.py` → [seguimiento.md](seguimiento.md), `outlook_utilities.py` → [outlook_utilities.md](outlook_utilities.md), `hana_manager.py` → [hana_manager.md](hana_manager.md), validación y draft → [validar_precios.md](validar_precios.md) y [construir_draft.md](construir_draft.md).
 
 ---
 

docs/outlook_utilities.md

@@ -1,6 +1,6 @@
 # outlook_utilities.py — Microsoft Graph (Outlook)
 
-Cliente mínimo de Microsoft Graph para leer la bandeja de entrada, bajar adjuntos y enviar las notificaciones. Autenticación con MSAL (client credentials, permisos de aplicación).
+Cliente mínimo de Microsoft Graph para leer la bandeja de entrada, bajar adjuntos y enviar las notificaciones. Autenticación con MSAL (client credentials, permisos de aplicación). Cómo obtener las credenciales: [configurar_msal.md](configurar_msal.md).
 
 ## Estructura
 
@@ -19,9 +19,9 @@ outlook_utilities.py
 | Función | Endpoint Graph | Qué hace |
 |---------|----------------|----------|
 | `get_access_token` | `login.microsoftonline.com/{TENANT_ID}` (scope `.default`) | Obtiene el token de aplicación. Lanza `Exception` si MSAL devuelve error. |
-| `get_emails` | `GET /users/{user}/mailFolders/Inbox/messages` | Correos de la bandeja de entrada del rango, con paginación (`$top=50`, sigue `@odata.nextLink`). Devuelve `id`, `fecha`, `sender`, `subject`, `has_attach`. Lanza `Exception` si el status no es 200. |
+| `get_emails` | `GET /users/{user}/mailFolders/Inbox/messages` | Correos de la bandeja de entrada del rango, con paginación (`$top=50`, sigue `@odata.nextLink`). Devuelve `id`, `fecha`, `sender`, `subject`, `has_attach` y `es_automatico` (calculado con los encabezados del mensaje). Lanza `Exception` si el status no es 200. |
 | `download_attachments` | `GET /users/{user}/messages/{id}/attachments` | Guarda en `download_path` los adjuntos tipo archivo y devuelve sus nombres. Crea la carpeta si no existe. |
-| `send_email` | `POST /users/{from}/sendMail` | Envía HTML con adjuntos y CC; guarda copia en Enviados. Devuelve `True` si Graph responde 202; `False` (con `ERROR` en el log) en cualquier otro caso. No lanza excepciones. |
+| `send_email` | `POST /users/{from}/sendMail` | Envía HTML con adjuntos, CC y copia oculta (`bcc_recipients`); guarda copia en Enviados. Devuelve `True` si Graph responde 202; `False` (con `ERROR` en el log) en cualquier otro caso. No lanza excepciones. |
 
 ## Zona horaria
 
@@ -38,3 +38,5 @@ Los adjuntos se leen de las rutas indicadas. Una ruta inexistente se omite con u
 - `VERIFY_SSL` se respeta en `get_access_token`, `get_emails` y `download_attachments`, pero `send_email` tiene `verify_ssl = False` fijo y lo ignora.
 - El módulo ejecuta `warnings.filterwarnings("ignore")`, lo que silencia todas las advertencias de Python del proceso (incluidas las de certificado SSL).
 - `get_access_token` retorna `None` (sin lanzar error) si MSAL devuelve un resultado vacío.
+- `es_mensaje_automatico(headers)` marca como automáticos los mensajes con `Auto-Submitted` distinto de `no`, `X-Auto-Response-Suppress`, `X-Autoreply`, `Precedence` (`bulk`, `junk`, `list`, `auto_reply`) o `Content-Type` de informe de entrega (rebotes). El sistema no responde a esos mensajes.
+

docs/pipeline.md

@@ -14,7 +14,10 @@ Módulos que orquesta _procesar_un_correo():
 ├── documentos.py      procesar_pdfs, procesar_xmls, completar_guias, validar_guias, copiar_a_red
 ├── persistencia.py    guardar_resultado, guardar_draft_json
 ├── draft_sap.py       validate_prices, obtener_valor_referencial_sap, build_sap_draft
-├── notificaciones.py  build_validation_html, build_valor_referencial_html, build_notification_body
+├── notificaciones.py  build_validation_html, build_valor_referencial_html, build_notification_body (correo técnico)
+├── observaciones.py   motivos de rechazo con sus textos
+├── respuesta_proveedor.py  respuesta con plantilla al remitente (modo prueba/real, protecciones)
+├── plantillas.py      renderizador de las plantillas HTML
 └── pipeline_utils.py  log, ruta_carpeta
 ```
 
@@ -54,29 +57,34 @@ flowchart TD
     F -- Sí --> G[4. _descomprimir ZIPs]
     G --> H[5. filtrar_y_limpiar]
     H --> I{Hay PDF/XML?}
-    I -- No --> C
+    I -- No --> RC[Rechazo del correo<br>responder al remitente]
     I -- Sí --> J[6. procesar_pdfs]:::highlight
     J --> K[7. procesar_xmls]:::highlight
     K --> K2[8. completar_guias]
     K2 --> K3[9. validar_guias]
     K3 --> L{Hay documentos?}
-    L -- No --> C
+    L -- No --> RC
     L -- Sí --> M[10. guardar_resultado]
     M --> N[11. Filtrar facturas tipo 01]
     N --> O{Hay facturas?}
-    O -- No --> C
+    O -- No --> RC
     O -- Sí --> P[Bucle: por cada factura]
 
     P --> Q[12. validate_prices]:::highlight
     Q --> Q2[12.5 obtener_valor_referencial_sap]
     Q2 --> R[13. build_sap_draft]:::highlight
     R --> S[14. guardar_draft_json]
-    S --> T{Todas coinciden?}
-    T -- Sí --> U[15. sapb1_manager.create_draft]
-    T -- No --> V[⏭️ Draft NO creado]
-    U --> W[16. outlook_utilities.send_email]
+    S --> T{¿Error de SAP/HANA?}
+    T -- Sí --> X[estado error]
+    T -- No --> T2{Todas coinciden?}
+    T2 -- Sí --> U[15. sapb1_manager.create_draft]
+    T2 -- No --> V[estado rechazado + observaciones]
+    U --> U2[estado aceptado]
+    U2 --> W[16. Correo técnico al equipo<br>+ respuesta con plantilla al remitente]
     V --> W
+    X --> W2[16. Correo técnico al equipo<br>NO se responde al proveedor]
     W --> P
+    W2 --> P
 
     classDef highlight fill:#fff3e0,stroke:#e65100,stroke-width:3px;
 ```
@@ -174,5 +182,23 @@ run_pipeline
         │     ├── guardar_draft_json
         │     ├── sapb1_manager.create_draft  (si todas las líneas coinciden)
         │     ├── build_notification_body
-        │     └── outlook_utilities.send_email
+        │     ├── respuesta_proveedor.enviar_a_equipo      (correo técnico, solo equipo)
+        │     └── respuesta_proveedor.responder            (plantilla aceptado/rechazado, ver respuesta_proveedor.md)
 ```
+
+---
+
+## Qué se envía y a quién (paso 16)
+
+| Resultado de la factura | Correo técnico (tablas de SAP, JSON adjuntos) | Respuesta con plantilla |
+|-------------------------|-----------------------------------------------|-------------------------|
+| `aceptado` (draft creado) | Equipo | Aceptado, al remitente |
+| `rechazado` (precio, guía…) | Equipo | Rechazado con observaciones, al remitente |
+| `error` (SAP/HANA, fallo inesperado) | Equipo | **Ninguna**: es una falla nuestra, no del proveedor |
+| Correo sin comprobante válido (sin PDF/XML, sin XML, sin factura) | — | Rechazado sin comprobante, al remitente |
+| Correo sin adjuntos | — | Ninguna |
+
+"Al remitente" depende de `NOTIFICACION_MODO` (en modo `prueba` va al equipo) y de las protecciones. Todo en [respuesta_proveedor.md](respuesta_proveedor.md).
+
+Un fallo inesperado al procesar una factura ya no interrumpe el ciclo: se registra como `error`, se avisa al equipo y se sigue con la siguiente.
+

docs/respuesta_proveedor.md

@@ -0,0 +1,92 @@
+# respuesta_proveedor.py — Respuesta al proveedor
+
+Cuando alguien envía un correo con el XML y el PDF de una factura, el sistema valida y **responde a esa misma dirección** con la plantilla de **aceptado** o de **rechazado** (`plantilla/plantilla-aceptado.html` y `plantilla-rechazado.html`). Aparte, el equipo recibe un correo técnico (tablas de SAP, JSON adjuntos).
+
+Piezas: `respuesta_proveedor.py` (contexto, protecciones, envío), `observaciones.py` (motivos de rechazo y sus textos), `plantillas.py` (renderizador) y `seguimiento.py` (código de seguimiento y registro).
+
+## Qué se responde
+
+| Situación | Respuesta al remitente |
+|-----------|------------------------|
+| Draft creado en SAP | **Aceptado** |
+| Precios que no coinciden, guía inexistente, línea sin guía, cantidad cero | **Rechazado** con una observación por motivo |
+| Correo con adjuntos pero sin PDF ni XML válido, o con PDF y sin XML, o sin ninguna factura (tipo 01) | **Rechazado** sin comprobante: no muestra proveedor, número ni tabla de guías |
+| Error de SAP o de HANA, o un fallo inesperado | **Nada**: es una falla nuestra. Solo se avisa al equipo |
+| Correo sin adjuntos | **Nada** |
+
+Una respuesta por comprobante: un correo con 3 facturas genera 3 respuestas. La aceptación significa "draft creado en SAP". La diferencia de valor referencial XML vs SAP es solo informativa y no rechaza.
+
+> **Guía "no encontrada" y caídas de HANA.** `get_delivery_notes` devuelve lista vacía tanto si la guía no existe como si SAP/HANA fallan. Antes de rechazar por guía no encontrada se comprueba que HANA responde; si no, se trata como error interno y no se le dice nada al proveedor.
+
+## Modo prueba y modo real
+
+`NOTIFICACION_MODO` en el `.env`:
+
+| Modo | A quién va la respuesta | Asunto |
+|------|-------------------------|--------|
+| `prueba` (**por defecto**) | Al equipo (`NOTIFICACION_EQUIPO`), **nunca** al remitente | `[PRUEBA → remitente] Aceptado · Factura F002-486 · ABR-…` |
+| `real` | Al remitente, con **copia oculta** al equipo | `Aceptado · Factura F002-486 · ABR-…` |
+
+Cualquier otro valor se trata como `prueba`. Al arrancar, `config_validator` deja en el log una advertencia con el modo activo. Pasar a `real` es una decisión explícita: no ocurre solo.
+
+## Protecciones: cuándo NO se responde
+
+El sistema contesta solo y a terceros, así que no responde a:
+
+| Caso | Motivo registrado |
+|------|-------------------|
+| Remitente vacío o desconocido | remitente desconocido |
+| Dirección sin dominio válido (por ejemplo `test@local`) | dirección no válida |
+| El propio buzón del sistema | el remitente es el propio buzón |
+| `no-reply`, `noreply`, `do-not-reply`, `no-responder`, `mailer-daemon`, `postmaster`, `bounce` | dirección automática |
+| Mensajes automáticos (respuestas automáticas, rebotes, listas) | mensaje automático |
+| En correos **sin comprobante**: asunto con `Re:`/`RV:` o que cita un código `ABR-…` | parece una respuesta a una notificación nuestra |
+| En correos sin comprobante: más de 3 respuestas al mismo remitente en 24 h | límite de respuestas |
+
+Cada omisión queda en `comprobantes` como `notificacion_estado = omitida`, con el motivo.
+
+## Qué ve el proveedor
+
+- **Importe por guía:** el importe de la línea aparece una vez, en su primera guía; las demás dicen "incluida en la línea". Todas las guías de una línea llevan el mismo resultado, porque la validación es por línea.
+- **Rechazo por precio:** se muestran "Importe en su factura" e "Importe esperado" (el de SAP).
+- **Pago estimado:** solo si hay condición de pago (fecha de vencimiento posterior a la de contabilización).
+- **Sin adjuntos internos:** la respuesta no lleva archivos.
+
+## Observaciones (`observaciones.py`)
+
+Los textos son un **borrador para revisar**; se cambian en ese archivo sin tocar la lógica.
+
+| Código | Cuándo |
+|--------|--------|
+| `precio_no_coincide` | El total de la línea del XML no coincide con la suma de SAP |
+| `guia_no_encontrada` | SAP no devuelve datos para la guía |
+| `linea_sin_guia` | Una línea no indica su guía de remisión |
+| `cantidad_cero` | Una línea tiene cantidad cero |
+| `sin_pdf_xml` | El correo trae adjuntos, pero ninguno es PDF ni XML |
+| `falta_xml` | Hay PDF y ningún XML |
+| `sin_factura` | El XML no contiene una factura electrónica (tipo 01) |
+
+## Configuración (`.env`)
+
+| Variable | Para qué | Por defecto |
+|----------|----------|-------------|
+| `NOTIFICACION_MODO` | `prueba` o `real` | `prueba` |
+| `NOTIFICACION_EQUIPO` | Direcciones internas (coma o `;`): correo técnico, y respuestas en modo prueba | `jlopez@aberio.com.pe`, `gcalle@pucp.pe` |
+| `NOTIFICACION_CONTACTO` | Dirección del botón "Escribir a Aberio" | el buzón `EMAIL` |
+| `LOGO_URL` | URL pública (https) del logo | vacío: sin logo |
+
+El buzón `EMAIL` es también el `envio_correo` al que se pide reenviar el comprobante corregido.
+
+## Cómo probar
+
+1. **Vista previa y envío de ejemplos:** `python tools/previsualizar_plantillas.py` (ver su ayuda). Los ejemplos están en `plantilla/ejemplos.json`.
+2. **Piloto en modo prueba:** con `NOTIFICACION_MODO=prueba` el flujo completo corre y las respuestas llegan solo al equipo, indicando en el asunto a quién habrían ido. El correo técnico también.
+3. **Pasar a real:** cuando el equipo valide los correos, cambiar a `NOTIFICACION_MODO=real`. Revisar antes que `LOGO_URL` tenga valor.
+
+## Limitaciones conocidas
+
+- **Un fallo de envío no se reintenta.** Queda `fallida` en `comprobantes`, pero el correo ya está marcado como procesado.
+- **Si SAP está caído, el correo tampoco se reintenta.** Se avisa al equipo y el correo queda procesado (con estado `error`).
+- **Un comprobante ya aceptado que se reenvía** genera otro draft y otra respuesta "Aceptado"; hoy solo se advierte en el log.
+- La respuesta va a la dirección `from` del mensaje. Si alguien reenvía la factura de un proveedor, la respuesta le llega a quien reenvió.
+- No se prueba contra el logo real ni contra Outlook de escritorio: hay que revisar los correos a mano.

docs/seguimiento.md

@@ -22,6 +22,7 @@ Los datos viven en la tabla `comprobantes` de `emails.db`. El esquema lo crea `d
 | `doc_entry` | DocEntry del draft creado en SAP |
 | `veces_recibido` | Cuántos correos distintos trajeron este comprobante |
 | `notificacion_estado`, `notificacion_error`, `notificacion_fecha` | `pendiente`, `enviada`, `fallida` u `omitida`, y su motivo |
+| `notificacion_destinatario` | Direcciones a las que se envió **de verdad** (en modo prueba no son las del remitente) |
 | `creado_en`, `actualizado_en` | Marcas de tiempo |
 
 ## Funciones
@@ -32,7 +33,8 @@ Los datos viven en la tabla `comprobantes` de `emails.db`. El esquema lo crea `d
 | `registrar_correo(email_id)` | Igual, para un correo sin comprobante. Idempotente por correo. |
 | `obtener(codigo)` | Devuelve el registro o `None`. |
 | `actualizar_resultado(codigo, estado, observaciones=None, doc_entry=None)` | Guarda el resultado. `ValueError` si el estado no es válido, `LookupError` si no existe el código. |
-| `registrar_notificacion(codigo, estado, error=None)` | Guarda el estado de la notificación. Mismas excepciones. |
+| `registrar_notificacion(codigo, estado, error=None, destinatario=None)` | Guarda el estado de la notificación y a quién se envió. Mismas excepciones. |
+| `contar_respuestas_correo(remitente, horas=24)` | Respuestas `enviada` a ese remitente en correos sin comprobante: el freno contra bucles de `respuesta_proveedor`. |
 
 ## Uso en el pipeline
 
@@ -44,12 +46,17 @@ En `pipeline._procesar_un_correo`, cada factura se registra al empezar (`_regist
 | Precios no coinciden con SAP | `rechazado` | `[{"codigo": "precios_no_coinciden"}]` |
 | Error al crear el draft | `error` | `[{"codigo": "error_sap", "detalle": "..."}]` |
 
+`init_db` agrega la columna `notificacion_destinatario` a una tabla creada antes sin ella, sin tocar los datos.
+
 El seguimiento **nunca impide procesar la factura**: si falla la base de datos, se registra un `WARNING` y el flujo continúa. Si el comprobante ya había llegado antes, se registra un `WARNING` con las veces recibidas y el estado anterior, pero **no se bloquea** la creación de otro draft.
 
-## Estado actual y pendiente
+## Observaciones guardadas
 
-- Los `observaciones` guardados hoy son mínimos. Se reemplazarán por observaciones estructuradas (título, filas, cómo corregir) cuando se definan las validaciones de rechazo.
-- `registrar_correo` y `registrar_notificacion` están implementados y probados, pero el pipeline todavía no los llama: los usarán las notificaciones al proveedor.
+- Rechazo de una factura: la lista de observaciones completa (`codigo`, `titulo`, `filas`, `como_corregir`; ver `observaciones.py`).
+- Error: `[{"codigo": "error_interno", "detalle": "..."}]`.
+- Correo sin comprobante: la observación del motivo (`sin_pdf_xml`, `falta_xml`, `sin_factura`).
+
+Las notificaciones las registra `respuesta_proveedor` (`enviada`, `fallida` u `omitida` con su motivo).
 
 ## Notas