旺店通·企业奇门对接打通金蝶云星空查询货品档案接口与物料新增接口来源系统:旺店通·企业奇门慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。写入目标:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。配置集成方案系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：旺店通·企业奇门的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试旺店通·企业奇门接口明细 API： wdt.goods.query NAME：查询货品档案 METHOD： POST 请求参数接口字段字段名称预设值描述 deleted 已删除货品默认为0, 0：只返回未删除货品 1：返回未删除和已删除货品 barcode 条码 start_time 开始时间 {{LAST_SYNC_TIME datetime}} 按最后修改时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss end_time 结束时间 {{CURRENT_TIME datetime}} page_size 分页大小 {{PAGINATION_PAGE_SIZE}} 每页返回的数据条数，输入值范围1 100，不传本参数，输入值默认为40，使用举例单击这里 page_no 页号 {{PAGINATION_START_PAGE}} 不传值默认从0页开始响应参数接口字段字段名称预设值描述 goods_id 货品ID 货品表主键 goods_no 货品编号代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍，单击这里 goods_name 货品名称货品名称 short_name 简称简称 alias 货品别名货品别名 goods_type 货品类别货品类别 0:其它, 1:销售货品, 2:原材料, 3:包装物, 4:周转材料, 5:虚拟商品, 6:固定资产,7:保修配件 spec_count 规格数规格数 pinyin 拼音拼音 brand_no 品牌编号品牌编号 brand_name 品牌品牌名称 origin 产地产地 class_id 分类id 分类id class_name 分类分类名称 brand_id 品牌id 品牌ID properties 属性属性 version_id 版本号版本号，用来检查同时修改的 unit_name 基本单位基本单位名称 aux_unit_name 辅助单位辅助单位名称 flag_name 标记名称标记名称 goods_created 创建时间格式：yyyy-MM-dd HH:mm:ss。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段 goods_modified 最后修改时间格式：yyyy-MM-dd HH:mm:ss spec_list 单品节点响应参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list" spec_list.remark 备注备注 spec_list.prop1 自定义1 自定义1 spec_list.prop2 自定义2 自定义2 spec_list.prop3 自定义3 自定义3 spec_list.prop4 自定义4 自定义4 spec_list.prop5 自定义5 自定义5 spec_list.prop6 自定义6 自定义6 spec_list.unit 基本单位基本单位 spec_list.aux_unit 辅助单位辅助单位 spec_list.flag_id 标记标记 spec_list.modified 最后修改时间最后修改时间格式：yyyy-MM-dd HH:mm:ss spec_list.created 创建时间创建时间格式：yyyy-MM-dd HH:mm:ss spec_list.deleted 是否已删除是否已删除：0：未删除 >0代表已删除 spec_list.spec_id 规格ID 规格ID spec_list.spec_no 商家编码代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍，单击这里 spec_list.spec_code 规格码规格码 spec_list.barcode 主条码主条码，单品下如果有多个条码，会随机返回其中一条条码 spec_list.spec_name 规格名称规格名称 spec_list.lowest_price 最低价最低价 spec_list.retail_price 零售价零售价 spec_list.wholesale_price 批发价批发价 spec_list.member_price 会员价会员价 spec_list.market_price 市场价市场价 spec_list.custom_price1 自定义价格1 自定义价格1 spec_list.custom_price2 自定义价格2 自定义价格2 spec_list.sale_score 销售积分销售积分 spec_list.pack_score 打包积分打包积分 spec_list.pick_score 拣货积分拣货积分 spec_list.validity_days 有效期天数保质期 spec_list.sales_days 最佳销售天数最佳销售天数 spec_list.receive_days 最佳收获天数最佳收获天数 spec_list.weight 重量重量 spec_list.length 长长(CM) spec_list.width 宽宽(CM) spec_list.height 高高(CM) spec_list.is_sn_enable 启用序列号 0不启用序列号 1强序列号 2弱序列号 spec_list.is_allow_neg_stock 是否允许负库存 0（不允许负库存）;1（允许负库存） spec_list.is_not_need_examine 是否出库不验货 0（出库不验货）;1（出库必须验货） spec_list.is_zero_cost 是否允许0成本 0（不允许0成本）;1（允许0成本） spec_list.is_lower_cost 是否允许低于成本价 0（不允许低于成本价）;1（允许低于成本价） spec_list.is_not_use_air 是否航空禁运 0(航空不禁运) 1(航空禁运); spec_list.tax_rate 税率税率 spec_list.large_type 大件类别 0非大件1普通大件2独立大件 spec_list.spec_created 创建时间格式：YYYY-MM-DD HH:MM:SS。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段 spec_list.spec_modified 最后修改时间格式：YYYY-MM-DD HH:MM:SS spec_list.img_url 图片图片url spec_list.tax_code_id 税务编码关联税务表税务编码 spec_list.is_single_batch 是否使用同一批次是否启用同一批次， 0,不使用同一批次，1,使用同一批次 spec_list.washing_label 水洗标水洗标 spec_list.img_key 图片在外部空间的key 看图片在外部空间的key 比如说云盘的一个外链 spec_list.barcode_count 条码个数条码个数 spec_list.plat_spec_count 平台货品数量平台货品数量(不包含删除的) spec_list.postfix_val sn自增数 sn自增数 spec_list.last_date 最后日期最后日期格式：yyyy-MM-dd HH:mm:ss spec_list.replenish_type 补货方式补货方式 0持续补货 1不补货 2低于警戒库存补货 spec_list.is_popular 是否畅销是否畅销 0非畅销 1畅销 spec_list.replace_no 备注换货匹配码备注换货匹配码 spec_list.spec_mask 单品标记二进制位单品标记二进制位 1同款备注换货虚拟规格 2是否在备注换货界面展示 spec_list.replace_proportion 同款备注换货同款备注换货--虚拟货品换货比例 spec_list.extra_3 扩展字段扩展字段 spec_list.tax_code 税务编码税务编码 spec_list.spec_unit_name 基本单位基本单位名称 spec_list.spec_aux_unit_name 辅助单位辅助单位名称金蝶云星空接口明细 API： batchSave NAME：物料新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FName 名称 {{goods_name}} FNumber 编码 {{goods_no}} FDescription 描述 {{short_name}} FCreateOrgId 创建组织 100 FUseOrgId 使用组织 100 FSpecification 规格型号 {{spec_list.spec_name}} FMnemonicCode 助记码 FMaterialGroup 物料分组 SubHeadEntity 基本 SubHeadEntity.FErpClsID 物料属性 1 SubHeadEntity.FBaseUnitId 基本单位 Pcs SubHeadEntity.FCategoryID 存货类别 SubHeadEntity.FBARCODE 条形码 SubHeadEntity.SubHeadEntity1 库存 SubHeadEntity.SubHeadEntity1.FStockId 仓库 SubHeadEntity.SubHeadEntity1.FSafeStock 安全库存 SubHeadEntity.SubHeadEntity1.SubHeadEntity2 销售 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty 最大批量 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty 最小批量 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3 采购 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor 默认供应商 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId 采购组织 SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId 业务对象表单Id BD_MATERIAL 必须填写金蝶的表单ID如😛UR_PurchaseOrder SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation 执行的操作 Save SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit 提交并审核 false SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录）数据对接效果采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。

旺店通·企业奇门对接打通金蝶云星空查询货品档案接口与物料新增接口

庄颜_qeasy

旺店通·企业奇门对接打通金蝶云星空查询货品档案接口与物料新增接口

来源系统:旺店通·企业奇门

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

写入目标:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

配置集成方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：旺店通·企业奇门的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

旺店通·企业奇门接口明细

API：wdt.goods.query
NAME：查询货品档案
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
deleted	已删除货品		默认为0, 0：只返回未删除货品 1：返回未删除和已删除货品
barcode	条码
start_time	开始时间	{{LAST_SYNC_TIME datetime}}	按最后修改时间增量查询数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间	{{CURRENT_TIME datetime}}
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围1_{100，不传本参数，输入值默认为40，使用举例单击这里}
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	描述
goods_id	货品ID	货品表主键
goods_no	货品编号	代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍，单击这里
goods_name	货品名称	货品名称
short_name	简称	简称
alias	货品别名	货品别名
goods_type	货品类别	货品类别 0:其它, 1:销售货品, 2:原材料, 3:包装物, 4:周转材料, 5:虚拟商品, 6:固定资产,7:保修配件
spec_count	规格数	规格数
pinyin	拼音	拼音
brand_no	品牌编号	品牌编号
brand_name	品牌	品牌名称
origin	产地	产地
class_id	分类id	分类id
class_name	分类	分类名称
brand_id	品牌id	品牌ID
properties	属性	属性
version_id	版本号	版本号，用来检查同时修改的
unit_name	基本单位	基本单位名称
aux_unit_name	辅助单位	辅助单位名称
flag_name	标记名称	标记名称
goods_created	创建时间	格式：yyyy-MM-dd HH:mm:ss。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段
goods_modified	最后修改时间	格式：yyyy-MM-dd HH:mm:ss
spec_list	单品节点	响应参数的2级数据节点，包含sku所有属性信息的数据节点,节点下数据字段详见下述"spec_list"
spec_list.remark	备注	备注
spec_list.prop1	自定义1	自定义1
spec_list.prop2	自定义2	自定义2
spec_list.prop3	自定义3	自定义3
spec_list.prop4	自定义4	自定义4
spec_list.prop5	自定义5	自定义5
spec_list.prop6	自定义6	自定义6
spec_list.unit	基本单位	基本单位
spec_list.aux_unit	辅助单位	辅助单位
spec_list.flag_id	标记	标记
spec_list.modified	最后修改时间	最后修改时间格式：yyyy-MM-dd HH:mm:ss
spec_list.created	创建时间	创建时间格式：yyyy-MM-dd HH:mm:ss
spec_list.deleted	是否已删除	是否已删除：0：未删除 >0代表已删除
spec_list.spec_id	规格ID	规格ID
spec_list.spec_no	商家编码	代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍，单击这里
spec_list.spec_code	规格码	规格码
spec_list.barcode	主条码	主条码，单品下如果有多个条码，会随机返回其中一条条码
spec_list.spec_name	规格名称	规格名称
spec_list.lowest_price	最低价	最低价
spec_list.retail_price	零售价	零售价
spec_list.wholesale_price	批发价	批发价
spec_list.member_price	会员价	会员价
spec_list.market_price	市场价	市场价
spec_list.custom_price1	自定义价格1	自定义价格1
spec_list.custom_price2	自定义价格2	自定义价格2
spec_list.sale_score	销售积分	销售积分
spec_list.pack_score	打包积分	打包积分
spec_list.pick_score	拣货积分	拣货积分
spec_list.validity_days	有效期天数	保质期
spec_list.sales_days	最佳销售天数	最佳销售天数
spec_list.receive_days	最佳收获天数	最佳收获天数
spec_list.weight	重量	重量
spec_list.length	长	长(CM)
spec_list.width	宽	宽(CM)
spec_list.height	高	高(CM)
spec_list.is_sn_enable	启用序列号	0不启用序列号 1强序列号 2弱序列号
spec_list.is_allow_neg_stock	是否允许负库存	0（不允许负库存）;1（允许负库存）
spec_list.is_not_need_examine	是否出库不验货	0（出库不验货）;1（出库必须验货）
spec_list.is_zero_cost	是否允许0成本	0（不允许0成本）;1（允许0成本）
spec_list.is_lower_cost	是否允许低于成本价	0（不允许低于成本价）;1（允许低于成本价）
spec_list.is_not_use_air	是否航空禁运	0(航空不禁运) 1(航空禁运);
spec_list.tax_rate	税率	税率
spec_list.large_type	大件类别	0非大件1普通大件2独立大件
spec_list.spec_created	创建时间	格式：YYYY-MM-DD HH:MM:SS。ERP客户端需升级至V2.3.8.6及以上版本可获取此字段
spec_list.spec_modified	最后修改时间	格式：YYYY-MM-DD HH:MM:SS
spec_list.img_url	图片	图片url
spec_list.tax_code_id	税务编码	关联税务表税务编码
spec_list.is_single_batch	是否使用同一批次	是否启用同一批次， 0,不使用同一批次，1,使用同一批次
spec_list.washing_label	水洗标	水洗标
spec_list.img_key	图片在外部空间的key	看图片在外部空间的key 比如说云盘的一个外链
spec_list.barcode_count	条码个数	条码个数
spec_list.plat_spec_count	平台货品数量	平台货品数量(不包含删除的)
spec_list.postfix_val	sn自增数	sn自增数
spec_list.last_date	最后日期	最后日期格式：yyyy-MM-dd HH:mm:ss
spec_list.replenish_type	补货方式	补货方式 0持续补货 1不补货 2低于警戒库存补货
spec_list.is_popular	是否畅销	是否畅销 0非畅销 1畅销
spec_list.replace_no	备注换货匹配码	备注换货匹配码
spec_list.spec_mask	单品标记二进制位	单品标记二进制位 1同款备注换货虚拟规格 2是否在备注换货界面展示
spec_list.replace_proportion	同款备注换货	同款备注换货--虚拟货品换货比例
spec_list.extra_3	扩展字段	扩展字段
spec_list.tax_code	税务编码	税务编码
spec_list.spec_unit_name	基本单位	基本单位名称
spec_list.spec_aux_unit_name	辅助单位	辅助单位名称

金蝶云星空接口明细

API：batchSave
NAME：物料新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FName	名称	{{goods_name}}
FNumber	编码	{{goods_no}}
FDescription	描述	{{short_name}}
FCreateOrgId	创建组织	100
FUseOrgId	使用组织	100
FSpecification	规格型号	{{spec_list.spec_name}}
FMnemonicCode	助记码
FMaterialGroup	物料分组
SubHeadEntity	基本
SubHeadEntity.FErpClsID	物料属性	1
SubHeadEntity.FBaseUnitId	基本单位	Pcs
SubHeadEntity.FCategoryID	存货类别
SubHeadEntity.FBARCODE	条形码
SubHeadEntity.SubHeadEntity1	库存
SubHeadEntity.SubHeadEntity1.FStockId	仓库
SubHeadEntity.SubHeadEntity1.FSafeStock	安全库存
SubHeadEntity.SubHeadEntity1.SubHeadEntity2	销售
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty	最大批量
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty	最小批量
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3	采购
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor	默认供应商
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId	采购组织
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId	业务对象表单Id	BD_MATERIAL	必须填写金蝶的表单ID如😛UR_PurchaseOrder
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation	执行的操作	Save
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit	提交并审核	false
SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。