金蝶云星辰V1和旺店通·企业版接口打通对接实战来源系统:金蝶云星辰V1 金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。对接目标平台:旺店通·企业版慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。多系统对接方案配置数据集成平台对应的配置金蝶云星辰V1与旺店通·企业版的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星辰V1的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星辰V1与旺店通·企业版之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。金蝶云星辰V1接口明细 API： jdy/inv/batch_kfperiod_inv_list NAME：批次保质期及库存列表查询 METHOD： POST 请求参数接口字段字段名称预设值描述 materialids materialids 商品ID集合，多个ID用英文逗号隔开 auxpropids auxpropids 商品辅助属性ID集合，多个ID用英文逗号隔开 stockids stockids 1352055976437514240,1352056159527249920,1352056248396163072,1352056343531386880,1352140684844365824 仓库ID集合，多个ID用英文逗号隔开 spids spids 仓位ID集合，多个ID用英文逗号隔开 begindate begindate 开始时间（修改时间），格式yyyy-MM-dd expiredate expiredate 结束时间（修改时间），格式yyyy-MM-dd page page function 1 1 页码默认1 pagesize pagesize _function 1*20 每页大小，默认10，不传表示不分页响应参数接口字段字段名称预设值描述 id id ID materialid materialid 商品 stockid stockid 仓库 spid spid 仓位 auxpropid auxpropid 辅助属性 qty qty 即时库存数量（基本单位） batchno batchno 批次号 kfdate kfdate 生产日期 kfperiod kfperiod 保质期时长 validdate validdate 到期日 kftype kftype 保质期单位，1：天，2：月，3：年 validqty validqty 即时库存可用量 auxqty auxqty 辅助基本单位库存数量 validauxqty validauxqty 辅助基本单位库存可用量旺店通·企业版接口明细接口： stockin_order_push 接口名称：创建货品档案接口方法： POST 请求参数字段名称类型描述 outer_no 外部单号 string 外部系统的唯一单据编号，避免重复推送数据 warehouse_no 仓库编号 string 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） logistics_code 物流编号 string 代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） logistics_no 物流单号 string 物流公司的运单号，用于追踪物流、快递流转信息（路由）的数字编码 is_check 是否审核 string 1：审核 0：不审核默认0 is_create_batch 是否创建批次 string 0:否；1:是，默认是0。ERP“批次管理”不存在推送的批次号，是否允许单据创建成功，并创建新的“批次号”。 post_fee 邮资 string 物流或者快递运输货物产生的费用 other_fee 其他费用 string 其他费用 remark 备注 string 其他入库单备注 reason 入库原因 string 入库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败，路径：设置—>基本设置—>原因列表） goods_list 货品明细节点 array 入库单货品列表节点 goods_list.spec_no 商家编码 string ERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。SKU概念介绍,单击这里 goods_list.stockin_num 入库数量 string 入库数量 goods_list.position_no 货位编号 string 商品在仓库内的位置编号,不传此参数，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。 goods_list.batch_no 批次 string 货品批次编号 goods_list.batch_remark 批次备注 string 货品批次备注 goods_list.production_date 生产日期 string 货品生产日期，格式：yyyy-MM-dd HH:mm:ss goods_list.validity_days 有效期天数 string 商品有效期，单位：天 goods_list.src_price 原价 string 上层单据的的货品价格，例如采购单的税前折后单价为采购入库的原价，原价减去入库价得出货品优惠。其他入库没有上层单据，根据业务情况自行传值。无特殊业务建议同入库价一致。 goods_list.stockin_price 入库价 string 入库价格，如推送为0默认取成本价。 goods_list.tax 税率 string 对征税对象的征收比例或征收额度。例如税率为16%，请求时填值为0.16 goods_list.is_enable_sn 是否开启序列号 string 是否开启序列号: 0代表不开启序列号 1代表开启序列号默认为不开启 goods_list.sn_list 序列号列表 string 序列号列表，多个序列号通过","隔开字符串区分，例如"xxx1,xxx2,xxx3" goods_list.stockin_info stockin_info string 系统集成总览数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。

金蝶云星辰V1和旺店通·企业版接口打通对接实战

汪淼_轻易云

金蝶云星辰V1和旺店通·企业版接口打通对接实战

来源系统:金蝶云星辰V1

金蝶云星辰是金蝶集团公司为小微型工商贸企业定制的一款集财务、进销存、订货商城和税务管理为一体的SAAS云平台，有标准版和专业版两个版本，标准版适用于小型企业(10-50人)业财一体化管理，专业版面向小型(10-100人)企业管理需求。金蝶云星辰聚焦小型企业在线经营和数字化管理，赋能小型企业拓客开源、智能管理和实时决策。

对接目标平台:旺店通·企业版

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

多系统对接方案配置

数据集成平台对应的配置金蝶云星辰V1与旺店通·企业版的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星辰V1的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星辰V1与旺店通·企业版之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星辰V1接口明细

API：jdy/inv/batch_kfperiod_inv_list
NAME：批次保质期及库存列表查询
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
materialids	materialids		商品ID集合，多个ID用英文逗号隔开
auxpropids	auxpropids		商品辅助属性ID集合，多个ID用英文逗号隔开
stockids	stockids	1352055976437514240,1352056159527249920,1352056248396163072,1352056343531386880,1352140684844365824	仓库ID集合，多个ID用英文逗号隔开
spids	spids		仓位ID集合，多个ID用英文逗号隔开
begindate	begindate		开始时间（修改时间），格式yyyy-MM-dd
expiredate	expiredate		结束时间（修改时间），格式yyyy-MM-dd
page	page	function 11	页码默认1
pagesize	pagesize	_function 1*20	每页大小，默认10，不传表示不分页

响应参数

接口字段	字段名称	描述
id	id	ID
materialid	materialid	商品
stockid	stockid	仓库
spid	spid	仓位
auxpropid	auxpropid	辅助属性
qty	qty	即时库存数量（基本单位）
batchno	batchno	批次号
kfdate	kfdate	生产日期
kfperiod	kfperiod	保质期时长
validdate	validdate	到期日
kftype	kftype	保质期单位，1：天，2：月，3：年
validqty	validqty	即时库存可用量
auxqty	auxqty	辅助基本单位库存数量
validauxqty	validauxqty	辅助基本单位库存可用量

旺店通·企业版接口明细

接口：stockin_order_push
接口名称：创建货品档案
接口方法：POST

请求参数

字段	名称	类型	描述
outer_no	外部单号	string	外部系统的唯一单据编号，避免重复推送数据
warehouse_no	仓库编号	string	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
logistics_code	物流编号	string	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_no	物流单号	string	物流公司的运单号，用于追踪物流、快递流转信息（路由）的数字编码
is_check	是否审核	string	1：审核 0：不审核默认0
is_create_batch	是否创建批次	string	0:否；1:是，默认是0。ERP“批次管理”不存在推送的批次号，是否允许单据创建成功，并创建新的“批次号”。
post_fee	邮资	string	物流或者快递运输货物产生的费用
other_fee	其他费用	string	其他费用
remark	备注	string	其他入库单备注
reason	入库原因	string	入库原因（需要在客户端维护好该原因，如客户端无该原因或者原因停用，则推送失败，路径：设置—>基本设置—>原因列表）
goods_list	货品明细节点	array	入库单货品列表节点
goods_list.spec_no	商家编码	string	ERP内单品唯一编码（SKU），代表单品(SKU)所有属性，并且为库存量出入计算最小单元。SKU概念介绍,单击这里
goods_list.stockin_num	入库数量	string	入库数量
goods_list.position_no	货位编号	string	商品在仓库内的位置编号,不传此参数，读ERP配置【入库开单货位优先级配置】，来决定取默认货位、上一次入库货位、ZANCUN货位其中一个货位。
goods_list.batch_no	批次	string	货品批次编号
goods_list.batch_remark	批次备注	string	货品批次备注
goods_list.production_date	生产日期	string	货品生产日期，格式：yyyy-MM-dd HH:mm:ss
goods_list.validity_days	有效期天数	string	商品有效期，单位：天
goods_list.src_price	原价	string	上层单据的的货品价格，例如采购单的税前折后单价为采购入库的原价，原价减去入库价得出货品优惠。其他入库没有上层单据，根据业务情况自行传值。无特殊业务建议同入库价一致。
goods_list.stockin_price	入库价	string	入库价格，如推送为0默认取成本价。
goods_list.tax	税率	string	对征税对象的征收比例或征收额度。例如税率为16%，请求时填值为0.16
goods_list.is_enable_sn	是否开启序列号	string	是否开启序列号: 0代表不开启序列号 1代表开启序列号默认为不开启
goods_list.sn_list	序列号列表	string	序列号列表，多个序列号通过","隔开字符串区分，例如"xxx1,xxx2,xxx3"
goods_list.stockin_info	stockin_info	string

系统集成总览

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。