当前位置: API文档
wms.stockin.SmartRefund.createExt(快速退货)
1.1 接口描述:推送快速退货单据信息给ERP |
1.2 适用版本:客户端 V1.2.2.8及以上版本 |
1.3 增量获取:不支持 |
1.4 时间跨度:start_time和end_time最大跨度为30天。 |
1.5注意事项:【权限校验】:店铺权限 |
2.1 举例说明:自研商城、分销系统、全渠道等系统对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/ |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | 是 | 由旺店通分配appkey, 在发送的数据中对应 key 字段 | |
盐 | salt | String | 是 | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | 是 | 调用的接口名称 | |
版本号 | v | String | 是 | 1.0 | |
秒级时间戳 | timestamp | int | 是 | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | 是 | 签名 | |
分页大小 | page_size | int | 否 | 分页大小,分页查询必传 | |
分页编号 | page_no | int | 否 | 分页编号,分页查询必传 | |
是否计算查询结果的总条数 | calc_total | int | 否 | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
退货信息 | refundInfo | Map<String, Object> | 是 | 退货信息 | |
退货货品详细信息 | detailMapList | List<Map<String, Object>> | 是 | 退货货品详细信息 | |
是否允许退货货品数量大于购买数量 | createPreStockin | boolean | 1 | 是 | 是否允许退货货品数量大于购买数量 |
refundInfo | |||||
原始单号 | tid | String | 40 | 是 | 原始单号 |
退货入库仓编号 | return_warehouse_no | String | 40 | 是 | 退货入库仓编号 |
退货备注 | remark | String | 255 | 是 | 退货备注,无备注可以传空字符串 |
detailMapList | |||||
商家编码 | spec_no | String | 40 | 是 | 商家编码 |
入库数量 | stockin_num | Decimal | 是 | 入库数量 | |
备注 | remark | String | 255 | 是 | 备注,无备注就传空字符串 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | code | Int | 是 | 如果成功就返回0 | |
返回值 | data | Object | 是 | 如果成功就返回null,否则以异常形式抛出 | |
失败值 | fail | boolean | 是 | 如果成功,返回false | |
返回信息 | message | String | 是 | 成功返回”OK” | |
成功值 | ok | boolean | 是 | 如果成功,返回true | |
post_handle | post_handle | Object | 是 | 返回null |
6.响应示例
6.1 正常响应示例
JSON | { "status": 0, "data": "ok" } |
6.2 异常响应示例
JSON | { "status": 100, "message": "未找到对应的单据信息!" } |