批量创建包裹
本接口当前不可用
POST /api/parcel/push-parcel-orders 当前未对外提供服务。该路径没有注册,请求在路由层就会失败——你会收到 404,而不是标准的 {Code, Message, Data} 结构。
请改用 创建单个包裹:它同步登记包裹,并在同一个响应里返回 WMG 运单号,因此不再需要单独调用 获取运单号。
本页仅作参考保留。请不要基于它开发;如需规划批量创建相关的接入,请先联系 tech@wmg-group.com。
接口概述
批量接口原本的设计目的是异步预写入包裹数据,以便之后更快地出面单,流程分三步:批量创建包裹、逐个查询 WMG 运单号、再取面单。
该流程已被取代。创建单个包裹 会立即返回 WMG 运单号,因此中间那步查询不再必要:
请求信息
- Method: POST
- Path:
/api/parcel/push-parcel-orders—— 未注册 - Authentication: Bearer Token
迁移到「创建单个包裹」
如果你之前对接的是批量接口,迁移是机械性的:
| 批量流程 | 替代方式 |
|---|---|
一个请求携带 Orders 数组 | 每个包裹发一次 创建单个包裹 请求 |
| 之后用 获取运单号 逐个解析 WMG 运单号 | 不需要——创建接口直接返回 Data.WmgTrackingNo |
| 逐条错误汇总在同一个响应里 | 每个包裹在各自的请求中独立成功或失败,Code 和 Message 对应该包裹 |
单个包裹的字段名没有变化,因此旧 Orders 数组中的一个元素可以原样作为 创建单个包裹 的请求体发送。请以适度的并发发送这些请求,并分别处理每个结果。
注意事项
- 由于路由未注册,本文档中涉及的认证、校验和业务错误都不适用——请求根本不会进入应用层。
- 调用它不会对你的账号或数据产生任何影响。
- 如果批量入库对你的业务量确实重要,请联系 tech@wmg-group.com,而不要反复重试该路径。