文档
测试

1.取消-采购入库单消息推送

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

接口描述

通过此接口推送wow采购入库单取消结果

流程图

![JD采购入库取消_海鼎采购入库_海鼎调拨入单据取消 2.png](https://cos.easydoc.net/48578360/files/kh1dlsxz.png)

调用前提条件

>i 当eclp采购单状态=已取消,则京东JOS EDI程序应判断采购单对应商家侧的单据类型。做不同的逻辑处理 ```json if 商家业务类型="stkin"(采购入) { 则eclp调此接口推送取消成功的消息 } if 商家业务类型="wmsinvxf.in"(物流间调拨入) { 则不做任何处理(因为wow侧反馈物流间调拨入无任何取消场景) } ```

调用异常处理

```language 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)
商家采购入库单号
必填
reason
string(255)
取消原因
必填

响应参数

参数名
类型
描述
必填
code
string(32)
返回结果码 0:正常, 非0异常。
必填
message
string(255)
结果描述
必填
success
boolean
true/false
必填

请求示例

==测试== ```json POST http://39.108.211.149:18164/h6-wms-service/open-api/wms/0001/stkin/cancel HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 { "num":"0016500011510190002", "reason":"下错单了" } ``` ==生产== ```json POST http://120.79.81.130:18164/h6-wms-service/open-api/wms/0001/stkin/cancel HTTP/1.1 Authorization: Basic Z3Vlc3Q6Z3Vlc3Q= Content-Type: application/json; charset=utf-8 { "num":"0016500011510190002", "reason":"下错单了" } ```

响应示例

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