管易云·奇门对接打通金蝶云星空历史订单查询接口与销售出库新增接口

数据源系统:管易云·奇门

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

对接目标系统:金蝶云星空

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

数据对接方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：管易云·奇门，然后选择对应的连接器。选择对应的gy.erp.trade.history.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

管易云·奇门接口明细

API：gy.erp.trade.history.get

NAME：历史订单查询

METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_date	开始时间	2022-09-12 00:00:00
end_date	结束时间	2022-09-15 00:00:00
date_type	时间类型		默认00:创建时间1:拍单时间2:付款时间3:修改时间
order_state	订单类型	2	默认00:全部1:未审核2:已审核
warehouse_code	仓库代码
shop_code	店铺代码
vip_name	会员名称
platform_code	平台单号	s524200796217
receiver_mobile	收件手机
code	单据编号
retrun_total	是否返回总量		0:不返回1:返回（不建议，有可能出现超时）默认1
page_no	页号	{{PAGINATION_START_PAGE}}	默认1
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	默认为10

响应参数

接口字段	字段名称	预设值	描述
code	单据编号
qty	商品数量
tax_amount	税额
amount	订单金额
payment	支付金额
approve	是否审核
cod	是否货到付款
cancle	是否取消
vipIdCard	身份证号
vipEmail	电子邮箱
vipRealName	真实姓名
accountStatus	到账状态
accountAmount	到账金额
assignState	配货状态		0:未配货1:部分配货2:全部配货
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	二次备注
post_fee	物流费用
cod_fee	货到付款服务费
discount_fee	让利金额
post_cost	物流成本
weight_origin	标准重量
payment_amount	商品总金额
delivery_state	发货状态
order_type_name	订单类型
business_man	业务员
platform_flag	平台旗帜
extend_memo	附加信息
approveDate	审核时间
accountDate	到账时间
details	商品列表
details.oid	子订单号
details.qty	数量
details.price	商品实际单价
details.amount	商品实际金额
details.note	备注
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	退款状态		0:未退款1:退款成功2:退款中
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

系统对接总览

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。