用途
该工具用于查询所有 B2B 公司账户及其关联的地点、价格表和付款条件，为运营和销售团队提供批发账户组合的集中视图。它执行只读操作，不会产生任何数据变更。该功能需要 Shopify B2B（仅 Shopify Plus 提供）。
主要能力
- 查询所有 B2B 公司账户，支持分页获取（每页最多 250 条）。
- 获取每个公司账户的地点信息，包括地点名称、所在国家与城市。
- 读取每个地点的买家体验配置，包括付款条款模板（名称、到期天数）以及 checkoutToDraft 设置。
- 统计每个地点关联的商品目录数量（catalogsCount）。
- 获取每个公司账户的联系人数量、地点数量，以及最近一笔订单的创建时间和金额。
- 将结果输出为 CSV 文件，文件名格式为 b2b_companies_<YYYY-MM-DD>.csv，包含列：company_id、company_name、locations_count、contacts_count、last_order_date、last_order_value、currency、payment_terms、has_catalog。
- 支持 human（默认）和 json 两种输出格式，并在执行各阶段按要求输出会话跟踪信息。
使用方式
前置条件：
- 已认证的 Shopify CLI 会话：
shopify store auth --store <domain> --scopes read_customers - API 权限范围：read_customers
- 店铺必须为 Shopify Plus 且已启用 B2B
参数：
- store（字符串，必填）：店铺域名，例如 mystore.myshopify.com
- format（字符串，可选，默认 human）：输出格式，可选 human 或 json
工作流程步骤：
- companies 查询：输入 first: 250，选择 name、locations、contacts、createdAt 及分页游标；预期输出为所有 B2B 公司账户，分页直到 hasNextPage 为 false。
- companyLocations 查询：每个公司输入 first: 250，选择 name、buyerExperienceConfiguration { paymentTermsTemplate, checkoutToDraft } 及 catalogsCount；预期输出为公司地点及其付款和目录配置。
适用场景
- 每月作为批发账户健康检查运行——90 天以上无订单的公司账户可能需要主动联系。
- checkoutToDraft 为 true 表示买家订单需先经审批才能付款，可用于了解哪些账户需要人工订单审核。
- 对于有多个地点但只有一个目录的公司，可检查目录是否正确限定到各个地点。
限制
- 只读技能，不执行任何变更操作，可随时安全运行。
- 需要 Shopify B2B（Shopify Plus 功能），在非 Plus 店铺上会返回空结果或错误。
- 错误处理：THROTTLED（API 速率限制超限）时等待 2 秒并重试，最多重试 3 次；公司列表为空时以 0 家公司退出并注明 B2B Plus 要求；companies 查询不可用时返回明确错误：B2B 需要 Shopify Plus。