2.获取-批发退货单据详情

websocket测试

POST

http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/wholesalebck/get?num=海鼎erp批发退货单号

接口描述

JOS EDI程序通过此接口查询wow侧批发退货单详情

调用前提条件

```c++ 京东JOS EDI采购定时轮询方式进行调用【单据通知接口】,获取到"billType=wholesalebck批发退货"的单据。 if (billtype = wholesalebck) { 则调用此接口获取门店退货单详情,并适配信息为京东退货入库单 } ```

调用异常处理

```c++ 1.请求对方接口失败/无响应/响应超时，连续重试(需记录每次请求日志)。如果连续失败次数>=6次，则放弃请求。发送异常事件邮件至罗琼丹gzluoqiongdan@jd.com 2.请求对方接口成功,适配信息创建eclp采购单失败时，连续重试(需记录每次请求日志)。如果连续失败次数>=6次，则放弃请求。发送异常事件邮件至罗琼丹gzluoqiongdan@jd.com ```

数据格式及编码

ChartSet:UTF-8 Content-Type:application/json Accept:application/json

auth接口认证

Authrization Type:BASIC AUTH Username: Password:

请求参数

参数名

类型

描述

必填

num

string(19)

商家批发退货入库单号(调用商家【单据通知接口】查询返回)

必填

响应参数

参数名

类型

描述

必填

是否为新增字段

code

string(32)

返回结果码 0:正常，非0异常。

必填

message

string(255)

结果描述

必填

success

boolean

true/false

必填

data

array

单据对象数组

可选

num

string(19)

海鼎erp批发退货入库单号

必填

cls

String(5)

单据类型，00024-批发退

必填

warehouseCode

string(10)

仓位代码(商家商品等级:91良品,92残品-次品仓,93残品-待确定仓,94残品-大货样仓,95残品-退供仓)

必填

clientCode

string(10)

wow客户代码

必填

orderDate

Date

下单日期(格式:YYYY-MM-DD)

必填

total

BigDecimal

批发合计金额

可选

note

string(255)

备注

可选

expressCode

string(200)

承运商代码

可选

新增字段

expressName

string(200)

承运商名称

可选

新增字段

expressNum

string(64)

运单号

可选

新增字段

details

array

商品明细数组

必填

line

int

wow批发退货单商品明细的行id)

必填

productCode

string(20)

商家商品代码(商家商品编码)

必填

qty

int

入库数量

必填

qpc

int

规格

必填

qpcStr

string(10)

规格说明

必填

munit

string(6)

包装单位

必填

singlePrice

BigDecimal

批发价

可选

total

BigDecimal

批发金额

可选

note

string(255)

备注

可选

请求示例

==测试环境== ```json GET http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/wholesalebck/get?num=海鼎erp批发退货单号 HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 ``` ==生产环境== ```json GET http://120.79.81.130:18164/h6-wms-service/open-api/wms/{wmsCode}/wholesalebck/get?num=海鼎erp批发退货单号 HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 ```

响应示例

```json { "code":"0", "message":null, "success":true, "data":[ { "num":"0002400011510190002", //海鼎erp批发退货单 "cls":"00024", //单据类型 "warehouseCode":"W001", //仓位代码(商家商品等级) "clientCode":"V0001", //客户编码 "orderDate":"2020-9-9", "total":"100", "note":"备注", "expressCode":"01", //批发退货-C端客户退货承运商编码 "expressName":"京东快递", //批发退货-C端客户退货承运商名称 "expressNum":"12345", //批发退货-C端客户退货运单号 "details":[ //入库明细 { "line":1, //行号 "productCode":"99010009", //商家商品编码 "qty":10, //数量 "qpc":1, //规格 "qpcStr":"1*1", //规格说明 "munit":"个", //包装单位 "singlePrice":"4", "total":"40", "note":"备注1" }, { "line":2, "productCode":"99010010", "qty":10, "qpc":1, "qpcStr":"1*1", "munit":"个", "singlePrice":"6", "total":"60", "note":"备注2" } ] } ] } ```