
Detenga grupos masivos pendientes en NumDetect, espere el estado final, conserve las respuestas completadas y concilie cargos antes de un reintento selectivo.
La cancelación detiene el trabajo masivo pendiente, mientras que los grupos completados o enviados aún requieren un resultado final y la conciliación de cargos.
Después de solicitar la cancelación de un trabajo masivo en NumDetect, conserve el ID del trabajo, espere a que alcance un estado terminal, descargue cualquier resultado disponible y concilie las filas y los grupos por país y producto. La cancelación detiene los grupos pendientes; no borra las respuestas ya completadas ni revierte los cargos de los grupos que finalizaron.
Detenga el trabajo pendiente y conserve la referencia del trabajo
Un archivo erróneo o una elección de producto incorrecta se gestionan mejor antes de que se envíe más trabajo. Guarde el ID del trabajo masivo y la versión del archivo enviado, luego utilice la acción de cancelación de trabajos masivos documentada. La guía de la API de NumDetect indica que la cancelación detiene los países que aún no se han verificado y devuelve el importe retenido. El límite de producto más preciso son los grupos pendientes: los grupos ya enviados pueden finalizar de todos modos. No trate la respuesta de cancelación como una reversión ni elimine el archivo de origen.
Informe al equipo por qué se detuvo el trabajo: columna incorrecta, lista obsoleta, selección de producto incorrecta o autorización modificada. Congele cualquier importación automatizada posterior para este trabajo hasta que se conozca su estado final. Si la carga original fue un CSV, conserve sus IDs de fila y todas las columnas originales. Una conciliación posterior necesita distinguir una fila que se verificó antes de la cancelación de una que nunca recibió un resultado concluyente.
Otros sistemas de trabajos masivos también advierten que la cancelación puede dejar el trabajo completado en su lugar (Axinom); sus estados y reglas de facturación no definen el comportamiento de NumDetect. Utilice el trabajo de NumDetect como la fuente de verdad.
Espere al estado terminal del trabajo e inspeccione cada grupo
Lea el endpoint de estado de trabajos masivos documentado hasta que el trabajo informe que está completado, fallido o cancelado. Un estado de ejecución significa que la solicitud de detención no ha resuelto todos los grupos. NumDetect agrupa el trabajo de telefonía por país y producto; el trabajo de correo electrónico se agrupa por producto. Un grupo que ya fue enviado puede completarse después de que el operador solicitara la cancelación, mientras que un grupo pendiente puede ser cancelado. Por lo tanto, “trabajo cancelado” y “sin respuestas útiles” no son sinónimos.
Registre qué grupos de país-producto se completaron, fallaron o fueron cancelados. Un grupo completado puede incluir resultados de fila de tipo sí, no y desconocido. Desconocido es una respuesta no resuelta, no una gratuita ni negativa. Esta vista a nivel de grupo explica por qué un trabajo detenido puede tener resultados utilizables y fondos reservados liberados. No reinicie todo el archivo original simplemente porque un grupo no finalizó; eso puede duplicar el trabajo completado y los costos.
Si el trabajo indica result_ready, solicite una URL de descarga a través del endpoint de resultados de trabajos masivos documentado. El enlace documentado dura diez minutos; solicite uno nuevo si caduca. Descargue el resultado solo después de que esté listo, guárdelo con el archivo de origen y el ID del trabajo, y conserve el estado terminal del trabajo para el registro de auditoría.
Concilie el CSV final con el origen conservado
El CSV de resultados de NumDetect conserva las filas y columnas originales en su orden original y añade las columnas numdetect_status, numdetect_country y product. Únalo al archivo de origen conservado utilizando el identificador de fila estable del equipo y compare los recuentos de filas. Marque el estado de las filas de origen válidas, duplicadas e inválidas por separado del resultado de sí, no, desconocido, no soportado, fallido o cancelado de cada producto seleccionado. Un resultado desconocido a nivel de fila no debe convertirse en no cuando la empresa prepara una lista de seguimiento.
Para el informe de detención del operador, resuma cuatro elementos: el alcance original solicitado, los grupos completados antes o durante la cancelación, los grupos cancelados o fallidos y las filas que requieren una ejecución posterior deliberada. Conserve las respuestas completadas como observaciones fechadas. Una lista de reintento debe contener solo las filas de origen elegibles no resueltas y los productos exactos que aún necesitan verificación, después de corregir el error original. Revise la selección de país y producto nuevamente antes de crear una nueva solicitud masiva y un nuevo Idempotency-Key; la clave antigua pertenece a la operación de creación original.
Esta es una revisión específica de la cancelación. Una guía general de importación de CSV puede explicar cada columna de resultados, pero la pregunta urgente aquí es qué dejó sin terminar la acción de detención y qué no debe volver a ejecutarse.
Concilie los cargos antes de aprobar una nueva ejecución
El envío masivo reserva un importe por grupo. Según la regla documentada de NumDetect, un grupo completado se cobra en su totalidad, incluidos los resultados desconocidos. Los grupos fallidos o cancelados con éxito liberan su importe retenido; los grupos ya completados permanecen cobrados. Revise el trabajo final y el historial de saldo frente a esa regla. No estime un reembolso contando solo las filas de sí y no, y no asuma que un grupo completado de todos desconocidos es gratuito.
Una nota concisa del operador puede decir: “Se solicitó la cancelación para el trabajo X; estos grupos se completaron; estos grupos fueron cancelados o fallaron; estas filas permanecen sin resolver; el cargo final y la liberación se verificaron contra el registro del trabajo; la siguiente ejecución requiere aprobación”. Esto permite que un compañero de equipo decida si corregir la entrada, ejecutar solo los grupos no resueltos seleccionados o dejarlos como están.
Antes de autorizar esa siguiente ejecución, muestre el alcance corregido y el control de costos al propietario. La primera cancelación debe dejar un estado final claro, evidencia conservada y una decisión de reintento deliberada, no un segundo trabajo grande lanzado desde la incertidumbre.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.
Fuentes
Elaborado a partir de la documentación de producto de NumDetect y de las fuentes citadas.