feature/capturar errores, evitar duplicados, eliminar manejar nuevas flags para descargar datos de vucem

api/api_v2/modules/edocs/services.py

@@ -277,6 +277,7 @@ async def change_edocument_status(edoc: dict, status: bool, pedimento: dict):
     data = {
         "id": edoc.get("id"),
         "edocument_descargado": status,
+        "edocument_estado": "descargado" if status else "pendiente",
         "numero_edocument": edoc.get("numero_edocument"),
         "pedimento": pedimento.get("id"),
         "organizacion": pedimento.get("organizacion"),
@@ -284,6 +285,36 @@ async def change_edocument_status(edoc: dict, status: bool, pedimento: dict):
 
     response = await edocs_rest_controller.put_edocument(edocument_id=edoc.get("id"), data=data)
 
+    # Nunca reportar éxito si el estatus no quedó persistido (T2026-05-027)
+    if response is None:
+        logger.error(f"No se pudo actualizar el estatus del EDocument {edoc.get('numero_edocument')} en la API")
+        raise Exception(f"Fallo al actualizar el estatus del EDocument {edoc.get('numero_edocument')}")
+
+    return response
+
+
+async def marcar_error_edocument(edoc: dict, pedimento: dict, mensaje: str, definitivo: bool = False):
+    """
+    Reporta un fallo de descarga al registro de negocio (T2026-05-027).
+
+    - definitivo=False (fallo transitorio): solo registra ultimo_error; el registro
+      permanece 'pendiente' y el tope de intentos automáticos del backend gobierna
+      la transición a 'error'.
+    - definitivo=True (fallo permanente): transiciona de inmediato a 'error';
+      queda fuera del ciclo automático, solo reproceso manual o reset.
+    """
+    data = {
+        "id": edoc.get("id"),
+        "ultimo_error": (mensaje or "Error de descarga en VUCEM")[:2000],
+        "numero_edocument": edoc.get("numero_edocument"),
+        "pedimento": pedimento.get("id"),
+        "organizacion": pedimento.get("organizacion"),
+    }
+    if definitivo:
+        data["edocument_estado"] = "error"
+    response = await edocs_rest_controller.put_edocument(edocument_id=edoc.get("id"), data=data)
+    if response is None:
+        logger.error(f"No se pudo registrar el error del EDocument {edoc.get('numero_edocument')} en la API")
     return response
 
 

api/api_v2/modules/edocs/tasks.py

@@ -5,12 +5,16 @@ from celery_app import celery_app
 from typing import Dict
 from fastapi import HTTPException as _HTTPException
 
-from .services import obtener_edoc
+from .services import obtener_edoc, marcar_error_edocument
 from api.api_v2.modules.tasks.services import register_task, update_task
 
 # Logger para el módulo
 logger = logging.getLogger(__name__)
 
+# Reintentos internos del worker: pertenecen al MISMO intento orquestado y no
+# incrementan el contador de intentos del backend (T2026-05-027)
+WORKER_MAX_RETRIES = 2
+
 @celery_app.task(bind=True)
 def process_edoc_download_request(self, edoc_data: Dict) -> Dict:
     """
@@ -29,18 +33,19 @@ def process_edoc_download_request(self, edoc_data: Dict) -> Dict:
     asyncio.set_event_loop(loop)
     
     try:
-        # Registrar el inicio de la tarea
-        logger.info(f"[EDOC] Registrando inicio de tarea {task_id}")
-        loop.run_until_complete(
-            register_task(
-                task_id=task_id,
-                status="submitted",
-                message=f"Iniciando proceso de descarga de E-document {edoc_number} para pedimento {pedimento_app}",
-                pedimento_id=pedimento_id,
-                organizacion_id=organizacion_id,
-                servicio=7  # cambiamos el servicio, el 7 le corresponde a los e documents
+        # Registrar el inicio de la tarea (solo en la primera ejecución, no en reintentos)
+        if self.request.retries == 0:
+            logger.info(f"[EDOC] Registrando inicio de tarea {task_id}")
+            loop.run_until_complete(
+                register_task(
+                    task_id=task_id,
+                    status="submitted",
+                    message=f"Iniciando proceso de descarga de E-document {edoc_number} para pedimento {pedimento_app}",
+                    pedimento_id=pedimento_id,
+                    organizacion_id=organizacion_id,
+                    servicio=7  # cambiamos el servicio, el 7 le corresponde a los e documents
+                )
             )
-        )
 
         # Esperar un momento breve para asegurar que el registro se complete
         time.sleep(1)
@@ -79,7 +84,22 @@ def process_edoc_download_request(self, edoc_data: Dict) -> Dict:
         # En caso de error, actualizar estado
         error_message = f"Error al descargar E-document {edoc_number} para pedimento {pedimento_app}: {str(e)}"
         logger.error(error_message, exc_info=True)
-        
+
+        # Reintento interno del worker para fallos transitorios (red, timeout):
+        # mismo intento orquestado, NO incrementa el contador del backend
+        if not isinstance(e, _HTTPException) and self.request.retries < WORKER_MAX_RETRIES:
+            raise self.retry(exc=e, countdown=60 * (self.request.retries + 1))
+
+        # Fallo definitivo de este intento: registrar el detalle en el registro de
+        # negocio. Permanece 'pendiente'; el tope de intentos automáticos del
+        # backend (MAX_INTENTOS_AUTO) gobierna la transición a 'error'.
+        try:
+            loop.run_until_complete(
+                marcar_error_edocument(edoc_info, pedimento_info, error_message, definitivo=False)
+            )
+        except Exception as report_error:
+            logger.error(f"No se pudo registrar el error en el registro de negocio: {report_error}")
+
         try:
             loop.run_until_complete(
                 update_task(