邮政普包入库单同步

使用场景：邮政普包入库完成后只可调用一次(幂等)。

调用凭证： 应用签名

测试环境请求地址: http://test-oapi.gongyi.woa.com/api/supply_service/SaveStockInPbEms

现网环境请求地址: http://oapi.gongyi.woa.com/api/supply_service/SaveStockInPbEms

请求方法: POST （ HTTPS ）

请求参数:

Product:

返回参数:

data内容:

请求示例:

{
  "org_id": "100113",
  "warehouse_id": "XBEMS01",
  "outer_order_id": "123456",
  "order_time": "2025-09-01 11:20:27",
  "purchaser": "测试采购人员",
  "purchaser_phone": "13581233114",
  "dispatch_time": "2025-09-11 11:20:27",
  "recipient_time": "2025-09-21 11:20:27",
  "car_pate": "京A12345",
  "driver_name": "司机姓名",
  "marketplace": "交易平台类型1",
  "warehouse_delivery_mode": 1,
  "finished_time": "2025-09-02 11:20:27",
  "product_list": [
    {
      "product_id": "M1963128510114078720",
      "num": 10,
      "actual_num": 10
    }
  ]
}

返回示例:

{
  "code": 0,
  "data": {
    "stock_in_id": "SI1964969826557009920"
  },
  "msg": "",
  "op_time": 1757320288,
  "trace_id": "58948a28ee43932570579c7c56a94f9b"
}

邮政普包出库单同步

使用场景：邮政普包出库完成后只可调用一次(幂等)。

调用凭证： 应用签名

测试环境请求地址: http://test-oapi.gongyi.woa.com/api/supply_service/SaveShippingOrderPbEms

现网环境请求地址: http://oapi.gongyi.woa.com/api/supply_service/SaveShippingOrderPbEms

请求方法: POST （ HTTPS ）

请求参数:

Product:

RecipientInfo:

省市区名称参照： https://lbs.qq.com/service/webService/webServiceGuide/search/webServiceDistrict

返回参数:

data内容:

请求示例:

{
  "org_id": "100113",
  "proj_id": "50001606",
  "warehouse_id": "XBEMS01",
  "tracking_number": "PbEmsTrackingNumber123123",
  "outer_shipping_id": "43214321",
  "helper_units": "测试受益人1",
  "sender_name": "测试寄件方1",
  "sender_phone": "15631244111",
  "recipient_info": {
    "recipient": "测试收件人1",
    "recipient_phone": "15631244112",
    "province": "北京市",
    "city": "北京市",
    "district": "朝阳区",
    "detailed_address": "新华家园测试街道"
  },
  "product_list": [
    {
      "product_id": "M1963128510114078720",
      "num": 10
    }
  ]
}

返回示例:

{
  "code": 0,
  "data": {
    "order_transcode": "XBEMSSO1964977839170822144"
  },
  "msg": "",
  "op_time": 1757322199,
  "trace_id": "d0998e686a4b05c5785bac95be0ea690"
}

邮政普包出库单更新

使用场景：邮政普包出库完成后，更新出库单状态、收件人信息、物流信息等。

调用凭证： 应用签名

测试环境请求地址: http://test-oapi.gongyi.woa.com/api/supply_service/UpdateShippingOrderPbEms

现网环境请求地址: http://oapi.gongyi.woa.com/api/supply_service/UpdateShippingOrderPbEms

请求方法: POST （ HTTPS ）

请求参数:

RouteInfo:

RecipientInfo:

省市区名称参照： https://lbs.qq.com/service/webService/webServiceGuide/search/webServiceDistrict

Product:

返回参数:

请求示例:

{
  "org_id" : "100113",
  "outer_shipping_id":"43214321",
  "shipping_order_status":3
}

返回示例:

{
  "code": 0,
  "msg": "",
  "op_time": 1757325269,
  "trace_id": "409999973d8ef21274717d7c4e5b8ed6"
}

注：返回http status为非200均需要重试。

data.code 错误码如下，该错误码为逻辑内部错误，其中参数错误需要检查请求参数，其他错误均为逻辑内部错误。