用途:面向跨境电商卖家,处理云途物流(YunExpress)与燕文物流(Yanwen)的承运商侧操作,包括查包裹、查订单、查渠道与仓库、报价、费用明细、轨迹、面单及创建承运订单。不用于注册承运账号、管理 Shopify 店铺、自动履约,也不替商户做清关或地址决策。
主要能力:读取类操作有国家、产品方式、货物类型、报价、订单、轨迹、全量轨迹、运单号、费用明细、渠道等;写入类包括创建订单、面单及取消、拦截、IOSS 注册/停用、订阅变更、提交 CPSC 数据等状态变更。创建订单单次最多 10 单。
使用方式:先向承运商获取自有凭证。云途在后台选专线(或 B2B),进入 API寄件→API,复制客户代码与 API 密钥;生产地址 YUNTU_OMS_BASE_URL=http://oms.api.yunexpress.com,UAT 仅用云途提供的地址与配套凭证。燕文在客户中心选小包专线,进入账号管理→制单账号管理→新增制单账号,复制制单账号与密钥;生产用 https://open.yw56.com.cn/api/order,测试用 https://open-fat.yw56.com.cn/api/order。凭证只放工作目录下被忽略的 yunexpress-shipping.env 或 yanwen-shipping.env,不得粘贴到聊天、源码、命令历史、报告或 Git。
初始化与检查命令:python <skill路径>/scripts/yunexpress_shipping.py init-env --env yunexpress-shipping.env;check 为只读校验,加载国家、产品方式、货物类型并试报价,不创建订单。燕文对应 yanwen_shipping.py init-env 与 check。报价示例:get quote --query CountryCode=GB Weight=0.125 Length=1 Width=1 Height=1 PackageType=0。查单用 get order --query OrderNumber=<运单或订单或轨迹号>。写操作先不带 --execute 生成脱敏预览与校验结果,确认操作与订单号后再加 --execute。可用 --help 查看全部操作。
限制与注意:写操作(创建、修改、取消、删除、拦截、IOSS 注册/停用、订阅变更、提交 CPSC)须在 --execute 前获得用户明确批准。燕文账号即使签名有效也可能被冻结,应报告承运商错误并联系燕文销售或支持,不要重试创建。报价为某一时点 API 结果。输出中不显示完整街道地址、电话、邮箱或凭证;面单只返回临时 URL 与订单级错误,不自动下载、打印或分享。响应码解释见 references/yunexpress-api.md 与 references/yanwen-api.md。