shopify-admin-revenue-by-location-report

用途

该技能将订单收入归因到实际发货的履约地点（仓库或履约中心），生成按地点拆分的收入报告。可用于多地点损益（P&L）分析、地点人员配置决策，以及了解需求由哪些地点完成履约。技能为只读，不执行任何变更操作。

主要能力

• 查询店铺中所有活跃地点（最多 50 个），获取地点 ID 与名称用于数据丰富。
• 查询已发货订单（默认回溯 30 天），提取每个订单的履约记录及其分配地点、订单总价与分页游标。
• 针对每个地点查询已关闭的履约订单，用于开放订单的收入归因。
• 按地点聚合收入；没有地点数据的订单归入“Unknown”或“Unassigned”。
• 输出 CSV 文件，包含 location_id、location_name、order_count、total_revenue、currency、share_pct 列。
• 支持 human（默认）和 json 两种输出格式。

使用方式

前置条件：

• 已认证的 Shopify CLI 会话：shopify store auth --store <domain> --scopes read_orders
• API 权限范围：read_orders

参数：

• store（字符串，必填）：店铺域名，例如 mystore.myshopify.com
• days_back（整数，可选，默认 30）：回溯窗口天数
• format（字符串，可选，默认 human）：输出格式，human 或 json

运行流程：

1. 查询活跃地点列表。
2. 查询已发货订单，条件为 fulfillment_status:shipped created_at:>='<NOW - days_back days>'，每页 250 条，提取履约分配地点与订单总价。
3. 按地点查询状态为 CLOSED 的履约订单，用于收入归因。
4. 按地点聚合收入，无地点数据的订单归入“Unknown”。

输出：

• human 格式：在终端展示总收入、订单数、各地点订单数、收入与占比，并生成 CSV 文件 revenue_by_location_<date>.csv。
• json 格式：输出包含 skill、store、period_days、total_revenue、currency、by_location、output_file 字段的 JSON。

适用场景

• 多仓库或多 3PL 运营：识别某个 3PL 是否承担了不成比例的份额，是否需要扩容。
• 多地点损益分析：按履约地点拆分收入。
• 地点人员配置决策：了解各地点实际履约吞吐量。
• 与库存估值报告配合，计算各地点库存周转率（收入 / 库存价值）。

限制与注意事项

• 收入归因基于履约分配，而非客户收货地址，反映的是各地点运营吞吐量，不是地理需求。
• 无履约地点的订单（未履约或 POS 订单）归入“Unassigned”。
• 单地点店铺报告仍然有效，显示全部收入。
• 遇到 THROTTLED（API 速率限制）时，等待 2 秒后重试，最多 3 次。
• 该技能为只读，不执行任何变更操作，可随时安全运行。
• 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。