中文 | English
Home > Document > 接口更新库存前提条件

接口更新库存前提条件

供应商ERP系统能够通过接口进行库存同步的前提条件:

1.供应商完成商品资料在供应商管理平台的录入和审核;———供应商和唯品会商务分别确定

2.商品定价完成、资料发布完成(商品资料审核—>定价审核—>商品发布 顺序不能错,否则系统无法自动初始化);———唯品会商务确定

3.商品所在档期退供地址绑定完成(未完成无法进行库存初始化);———唯品会商务确定

4.商品库存初始化完成(以上步骤完成会自动进行库存初始化,初始化未成功可对未成功的条码再次进行初始化,初始化完成后可根据日志查看初始化是否商品是否初始化成功);———唯品会商务确定

5.供应商在内部云仓系统已登记、且常态合作编码的库存同步权限已开通;———唯品会商务确定

6.唯品会接口已有数据,供应商ERP入参错误导致未下载到商品资料;———供应商技术或者软件服务商技术确定

1.商品资料在唯品会已完成录入(供应商&商务共同确认)

1)供应商和商务自行确认

2.商品发布已完成标志(商务确认)

商品在价格系统定价后,系统自动发布商品,一般情况自动发布都会成功,除非有异常导致发布失败,例如PDC资料有问题,定价有问题。日志按钮可以查失败原因。没有自动发布成功,需要手工点击发布。(禁售一定要确认,禁售商品初始化不会成功) 2.png

3.绑定退供地址完成的标志(商务确认)

1.png

4. 库存初始化完成标志(商务确认)

初始化完成一定要点击查看日志,日志都成功才算成功。 1.png

5.供应商在内部云仓系统已登记&常态合作编码的库存同步权限已开通标志(商务确认)

如商务未开通该常态合作编码的库存同步权限,更新库存会报错:vipapis.comm.invalid-parameter,cooperation_no xxxxxxxx is forbidden!

备注:如有新入驻的供应商主体需要拉取商品资料但使用VC后台手动维护库存的方式,需要先开启库存同步,供应商信息会自动在内部云仓系统登记,5分钟后再关闭该权限。(只有在内部云仓系统登记过的供应商才能通过getSkuList接口获取商品资料) 常态权限开通.png

6.唯品会接口(getSkuList)已有数据标志(供应商技术或者服务商技术确认)

通过点击接口文档下方的在线测试工具,直接跳转到该接口的测试工具界面,使用ERP的参数直接模拟调用该接口查询对应条码接口是否有返回数据。 getSkuList接口文档链接:https://vop.vip.com/home#/api/method/detail/vipapis.inventory.InventoryService-1.0.0/getSkuList

4.png 5.png

如果该接口已有数据,但是更新库存还不成功,即erp系统参数不正确或者触发熔断值:

参数不正确或者缺失:

1)常态合作编码缺失,一个条码只存在一个常态档期下,常态合作编码可以为空;一个条码在多个常态档期下,更新库存时如果入参常态合作编码为空,会报错:barcode maybe in multiple schedule

2)常态合作编码入参不正确,B常态下的条码,更新库存时入参常态合作编码为A,常见于创建新档期场景。

触发熔断值报错(此场景表现为部分条码可以同步成功,部分条码更新库存报错):

1.png