金蝶云星空和旺店通·企业奇门接口打通对接实战

金蝶云星空和旺店通·企业奇门接口打通对接实战

来源系统:金蝶云星空

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

集成系统:旺店通·企业奇门

慧策最先以旺店通ERP切入商家核心管理痛点——订单管理，之后围绕电商经营管理中的核心管理诉求，先后布局流量获取、会员管理、仓库管理等其他重要经营模块。慧策的产品线从旺店通ERP起步，向前向后延伸，全面布局零售企业经营，整体构建一体化智能零售解决方案，打破数据孤岛，AI植入系统，实现智能决策，助力零售企业智能化转型。当前旗下拥有店+小程序、数智门店POS、旺店通ERP、旺店通WMS、卡米全渠道、客优CRM、云筹大数据等多个PssS、SaaS产品，从前端吸引流量到后端集约化管理，助力企业智慧决策

数据接口配置方案

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

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：销售退货查询
• 方法：POST

请求参数

字段	字段名称	类型	配置值
FID	FID	string	FID
FBillNo	单据编码	string	FBillNo
FDate	单据日期	string	FDate
FSaleOrgId_FNumber	销售组织	string	FSaleOrgId.FNumber
FRetcustId_FNumber	退货客户	string	FRetcustId.FNumber
SubHeadEntity_FEntryId	SubHeadEntity_FEntryId	string	SubHeadEntity_FEntryId
FMaterialId_FNumber	物料编码	string	FMaterialId.FNumber
FStockId_FNumber	仓库编码	string	FStockId.FNumber
FRealQty	实退数量	string
Limit	最大行数	string	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	string	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数	int
FilterString	过滤条件	string	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'
FieldKeys	需查询的字段key集合	array
FormId	业务对象表单Id	string	SAL_RETURNSTOCK

响应参数

字段	字段名称	类型	配置值
FID	FID	string
FBillNo	单据编码	string
FDate	单据日期	string
FSaleOrgId_FNumber	销售组织	string
FRetcustId_FNumber	退货客户	string
SubHeadEntity_FEntryId	SubHeadEntity_FEntryId	string
FMaterialId_FNumber	物料编码	string
FStockId_FNumber	仓库编码	string
FRealQty	实退数量	string

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

• 接口：wdt.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

系统对接总览

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。