用途:在 Metronome 中创建一条客户记录,采用“先预览、后确认”的两步流程,查重与写入均直接调用 API。基础地址为 https://api.metronome.com/v1。
主要能力与字段:需收集四项必填信息——法定实体名称(会原样出现在发票上,须用准确法定名称)、ingest 别名(客户在其自身系统中的 client ID)、Salesforce 账户 ID(来自 Salesforce 账户 URL 的字母数字 ID)、外部 Slack 频道(共享频道名,非内部频道,供 Pylon 支持使用)。
使用方式:第一步收集缺失字段;第二步查重,调用 GET /v1/customers,请求头为 Authorization: Bearer $METRONOME_API_TOKEN,返回全部客户并按 name 字段匹配,若命中则展示并请用户确认是否为不同实体,无匹配则继续;第三步展示预览(名称、ingest 别名、Salesforce ID、Slack 频道),用户回复 "confirmed" 后才可调用 API;第四步创建,调用 POST /v1/customers,请求头含 Authorization: Bearer $METRONOME_API_TOKEN 与 Content-Type: application/json,请求体包含 name、ingest_aliases 数组、customer_config.salesforce_account_id 以及 custom_fields.slack_channel。返回响应中的 id,用户后续创建合同时会用到。
限制:custom_fields 的键必须先在 Metronome 账户中预先注册,若 slack_channel 未注册,API 会返回 "Invalid custom field keys",需请 Metronome 管理员先注册,或未配置时完全省略 custom_fields。用户未确认前不得调用 API。