用途:对一份有限的客户名单逐一检测计费异常,覆盖收入波动、停留 DRAFT 的发票、commit 消耗速率异常和长期未动的信用余额。所有 API 调用均为只读,鉴权使用 $METRONOME_API_TOKEN,生产 Base URL 为 https://api.metronome.com/v1,沙箱为 https://staging.api.metronome.com/v1。
主要能力:先解析客户名到 UUID(GET /v1/customers 按 name 匹配),再取当期与上期支出(GET /v1/customers/{customer_id}/costs?starting_on=...&ending_before=...),查发票(GET /v1/customers/{customer_id}/invoices,可加 ?status=DRAFT 或 ?type=USAGE&sort=date-desc),查 commit 余额(POST /v1/contracts/customerBalances/list,body 含 customer_id 与 include_balance)。按阈值标记:收入 MoM 波动>20%(仅 FINALIZED 发票)、DRAFT 超过账期结束、commit 消耗环比增>30%、信用余额 60 天以上未变。commit 预期消耗率按 days_elapsed/contract_term_days×100,实际高于预期+20 或低于预期−30 时标记。
使用方式:需用户提供有界客户名单。Metronome 无全量客户接口,禁止尝试遍历全部客户,遇到“所有客户”请求应要求用户粘贴目标账户名或 ID。逐客户填表后再进入标记阶段,标记阶段不再发起额外 API 调用。
限制与注意:金额单位均为分,需除以 100 再算百分比;POST customerBalances/list 每页上限 25 条,需用 next_page 分页。月中 DRAFT 不算异常(约第 13 天约 37%)。PAYGO 无 PREPAID 时跳过 commit 列。Evergreen 合同无 ending_before,用发票 end_timestamp。新客户无发票不标记。纯固定费用客户跳过收入波动。活跃客户零发票可能是在 Metronome 外计费,标记为 external invoicing 而非异常。信用余额长期未动只是待排查信号,不是确认错误。