Skip to content

批量创建包裹 ​

本接口当前不可用

POST /api/parcel/push-parcel-orders 当前未对外提供服务。该路径没有注册,请求在路由层就会失败——你会收到 404,而不是标准的 {Code, Message, Data} 结构。

请改用 创建单个包裹:它同步登记包裹,并在同一个响应里返回 WMG 运单号,因此不再需要单独调用 获取运单号。

本页仅作参考保留。请不要基于它开发;如需规划批量创建相关的接入,请先联系 tech@wmg-group.com。

接口概述 ​

批量接口原本的设计目的是异步预写入包裹数据,以便之后更快地出面单,流程分三步:批量创建包裹、逐个查询 WMG 运单号、再取面单。

该流程已被取代。创建单个包裹 会立即返回 WMG 运单号,因此中间那步查询不再必要:

  1. 创建单个包裹 —— 返回 Data.WmgTrackingNo
  2. 获取面单 PDF —— 使用上一步得到的运单号

请求信息 ​

  • Method: POST
  • Path: /api/parcel/push-parcel-orders —— 未注册
  • Authentication: Bearer Token

迁移到「创建单个包裹」 ​

如果你之前对接的是批量接口,迁移是机械性的:

批量流程替代方式
一个请求携带 Orders 数组每个包裹发一次 创建单个包裹 请求
之后用 获取运单号 逐个解析 WMG 运单号不需要——创建接口直接返回 Data.WmgTrackingNo
逐条错误汇总在同一个响应里每个包裹在各自的请求中独立成功或失败,Code 和 Message 对应该包裹

单个包裹的字段名没有变化,因此旧 Orders 数组中的一个元素可以原样作为 创建单个包裹 的请求体发送。请以适度的并发发送这些请求,并分别处理每个结果。

注意事项 ​

  • 由于路由未注册,本文档中涉及的认证、校验和业务错误都不适用——请求根本不会进入应用层。
  • 调用它不会对你的账号或数据产生任何影响。
  • 如果批量入库对你的业务量确实重要,请联系 tech@wmg-group.com,而不要反复重试该路径。