金蝶云星空和管易云接口打通对接实战|轻易云数据集成平台

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

来源系统:金蝶云星空

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

对接目标系统:管易云

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

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的销售订单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为管易云，并且选择对应连接器。选择对应的订单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

接口：executeBillQuery
接口名称：销售订单查询
接口方法：POST

请求参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FCustId_FName	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId_FNumber	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID_FADDRESS	交货地点	string
FHEADLOCID_FTCONTACT	交货地点	string
FHEADLOCID_FTEL	交货地点	string
FReceiveContact	收货方联系人	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FARJOINAMOUNT	关联应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_FNumber	明细仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
F_BCYS_Payback	互客回款金额	string
F_BCYS_Logistics	互客物流公司	string
F_BCYS_Amount2	F_BCYS_Amount2	string
F_hKFKFS	F_hKFKFS	string
FRecConditionId	FRecConditionId	string
F_BCYS_BillType1	F_BCYS_BillType1	string
FLinkPhone	FLinkPhone	string
FReceiveAddress	收货地址	string
F_BCYS_Amount2	F_BCYS_Amount2	string
receiver_province	receiver_province	string
receiver_city	receiver_city	string
receiver_district	receiver_district	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FCustId_FName	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId_FNumber	销售员	string
FReceiveId	收货方	string
FSettleId	结算方	string
FSettleAddress	结算方地址	string
FChargeId	付款方	string
FCreatorId	创建人	string
FCreateDate	创建日期	string
FModifierId	最后修改人	string
FModifyDate	最后修改日期	string
FApproverId	审核人	string
FApproveDate	审核日期	string
FCloseStatus	关闭状态	string
FCloserId	关闭人	string
FCloseDate	关闭日期	string
FCancelStatus	作废状态	string
FCancellerId	作废人	string
FCancelDate	作废日期	string
FVersionNo	版本号	string
FChangerId	变更人	string
FChangeDate	变更日期	string
FChangeReason	变更原因	string
FBillTypeID_Fnumber	单据类型	string
FBusinessType	业务类型	string
FHeadDeliveryWay	交货方式	string
FReceiveAddress	收货方地址	string
FHEADLOCID_FADDRESS	交货地点	string
FHEADLOCID_FTCONTACT	交货地点	string
FHEADLOCID_FTEL	交货地点	string
FReceiveContact	收货方联系人	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FSOFrom	订单来源	string
FMaterialId_Fnumber	物料编码	string
FMaterialName	物料名称	string
FMaterialModel	规格型号	string
FMaterialType	物料类别	string
FUnitID_Fnumber	销售单位	string
FPrice	单价	string
FTaxPrice	含税单价	string
FBomId	BOM版本	string
FPriceUnitId	计价单位	string
FPriceUnitQty	计价数量	string
FPriceCoefficient	价格系数	string
FDiscountRate	折扣率%	string
FDiscount	折扣额	string
FEntryTaxRate	税率%	string
FEntryTaxAmount	税额	string
FAllAmount	价税合计	string
FTaxNetPrice	净价	string
FBaseUnitQty	销售基本数量	string
FDeliveryControl	控制发货数量	string
FDeliveryMaxQty	发货上限	string
FDeliveryMinQty	发货下限	string
FTransportLeadTime1	运输提前期	string
FBefDisAllAmt	折前价税合计	string
FBefDisAmt	折前金额	string
FTaxAmount_LC	税额（本位币）	string
FAmount_LC	金额（本位币）	string
FAllAmount_LC	价税合计（本位币）	string
FMrpCloseStatus	业务关闭	string
FMrpFreezeStatus	业务冻结	string
FFreezerId	冻结人	string
FFreezeDate	冻结日期	string
FMrpTerminateStatus	业务终止	string
FTerminaterId	终止人	string
FTerminateDate	终止日期	string
FBaseDeliJoinQty	（代码有用）关联发货通知数量（销售基本）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseUnitId	基本单位	string
FChangeFlag	变更标志	string
FMapId	客户物料编码	string
FOwnerTypeId	货主类型	string
FOwnerId	货主	string
FIsFree	是否赠品	string
FLOCKQTY	锁库/预留数量(库存单位)	string
FLOCKFLAG	锁库/预留标识	string
FProduceDate	生产日期	string
FExpiryDate	有效期至	string
FExpUnit	保质期单位	string
FExpPeriod	保质期	string
FMaterialIsProduce	物料允许生产属性	string
FTaxCombination	税组合	string
FLot	批号	string
FMapName	客户物料名称	string
FAuxPropId	辅助属性	string
FReturnType	退补类型	string
FDeliveryDate	要货日期	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FARJOINAMOUNT	关联应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FMtoNo	计划跟踪号	string
FPriority	需求优先级	string
FReserveType	预留类型	string
FMinPlanDeliveryDate	计划交货日期	string
FDeliveryStatus	发货状态	string
FOldQty	原数量	string
FPromotionMatchType	促销匹配类型	string
FPriceListEntry	行价目表	string
FSupplyOrgId	供应组织	string
FNetOrderEntryId	供应商协同平台订单分录ID	string
FPriceBaseQty	计价基本数量	string
FSetPriceUnitID	定价单位	string
FStockUnitID	库存单位	string
FStockQty	库存数量	string
FStockBaseQty	库存基本数量	string
FStockBaseCanOutQty	可出数量（库存基本）	string
FStockBaseCanReturnQty	可退数量（库存基本）	string
FStockBaseARJoinQty	关联应收数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FCONSIGNSETTQTY	寄售结算数量	string
FCONSIGNSETTBASEQTY	寄售结算数量（销售基本）	string
FLeftQty	待锁库/待预留数量(库存单位)	string
FRowType	产品类型	string
FParentMatId	父项产品	string
FRowId	行标识	string
FParentRowId	父行标识	string
FInStockPrice	最新采购入库价	string
FSOStockId_FNumber	明细仓库	string
FSOStockLocalId	仓位	string
FPurPriceUnitId	采购计价单位	string
FISMRP	已计划运算	string
FBarcode	零售条形码	string
FBranchId	发货门店	string
FRetailSaleProm	是否零售促销	string
FBASEFINARQTY	先开票数量（计价基本）	string
FSALBASEFINARQTY	先开票数量（销售基本）	string
FEntryDiscountList	行折扣表	string
FPriceDiscount	单价折扣	string
F_BCYS_Payback	互客回款金额	string
F_BCYS_Logistics	互客物流公司	string
F_BCYS_Amount2	F_BCYS_Amount2	string
F_hKFKFS	F_hKFKFS	string
FRecConditionId	FRecConditionId	string
F_BCYS_BillType1	F_BCYS_BillType1	string
FLinkPhone	FLinkPhone	string
FReceiveAddress	收货地址	string
F_BCYS_Amount2	F_BCYS_Amount2	string
receiver_province	receiver_province	string
receiver_city	receiver_city	string
receiver_district	receiver_district	string

管易云接口明细

接口：gy.erp.trade.add
接口名称：订单新增
接口方法：POST

请求参数

字段	名称	类型	描述
shop_code	店铺代码	string
vip_code	会员代码	string
platform_code	平台单号	string
warehouse_code	仓库代码	string
business_man_code	业务员	string
express_code	物流公司	string
deal_datetime	拍单时间	string
order_type_code	订单类型	string
receiver_name	收货人	string
receiver_mobile	手机号码	string
receiver_zip	邮政编码	string
receiver_province	省名称	string
receiver_city	市名称	string
receiver_district	区名称	string
receiver_address	收货地址	string
extend_memo	附加信息	string
seller_memo_late	二次备注	string
details	商品明细	array
details.item_code	商品代码	string
details.price	实际单价	string
details.qty	商品数量	string
details.note	备注	string
details.oid	子订单	string
details.origin_price	标准单价	string
details.payments	支付明细	array
details.payments.pay_type_code	支付方式	string
details.payments.payment	支付金额	string
details.payments.cod	是否货到付款	string
details.payments.seller_memo	卖家备注	string
details.payments.buyer_memo	买家留言	string

系统对接概况

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：管易云与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。