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

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

对接源平台:金蝶云星空

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

接入系统：金蝶云星空

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

数据接口配置方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：销售订单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：客户新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	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	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	string
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	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
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	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
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	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
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	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
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	string
FTailDiffFlag	尾差处理标识	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如 UR_PurchaseOrder

响应参数

字段	名称	类型	描述
FSaleOrderEntry_FEntryID	FSaleOrderEntry_FEntryID	string
FID	FID	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FSaleOrgId_FNumber	销售组织	string
FDate	日期	string
FCustId_FNumber	客户	string
FSaleDeptId_Fnumber	销售部门	string
FSaleGroupId	销售组	string
FSalerId	销售员	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	交货地点	string
FCreditCheckResult	信用检查结果	string
FReceiveContact	收货方联系人	string
FNetOrderBillNo	移动销售订单编号	string
FNetOrderBillId	移动销售订单ID	string
FOppID	商机内码	array
FSalePhaseID	销售阶段	string
FISINIT	是否期初单据	string
FNote	备注	string
FSignStatus	签收状态	string
FManualClose	是否手工关闭	string
FLinkMan	收货人姓名	string
FLinkPhone	联系电话	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
FDeliQty	累计发货通知数量	string
FStockOutQty	累计出库数量	string
FRetNoticeQty	累计退货通知数量（销售）	string
FReturnQty	累计退货数量（销售）	string
FRemainOutQty	剩余未出数量（销售）	string
FBaseInvoiceJoinQty	关联开票数量（基本）(作废)	string
FInvoiceJoinQty	关联开票数量(作废)	string
FInvoiceQty	累计开票数量(作废)	string
FInvoiceAmount	累计开票金额(作废)	string
FReceiveAmount	累计收款金额	string
FBasePurJoinQty	关联采购/生产数量（销售基本）	string
FPurJoinQty	关联采购/生产数量	string
FPurReqQty	累计采购申请数量	string
FPurOrderQty	累计采购订单数量	string
FReceiptOrgId	收款组织	string
FSettleOrgIds	结算组织	string
FAmount	金额	string
FEntryNote	备注	string
FQty	销售数量	string
FLimitDownPrice	最低限价	string
FSysPrice	系统定价	string
FStockOrgId	库存组织	string
FBaseStockOutQty	累计出库数量（销售基本）	string
FBaseDeliQty	累计发货通知数量（销售基本）	string
FBaseRetNoticeQty	累计退货通知数量（销售基本）	string
FBaseReturnQty	累计退货数量（销售基本）	string
FBasePurReqQty	累计采购申请数量（销售基本）	string
FBasePurOrderQty	累计采购订单数量（销售基本）	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
FTransJoinQty	累计调拨数量	string
FBaseTransJoinQty	累计调拨数量(销售基本)	string
FSrcType	源单类型	string
FSrcBillNo	源单编号	string
FBaseDeliveryMaxQty	发货上限（基本）	string
FBaseDeliveryMinQty	发货下限（基本）	string
FOEMInStockJoinQty	关联受托材料入库套数	string
FBaseOEMInStockJoinQty	关联受托材料入库套数(库存基本)	string
FBaseARJoinQty	关联应收数量（计价基本）	string
FIsReturn	物料允许退货属性	string
FBFLowId	业务流程	string
FIsInventory	物料允许库存属性	string
FBASEARQTY	累计应收数量（销售基本）	string
FARJOINAMOUNT	关联应收金额	string
FARAMOUNT	累计应收金额	string
FBaseRemainOutQty	剩余未出数量（销售基本）	string
FReBackQty	累计退货补货数量（销售）	string
FBaseReBackQty	累计退货补货数量（销售基本）	string
FARQTY	累计应收数量（销售）	string
FMaterialIsSubContract	物料允许委外属性	string
FCanOutQty	可出数量（销售）	string
FBaseCanOutQty	可出数量（销售基本）	string
FCanReturnQty	可退数量（销售）	string
FBaseCanReturnQty	可退数量（销售基本）	string
FBASEAPQTY	累计应付数量(基本单位)	string
FAPAMOUNT	累计应付金额	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
FStockBaseTransJoinQty	累计调拨数量（库存基本）	string
FStockBasePurJoinQty	关联采购/生产数量（库存基本）	string
FSalBaseNum	源单基本分子	string
FStockBaseDen	库存基本分母	string
FSRCBIZUNITID	携带主单位	string
FPurBaseQty	采购基本数量	string
FPurUnitID	采购单位	string
FPurQty	采购数量	string
FSalBaseARJoinQty	关联应收数量（销售基本）	string
FSTOCKBASESTOCKOUTQTY	累计出库数量（库存基本）	string
FSTOCKBASEREBACKQTY	累计退货补货数量（库存基本）	string
FOUTLMTUNIT	超发控制单位类型	string
FOutLmtUnitID	超发控制单位	string
FTRANSRETURNQTY	累计调拨退货数量	string
FTRANSRETURNBASEQTY	累计调拨退货数量（销售基本）	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
FZHJStockQty	智慧记上报库存	string
FSPMENTRYID	促销政策ID	string
FSPMANDRPMCONTENT	促销内容	string
FTransReturnStockBaseQty	累计调拨退货数量（库存基本）	string
FTailDiffFlag	尾差处理标识	string

金蝶云星空接口明细

• 接口：/customer/add
• 接口名称：客户新增
• 接口方法：POST

请求参数

字段	名称	类型	描述
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如 UR_PurchaseOrder
Operation	执行的操作	string
IsAutoSubmitAndAudit	提交并审核	bool
IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统数据对接

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。