到家侧接口开发规范
API功能描述
查询售后单详情接口
接口地址:https://openapi.jddj.com/djapi/afs/getAfsService
授权类型
是
应用场景
商家接收到“新建售后单申请消息”、“售后单状态消息”为待审核时,需要调用此接口返查售后单详情。 注:用户售后实际退款总金额totalMoney=应退商品金额cashMoney+应退订单餐盒费mealBoxMoney+应退订单运费金额orderFreightMoney+应退包装费金额packagingMoney+应退到家积分金额platformIntegralDeductMoney+自提服务费实付金额selfPickPayMoney。
追加说明:
1)针对京东物竞天择(京东秒送)售后单(afsOrderType=20)的售后详情数据,已经转译为与到家售后单一样的详情数据结构,如果商家之前按照特殊逻辑对接过,可以按需切换到正常逻辑来
2)针对京东天选售后单(afsOrderType=23),售后详情数据结构与到家售后单一致,如果商家新入驻了天选业务,则可以直接按照到家售后单字段对接即可
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30 |
format | String | 是 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:1.0 |
应用级别输入参数
字段 | 类型 | 是否必须 | 示例值 | 描述 |
返回结果
字段 | 类型 | 示例值 | 描述 |
code | String | 0 | 0表示成功,其他均为失败。 详见:到家平台状态码说明 |
msg | String | 操作成功 | 结果描述 |
+data | String | 返回值对象,该属性值为字符串型JSON数据,请先按照字符串取值,再解析转换成JSON对象。 |
返回示例值
JSON 数据格式