1.推送-采购入详情

websocket测试

POST

http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/stkin/upload

接口描述

JOS EDI通过此接口推送wow侧采购入库单入库结果

调用前提条件

>i wms进行批次完验后,推送入库详情至eclp,eclp需判断商家业务类型="采购入stkin",进行入库详情明细推送 ```c++ if 商家业务类型="stkin"(采购入) { 则wms入库,批次完验后,回传库存给eclp,eclp调此接口详情给商家 } ```

调用异常处理

```c++ 1.请求对方接口失败/超时未响应,则重试6次(需记录每次请求日志) 如果连续失败次数>=6次.则放弃,并发送异常事件邮件至罗琼丹 2.对方接口响应异常(正常标准:code=0 and success=true),则继续重试如果连续失败次数>=6次.则放弃,并发送异常事件邮件至罗琼丹 ```

数据格式及编码

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

auth接口认证

Authrization Type:BASIC AUTH Username: Password:

调用注意

```json 1.商品明细details数组中元素顺序：应严格按照商家行号进行排序后,再进行推送 2.实收为0的行,也应加入推送 ```

请求参数

参数名

类型

描述

必填

num

string(19)

商家采购入库单号(调用商家【单据通知接口】查询返回)

必填

ocrTime

Date

业务发生时间(影响库存时间), 格式：2020-7-23 12:29:30

必填

sendTime

Date

发送时间，格式：2020-7-23 14:29:30

必填

wmsNo

string

物流单号(京东eclp采购入库单号)

必填

details

array

数据列表

必填

line

int

采购入库单入库商品明细中-商品行号

必填

productCode

string(20)

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

必填

qty

int

实际入库数量

必填

响应参数

参数名

类型

描述

必填

code

string

结果码(0 正常，非0异常)

必填

message

string(255)

结果描述

必填

success

boolean

true/false

必填

请求示例

==测试== ```json POST http://39.108.211.149:18164/h6-wms-service/open-api/wms/{wmsCode}/stkin/upload HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 { "num":"0016500011510190002", //商家采购入库单号 "ocrTime":"2020-7-23 12:29:30", //业务发生时间(影响库存时间) "sendTime":"2020-7-23 14:29:30", //发送时间 "wmsNo":"V123456789XXXXXXX", //物流单号(京东eclp采购入库单号,由于商家要求唯一属性,因此需拼接序号) "details":[ { "line":1, //采购入库单入库商品明细中-商品行号 "productCode":"99010009", //商品代码(商家商品编码) "qty":10 //实际入库数量 }, { "line":2, "productCode":"99010010", "qty":10 } ] } ``` ==生产== ```json POST http://120.79.81.130:18164/h6-wms-service/open-api/wms/{wmsCode}/stkin/upload HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 { "num":"0016500011510190002", //商家采购入库单号 "ocrTime":"2020-7-23 12:29:30", //业务发生时间(影响库存时间) "sendTime":"2020-7-23 14:29:30", //发送时间 "wmsNo":"V123456789XXXXXXX", //物流单号(京东eclp采购入库单号,由于商家要求唯一属性,因此需拼接序号) "details":[ { "line":1, //采购入库单入库商品明细中-商品行号 "productCode":"99010009", //商品代码(商家商品编码) "qty":10 //实际入库数量 }, { "line":2, "productCode":"99010010", "qty":10 } ] } ```

响应示例

```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":"个" } ] } ] } ```