当前位置： API文档

stock_sync_by_pd.php（创建盘点单）

¥标准

1.接口说明

1.1 接口描述：旺店通ERP库存需要调整时，推送盘点库存单据给旺店通ERP，覆盖旺店通ERP实物库存。

                        注：旺店通ERP盘点成功后，盘点单内的库存值直接覆盖前库存

1.2 创建盘点分支场景说明：

①单品盘点：将mode传为1，type传为1，按照仓库+商品+数量维度进行盘点；

②货位盘点：按照仓库+商品+货位+数量维度进行盘点，将mode固定传为2，type传为1时，只变更该商品盘点货位的库存，其他货位库存不变；type传为2时，对该商品盘点货位库存进行传入数量盘点，其他货位库存盘点为0，具体场景说明如下：

假设仓库1 A商品库存情况为 A1货位库存10；A2货位库存20；A3货位库存30，

此时传输盘点信息为仓库1 A商品 货位A1 盘点数量20

当mode传为2，type传为1后库存情况：仓库1 A商品库存情况为 A1货位库存20；A2货位库存20；A3货位库存30

当mode传为2，type传为2后库存情况：仓库1 A商品库存情况为 A1货位库存20；A2货位库存0；A3货位库存0

③明细盘点：将mode传为3，type传为1，按照仓库+商品+货位+批次+效期+数量维度进行盘点；


特别说明：当mode传为3时，position字段为必传字段；Y极速版不支持货位盘点与明细盘点方案，如有需要请联系旺店通商务人员沟通

1.3 注意事项：①：本接口调用时占用服务器资源较多，会影响客户端功能执行效率，因此不要频繁调用，

                        且推送时盘点单货品明细控制在500条及以下,如盘点明细过多，分多次推送。

                        ②：在客户端不做发货操作时调用本接口，一般在前一天20:00以后至下一天凌晨6:00之前。

                        如一个请求包含明细过多，分多次请求。

                        ③：该接口调用日上限2000次。

2.调用场景

2.1举例说明：线下ERP、SAP等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapitest.huice.com/openapi/stock_sync_by_pd.php
正式环境https://openapi.huice.com/openapi/stock_sync_by_pd.php

   3.2 公共请求参数

名称字段类型长度必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是
时间戳timestampint
是

北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通网页

API服务端允许请求最大时间误差为5min，

date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里


 3.3 业务请求参数

名称字段类型长度必须描述
仓库编号warehouse_idint11是

代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义

（ERP仓库界面设置）用于创建指定仓库单据信息

API单号api_outer_no
40是外部单号唯一标识
货品明细列表节点goods_listdata[ ]
是货品明细列表节点
盘点方案modeint11否盘点方案：1.单品盘点（默认） 2.货位盘点 3.明细盘点
盘点类型typeint11否盘点类型：1.货品盘点（默认） 2.货位盘点  注：货位盘点（mode=2）时盘点类型才可以为货位盘点

goods_list

名称字段类型长度必须描述
商家编码spec_novarchar40是代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
盘点数量stock_numdecimal(19,4)是盘点数量（盘点推送的库存数量指覆盖数量，不是调整数量）
货位position_novarchar40否货位；注：货位盘点（mode=2）或明细盘点（mode=3）时必传
批次batch_novarchar
否批次编号 不传默认为空;注:明细盘点（mode=3）使用;
有效期expire_datevarchar
否

有效期 注:明细盘点使用;

日期格式：

[yyyy-MM-dd]

不要时间time

生产日期production_datevarchar
否

生产日期 注:明细盘点使用;

日期格式：

[yyyy-MM-dd]

不要时间time

4.响应参数

 4.1公共相应参数

名称字段类型长度必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误信息messagevarchar255是错误信息
明细校验失败列表warning data[ ]255否返回创建失败的商品信息。创建成功，返回一个空的数组。


warning

名称字段类型长度必须描述
商家编码spec_novarchar40否代表单品(sku)所有属性的编码，SKU概念介绍,单击这里
错误信息error_msgvarchar
否错误信息


常用工具