系统数据集成方案

聚水潭和金蝶云星空单据接口对接

数据源平台:金蝶云星空

对接目标平台:聚水潭

数据接口配置方案

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

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：采购入库查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
FID	实体主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FStockOrgId_FNumber	收料组织	string
FDate	入库日期	string
FBillTypeID_FNumber	单据类型	string
FOwnerTypeIdHead	货主类型	string
FOwnerIdHead_FNumber	货主	string
FDemandOrgId_FNumber	需求组织	string
FPurchaseOrgId_FNumber	采购组织	string
FSupplierId_FNumber	供应商	string
FStockerGroupId_FNumber	库存组	string
FStockDeptId_FNumber	收料部门	string
FCreateDate	创建日期	string
FCancelDate	作废日期	string
FDeliveryBill	送货单号	string
FTakeDeliveryBill	提货单号	string
FApproveDate	审核日期	string
FCancelStatus	作废状态	string
FSupplyId_FNumber	供货方	string
FSettleId_FNumber	结算方	string
FChargeId_FNumber	收款方	string
FBusinessType	业务类型	string
FSupplyAddress	供货方地址	string
FAPSTATUS	应付状态	string
FTransferBizType	跨组织业务类型	string
FDisassemblyFlag	拆单新单标识	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FSplitBillType	拆单类型	string
FPayOrgId_FNumber	付款组织	string
FSettleOrgId_FNumber	结算组织	string
FSettleCurrId_FNumber	结算币别	string
FBillCost	整单费用	string
FBillTaxAmount	税额	string
FBillCostAmount	总成本	string
FBillAllAmount	价税合计	string
FSettleTypeId	结算方式	string
FExchangeRate	汇率	string
FLocalCurrId_FNumber	本位币	string
FBillAmount	金额	string
FIsIncludedTax	含税	string
FOwnerCustomerID_FNumber	货主客户	string
FSettleSupplierID_FNumber	结算组织供应商	string
FISGENFORIOS	跨组织结算生成	string
FISPRICEEXCLUDETAX	价外税	string
FISINVOICEARLIER	先到票后入库	string
FMaterialId_FNumber	物料编码	string
FStockId_FNumber	仓库	string
FProduceDate	生产日期	string
FNote	备注	string
FSupplierLot	供应商批号	string
FGrossWeight	毛重	string
FNetWeight	净重	string
FContractlNo	合同单号	string
F_sms_BaseProperty	69码	string
FMustQty	应收数量	string
FRealQty	实收数量	string
FSRCRowId	源单行内码	string
FExpiryDate	有效期至	string
FIsFree	免费	string
FStockStatusId	库存状态	string
FBOMId	BOM版本	string
FTaxPrice	含税单价	string
FCostPrice	成本价	string
FEntryTaxRate	税率(%)	string
FEntryTaxAmount	税额	string
FDiscountRate	折扣率(%)	string
FPriceCoefficient	价格系数	string
FPriceUnitQty	计价数量	string
FTaxNetPrice	净价	string
FEntryCostAmount	总成本	string
FAllAmount	价税合计	string
FStockFlag	入库库存更新标志	string
FPOOrderNo	订单单号	string
FEXPUnit	保质期单位	string
FExpPeriod	保质期	string
FSRCBILLTYPEID	源单类型	string
FSRCBillNo	源单编号	string
FINVOICEDQTY	已开票数量	string
FBaseAPJoinQty	关联应付数量（计价基本）	string
FReceiveStockFlag	收货库存更新标志	string
FProcessFee	加工费	string
FMaterialCosts	材料成本	string
FLot	批号	string
FPrice	单价	string
FAmount	金额	string
FDiscount	折扣额	string
FReturnJoinQty	退料关联数量	string
FBFLowId	业务流程	string
FGiveAway	是否赠品	string
FWWInType	入库类型	string
FRowId	行标识	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如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FInStockEntry_FEntryId	id	string
FID	实体主键	string
FBillNo	单据编号	string
FDocumentStatus	单据状态	string
FStockOrgId_FNumber	收料组织	string
FDate	入库日期	string
FBillTypeID_FNumber	单据类型	string
FOwnerTypeIdHead	货主类型	string
FOwnerIdHead_FNumber	货主	string
FDemandOrgId_FNumber	需求组织	string
FPurchaseOrgId_FNumber	采购组织	string
FSupplierId_FNumber	供应商	string
FStockerGroupId_FNumber	库存组	string
FStockDeptId_FNumber	收料部门	string
FCreateDate	创建日期	string
FCancelDate	作废日期	string
FDeliveryBill	送货单号	string
FTakeDeliveryBill	提货单号	string
FApproveDate	审核日期	string
FCancelStatus	作废状态	string
FSupplyId_FNumber	供货方	string
FSettleId_FNumber	结算方	string
FChargeId_FNumber	收款方	string
FBusinessType	业务类型	string
FSupplyAddress	供货方地址	string
FAPSTATUS	应付状态	string
FTransferBizType	跨组织业务类型	string
FDisassemblyFlag	拆单新单标识	string
FConfirmDate	确认日期	string
FConfirmStatus	确认状态	string
FSplitBillType	拆单类型	string
FPayOrgId_FNumber	付款组织	string
FSettleOrgId_FNumber	结算组织	string
FSettleCurrId_FNumber	结算币别	string
FBillCost	整单费用	string
FBillTaxAmount	税额	string
FBillCostAmount	总成本	string
FBillAllAmount	价税合计	string
FSettleTypeId	结算方式	string
FExchangeRate	汇率	string
FLocalCurrId_FNumber	本位币	string
FBillAmount	金额	string
FIsIncludedTax	含税	string
FOwnerCustomerID_FNumber	货主客户	string
FSettleSupplierID_FNumber	结算组织供应商	string
FISGENFORIOS	跨组织结算生成	string
FISPRICEEXCLUDETAX	价外税	string
FISINVOICEARLIER	先到票后入库	string
FMaterialId_FNumber	物料编码	string
FStockId_FNumber	仓库	string
FProduceDate	生产日期	string
FNote	备注	string
FSupplierLot	供应商批号	string
FGrossWeight	毛重	string
FNetWeight	净重	string
FContractlNo	合同单号	string
F_sms_BaseProperty	69码	string
FMustQty	应收数量	string
FRealQty	实收数量	string
FSRCRowId	源单行内码	string
FExpiryDate	有效期至	string
FIsFree	免费	string
FStockStatusId	库存状态	string
FBOMId	BOM版本	string
FTaxPrice	含税单价	string
FCostPrice	成本价	string
FEntryTaxRate	税率(%)	string
FEntryTaxAmount	税额	string
FDiscountRate	折扣率(%)	string
FPriceCoefficient	价格系数	string
FPriceUnitQty	计价数量	string
FTaxNetPrice	净价	string
FEntryCostAmount	总成本	string
FAllAmount	价税合计	string
FStockFlag	入库库存更新标志	string
FPOOrderNo	订单单号	string
FEXPUnit	保质期单位	string
FExpPeriod	保质期	string
FSRCBILLTYPEID	源单类型	string
FSRCBillNo	源单编号	string
FINVOICEDQTY	已开票数量	string
FBaseAPJoinQty	关联应付数量（计价基本）	string
FReceiveStockFlag	收货库存更新标志	string
FProcessFee	加工费	string
FMaterialCosts	材料成本	string
FLot	批号	string
FPrice	单价	string
FAmount	金额	string
FDiscount	折扣额	string
FReturnJoinQty	退料关联数量	string
FBFLowId	业务流程	string
FGiveAway	是否赠品	string
FWWInType	入库类型	string
FRowId	行标识	string

聚水潭接口明细

• 接口：/open/jushuitan/otherinout/upload
• 接口名称：新建其它出入库（新）
• 接口方法：POST

请求参数

字段	名称	类型	描述
is_confirm	是否自动确认单据	string	是否自动确认单据
wms_co_id	分仓编号	string	分仓编号
type	出入库类型: in是入库 out是出库	string	出入库类型: in是入库 out是出库
external_id	外部单号	string	外部单号
warehouse	主仓=1，销退仓=2， 进货仓=3，次品仓 = 4	string	主仓=1，销退仓=2， 进货仓=3，次品仓 = 4
remark	备注	string	备注
drp_co_name	出库类型	string	出库类型
receiver_name	收件人姓名	string	收件人姓名
receiver_mobile	收件人手机号	string	收件人手机号
receiver_state	收件地址省	string	收件地址省
receiver_city	收件地址市	string	收件地址市
receiver_district	收件地址区|县	string	收件地址区 县
receiver_address	收件详细地址	string	收件详细地址
items	商品列表	array	商品列表
items.sku_id	商品编码	string	商品编码
items.qty	数量	string	数量
items.batch_id	批次单号，系统中需开启相关配置	string	批次单号，系统中需开启相关配置
items.produced_date	生产日期，系统中需开启相关配置	string	生产日期，系统中需开启相关配置
items.expiration_date	有效期至，系统中需开启相关配置	string	有效期至，系统中需开启相关配置
items.remark	备注	string	备注

响应参数

字段	名称	类型	描述
code	非0失败	string	非0失败
msg	错误描述	string	错误描述
data	返回内容	array	返回内容
data.external_id	外部单号	string	外部单号
data.io_id	系统内部单号	string	系统内部单号

系统对接概况

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与聚水潭之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

系统数据对接方案元数据代码