旺店通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是否正常,如果以上信息全部正确,联系客户实施邮件申请对应接口权限

四、业务咨询

五、wms操作