云途燕文物流发货

解决什么问题

跨境电商卖家在发货时往往要在两套承运商系统之间来回切换：在云途（YunExpress）后台查运单、在燕文（Yanwen）客户中心试算运费，再把物流信息手动填回自己的订单系统。这个技能把 carrier-side 的操作收拢到一套命令行入口，让 Agent 可以直接调用承运商 API 完成查件、报价、下单、获取面单等动作，全程不登录任何 Web 后台。

核心能力

只支持两家承运商，且彼此独立：

• 云途物流（YunExpress）：查件、查单、渠道、仓库、运费、跟踪号、面单，以及运单的创建与变更
• 燕文物流（Yanwen）：报价、下单、跟踪、获取面单

所有操作通过脚本入口执行。写操作默认只输出脱敏后的请求预览，必须显式传入 --execute 才会真正提交。

关键步骤

1. 商家自行申请两家的 API 凭证，分别写入本地私有的 yunexpress-shipping.env 和 yanwen-shipping.env
2. 任何操作前先跑 check，验证认证是否通过
3. 报价需要货物尺寸、重量、邮编、包裹类型等参数
4. 创建或变更运单时，先生成 JSON payload 文件，预览并确认后才能执行
5. 创建完成后用 get order 回查运单状态

适用边界

• 不碰 Shopify API，也不注册承运商账号，账户类问题直接转承运商客服
• 凭证只写在被 Git 忽略的 env 文件里，不出现在对话、日志或报告中
• 账号冻结、产品权限、清关决策等需要商家判断的事项，只上报错误，不擅自重试
• 官方提供的 UAT 测试凭证只能用于试算，不能用于真实发货