salla-shipping-app

用途：通过 Salla Partners MCP 工具按步骤构建运费应用。运费应用必须为公开应用，不支持私有应用。须先连接 Salla Partners MCP 服务器，全程携带 app_id；若提示“Salla session expired”，需重新执行登录流程。两种应用模型需先选定：Shipping Management（承运商/AWB）集成一家承运商，采用现代 Salla AWB 模型，在 Salla Partners 内编写 App Functions 调用承运商 API 生成 AWB 并返回 Salla，无需构建或托管后端；Order Fulfilment 跨承运商，接收订单后自动分配最佳承运商/分支。主要步骤：一、用 salla_reference 解析运费子类目，上传方形 logo（1:1，≥250×250），用 salla_apps action=create 创建并设为公开；二、用 salla_apps action=connect 配置 OAuth、作用域（按需最小化，优先 read）与 webhook；webhook 签名密钥需在合作伙伴门户创建/轮换，再用 salla_apps action=get 读取 webhook_secret 用于 HMAC 验证；三、用 salla_shipping 配置费率区域与选项：get_zones 取当前区域，list_zone_countries/list_zone_cities 取得真实国家与城市 id，-1 为“全部”哨兵值；set_zones 每次整体替换区域列表；一个区域创建后其 country/city 不可更改，只能改费率、时效与货到付款；费用字段有严格边界校验，越界会被拒绝。list_search_options 返回的目录需自行拆分为 Policy Options（is_shipping_policy 为 true）与 Shipment Features（is_filter 为 true 且 is_shipping_policy 为 false 且 categories 含 shipping_category）。适用场景：为 Salla 商家构建承运商运费集成或订单履约分配应用。限制：部分更新的运费设置模型尚未发布，不在范围内；若工具返回信息不足，暂未提供更多细节。