用途:分析已履约订单,计算从履约创建(fulfillment created)到送达(delivered)的平均运输时间,并按承运商分组,找出持续偏慢或缺少送达确认的承运商。该技能为只读,不执行任何变更操作。
前置条件:已认证的 Shopify CLI 会话,命令为 shopify store auth --store <domain> --scopes read_orders;API 权限范围为 read_orders。
参数:store(必填,店铺域名,如 mystore.myshopify.com);days_back(可选,默认 30,已履约订单的回溯窗口);min_orders(可选,默认 5,纳入平均值的每承运商最少订单数);location_id(可选,按履约地点过滤);format(可选,默认 human,可选 human 或 json)。
主要能力:通过 orders 查询拉取 fulfillment_status:shipped 且创建时间在窗口内的订单,读取 fulfillments 的 createdAt、updatedAt、deliveredAt 与 trackingInfo.company,分页至 hasNextPage: false;按承运商计算 deliveredAt - createdAt,跳过 deliveredAt 为空的订单;可选通过 fulfillmentOrders 查询按 assignedLocationId 与 status: CLOSED 做地点维度细分。
输出:human 格式打印各承运商的订单数、平均天数、最小与最大天数;json 格式输出结构化结果;同时生成 CSV 文件 delivery_analysis_<YYYY-MM-DD>.csv,列为 order_name, fulfillment_id, carrier, fulfilled_at, delivered_at, transit_days。
限制与错误处理:deliveredAt 仅在承运商通过跟踪事件确认送达时才有值,部分承运商不上报,空值属正常,会被排除在平均值外并计为在途;遇到 THROTTLED 限流可等待 2 秒重试最多 3 次;窗口内无已履约订单时以 0 订单汇总退出。建议将 min_orders 设为 10 以获得更有统计意义的平均值,并每月运行以跟踪承运商表现。