道一云·七巧和金蝶云星空单据接口对接

对接系统金蝶云星空

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

集成系统:道一云·七巧

道一云七巧拥有强大的自定义表单设计工具，并配置工作流程，通过流程智能流转，打通各个业务场景中的审批、协作环节，包含数据采集单、任务单和审批单、外部表单等多种模式，并支持管理后台导出、查询数据明细，高效的处理企业内外部工作、数据，提升工作效率。

数据接口配置方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区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
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
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

道一云·七巧接口明细

API：/plus/cgi-bin/open/applications/{applicationId}/forms/{formModelId}
NAME：新增七巧表单
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
codea	订单编码	示例值
fieldName2	实例字段2
applicationId	应用id	c6744fdb44ed657a
formModelId	表单id	c6744fdb44ed657a
id	id	c6744fdb44ed657a	选填（id的长度为32）表单数据实例id
version	版本		选填（必须为0）表单数据版本号（数据修改后递增）
loginUserId	操作用户id	c6744fdb44ed657a

系统打通概况

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