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

庄颜_qeasy

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

数据源平台:金蝶云星空

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

写入目标:管易云

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

数据集成方案配置

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

金蝶云星空接口明细

API：executeBillQuery
NAME：销售订单查询
METHOD：POST

请求参数

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

响应参数

管易云接口明细

接口：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组织及交付能力。