金蝶云星空对接打通易仓分布式调出单查询接口与创建采购单接口

来源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:易仓
圳市易仓科技有限公司一直致力于研发高效可控的跨境管理模式。精研跨境电商ERP、国际物流TMS、海外仓WMS和跨境分销M2B等管理系统。汇集目前国内强大的IT团队,创始人和开发巨匠均在跨境B2C、海外仓、国际物流等领域有5-12年研发经验,易仓目前已和国内外众多跨境卖家、海外仓服务商和国际物流等跨境巨头合作。
数据对接方案
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶云星空接口:分布式调出单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:易仓接口:创建采购单,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:易仓写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细
- 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 | |
数据对接价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到易仓之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。
