RUNBOOK — job-envio-proveedores-exceso¶
envio_externo_excel_proveedores (W14)¶
| Dato | Valor |
|---|---|
| Programacion | 30 10 * * * |
| Duracion esperada | no medida (un correo con adjunto por proveedor; propuesta: < 15 min) |
| Timeout | 60 min (propuesto) |
| Comando | .venv/bin/python -m envio_proveedores_exceso |
| Efecto | Reemplaza el catalogo de destinatarios en ATHENAS, sube los ZIP a SharePoint, envia correos a proveedores, fila en tbl_control_procesos |
| Logs | /var/log/dabra/envio_externo_excel_proveedores/<fecha_hora>.log |
| Auditoria | ATHENAS.ods.tbl_control_procesos: ID08 - PY_ENVIO_EXTERNO_EXCEL_PROVEEDORES_DIARIO_ATHENAS. Num_Registros = correos enviados |
| Datos | /var/lib/dabra/envio_externo_excel_proveedores/{tmp,output} |
| Codigo | Significado | Accion |
|---|---|---|
| 0 | Todos los correos salieron (o no habia destinatarios) | — |
| 1 | Fallo general o al menos un proveedor sin enviar | Ver el correo "ERROR - Envio de reportes de exceso" (lista los proveedores) y el log; reenviar a mano o reejecutar |
| 2 | Configuracion invalida | Revisar .env |
python -m envio_proveedores_exceso --dry-run # ZIP en output/ y log de a quien se enviaria; sin correos ni SharePoint ni auditoria
python -m envio_proveedores_exceso # real
--dry-run SI descarga el maestro y reemplaza la tabla de destinatarios (la consulta la necesita), pero no envia, no sube a SharePoint y no audita.
Reproceso¶
Reejecutar reenvia el correo a TODOS los proveedores (no hay control de "ya enviado"). Antes de reejecutar tras un fallo parcial, ver en el log cuales quedaron sin enviar; si son pocos, mandarlos a mano desde el ZIP guardado en SharePoint (<carpeta>/<AAAAMM>/).
Rollback¶
No hay. Un correo enviado no se puede retirar.
Problemas conocidos¶
- Si el maestro de SharePoint tiene un destinatario equivocado, el correo sale al proveedor equivocado: revisar el maestro antes de las 10:30.
- Un fallo al subir el ZIP a SharePoint no impide el envio ni marca
Error(quedaERRORen el log); el original hacia lo mismo. - Sin filas en la consulta de exceso no hay periodo: el job termina en
Errorsin enviar nada. - El PUT a SharePoint es simple (hasta 4 MB por ZIP).
Fuente: repositorio job-envio-proveedores-exceso, versión 4054d46 (con cambios locales). Página generada con tools/publicar_docs.py.