易仓和金蝶云星空单据接口对接
来源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
接通系统:易仓
易仓科技是一家专门做跨境电商软件服务提供商,目前他们有跨境电商ERP、国际物流TMS、海外仓WMS、跨境分销M2C,保税仓BBC等管理系统。
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶云星空接口:分布式调出单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:易仓接口:创建采购单,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:易仓写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星空接口明细
- 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 | 调出货主 | | |
易仓接口明细
- 调用接口:syncPurchaseOrders
- 接口名称:创建采购单
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
action_type | 采购单操作类型 | string | ADD |
warehouse_id | 采购仓库ID | string | findCollection find warehouseId from de1387a4-c479-35db-9bcb-c73858fcb2b1 where warehouseCode={{FDestStockID_FNumber}} |
to_warehouse_id | 中转仓库ID | string | |
po_type | 补货方式: | string | 1 |
suppiler_id | 供应商ID | string | _findCollection find FSupplierId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}} |
is_rebate_tax | 是否退税 | string | |
operator_purchase | 采购员ID | string | 707 |
operation_type | 运营方式: | string | 2 |
account_type | 结算方式: | string | 2 |
account_proportion | 预付比例 | string | |
is_1688 | 是否是1688采购单 | string | |
payment_cycle | 支付周期(beta) | string | |
currency_code | 币种 | string | findCollection find FSettleCurrId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}} |
pay_type | 支付方式: | string | 1 |
supplier_pay_type | 供应商收款方式😐 | string | 3 |
shipping_method_id_head | 供应商运输方式: | string | 2 |
alipay_account | 支付宝账户 | string | |
bk_id | 支付银行 | string | |
ba_id | 支付银行卡账号 | string | |
alipay_supplier_account | 供应商支付宝账户 | string | |
supplier_bk_id | 收款银行 | string | |
supplier_ba_id | 支付方式ID | string | |
pts_oprater | 跟单员ID | string | 707 |
po_code | 采购单号 | string | |
po_status | 操作类型 | string | 3 |
company | 采购公司 | string | |
receiver | 收件人ID | string | |
tracking_no | 跟踪单号 | string | {{FBillNo}} |
ref_no | 参考号 | string | {{F_ABCD_InvoiceNo}} |
date_eta | 预计到货时间 | string | |
pay_ship_amount | 运费 | string | |
transaction_no | 支付单号 | string | {{FOwnerIdHead}} |
date_expected | 预计出厂时间 | string | |
date_create | 创建时间 | string | |
po_is_net | 是否网采 | string | 1 |
single_net_number | 网采单号 | string | {{F_ABCD_guihao}} |
po_is_has_tax | 采购是否含税 | string | |
organization_id | 组织机构Id | string | |
pro_code | 申购单号 | string | |
productList | 采购产品明细 | array | details |
productList.product_sku | 产品代码 | string | {{F_ABCD_BaseProperty}} |
productList.qty_expected | 产品数量 | string | {{FQty}} |
productList.currency_code | 币种 | string | _findCollection find FSettleCurrId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}} |
productList.unit_price | 不含税单价 | string | 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 |
productList.contract_price | 含税单价 | string | |
productList.sp_reference_unit_price | 采购参考价 | string | |
productList.is_qc | 是否质检 | string | |
productList.is_free | 是否赠品, | string | _function case when '{{F_ABCD_UnitPrice}}' ='0' then '1' else '' end |
productList.qty_free | 赠品数量 | string | _function case when '{{F_ABCD_UnitPrice}}' ='0' then '{{FQty}}' else '' end |
productList.po_tax_rate | 税率 | string | |
productList.pop_external_number | 外部单号 | string | |
productList.note | 备注 | string | |
productList.reason | 下单原因 | string | |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。