管易云·奇门和金蝶云星空接口打通对接实战

对接系统：管易云·奇门

管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。

接通系统：金蝶云星空

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

多系统对接方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取管易云·奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

管易云·奇门接口明细

• API：gy.erp.trade.get

• NAME：订单查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_date	开始时间	2022-08-23 00:00:00
end_date	结束时间	2022-08-23 23:59:58
date_type	时间类型		默认0 0:创建时间 1:拍单时间2:付款时间3:修改时间
order_state	订单类型	2	默认0 0:全部1:未审核2:已审核
warehouse_code	仓库代码
shop_code	店铺代码
vip_name	会员名称
platform_code	平台单号
receiver_mobile	收件手机
code	单据编号
has_cancel_data	是否附带返回已取消与已删除的订单数据		false:不返回 true:返回 默认false
page_no	页号	{{PAGINATION_START_PAGE}}	默认1
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	默认为10

响应参数

接口字段	字段名称	预设值	描述
id	id
hold_info	拦截信息
code	单据编号
tax_amount	税额
payment	支付金额
approve	是否审核
cod	是否货到付款
vipIdCard	身份证号
vipEmail	电子邮箱
vipRealName	真实姓名
accountStatus	到账状态
accountAmount	到账金额
assignState	配货状态
platform_code	平台单号
createtime	创建时间
modifytime	修改时间
dealtime	拍单时间
paytime	支付时间
shop_name	店铺名称
shop_code	店铺代码
warehouse_name	仓库名称
warehouse_code	仓库代码
express_name	快递公司名称
express_code	快递公司代码
vip_name	会员名称
vip_code	会员代码
receiver_name	收货人姓名
receiver_phone	收货人电话
receiver_mobile	收货人手机
receiver_zip	收货邮编
receiver_address	收货地址
receiver_area	地区信息
buyer_memo	买家留言
seller_memo	卖家备注
seller_memo_late	二次备注
cod_fee	货到付款服务费
post_cost	物流成本
weight_origin	标准重量
payment_amount	商品总金额
business_man	业务员
extend_memo	附加信息
delivery_state	发货状态
order_type_name	订单类型
platform_flag	平台旗帜
approveDate	审核时间
accountDate	到账时间
trade_tag_code	订单标记代码
trade_tag_name	订单标记名称
plan_delivery_date	预计发货时间
platform_trading_state	平台交易状态
substitut_order	非代发
details	商品列表
details.oid	子订单号
details.qty	数量
details.price	实际单价
details.amount	实际金额
details.note	备注
details.cancel	是否取消
details.item_code	商品代码
details.item_name	商品名称
details.item_simple_name	商品简称
details.sku_name	规格名称
details.sku_code	规格代码
details.post_fee	物流费用
details.discount_fee	让利金额
details.amount_after	让利后金额
details.refund	退款状态
details.platform_item_name	平台规格名称
details.platform_sku_name	平台规格代码
details.sku_note	商品备注

金蝶云星空接口明细

• 调用接口：batchSave

• 接口名称：销售出库新增

• 方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSCKD01_SYS
FBillNo	单据编号	string	{{platform_code}}
FDate	日期	string	{{createtime_new}}
FSaleOrgId	销售组织	string	{{shop_code}}
FCustomerID	客户	string	{{shop_code}}
FStockOrgId	发货组织	string	{{details.warehouse_code}}
FNote	备注	string
F_mhgj_Assistant	管易订单类型	string	{{details.order_type_name}}
SubHeadEntity	财务信息	object
SubHeadEntity.FSettleOrgID	结算组织	string	{{shop_code}}
SubHeadEntity.FSETTLECURRID	结算币别	string	PRE001
SubHeadEntity.FEntity	明细信息	array	details
SubHeadEntity.FEntity.FMaterialID	物料编码	string	{{details.details_item_code}}
SubHeadEntity.FEntity.FRealQty	实发数量	string	{{details.details_qty}}
SubHeadEntity.FEntity.FTaxPrice	含税单价	string	{{details.details_price}}
SubHeadEntity.FEntity.FIsFree	是否赠品	string	_function case '{{details.details_price}}' when '0.0' then true else false end
SubHeadEntity.FEntity.FLot	批号	string	001
SubHeadEntity.FEntity.FStockID	仓库	string	{{details.warehouse_code}}
SubHeadEntity.FEntity.FOwnerTypeId	货主类型	string	BD_OwnerOrg
SubHeadEntity.FEntity.FOwnerId	货主	string	{{details.warehouse_code}}
SubHeadEntity.FEntity.FEntrynote	备注	string
SubHeadEntity.FEntity.FormId	业务对象表单Id	string	SAL_OUTSTOCK
SubHeadEntity.FEntity.Operation	执行的操作	string	Save
SubHeadEntity.FEntity.IsAutoSubmitAndAudit	提交并审核	bool	false
SubHeadEntity.FEntity.IsVerifyBaseDataField	验证基础资料	bool	false
SubHeadEntity.FEntity.SubSystemId	系统模块	string	21

数据对接价值

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