用途:fedex-pp-cli 是一个驱动 FedEx REST API 的命令行工具,适合中小发货业务,如从订单 CSV 批量创建面单、生成退货标签、跟踪在途包裹,以及在本地留存运单与报价台账。
安装:npx -y @mvanhorn/printing-press-library install fedex --cli-only,随后用 fedex-pp-cli --version 验证。若 npx 安装失败,可改用 go install github.com/mvanhorn/printing-press-library/library/commerce/fedex/cmd/fedex-pp-cli@latest(需 Go 1.26.6 或更新)。若 --version 报 command not found,需先将安装目录加入 PATH 再继续。
主要能力:rate shop 并行比价并按费用或时效排序;ship bulk 按 CSV 批量打单并支持断点续传;return create 依据原运单号生成退货标签;address validate 带本地缓存校验地址;ship etd 一步完成国际电子贸易单据发货。本地状态方面有 address save/list/delete 地址簿、track diff 与 track watch 增量跟踪、archive 的 SQLite FTS5 检索、spend report 费用汇总、export 导出 CSV/JSON、manifest 生成当日清单、sql 直接查询本地库。另含 rates、shipments、track、pickups、freight、consolidations、locations 等 REST 命令。
使用方式:先运行 fedex auth login(OAuth2 client_credentials,客户端 ID/密钥,支持 sandbox 或 prod)缓存令牌,再用 fedex-pp-cli doctor 校验鉴权、环境路由、账号格式与面单格式,并查看 BAG 审批状态。任意命令可加 --agent(等价于 --json --compact --no-input --no-color --yes),可用 --select 裁剪字段,输出可管道处理。不确定命令时用 fedex-pp-cli which "<自然语言描述>"。
限制:生产环境打印面单需 FedEx 的 Bar Code Analysis Group(BAG)审批。部分能力(consolidations、openship)面向高量 3PL 或高级场景,常规 SMB 流程通常不需要。定价、套餐与价格信息资料未提供。