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

汪淼_轻易云

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

源系统:金蝶云星空

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

对接目标系统:易仓

易仓作为一家专门服务于跨境电商行业的纯软件服务商，为了更好的服务跨境电商，易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。

数据接口配置方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：易仓，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

API：executeBillQuery
NAME：分布式调出单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FSTKTRSOUTENTRY_FEntryIDFEntryIDFSTKTRSOUTENTRY_FEntryID FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FStockOrgID_FNumber调入库存组织FStockOrgID.FNumber FDate日期FDate FBillTypeID单据类型FBillTypeID FTransferDirect调拨方向FTransferDirect FNOTE备注FNOTE FCreateDate创建日期FCreateDate FApproveDate审核日期FApproveDate FTransferBizType调拨类型FTransferBizType FBizType业务类型FBizType FCustID_FNumber对应客户FCustID.FNumber FSUPPLIERID_FNumber对应供应商FSUPPLIERID.FNumber FThirdSystem第三方系统FThirdSystem FThirdSrcId第三方源单内码FThirdSrcId FThirdSrcBillNo第三方源单编码FThirdSrcBillNo FVirIsSameAcctOrg是否同一核算组织FVirIsSameAcctOrg FMaterialID_FNumber物料编码FMaterialID.FNumber FCMKBarCode零售条形码FCMKBarCode FSrcStockID_FNumber调出仓库FSrcStockID.FNumber FDestStockID_FNumber调入仓库FDestStockID.FNumber FQty调入数量FQty FPrice成本价FPrice FAmount总成本FAmount FBOMIDBOM版本FBOMID FProduceDate生产日期FProduceDate FEXPIRYDATE有效期至FEXPIRYDATE FMTONO计划跟踪号FMTONO FOwnerID_FNumber调入货主FOwnerID.FNumber FUnitID单位FUnitID FStockOutFlag出库库存更新标识FStockOutFlag FStockInFlag入库库存更新标识FStockInFlag FDestStockLocId调入仓位FDestStockLocId FSRCStockLocId调出仓位FSRCStockLocId FSrcBillNo源单编号FSrcBillNo FLOT调出批号FLOT FEntryNote备注FEntryNote FSRCBILLNAME源单单据类型FSRCBILLNAME FSrcBillDate源单日期FSrcBillDate FDestLot调入批号FDestLot FBusinessDate入库日期FBusinessDate FExtAuxUnitQty调入数量（辅单位）FExtAuxUnitQty FThirdSrcEntryId第三方源单分录编码FThirdSrcEntryId FRowId行标识FRowId FParentRowId父行标识FParentRowId F_ABCD_BasePropertySKUF_ABCD_BaseProperty F_ABCD_guihao发票号F_ABCD_guihao F_ABCD_InvoiceNo柜号F_ABCD_InvoiceNo F_ABCD_UnitPrice单价F_ABCD_UnitPrice F_ABCD_supplier1供应商F_ABCD_supplier1.FNumber FOwnerIdHead调出货主FOwnerIdHead.FNumber Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and F_ABCD_supplier1<>''示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSTK_TRANSFEROUT必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FSTKTRSOUTENTRY_FEntryIDFEntryID FID实体主键 FBillNo单据编号 FDocumentStatus单据状态 FStockOrgID_FNumber调入库存组织 FDate日期 FBillTypeID单据类型 FTransferDirect调拨方向 FNOTE备注 FCreateDate创建日期 FApproveDate审核日期 FTransferBizType调拨类型 FBizType业务类型 FCustID_FNumber对应客户 FSUPPLIERID_FNumber对应供应商 FThirdSystem第三方系统 FThirdSrcId第三方源单内码 FThirdSrcBillNo第三方源单编码 FVirIsSameAcctOrg是否同一核算组织 FMaterialID_FNumber物料编码 FCMKBarCode零售条形码 FSrcStockID_FNumber调出仓库 FDestStockID_FNumber调入仓库 FQty调入数量 FPrice成本价 FAmount总成本 FBOMIDBOM版本 FProduceDate生产日期 FEXPIRYDATE有效期至 FMTONO计划跟踪号 FOwnerID_FNumber调入货主 FUnitID单位 FStockOutFlag出库库存更新标识 FStockInFlag入库库存更新标识 FDestStockLocId调入仓位 FSRCStockLocId调出仓位 FSrcBillNo源单编号 FLOT调出批号 FEntryNote备注 FSRCBILLNAME源单单据类型 FSrcBillDate源单日期 FDestLot调入批号 FBusinessDate入库日期 FExtAuxUnitQty调入数量（辅单位） FThirdSrcEntryId第三方源单分录编码 FRowId行标识 FParentRowId父行标识 F_ABCD_BasePropertySKU F_ABCD_guihao发票号 F_ABCD_InvoiceNo柜号 F_ABCD_UnitPrice单价 F_ABCD_supplier1供应商 FOwnerIdHead调出货主

易仓接口明细

API：syncPurchaseOrders
NAME：创建采购单
METHOD：POST

请求参数

接口字段字段名称预设值描述 action_type采购单操作类型ADD采购单操作类型 ADD：创建；EDIT：编辑；默认 ADD warehouse_id采购仓库IDfindCollection find warehouseId from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseCode={{FDestStockID_FNumber}}采购仓库ID to_warehouse_id中转仓库ID中转仓库ID po_type补货方式：1补货方式： suppiler_id供应商ID_findCollection find supplier_id from 1cfb0d16-4425-3e49-bed4-c1cde2c6b7fa where supplier_code={{F_ABCD_supplier1}}供应商ID is_rebate_tax是否退税是否退税 0：否 1：是 operator_purchase采购员ID707采购员ID operation_type运营方式：2运营方式： account_type结算方式：2结算方式： account_proportion预付比例预付比例(结算方式为款到发货时可选填） is_1688是否是1688采购单是否是1688采购单，0：否1：是。注：1688采购单只能是待确认状态 payment_cycle支付周期（beta)支付周期（beta) currency_code币种findCollection find FSettleCurrId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}}币种 pay_type支付方式：1支付方式： supplier_pay_type供应商收款方式😐3供应商收款方式😐 shipping_method_id_head供应商运输方式：2供应商运输方式： alipay_account支付宝账户支付宝账户(当支付方式为在线时，可选填) ,提供接口getPaymentAccount bk_id支付银行支付银行(当支付方式银行卡时，可选填) ,提供接口getPaymentAccount ba_id支付银行卡账号支付银行卡账号(当支付方式为银行卡时，可选填),提供接口getPaymentAccount alipay_supplier_account供应商支付宝账户供应商支付宝账户(当供应商收款方式为在线时，可选填) ,接口getSupplierInfo supplier_bk_id收款银行收款银行(当供应商收款方式为银行卡时，可选填),接口getSupplierInfo supplier_ba_id支付方式ID支付方式ID(当供应商收款方式为银行卡时，可选填),接口getSupplierInfo pts_oprater跟单员ID707跟单员ID po_code采购单号采购单号，采购单操作类型为1（编辑）时，必填 po_status操作类型31：待确认，2:待审核，3:已审核默认值：待确认 company采购公司采购公司 receiver收件人ID收件人ID tracking_no跟踪单号{{FBillNo}}跟踪单号 ref_no参考号{{F_ABCD_InvoiceNo}}参考号 date_eta预计到货时间预计到货时间 pay_ship_amount运费运费 transaction_no支付单号{{FOwnerIdHead}}支付单号 date_expected预计出厂时间预计出厂时间 date_create创建时间创建时间，默认当前时间 po_is_net是否网采1是否网采，0 single_net_number网采单号{{F_ABCD_guihao}}网采单号（可填多个，当是否网采为1时可选填），格式：["101508120001","101508120001"] po_is_has_tax采购是否含税采购是否含税 0：否 1：是 organization_id组织机构Id组织机构Id pro_code申购单号申购单号（分销系统用） productList采购产品明细details采购产品明细，具体见下表 productList.product_sku产品代码{{F_ABCD_BaseProperty}}产品代码 productList.qty_expected产品数量{{FQty}}产品数量 productList.currency_code币种_findCollection find FSettleCurrId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}}币种 productList.unit_price不含税单价function case when '{{F_ABCD_UnitPrice}}' ='0' then '1.0000' when '{{F_ABCD_UnitPrice}}' like '%.%' then '{{F_ABCD_UnitPrice}}' else '{{F_ABCD_UnitPrice}}.0000' end不含税单价该值需大于0，is_free字段传1后，该值会默认为0，但传值仍需大于0 productList.contract_price含税单价含税单价 productList.sp_reference_unit_price采购参考价采购参考价 productList.is_qc是否质检是否质检是（1）否（0） productList.is_free是否赠品，_function case when '{{F_ABCD_UnitPrice}}' ='0' then '1' else '' end是否赠品，1为赠品 productList.qty_free赠品数量_function case when '{{F_ABCD_UnitPrice}}' ='0' then '{{FQty}}' else '' end赠品数量 productList.po_tax_rate税率税率 productList.pop_external_number外部单号外部单号 productList.note备注备注 productList.reason下单原因下单原因

数据对接价值

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶云星空、易仓间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。