从管易云·奇门到金蝶云星空通过接口配置打通数据

从管易云·奇门到金蝶云星空通过接口配置打通数据

对接源平台:管易云·奇门

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

目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：管易云·奇门的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

管易云·奇门接口明细

• 调用接口：gy.erp.trade.get
• 接口名称：订单查询
• 方法：POST

请求参数

字段	字段名称	类型	配置值
start_date	开始时间	string	{{LAST_SYNC_TIME datetime}}
end_date	结束时间	string	{{CURRENT_TIME datetime}}
date_type	时间类型	string
order_state	订单类型	string	2
warehouse_code	仓库代码	string
shop_code	店铺代码	string	N0245
vip_name	会员名称	string
platform_code	平台单号	string
receiver_mobile	收件手机	string
code	单据编号	string
has_cancel_data	是否附带返回已取消与已删除的订单数据	string
page_no	页号	string	{{PAGINATION_START_PAGE}}
page_size	分页大小	string	{{PAGINATION_PAGE_SIZE}}

响应参数

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

金蝶云星空接口明细

• 调用接口：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

系统对接概况

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。