用途:对用户提供的有限客户名单(建议 10–30 家)执行提交健康度、续约与异常检查,输出结构化月度简报。API 无全量客户端点,无法做全量扫描,必须由用户提供名单。
主要能力:按数据源层级依次调用 Metronome API。第一层直接调用:GET /v1/customers 匹配客户 UUID;POST /v2/contracts/list 获取合同条款与结束日期;POST /v1/contracts/customerBalances/list 并设 include_balance: true 获取提交/信用余额;GET /v1/customers/{id}/costs 获取消耗率与支出趋势;GET /v1/customers/{id}/invoices?type=USAGE 检查发票状态与类型。第二层为回退计算:仅当 costs 返回 $0 时,用 (original_balance - remaining_balance) / months_elapsed 估算消耗率,并标注为估算值。
使用方式:先并行采集每位客户全部信号,填满中间表(客户、合同类型、结束日期、提交使用率、剩余金额、消耗率、距续约天数、环比变化、DRAFT 卡住、标记),再按阈值分析:提交使用率 ≥80% 为超支风险,<20% 且已过 80% 期限为闲置风险,续约 ≤30 天为紧急,31–90 天为临近,环比 >+20% 为支出激增,<−20% 为下降,DRAFT 发票时间戳已过为计费问题。最后按执行摘要、需行动项、观察名单、健康客户、完整数据表五段输出。
适用场景:月度组合报告、快速风险扫描、Slack/文档/CSV 输出。
限制:金额单位为分,需除以 100;PAYGO、evergreen、flat-fee 和新客户也须出现,用“—”标注;环比仅适用于已定稿 USAGE 发票;customerBalances 端点每页上限 25 条,需用 next_page 分页;预测值须标注为预测而非事实;API 报错应如实反馈,不得编造数据。