提交运单信息 · 全球云商供应链

### 使用描述 [售后单状态](查询售后订单详情.md)为`待寄回`且已获取到售后支持的物流信息时,当售后单是退款退货\\换货\\维修类型并且商品售后送货方式为客户发货则需要提交运单信息 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E6%96%B9%E6%B3%95%E5%90%8D)方法名 dby.scm.aftersale.waybill ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E7%BD%91%E5%85%B3%E5%9C%B0%E5%9D%80)网关地址 | 环境 | 地址 | 请求方式 | | --- | --- | --- | | 生产环境 | `https://openapi.duobaoyu.com.cn/open/api` | post+json | | 测试环境 | `https://openapi.duobaoyu88.cn/open/api` | post+json | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E5%85%AC%E5%85%B1query%E5%8F%82%E6%95%B0)公共Query参数 * * * | 名称 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | method | String | 是 | 方法名称 | | sign | String | 是 | [签名](签名规则.md) | | timestamp | String | 是 | 时间戳,格式为13位,例如:1670223623000 | | version | String | 是 | 版本号,现固定为v1 | | appKey | String | 是 | 申请的应用appKey | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)业务Body参数(application/json) * * * | 名称 | 类型 | 必填 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | afterSaleOrderId | java.lang.String | 是 | 1595302620191391744 | 售后订单号 | | waybillInfos | java.util.List | 是 | | 运单信息集合 | | ├─deliverDate | java.lang.Long | 是 | 1669305375031 | 发货日期(13位时间戳例：1669305375031) | | ├─expressCode | java.lang.String | 是 | 344323234 | 物流单号,字段长度不超过50 | | ├─expressCompany | java.lang.String | 是 | 申通 | 发货公司从[查询售后支持的物流](https://duobaoyu.com.cn/documentcenter?onlyFlag=d3dfb3396d80347d6cc2a0ca3173b23c)接口中获取 | | ├─expressCompanyCode | java.lang.String | 是 | STO | 发货公司编码从[查询售后支持的物流](https://duobaoyu.com.cn/documentcenter?onlyFlag=d3dfb3396d80347d6cc2a0ca3173b23c)接口中获取 | | ├─freightAmount | java.lang.Long | 是 | 1000 | 运费(单位:分) | | ├─skuNum | java.lang.Integer | 是 | 2 | 商品数量 | | ├─skuCode | java.lang.String | 是 | 50106182257 | 商品SKU编号 | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0)响应参数 * * * | 名称 | 类型 | 示例值 | 描述 | | --- | --- | --- | --- | | code | java.lang.String | 0 | 业务编码处理结果编码 | | msg | java.lang.String | 请求成功 | 业务处理结果结果说明 | | data | java.lang.Object | | 响应结果 | | ├─afterSaleOrderId | java.lang.String | 1597771590437830656 | 售后订单id | | ├─result | java.lang.Boolean | true | 处理结果 | | msgId | java.lang.String | efd7f07011124adf | 消息id | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)请求示例 curljavaphp ~~~json curl -XPOST -H "Content-type: application/json" -d '{ "afterSaleOrderId":"1597771590437830656", "waybillInfos":[ { "deliverDate":1671851011000, "skuNum":2, "expressCode":"344323234", "skuCode":"50106182257", "expressCompanyCode":"STO", "expressCompany":"申通", "freightAmount":10 } ] }' 'http://xxxxx/open/api?method=dby.scm.aftersale.waybill&version=v1&appKey=your appKey&timestamp=1670057525000&sign=123' ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B)响应示例 ~~~json { "code": "0", "msg": "请求成功", "data": { "afterSaleOrderId": "1597771590437830656", "result": true }, "msgId": "c83409365d724a94" } ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=d236fbf1a9cedc24cce9a71ef5245cbd#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)异常示例 ~~~json { "code": "1", "msg": "请求失败", "data": null, "msgId": "efd7f07011124adf" } ~~~