到家侧接口开发规范
API功能描述
售后单确认收货接口
接口地址:https://openapi.jddj.com/djapi/afs/confirmReceipt
授权类型
是
应用场景
商家收到退货类型的售后单的退货商品后(达达转送或商家自送),调用此接口操作确认收货,售后单状态变更为“已收货”,会推送售后单状态消息(1112 退货成功-商家已确认收货) 1、达达专送的-退货中111;退货成功1111才可以确认收货;达达专送:如售后单总金额≥200元,商家确认收货时效为180分钟;如售后单总金额<200元,商家确认收货时效为100分钟(自达达妥投开始计算),111取件成功就可以点击缺认收货按钮;超时系统会自动确认收货后退款。 2、自送商家:待退货110可以确认收货,确认收货时效是24小时(从预计取件结束时间开始计算);超时系统会自动确认收货后退款。 3、自提单用户自送—110待退货可以确认收货
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
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 数据格式