### 使用描述
根据[批量查询商品售后权益](批量查询商品售后权益.md)接口返回的结果来创建售后单,[售后单初始状态](查询售后订单详情.md)为`待审核`
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E6%96%B9%E6%B3%95%E5%90%8D)方法名
dby.scm.aftersale.apply
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%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=ddb99c0b0e143e98737ffc2dd794e33e#%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=ddb99c0b0e143e98737ffc2dd794e33e#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)业务Body参数(application/json)
* * *
| 名称 | 类型 | 必填 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| orderItemId | java.lang.String | 是 | 1595302620191391744 | 子订单号 |
| afterSaleType | java.lang.Integer | 是 | 3 | 售后类型：(1:退货退款；2:换货 3:维修 4:仅退款) 从[查询商品售后权益中获取](批量查询商品售后权益.md)接口中获取 |
| buyerReceived | java.lang.String | 否 | true | 买家是否收到货(true：已收到货 false：未收到货),从[查询商品售后权益中获取](批量查询商品售后权益.md)接口中获取,默认是false |
| skuCode | java.lang.String | 是 | 50106182257 | 商品编号 |
| skuNum | java.lang.Integer | 是 | 2 | 商品数量 注:如果售后类型为仅退款，则商品数量为非必填,如果是退货退款，换货，维修等，商品数量为必填项 |
| reasonCode | java.lang.String | 是 | | 售后原因编码 从[查询商品售后权益中获取](批量查询商品售后权益.md)接口中获取 |
| reasonName | java.lang.String | 是 | | 售后原因说明 从[查询商品售后权益中获取](批量查询商品售后权益.md)接口中获取 |
| remark | java.lang.String | 否 | | 售后描述（限100字符） |
| refundFreightAmount | java.lang.Long | 是 | 800 | 期望退款运费 单位:分 仅做参考作用，具体以[查询售后订单详情](查询售后订单详情.md)的实际退款运费为准 |
| vouchers | java.util.List | 否 | | 凭证图片列表 从[查询商品售后权益](批量查询商品售后权益.md)接口中返回的needVoucher字段判断是否必传 |
| pickUpWare | java.lang.Object | 否 | | 预约取件 如果售后类型为仅退款, 则预约取件为空,其他类型不能为空 |
| ├─pickupWare | java.lang.String | 否 | | 取件方式 从[查询商品售后权益中获取](批量查询商品售后权益.md)接口中获取 注:售后类型如果为仅退款，则取件方式为非必填，如果是退货退款，换货，维修等方式，则取件方式为必填项 |
| ├─consigneeProvinceCode | java.lang.String | 否 | | 取件省ID |
| ├─consigneeCityCode | java.lang.String | 否 | | 取件市ID |
| ├─consigneeCountyCode | java.lang.String | 否 | | 取件县ID |
| ├─consigneeTownCode | java.lang.String | 否 | | 取件乡镇ID |
| ├─consigneeAddress | java.lang.String | 否 | | 收货详细地址 |
| ├─reserveDateBegin | java.lang.Long | 否 | | 预约取件开始时间(13位时间戳 例：1669305374031) |
| ├─reserveDateEnd | java.lang.Long | 否 | | 预约取件结束时间 (13位时间戳 例：1669305375031) |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%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 | 售后订单号 |
| ├─result | java.lang.Boolean | true | 处理结果 |
| msgId | java.lang.String | efd7f07011124adf | 消息id |
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)请求示例
curljavaphp
~~~json
curl -XPOST -H "Content-type: application/json" -d '{
"afterSaleType":"1",
"reasonCode":"11060778541",
"reasonName":"包装损坏",
"vouchers":["https://xxxxxx/d36a88f001fa4cefb07b461f1b133561.png "],
"skuCode":"50106182257",
"skuNum":"1",
"orderItemId":"1598946719310151680",
"buyerReceived":true,
"refundFreightAmount": 234,
"pickUpWare":{
"pickupWare":"3",
"consigneeProvinceCode":"31",
"consigneeCityCode":"3101",
"consigneeCountyCode":"310101",
"consigneeTownCode":"310101002",
"consigneeAddress":"和平大厦",
"reserveDateBegin": 1669305374031,
"reserveDateEnd": 1669305375031
}
}' 'http://xxxxx/open/api?method=dby.scm.aftersale.apply&version=v1&appKey=your appKey×tamp=1670057525000&sign=123'
~~~
### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%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=ddb99c0b0e143e98737ffc2dd794e33e#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)异常示例
~~~json
{
"code": "1",
"msg": "请求失败",
"data": null,
"msgId": "efd7f07011124adf"
}
~~~
- 产品介绍
- 开发指南
- 实物商品对接流程
- 签名规则
- JAVA SDK使用
- PHP SDK使用
- 商品消息对接流程
- 虚拟商品对接流程
- 电影H5对接流程
- 卡密信息解密规范
- 错误码查询
- 商品API文档
- 商品
- 查询商品SPU详情
- 查询商品SPU深度分页
- 查询商品可售性
- 手机号所属运营商查询
- 查询商品详情
- 查询商户商品上下架状态
- 查询商品最小起订量
- 查询商品价格
- 根据SKU查询商品SPU详情
- 查询商品分类逐级获取
- 查询商品分类分页获取
- 订单
- 运费评估
- 确认收货
- 查询订单物流信息
- 查询订单详情
- 取消订单
- 确认下单
- 实物商品预下单
- 虚拟商品预下单
- 售后
- 查询售后退款详情
- 查询售后订单详情
- 取消售后申请
- 确认售后完成
- 提交运单信息
- 查询售后支持的物流
- 查询客户寄回地址
- 创建退款退货申请
- 上传商品售后凭证
- 批量查询商品售后权益
- 地址
- 详细地址转换成供应链地址编码
- 省市区街道4级地址查询
- 消息
- 消息通知
- 账户
- 查询商户账户信息
- 电影API文档
- 电影H5
- 电影H5首页免登录
- 设置商户价格策略
- 设置商户货币兑换比例
- H5电影订单详情
- H5电影订单确认
- H5电影订单列表
- 电影消息
- 电影消息通知