金蝶云星空和易仓接口打通对接实战
源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:易仓
易仓作为一家专门服务于跨境电商行业的纯软件服务商,为了更好的服务跨境电商,易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。
数据接口配置方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:易仓,把获取的数据组装成目标系统需要的格式进行写入。
金蝶云星空接口明细
- API:executeBillQuery
- NAME:分布式调出单查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FSTKTRSOUTENTRY_FEntryID | FEntryID | FSTKTRSOUTENTRY_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 | |
FBOMID | BOM版本 | 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_BaseProperty | SKU | F_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 | 业务对象表单Id | STK_TRANSFEROUT | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
FSTKTRSOUTENTRY_FEntryID | FEntryID | | |
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 | 总成本 | | |
FBOMID | BOM版本 | | |
FProduceDate | 生产日期 | | |
FEXPIRYDATE | 有效期至 | | |
FMTONO | 计划跟踪号 | | |
FOwnerID_FNumber | 调入货主 | | |
FUnitID | 单位 | | |
FStockOutFlag | 出库库存更新标识 | | |
FStockInFlag | 入库库存更新标识 | | |
FDestStockLocId | 调入仓位 | | |
FSRCStockLocId | 调出仓位 | | |
FSrcBillNo | 源单编号 | | |
FLOT | 调出批号 | | |
FEntryNote | 备注 | | |
FSRCBILLNAME | 源单单据类型 | | |
FSrcBillDate | 源单日期 | | |
FDestLot | 调入批号 | | |
FBusinessDate | 入库日期 | | |
FExtAuxUnitQty | 调入数量(辅单位) | | |
FThirdSrcEntryId | 第三方源单分录编码 | | |
FRowId | 行标识 | | |
FParentRowId | 父行标识 | | |
F_ABCD_BaseProperty | SKU | | |
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 | 采购仓库ID | findCollection 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 | 采购员ID | 707 | 采购员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 | 跟单员ID | 707 | 跟单员ID |
po_code | 采购单号 | | 采购单号,采购单操作类型为1(编辑)时,必填 |
po_status | 操作类型 | 3 | 1:待确认,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的方式对外开放,实现业务创新、能力输出。