文档

测试

1.推送-门店退货单入库详情

websocket测试

POST

http://39.108.211.149:18164/h6-wms-service/open-api/wms/商家库房编号/stkoutbck/upload

接口描述

通过此接口推送入库单入库结果

调用前提条件

```language 当eclp退货入库单号状态=已完成,则判断商家单据类型=门店退货,则调用此接口,推送退货入库详情 if (billtype = stkoutbck) { 则调用此接口推送退货入库详情 } ```

调用异常处理

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

调用注意方式

```language 调用注意事项： 1.请求时detail商品明细数组中，元素顺序应严格按照wow门店退货单获取明细时,明细中的顺序进行排列,再进行推送 ```

数据格式及编码

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

auth接口认证

Authrization Type:BASIC AUTH Username: Password:

请求参数

参数名

类型

描述

必填

num

string(19)

wow门店退货单号(调用商家【单据通知接口】查询返回)

必填

ocrTime

Date

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

必填

sendTime

Date

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

必填

wmsNo

string

物流单号(京东eclp退货入库单号,由于商家要求唯一属性,因此需拼接序号)

必填

details

array

数据列表

必填

line

int

wow门店退货单商品明细中-商品行id

必填

productCode

string(20)

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

必填

qty

int

实际入库数量

必填

batchs

List

批次明细

可选

stockBatch

string(38)

库存批次号(批次属性索引,能反向查询代表了哪些批次属性)

必填

lot

string(38)

批号

可选

mfgDate

Date

生产日期（格式如:YYYY-MM-DD）

可选

validDate

Date

到期日期（格式如:YYYY-MM-DD）

可选

qty

int

当前批次数量

可选

响应参数

参数名

类型

描述

必填

code

string

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

必填

message

string(255)

结果描述

必填

success

boolean

true/false

必填

请求示例

```json { "num":"0010700011510190002", "ocrTime":"2020-7-23 12:29:30", "sendTime":"2020-7-23 14:29:30", "wmsNo":"V123456789XXXXXXX", "details":[ { "line":1, "productCode":"99010009", "qty":10, "batchs":[ { "stockBatch":"P0001", "lot":"V0001", "mfgDate":"2020-9-16", "validDate":"2021-9-16", "qty":5 }, { "stockBatch":"P0002", "lot":"V0002", "mfgDate":"2020-9-16", "validDate":"2021-9-16", "qty":5 } ] }, { "line":2, "productCode":"99010010", "qty":10, "batchs":[ { "stockBatch":"P0003", "lot":"V0003", "mfgDate":"2020-9-16", "validDate":"2021-9-16", "qty":10 } ] } ] } ```

响应示例

```json { "code":"0", "message":null, "success":true } ```

上一篇流程图

nextDoc 2.推送-批发退货单入库详情