核对原始归属运营商查询批量任务的预扣款与最终扣费
区分预扣余额、已完成结果和退回的预扣款，并解释当其他任务共享同一钱包时产生的余额差异。
本地核对记录将原始归属运营商查询批量任务与其文件、最终结果及钱包变动关联起来，无需猜测并发支出。
对于原始归属运营商查询批量任务的余额核对，应将预估的预扣款与最终扣费及未使用的退回预扣款区分开来。将任务与其准备好的文件及已完成的结果进行匹配，然后检查是否有其他活动影响了共享账户的余额。
将预扣款视为进行中的工作
您提交一份号码文件，看到可用余额减少，随后收到一份行数少于原始上传文件的 CSV 文件。余额的首次变动本身并不能说明任务的最终成本。批量提交会在任务处理期间预扣一笔预估金额。
CarrierLookup 会对返回结果的号码进行扣费，并将未使用的预扣款退回到同一钱包。在准备阶段失败的任务会全额退回预扣款。这种预扣款核对与撤销充值或套餐购买不同。
请在您的记录中区分三个数值：预扣金额、最终扣费金额和退回金额。当同一任务的这三个数值均已知时，预期的关系是：预扣金额等于最终扣费金额加上退回金额。请勿为了凑齐等式而将无法获取的任务级数值填入整个账户的余额差额中。
根据提交的文件建立任务记录
从您提交的原始文件开始，而不是从某人后续可能编辑过的电子表格版本开始。保存文件摘要、所选国家/地区、服务类型 carrier_batch、任务 ID 和提交时间。将包含联系信息的文件存放在受限存储中，并在工作表中引用它们。
批量准备阶段会排除无效行、重复项、缺少国家代码的号码以及所选国家/地区之外的号码。被排除的行不会被扣费。您的本地准备报告可以解释部分排除原因，但请区分您的预估值与服务实际报告的计数。
| 本地工作表字段 | 连接内容 |
|---|---|
| 任务 ID 和服务类型 | 单个运营商文件任务，而非所有账户工作 |
| 源文件摘要和行数 | 确切的上传版本 |
| 国家/地区和准备说明 | 预期的号码集和本地排除项 |
| 提交和状态时间戳 | 预扣款被持有的期间 |
| 预扣款凭证 | 可用任务或账户记录显示的持有金额 |
| 结果文件、摘要和行数 | 该任务的已完成输出 |
| 最终扣费和退回凭证 | 可用的结算数值 |
| 其他钱包活动 | 余额快照无法隔离此任务的原因 |
| 未解释的差异 | 可见的未解决金额，而非人为调整 |
以上是您工作表中的字段，而非提供商的账单分类账 API。请保留每个金额的来源，以便操作员能够区分观察到的数值与计算得出的数值。
统计已完成的结果，不要将空白视为失败
成功的运营商任务会提供一份包含 identifier、carrier、underlying_carrier、number_type、country_code、region 和 city 的 CSV 文件。使用标识符将输出行与准备好的输入关联起来。批量 CSV 不具备同步多号码响应中的 exists 字段。
空白的运营商或地理位置值意味着该值不可用。这不足以证明该行失败或应免费。即使分配字段为空，已完成的运营商结果也可能产生扣费。在估算扣费时，请将字段完整性与已完成结果的计数分开。
例如，您的本地报告可能显示一些重复的输入行和一些城市值为空的已完成输出行。重复的输入行属于预处理核对范畴，而空白的城市值属于结果质量审查范畴。从可计费计数中同时减去这两组数据会混淆两个不同的问题。
请一致地统计标识符，并在计算总数之前检查重复或缺失的输出映射。如果可用的任务详情无法确定提交的标识符缺失的原因，请将该差异标记为“未解决”。请勿仅凭 CSV 行的缺失就臆造出每个号码的失败代码。请使用任务状态和服务提供的证据来解决该问题。
使用安静的钱包来了解单个任务
在一次隔离的运行中，暂停您控制下的其他付费工作，并记录提交前的余额。记录预扣款观察结果，等待任务达到最终状态，并记录结算后的余额以及显示的任何扣费或退回金额。将观察期内的充值、套餐变更和任何其他账户变动都考虑在内。
如果确实没有其他变动，则起始余额与结算余额之间的差额可以佐证任务的净成本。将该结果与已完成的计数以及 CarrierLookup 定价 中显示的适用价格进行比较仍然很有帮助。请保留当时使用的价格，而不是悄悄地用后续价格替换它。
GET /api/v1/balance 读取当前的 balance_micros，而不会创建查询或产生查询费用。直接存储该整数并使用整数运算计算差额；在应用程序的边缘将其转换为显示金额。余额快照是对账户的观察，而非逐项的任务清单。
任务状态可以是 processing、success 或 failed。仅仅因为一个余额读数保持不变，并不意味着处理中的任务已经结算。查询任务状态的频率不要超过每 30 秒一次，并将最终状态与结果记录一起保留。
解释并发支出，不要将其归咎于文件
实时运营商查询和异步服务共享同一个钱包余额。如果另一个团队在您的批量任务运行时执行查询，则起始余额减去结束余额的结果中将包含那部分工作。另一个批量预扣款也可能在周期结束时保持开启状态，这使得可用余额无法准确反映结算扣费。
在您的工作表中，将任务归属金额与账户范围内的变动分开。使用您实际拥有的证据来核对已知的其他扣费、抵扣和未结预扣款。如果剩余部分无法分配，请在观察窗口中报告“无法归因的共享钱包差异”。请勿将其附加到最后完成的任务上。
对于未解释的差异，请收集任务 ID、服务类型、时间戳、文件摘要、准备计数、最终状态、结果计数、余额观察结果以及任何可用的预扣款或结算详情。请注明实时工作或其他文件任务是否同时运行。仅通过适当的支持渠道共享必要的最低限度联系数据；切勿包含 API 密钥。
从下一个 原始归属运营商查询批量任务 开始：在提交前将输入版本和任务 ID 放在一起。这一小步使得最终的 CSV、退回的预扣款以及任何剩余的差异都可以追溯到同一项工作。
了解更多
选择适合您工作流程下一步的产品信息。