从金蝶云星空到小满OKKICRM通过接口集成数据

源系统:金蝶云星空

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

对接目标平台:小满OKKICRM

小满科技成立于2013年，是阿里巴巴集团战略投资的高新技术企业。小满科技以“人工智能+大数据”为核心驱动力，为外贸企业提供智能CRM解决方案。公司旗下的产品OKKICRM聚焦海外客户管理与销售管理，已累计服务客户数万家，用户超10万

数据集成方案配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：小满OKKICRM的映射，即可启动方案进行测试

金蝶云星空接口明细

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

请求参数

字段名称类型描述 FSaleOrderEntry_FEntryIDFSaleOrderEntry_FEntryIDstring FIDFIDstring 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 FExchangeRateFExchangeRatestring 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 FBomIdBOM版本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供应商协同平台订单分录IDstring 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 FSettleCurrIdFSettleCurrIdstring FSPMENTRYID促销政策IDstring FSPMANDRPMCONTENT促销内容string FBillAllAmount整单价税合计string FLINKMAN收货人姓名string FLINKPHONE联系电话string F_hesh_Discount产品折扣额string FSalerId_FName销售员名称string FSaleDeptId_FName销售部门名称string FVersionNo版本号string Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段名称类型描述 FSaleOrderEntry_FEntryIDFSaleOrderEntry_FEntryIDstring FIDFIDstring 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 FExchangeRateFExchangeRatestring 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 FBomIdBOM版本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供应商协同平台订单分录IDstring 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 FSettleCurrIdFSettleCurrIdstring FSPMENTRYID促销政策IDstring FSPMANDRPMCONTENT促销内容string FBillAllAmount整单价税合计string FLINKMAN收货人姓名string FLINKPHONE联系电话string F_hesh_Discount产品折扣额string FSalerId_FName销售员名称string FSaleDeptId_FName销售部门名称string FVersionNo版本号string 物流费渠道物料费用string Q1返利渠道第一季度返利费用string Q2返利渠道第二季度返利费用string Q3返利渠道第三季度返利费用string Q4返利渠道第四季度返利费用string 售后费渠道客户售后费用string 年度返利渠道年度返利费用string 前返前返string 出样补贴渠道客户出样品补贴string

小满OKKICRM接口明细

接口：/v1/invoices/order/push
接口名称：回款单数据更新
接口方法：POST

请求参数

字段名称类型描述 order_no订单号string name订单名称string company_id客户IDstring customer_id客户联系人IDstring currency货币string users业绩归属人array users.user_id用户idstring users.rate业绩占比string users.product_list产品子列表array users.product_list.product_id产品IDstring users.product_list.count产品数量string users.product_list.unit_price产品单价string users.product_list.cost_amount产品金额string users.product_list.sku_id产品SKU IDstring users.product_list.物流费物流费string users.product_list.Q1返利Q1返利string users.product_list.Q2返利Q2返利string users.product_list.Q3返利Q3返利string users.product_list.Q4返利Q4返利string users.product_list.售后费售后费string users.product_list.年度返利年度返利string users.product_list.前返前返string users.product_list.出样补贴出样补贴string users.product_list.customer_name联系人名称string users.product_list.customer_phone联系人电话string users.product_list.exchange_rate折现人民币汇率string users.product_list.exchange_rate_usd汇率美元string users.product_list.remark备注string users.product_list.account_date订单日期，YYYY-mm-ddstring users.product_list.cost_list费用列表array users.product_list.cost_list.cost_name费用名称string users.product_list.cost_list.percent_type计算规则0（加（+）绝对值、1加（+）占产品总金额百分比、2减（-）绝对值、3减（-）占产品总金额百分比）string users.product_list.cost_list.percent_amount计算金额值，比如1%，那就是产品金额*1%string users.product_list.cost_list.cost金额，根据计算金额计算出来后的费用string users.product_list.cost_list.users_info业绩归属人信息列表array users.product_list.cost_list.users_info.user_id业绩归属人idstring users.product_list.cost_list.users_info.rate业绩占比string users.product_list.cost_list.users_info.nickname业绩归属人昵称string users.product_list.cost_list.users_info.handler_infohandler_infoarray users.product_list.cost_list.users_info.handler_info.user_id业绩归属人idstring users.product_list.cost_list.users_info.handler_info.rate业绩占比string users.product_list.cost_list.users_info.handler_info.nickname业绩归属人昵称string users.product_list.cost_list.users_info.handler_info.departments业绩归属部门信息列表array users.product_list.cost_list.users_info.handler_info.departments.department_id业绩归属部门idstring users.product_list.cost_list.users_info.handler_info.departments.rate业绩占比string users.product_list.cost_list.users_info.handler_info.departments.name业绩归属部门名称string users.product_list.cost_list.users_info.handler_info.departments.handler处理人string users.product_list.cost_list.users_info.handler_info.departments.产品折扣费产品折扣费string users.product_list.cost_list.users_info.handler_info.departments.5094664372713金蝶标识状态string users.product_list.cost_list.users_info.handler_info.departments.order_id订单IDstring

响应参数

字段名称类型描述 primaryWritebackprimaryWritebackobject primaryWriteback.IdIdstring primaryWriteback.callBackStrategy回写方案object primaryWriteback.callBackStrategy.strategyId方案IDstring primaryWriteback.callBackStrategy.order_no单据号string

数据对接效果

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。