Cómo descartar tareas

Descartar una tarea significa cancelar su ejecución y marcarla como no activa para la entrega o recogida. Cuando se descarta una tarea:

• El estado de la tarea cambia a "DESCARTADO";

• Se elimina de cualquier ruta asignada (si corresponde);

• Queda no disponible para la optimización y la entrega;

• Los transportistas externos reciben notificaciones de cancelación si la tarea estaba asociada a ellos;

• La tarea aparece en la sección "Descartadas" de la plataforma

Métodos para descartar

Métodos de API:

• Descarte de tarea individual por ID interno

Parámetros:
id: ID de base de datos de la tarea
removeFromRound (opcional): Establezca en true para eliminar de la ruta antes de descartar

• Descarte de tarea individual por TaskId

Parámetros:
taskId: El ID externo de la tarea
removeFromRound (opcional): Establezca en true para eliminar de la ruta antes de descartar

• Descarte masivo de tareas

Cuerpo:
taskId: El ID externo de la tarea

Plataforma web:

• Descarte de tarea individual

Navegue hasta los detalles de la tarea -> Use la opción de eliminar en la interfaz de la tarea:

• Descarte masivo de tareas

1. Vaya a la pestaña Tareas;

2. Seleccione "Cambio masivo";

3. Elija las tareas: Seleccione todas las tareas presentes o defina tareas específicas por sus IDs;

4. Seleccione la acción: "Descartar una tarea";

5. Importante: Active el interruptor "Eliminar tarea de la ruta" por seguridad;

6. Haga clic en "Continuar" para descartar todas las tareas seleccionadas.

• Descartar eliminando anuncios

Elimine el anuncio completo que contiene las tareas.

ℹ️ Nota ℹ️

Si elimina un anuncio antes de optimizar las tareas, todas las tareas pasarán al estado DESCARTADO.

Esta es una operación irreversible: una vez eliminado un anuncio, todas sus tareas pasan a estar DESCARTADAS y no pueden optimizarse ni procesarse más.

Si elimina un anuncio después de optimizar, las siguientes tareas PUEDEN o NO PUEDEN descartarse:

• PUEDEN: Anuncios con tareas en estado ASSIGNED, PREPARED, GEOCODED

• NO PUEDEN: Anuncios con alguna tarea en estado ONGOING, COMPLETED, o IN_PROGRESS

El sistema protege contra la eliminación de anuncios con tareas que están siendo ejecutadas activamente o que ya han sido completadas, garantizando la integridad de los datos y evitando interrupciones en las operaciones en curso.

Consideraciones importantes

Tareas en rutas

• Comportamiento predeterminado: la API rechaza las solicitudes de descarte de tareas asignadas a rutas

• Solución: use el parámetro removeFromRound=true para forzar la eliminación de la ruta antes de descartar

• Condiciones de carrera: descartar varias tareas de la misma ruta simultáneamente puede causar problemas

Límites de frecuencia y rendimiento

• Se recomiendan las operaciones masivas en lugar de múltiples llamadas individuales a la API

• Descartar cientos de tareas simultáneamente puede causar latencia

Registros y seguimiento

• Las tareas descartadas aparecen en los registros del sistema

• Los descartes por API aparecen como "discard by SYSTEM" en los registros

• El historial de la tarea registra la acción de descarte y quién la realizó

Integración con transportistas externos

• Cuando se descartan tareas asociadas a transportistas externos, se envían automáticamente solicitudes de cancelación a dichos transportistas

• Esto ocurre para descartes realizados mediante la API, acciones manuales en la aplicación web o eliminaciones de anuncios