获取-各场景业务场景集合

websocket测试

POST

http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/notify/get?lastSerialNo=上次获取的业务单据通知表最大序列号

接口描述

JOS EDI程序调用此接口从海鼎erp-单据通知表中获取各业务场景的单据集合

流程图

![海鼎获取业务单号集合 3.png](https://cos.easydoc.net/48578360/files/kniks1vd)

数据格式及编码

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

auth接口认证

Authrization Type:BASIC AUTH Username: Password:

调用方式及异常处理

==调用方式及频率:== ```language 1.京东JOS EDI程序采用"定时轮询方式(定时间隔:5分钟)"进行调用此接口 ``` ==调用异常处理:== ```language 1.请求失败或未收到响应或响应超时,则连续重试(每次需记录日志)。如果连续失败次数>=6次则放弃调用,等待下次轮询，同时发送异常邮件至"gzluoqiongdan@jd.com" 2.如果响应状态码异常(正常判断条件:code=0 and success=true),则连续重试。如果连续失败次数>=6次则放弃调用,等待下次轮询，同时发送异常邮件至"gzluoqiongdan@jd.com" ```

业务逻辑处理

```c++ //处理为:JD采购入库场景 if（billType = "stkin" ） //wow采购则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.2采购入库通知查询接口】获取单据详情 else if（billType = "wmsinvxf.in" ） //wow物流间调拨入则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.30物流间调拨入通知查询接口】获取单据详情 //处理为:JD退货入库场景 else if （billType = "wholesalebck" ） //wow侧批发退货则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.18批发退货通知查询接口】获取单据详情 else if （billType = "stkoutbck" ） //wow侧门店退货则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.12门店退货通知查询接口】获取单据详情 //处理为:JD销售出库场景 else if （billType = "stkout" ） //wow侧门店配货则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.9门店配货通知查询】获取单据详情 else if （billType = "wholesale" ） //wow侧批发配货则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.15批发通知查询接口】获取单据详情 else if （billType = "wmsinvxf.out" ） //wow侧物流间调拨出则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.27物流间调拨出通知查询接口】获取单据详情 //处理为:JD退供应商出库场景 else if （billType = "stkinbck" ）则通过返回的“单据号+单据号对应的wmsCode(使用此值替换请求url中wmsCode的值)”,调wow侧【4.6采购退货通知查询接口】获取单据详情 //处理为:JD纯配单据 else if (billType = "callExpressman") 则通过返回的“单据号,调wow侧【呼叫快递-通知查询接口】获取单据详情 //其他类型单据不处理 else 则其他场景不处理 ```

请求参数

参数名

类型

描述

必填

wmsCode

string

wowCode编码

必填

lastSerialNo

int

wow侧单据通知表行id。传上次接口返回的“serialNo"的最大值

必填

响应参数

参数名

类型

描述

必填

code

string(32)

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

必填

message

string(255)

结果描述

必填

success

boolean

true/false

必填

data

array

数据列表

可选

serialNo

string

wow侧单据通知表行id。（京东需记录数组中最大值,作为下次调用时的入参）

必填

billType

string(40)

单据类型，stkin/stkinbck-采购/采购退、 stkout/stkoutbck-门店配货/门店退货、 wholesale/wholesalebck-批发/批发退、stkoutdiff-门店配货差异. wmsinvxf.in/wmsinvxf.out-物流调拨入/物流调拨出,、invusesign/invusesignbck-仓库领用/仓库领用返回

必填

billNum

string(19)

wow侧业务单据编号

必填

请求示例

==测试环境== ```json GET http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/notify/get?lastSerialNo=上次获取的业务单据通知表最大序列号 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}/stkin/get?lastSerialNo=上次获取的业务单据通知表最大序列号 HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 ```

响应示例

```json { "code":"0", "message":null, "success":true, "data":[ { "serialNo":"1", //wow侧单据通知表行id，京东需记录数组中最大值,作为下次调用时的入参 "billType":"stkin", //单据类型 "billNum":"0016500011510190002" //wow侧业务单据编号 }, { "serialNo":"2", "billType":"stkinbck", "billNum":"0016500011510190003" } ] } ```