旺店通wms接口FAQ汇总
一、接入开发
【openapi接口】
Q：接口的请求地址是多少？
A：测试环境：http://39.105.14.222/open_api/service.php
正式环境：https://openapi.wdtwms.com/open_api/service.php
Q：appkey、sid、appsecret、货主编号、仓库编号等参数在哪里查看？
A：测试环境：联调人员提供
正式环境：接口联调完成后，实施人员提供sid等参数
货主编号和仓库编号在wms设置-基本设置-货主或仓库界面进行查看
Q：响应数据做了分页，如何获取所有页的数据？
A：1.涉及的参数说明：
1.1 page_size ：分页大小
请求参数可输入数值，对返回的分页大小进行控制
获取数据的每个接口都有分页大小输入值的范围，例如“销售出库单查询接口（stockout.query）”接口的传参范围为0~30，不传默认10。
1.2 page_no：页号 从0页开始
1.3 total
page_no = 0 时才返回的符合条件的数据总条数
2.建议的分页查询方式：
1. 查询的开始、结束时间递增：如果某个时间段的数据已经查完了，那么就不需要重复查询，因为查询出来的数据也是重复的
第一次查询：
入参：begin_time = "2020-02-14 00:00:00"，end_time = "2020-02-14 00:10:00"，page_no = 0, page_size = 10；
响应：返回数据内容有10条单据——说明数据可能没查完，进入第二次查询，还需要查询这个时间段内的；
第二次查询：
入参：begin_time = "2020-02-14 00:00:00"，end_time = "2020-02-14 00:10:00"，page_no = 1, page_size = 10；
响应：返回数据内容有5条单据——说明这个时间段内数据已经查完，进入第三次查询，不需要再查已经查过的时间范围；
第三次查询：
入参：begin_time = "2020-02-14 00:10:00"，end_time = "2020-02-14 00:20:00"，page_no = 0, page_size = 10；
响应：可以忽略；
2. 查询开始时间、结束时间相互保留一些交叉，避免数据处于临界值而漏掉，处理数据时做好去重。出库单号是唯一的。
第一次查询：入参：begin_time = "2020-02-14 00:00:00"，end_time = "2020-02-14 00:10:00"；
第二次查询：入参：begin_time = "2020-02-14 00:09:59"，end_time = "2020-02-14 00:20:00"；
第三次查询：入参：begin_time = "2020-02-14 00:19:59"，end_time = "2020-02-14 00:30:00"。
Q：调用接口提示“start_time与end_time起止时间跨度不能超过1天？”
A：接口对于start_time 和 end_time之间的间隔有相应的要求，目的是为了控制查询结果中单据的数量,提高接口调用的成功率。解决方案是把1天分成很小的时间段分多次访问。
Q：调用接口wms出参提示“货品有重复的货位有效期批次”如何处理？
A：请求参数里同一个商品出现了多条一模一样的明细，合并成一行后再操作
Q：调用接口提示“接口【】名字错误”如何处理？
A：首先检查method是否传值了，如果传了则是接口地址里拼接了method，但接口实际没把method传过来
Q：销售出库单查询接口 stockout.query出参consign_time发货时间字段是取值哪里的？
A：发货时间字段 路径：出库管理-销售出库-销售出库单界面
Q：调用接口wms出参提示"content":[]"如何处理？
A：检查page_no是否传的0，如果是，则查询对应入参条件下wms是否有满足的单据
Q：为什么不能获取淘系平台数据？
A：淘宝为了保护平台商家、消费者以及阿里巴巴平台的信息数据安全，是规范订单敏感信息的，查看详情链接：https://open.taobao.com/announcement.htm?docId=24981&docType=12&qq-pf-to=pcqq.c2c
Q：stockout.query接口获取的数据如何核对？
A：1. 将获取到的数据存到本地数据库，获取全部数据后，按照货主编号，仓库编号 时间等字段（筛选订单
2. 登录旺店通wms，在出库管理——>销售出库单界面或非销售出库单界面同样按照主编号，仓库编号 时间等筛选单据，在将筛选出的数据进行核对。
Q：调用接口返回的出参总数和wms系统查到的总数不一致，如何处理？
A：检查接口各个入参比如时间范围、货主等和wms系统查询的条件是否完全一致
【wms通用接口和奇门接口】
Q：wms通用接口数据流转方式是怎样的？
A：ERP使用 通用推送接口 接口，调用 WMS的接口 下发数据到WMS
WMS使用 通用回传接口 接口，调用 ERP的接口 返回数据到ERP
Q：wms通用接口appkey、sid、appsecret等参数在哪里查看？
A：请先提供erp联调环境接口地址，然后wms配置后会提供相关参数信息
正式环境，等实施申请配置货主授权后，会提供给erp
Q：奇门接口，ownerCode、customerId、warehouseCode等参数在哪里查看？
A：请先提供erp奇门联调申请截图，然后wms配置后会提供相关参数信息
正式环境，请先申请erp奇门上线截图，实施申请配置后，在wms系统-设置-基本设置-货主或仓库界面查看
Q：怎样更新已经创建成功的货品档案信息？
A：支持更新，actionType传：update
旺店通WMS内的货品结构为 2层结构 目的是为了支持多规格
goodsCode itemCode 字段含义详细说明
比如 外套A 有 xl xxl xxxl 等
那么在旺店通WMS内就可以这么表示
goodsCode=ceshiA itemCode=ceshiAxl
goodsCode=ceshiA itemCode=ceshiAxxl
goodsCode=ceshiA itemCode=ceshiAxxxl
...
这样 goodsCode相同 itemCode不同来表示同一个种类中规格不同的商品
goodsCode与itemCode是一对多的关系,多规格的情况下多个itemCode对应一个goodsCode，单规格的情况下一个itemCode对应一个goodsCode
itemCode是旺店通WMS系统内商品的一个唯一标识
Q：接口的请求地址是多少？
A：测试环境：http://39.105.14.222/wms_api/wdt_service.php
正式环境：https://wmsapi.wdtwms.com/wms_api/wdt_service.php
Q：单据取消之前有接口可以查询是否满足取消条件吗？
A：没有，只有未出库和未入库完成的单据允许取消成功；订单处于不可取消状态时(已发货、已入库等)取消接口是会报错的
Q：创建单据带有特殊字符可以调用成功吗？wms会自动替换或者删掉特殊字符吗？
A：不会，erp下发什么wms原封不动显示什么；如果带特殊字符的话，可能会推送失败，wms也会提示不允许有特殊字符
Q：wms通用接口，一个采购订单传递了两行一模一样的明细到WMS，入库回传时也回传两行吗？
A：是的，wms对行号不做任何业务处理，erp如何下发，wms如何回传
二、API调用
Q：wms通用接口提示签名不正确，如何处理？
A：https://www.yuque.com/docs/share/627960ea-bc4a-4fd9-a6a4-01c220feb390?# 《sign算法签名》
1. url后面只需要放公共请求参数——具体传递哪些看具体业务文档。签名文档仅为示例。
2. 接口为post请求，业务数据（请求参数）通过post请求放在请求体中。
3. 业务数据参与了签名之后，也要通过请求体发送给接口
4. 签名文档中的body即请求体
Q：商品同步成功了然后下发单据还提示旺店通WMS返回：发货单推送失败货品不存在xxx，如何处理？
A：检查下itemcode字段值，itemcode对应wms商家编码字段，所有接口商品信息都要传(商品同步接口下发的itemcode值)
Q：wms接口单据创建成功后，wms返回值都是成功或失败吗
A：再次基础上，如果成功<message>会把wms内部单号返回，如果失败<message>会把错误信息返回
Q：如何申请测试环境延期？
A：目前测试环境是不会关闭的，一直生效。
Q：调用接口提示'入库单推送失败仓库xxx不存在'如何处理？
A：仓库编号传错了，路径：设置-基本设置-仓库界面 查一下正确的仓库编号
Q：订单推送之后，查询不到该订单如何处理？
A：1.订单推送失败，有相关报错：
根据报错信息检查推送的参数，修改后重新进行推送。
2.订单推送响应成功，出参返回了wms内部单号，但是在wms系统里搜索不到对应的订单：
2.1如果调用的是发货单创建接口，首先在业务单据-销售订单界面 查看，状态选择全部，如果查不到，则检查员工权限是否勾选了对应货主和仓库也页面权限，路径：设置-安 全设置-员工权限
2.2如果调用的是出库单创建接口
采购退货类型：CGTH 在业务单据-采购退货单界面查看
其它出库类型QTCK 调拨出库类型DBCK 普通出库类型PTCK 生产出库类型SCCK 唯品会出库类型B2BCK 在业务单据-出库业务单管理界面查看
如果查不到，则检查员工权限是否勾选了对应货主和仓库也页面权限 路径：设置-安全设置-员工权限
2.3如果调用的是入库单创建接口
采购入库单类型CGRK 在业务单据-采购单界面查看
其它入库类型QTRK 调拨入库类型DBRK 生产入库类型SCRK B2BRK在业务单据-入库业务单管理界面查看
2.4如果调用的是退货入库单创建接口，在业务单据-销售退换单界面查看
2.5如果调用的是仓内加工单接口，在货品-货品生产-生产单管理界面查看
Q：推送单据报错：Field Required:detailAddress
A：detailAddress字段必传，内容可以为空。
三、应用授权
Q：调用接口提示'无该接口调用权限'如何处理？ A：请检查请求的sid、appkey、url是否正常，如果以上信息全部正确，联系客户实施邮件申请对应接口权限