Conciliar una reserva de tarea masiva de operador con su cargo final
Separe el saldo reservado, los resultados completados y la reserva liberada, y explique las diferencias cuando otras actividades comparten la misma billetera.
Un registro de conciliación local conecta una tarea masiva de operador con su archivo, los resultados finales y las observaciones de la billetera sin adivinar los gastos concurrentes.
Para la conciliación del saldo de tareas masivas de operador, separe la reserva estimada del cargo final y de la reserva no utilizada. Empareje la tarea con su archivo preparado y los resultados completados, luego verifique si otras actividades afectaron el saldo compartido de la cuenta.
Lea la reserva como trabajo en curso
Usted envía un archivo de operador, observa cómo disminuye el saldo disponible y, posteriormente, recibe un CSV con menos filas que la carga original. El primer movimiento de saldo no indica por sí solo el costo final de la tarea. El envío masivo reserva una cantidad estimada mientras se procesa la tarea.
CarrierLookup cobra por los números que devuelven resultados y devuelve la reserva no utilizada a la misma billetera. Una tarea que falla durante la preparación devuelve su reserva en su totalidad. Esta conciliación de reserva es diferente a revertir una recarga o una compra de plan.
Mantenga tres valores distintos en su propio registro: la cantidad reservada, el cargo final y la cantidad liberada. Cuando los tres están disponibles para la misma tarea, la relación esperada es que la reserva sea igual al cargo final más la reserva liberada. No complete un valor a nivel de tarea no disponible con una diferencia de saldo de toda la cuenta simplemente para que esa ecuación funcione.
Construya el registro de la tarea a partir del archivo enviado
Comience con el archivo exacto que envió, no con la versión actual de una hoja de cálculo que alguien pudo haber editado posteriormente. Guarde un resumen del archivo, el país seleccionado, el tipo de servicio carrier_batch, el ID de la tarea y la hora de envío. Mantenga los archivos que contienen datos de contacto en un almacenamiento restringido y utilice referencias a ellos en la hoja de trabajo.
La preparación masiva excluye filas no válidas, duplicados, números sin código de país y números fuera del país seleccionado. Las filas excluidas no se cobran. Su informe de preparación local puede explicar algunas exclusiones, pero distinga su estimación de los recuentos informados realmente por el servicio.
| Campo de la hoja de trabajo local | Qué conecta |
|---|---|
| ID de tarea y tipo de servicio | Una tarea de archivo de operador, en lugar de todo el trabajo de la cuenta |
| Resumen del archivo fuente y recuento de filas | Versión exacta de la carga |
| País y notas de preparación | Conjunto de números previsto y exclusiones locales |
| Marcas de tiempo de envío y estado | Período durante el cual se mantuvo la reserva |
| Evidencia de reserva | Cantidad retenida, si se muestra en los registros de la tarea o de la cuenta |
| Archivo de resultados, resumen y recuento de filas | Salida completada para esta tarea |
| Evidencia de cargo final y liberación | Valores de liquidación cuando estén disponibles |
| Otra actividad de la billetera | Razones por las que las instantáneas de saldo pueden no aislar esta tarea |
| Diferencia no explicada | Una cantidad visible no resuelta, no un ajuste fabricado |
Estos son campos en su hoja de trabajo, no una API de libro mayor de facturación del proveedor prometida. Conserve la fuente de cada cantidad para que un operador pueda distinguir una cifra observada de un cálculo.
Cuente los resultados completados sin tratar los espacios en blanco como fallos
Una tarea de operador exitosa proporciona un CSV con identifier, carrier, underlying_carrier, number_type, country_code, region y city. Utilice los identificadores para conectar las filas de salida con la entrada preparada. El CSV masivo no tiene el campo exists de la respuesta múltiple sincrónica.
Un valor de operador o geografía vacío significa que el valor no estaba disponible. No es evidencia suficiente de que la fila falló o deba ser gratuita. Los resultados de operador completados pueden ser facturables incluso cuando los campos de asignación están vacíos. Mantenga la integridad del campo separada del recuento de resultados completados al estimar un cargo.
Por ejemplo, su informe local podría mostrar algunas líneas de entrada duplicadas y algunas filas de salida completadas con valores de ciudad en blanco. Las líneas de entrada duplicadas pertenecen a la conciliación de preprocesamiento. Las ciudades en blanco pertenecen a la revisión de calidad de los resultados. Restar ambos grupos del recuento facturable mezclaría dos preguntas diferentes.
Cuente los identificadores de manera consistente e inspeccione las asignaciones de salida duplicadas o faltantes antes de calcular los totales. Si el detalle de la tarea disponible no establece por qué falta un identificador enviado, etiquete la diferencia como no resuelta. No invente un código de error por número a partir de la ausencia de una fila CSV. Utilice el estado de la tarea y la evidencia de servicio disponible para resolverlo.
Utilice una billetera silenciosa para comprender una tarea
En una ejecución aislada, pause otros trabajos pagados bajo su control y anote el saldo inmediatamente antes del envío. Registre la observación de la reserva, espere el estado final de la tarea y registre el saldo liquidado y cualquier cargo o liberación mostrada. Incluya recargas, cambios de plan y cualquier otro movimiento de cuenta en el período de observación.
Si realmente no hubo otros movimientos, la diferencia entre los saldos inicial y liquidado puede corroborar el costo neto de la tarea. Aún ayuda comparar ese resultado con el recuento completado y el precio aplicable que se muestra en Precios de CarrierLookup. Conserve el precio utilizado en ese momento en lugar de reemplazarlo silenciosamente por un precio posterior.
GET /api/v1/balance lee el balance_micros actual sin crear una verificación ni cobrar por la consulta. Almacene ese número entero directamente y utilice aritmética de números enteros para las diferencias; conviértalo a una cantidad de visualización en el borde de su aplicación. Una instantánea de saldo es una observación de cuenta, no un estado de cuenta detallado de la tarea.
La tarea puede estar en estado processing, success o failed. Una tarea en procesamiento no se ha liquidado simplemente porque una lectura de saldo permaneció sin cambios. Consulte el estado de la tarea no más de una vez cada 30 segundos y conserve el estado final con el registro de resultados.
Explique el gasto concurrente sin asignarlo al archivo
Las verificaciones de operador en tiempo real y los servicios asincrónicos comparten un mismo saldo. Si otro equipo realiza verificaciones mientras se ejecuta su tarea masiva, el saldo inicial menos el saldo final incluye ese trabajo. Otra reserva masiva también puede permanecer abierta al final del período, lo que hace que el saldo disponible sea un indicador deficiente de los cargos liquidados.
En su hoja de trabajo, separe las cantidades atribuidas a la tarea de los movimientos de toda la cuenta. Concilie otros cargos, créditos y reservas pendientes conocidos utilizando la evidencia que realmente posee. Si el residuo no puede asignarse, informe una "diferencia de billetera compartida no atribuida" con la ventana de observación. No la asigne a la tarea que finalizó en último lugar.
Para una diferencia no explicada, recopile el ID de la tarea, el tipo de servicio, las marcas de tiempo, el resumen del archivo, el recuento preparado, el estado final, el recuento de resultados, las observaciones de saldo y cualquier detalle de reserva o liquidación disponible. Incluya si el trabajo en tiempo real u otras tareas de archivo se ejecutaron simultáneamente. Comparta solo los datos de contacto mínimos necesarios a través del canal de soporte apropiado; nunca incluya una clave de API.
Comience con la siguiente tarea masiva de operador: mantenga su versión de entrada y el ID de la tarea juntos antes del envío. Ese pequeño paso hace que el CSV final, la reserva liberada y cualquier discrepancia restante sean rastreables hasta la misma pieza de trabajo.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.