1.推送-采购退库出库详情

websocket测试

POST

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

接口描述

通过此接口推送退仓单据操作结果及详情

流程图

![JD退供出库详情推送流程 1.png](https://cos.easydoc.net/48578360/files/kh1ccub8.png)

调用前提条件

>i 当eclp退供单状态=已完成，则调用此接口,回传退供单出库详情 ```json if (退供单状态= 已完成) { 调用此接口回传退供单出库详情 } ```

调用异常处理

>i 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:

请求参数

参数名

类型

描述

必填

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