金蝶云星空与小满OKKICRM对接集成销售订单查询打通推送产品到小满产品库

数据源系统:金蝶云星空

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

对接目标平台:小满OKKICRM

深圳市小满科技有限公司（简称：小满科技）成立于2013年3月，公司位于深圳市南山区高新园区，是一家国家级高新技术企业。公司旗下产品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 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 物流费渠道物料费用string Q1返利渠道第一季度返利费用string Q2返利渠道第二季度返利费用string Q3返利渠道第三季度返利费用string Q4返利渠道第四季度返利费用string 售后费渠道客户售后费用string 年前返利渠道年度返利费用string 前返前返string 出样补贴渠道客户出样品补贴string

小满OKKICRM接口明细

调用接口：/v1/invoices/order/push
接口名称：推送产品到小满产品库
方法：POST

请求参数

字段字段名称类型配置值 order_no订单号string{{FBillNo}} name订单名称string销售订单 company_id客户IDstringmongoQuery 994c52b4-b37a-3b1d-a88b-1ecae9d2bfce findField=content.company_id where= {"content.name":{"$eq":"{{FCustId_FName}}"}} customer_id客户联系人IDstring currency货币string_function case when'{{FSettleCurrId}}' ='PRE001' then 'CNY' else 'USD' end users业绩归属人array users.user_id用户idstringfindCollection find user_id from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where full_name={{FSalerId_FName}} users.rate业绩占比string100 users.product_list产品子列表arraydetails users.product_list.product_id产品IDstring_findCollection find product_id from b6fff4b7-68fb-3316-b03c-ae6633c3824c where product_no={{details.FMaterialId_Fnumber}} users.product_list.count产品数量string{{details.FQty}} users.product_list.unit_price产品单价stringfunction ({{details.FAllAmount}}+{{details.FDiscount}})/{{details.FQty}} users.product_list.cost_amount产品金额string_function sum({{details.FAllAmount}}+{{details.FDiscount}}) users.product_list.sku_id产品SKU IDstring users.product_list.物流费物流费string{{details.物流费}} users.product_list.Q1返利Q1返利string{{details.Q1返利}} users.product_list.Q2返利Q2返利string{{details.Q2返利}} users.product_list.Q3返利Q3返利string{{details.Q3返利}} users.product_list.Q4返利Q4返利string{{details.Q4返利}} users.product_list.售后费售后费string{{details.售后费}} users.product_list.年度返利年度返利string{{details.年度返利}} users.product_list.前返前返string{{details.前返}} users.product_list.出样补贴出样补贴string{{{{details.出样补贴}} users.product_list.customer_name联系人名称string{{contact_linkman}} users.product_list.customer_phone联系人电话string{{contact_phone}} users.product_list.exchange_rate折现人民币汇率stringfunction {{FExchangeRate}} * (100) users.product_list.exchange_rate_usd汇率美元string_function CASE LOCATE('USD','{{currencyid_number}}') WHEN 0 THEN '{{new_exchange_rate}}' ELSE '100' END users.product_list.remark备注string{{remark}} users.product_list.account_date订单日期，YYYY-mm-ddstring{{billdate date}} 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业绩归属人idstringfindCollection find user_id from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where full_name={{FSalerId_FName}} users.product_list.cost_list.users_info.rate业绩占比string100 users.product_list.cost_list.users_info.nickname业绩归属人昵称string_findCollection find full_name from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where full_name={{FSalerId_FName}} users.product_list.cost_list.users_info.handler_infohandler_infoarray users.product_list.cost_list.users_info.handler_info.user_id业绩归属人idstringfindCollection find user_id from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where full_name={{FSalerId_FName}} users.product_list.cost_list.users_info.handler_info.rate业绩占比string100 users.product_list.cost_list.users_info.handler_info.nickname业绩归属人昵称string{{FSalerId_FName}} users.product_list.cost_list.users_info.handler_info.departments业绩归属部门信息列表array users.product_list.cost_list.users_info.handler_info.departments.department_id业绩归属部门idstring_findCollection find departments.0.department_id from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where departments.0.department_name={{FSaleDeptId_FName}} users.product_list.cost_list.users_info.handler_info.departments.rate业绩占比string100 users.product_list.cost_list.users_info.handler_info.departments.name业绩归属部门名称string{{FSaleDeptId_FName}} users.product_list.cost_list.users_info.handler_info.departments.handler处理人string_findCollection find user_id from 7d2d5073-0558-377d-ac2b-280fc6a8a21b where full_name={{FSalerId_FName}} users.product_list.cost_list.users_info.handler_info.departments.产品折扣费产品折扣费string{{F_hesh_Discount}} users.product_list.cost_list.users_info.handler_info.departments.5094664372713金蝶更新标识string未更新

响应参数

字段字段名称类型配置值 primaryWritebackprimaryWritebackobject primaryWriteback.IdIdstring{{data.order_id}} primaryWriteback.callBackStrategy回写方案object primaryWriteback.callBackStrategy.strategyId方案IDstring941a324d-aa39-3fcb-888b-2d9f6ce7df8f primaryWriteback.callBackStrategy.order_no单据号string{{FBillNo}}

系统对接总览

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

金蝶云星空与小满OKKICRM对接集成销售订单查询打通推送产品到小满产品库