1.获取-采购入单据详情

websocket测试

POST

http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/stkin/get?num=海鼎erp采购入库单号

接口描述

JOS EDI程序调用此接口查询wow采购单据详情

调用前提条件

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

调用异常处理

```language 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:

业务处理逻辑

1.JOS EDI调用此接口成功后,需适配为eclp采购单信息,在eclp创建采购单 2.创建采购单事项: ```language ==采购单主信息== 2.1采购单类型=一般 2.2isv采购单号=接口返回值“num商家采购入库单号” 2.3记录商家单据类型=采购(后续推送取消结果,推送入库详情时需判断,调不同的接口) 2.4是否缺量收货=是 2.5是否分批次收货=否 2.6供应商编码=需拿接口返回值“商家供应商编码vendorCode”到【eclp-商家供应商管理】中查询返回供应商编码,供应商名称 2.7同时需记录并下传“商家供应商编码”至wms（后续打印供应商送货验收单时需打印） 2.8收货等级=单据等级 2.9是否支持修改=否 2.10按箱入库=否 2.11是否上门取件=否 2.12是否上传序列号清单=否 2.13回传方式=按单回传 ``` ```language ==采购单入库商品明细== 2.1需根据商家商品代码productCode到商品主数据中查询相关信息作为行商品明细 2.2计划入库数量=接口返回值qty 2.2需记录商家商品行号(后续需按照商家行号排序后推送详情) ```

请求参数

参数名

类型

描述

必填

num

string(19)

wow采购入库单号

必填

响应参数

参数名

类型

描述

必填

code

string(32)

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

必填

message

string(255)

结果描述

必填

success

boolean

true/false

必填

data

array

单据对象数组

可选

num

string(19)

商家采购入库单号

必填

cls

String(5)

单据类型，00165-自营进

必填

warehouseCode

string(10)

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

必填

vendorCode

string(10)

商家商品供应商编码,供应商编码及详情见eclp-商家供应商管理

必填

orderDate

Date

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

必填

demandDate

Date

要求到货日期(格式:YYYY-MM-DD)

必填

expiryDate

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://localhost:8080/h6-service/open-api/wms/0001/stkin/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/0001/stkin/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", //商家采购入库单号 "cls":"00165", //单据类型，00165-自营进 "warehouseCode":"W001", //仓位代码(商家商品等级:91良品,92残品-次品仓,93残品-待确定仓,94残品-大货样仓,95残品-退供仓) "vendorCode":"V0001", //商家商品供应商编码,供应商编码及详情见eclp-商家供应商管理 "orderDate":"2020-9-8", //采购单建单日期 "demandDate":"2020-9-9", //要求到货日期(格式:YYYY-MM-DD) "expiryDate":"2020-9-20", //单据到期日期(格式:YYYY-MM-DD) "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":"个" } ] } ] } ```