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