3.获取-仓库领用返回单据详情

websocket测试

POST

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

接口描述

JOS EDI程序通过此接口查询wow侧仓库领用返回单据详情

调用前提条件

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

调用异常处理

```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)

单据类型，04402-领用返回

必填

warehouseCode

string(10)

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

必填

deptCode

string(10)

部门代码(京东可忽略)

必填

orderDate

Date

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

必填

details

array

商品明细数组

必填

line

int

商品明细的行id

必填

productCode

string(20)

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

必填

qty

int

入库数量

必填

qpc

int

规格

必填

qpcStr

string(10)

规格说明

必填

munit

string(6)

包装单位

必填

请求示例

==测试环境== ```json GET http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/invusesignbck/get?num=0440200011510190002 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}/invusesignbck/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":"0016500011510190002", //wow领用返回单号 "cls":"00165", //单据类型，04402-领用返回 "warehouseCode":"w001", //仓位代码(商家商品等级:91良品,92残品-次品仓,93残品-待确定仓,94残品-大货样仓,95残品-退供仓) "deptCode":"V0001", //部门代码,京东忽略 "orderDate":"2020-9-8", //门店退货单建单日期 "details":[ //商品明细 { "line":1, //商品明细行id "productCode":"99010009", //商家商品代码(商家商品编码) "qty":10, //数量 "qpc":1, //规格 "qpcStr":"1*1", //规格说明 "munit":"个" //包装单位 }, { "line":2, "productCode":"99010010", "qty":10, "qpc":1, "qpcStr":"1*1", "munit":"个" } ] } ] } ```