金蝶云星空与易仓对接集成分布式调出单查询连通创建采购单(分布调出单-采购订单【供应商为空需要找上游采购入库单供应商】)

源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
写入目标:易仓
易仓科技是一家专门做跨境电商软件服务提供商,目前他们有跨境电商ERP、国际物流TMS、海外仓WMS、跨境分销M2C,保税仓BBC等管理系统。
接口方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取金蝶云星空的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到易仓中。轻易云集成平台的可视化配置轻松实现。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:分布式调出单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FSTKTRSOUTENTRY_FEntryID | FEntryID | string | FSTKTRSOUTENTRY_FEntryID |
FID | 实体主键 | string | FID |
FBillNo | 单据编号 | string | FBillNo |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FStockOrgID_FNumber | 调入库存组织 | string | FStockOrgID.FNumber |
FDate | 日期 | string | FDate |
FBillTypeID | 单据类型 | string | FBillTypeID |
FTransferDirect | 调拨方向 | string | FTransferDirect |
FNOTE | 备注 | string | FNOTE |
FCreateDate | 创建日期 | string | FCreateDate |
FApproveDate | 审核日期 | string | FApproveDate |
FTransferBizType | 调拨类型 | string | FTransferBizType |
FBizType | 业务类型 | string | FBizType |
FCustID_FNumber | 对应客户 | string | FCustID.FNumber |
FSUPPLIERID_FNumber | 对应供应商 | string | FSUPPLIERID.FNumber |
FThirdSystem | 第三方系统 | string | FThirdSystem |
FThirdSrcId | 第三方源单内码 | string | FThirdSrcId |
FThirdSrcBillNo | 第三方源单编码 | string | FThirdSrcBillNo |
FVirIsSameAcctOrg | 是否同一核算组织 | string | FVirIsSameAcctOrg |
FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
FCMKBarCode | 零售条形码 | string | FCMKBarCode |
FSrcStockID_FNumber | 调出仓库 | string | FSrcStockID.FNumber |
FDestStockID_FNumber | 调入仓库 | string | FDestStockID.FNumber |
FQty | 调入数量 | string | FQty |
FPrice | 成本价 | string | FPrice |
FAmount | 总成本 | string | FAmount |
FBOMID | BOM版本 | string | FBOMID |
FProduceDate | 生产日期 | string | FProduceDate |
FEXPIRYDATE | 有效期至 | string | FEXPIRYDATE |
FMTONO | 计划跟踪号 | string | FMTONO |
FOwnerID_FNumber | 调入货主 | string | FOwnerID.FNumber |
FUnitID | 单位 | string | FUnitID |
FStockOutFlag | 出库库存更新标识 | string | FStockOutFlag |
FStockInFlag | 入库库存更新标识 | string | FStockInFlag |
FDestStockLocId | 调入仓位 | string | FDestStockLocId |
FSRCStockLocId | 调出仓位 | string | FSRCStockLocId |
FSrcBillNo | 源单编号 | string | FSrcBillNo |
FLOT | 调出批号 | string | FLOT |
FEntryNote | 备注 | string | FEntryNote |
FSRCBILLNAME | 源单单据类型 | string | FSRCBILLNAME |
FSrcBillDate | 源单日期 | string | FSrcBillDate |
FDestLot | 调入批号 | string | FDestLot |
FBusinessDate | 入库日期 | string | FBusinessDate |
FExtAuxUnitQty | 调入数量(辅单位) | string | FExtAuxUnitQty |
FThirdSrcEntryId | 第三方源单分录编码 | string | FThirdSrcEntryId |
FRowId | 行标识 | string | FRowId |
FParentRowId | 父行标识 | string | FParentRowId |
F_ABCD_BaseProperty | SKU | string | F_ABCD_BaseProperty |
F_ABCD_guihao | 发票号 | string | F_ABCD_guihao |
F_ABCD_InvoiceNo | 柜号 | string | F_ABCD_InvoiceNo |
F_ABCD_UnitPrice | 单价 | string | F_ABCD_UnitPrice |
F_ABCD_supplier1 | 供应商 | string | F_ABCD_supplier1.FNumber |
FOwnerIdHead | 调出货主 | string | FOwnerIdHead.FNumber |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and F_ABCD_supplier1= '' |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | STK_TRANSFEROUT |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FSTKTRSOUTENTRY_FEntryID | FEntryID | string | |
FID | 实体主键 | string | |
FBillNo | 单据编号 | string | |
FDocumentStatus | 单据状态 | string | |
FStockOrgID_FNumber | 调入库存组织 | string | |
FDate | 日期 | string | |
FBillTypeID | 单据类型 | string | |
FTransferDirect | 调拨方向 | string | |
FNOTE | 备注 | string | |
FCreateDate | 创建日期 | string | |
FApproveDate | 审核日期 | string | |
FTransferBizType | 调拨类型 | string | |
FBizType | 业务类型 | string | |
FCustID_FNumber | 对应客户 | string | |
FSUPPLIERID_FNumber | 对应供应商 | string | |
FThirdSystem | 第三方系统 | string | |
FThirdSrcId | 第三方源单内码 | string | |
FThirdSrcBillNo | 第三方源单编码 | string | |
FVirIsSameAcctOrg | 是否同一核算组织 | string | |
FMaterialID_FNumber | 物料编码 | string | |
FCMKBarCode | 零售条形码 | string | |
FSrcStockID_FNumber | 调出仓库 | string | |
FDestStockID_FNumber | 调入仓库 | string | |
FQty | 调入数量 | string | |
FPrice | 成本价 | string | |
FAmount | 总成本 | string | |
FBOMID | BOM版本 | string | |
FProduceDate | 生产日期 | string | |
FEXPIRYDATE | 有效期至 | string | |
FMTONO | 计划跟踪号 | string | |
FOwnerID_FNumber | 调入货主 | string | |
FUnitID | 单位 | string | |
FStockOutFlag | 出库库存更新标识 | string | |
FStockInFlag | 入库库存更新标识 | string | |
FDestStockLocId | 调入仓位 | string | |
FSRCStockLocId | 调出仓位 | string | |
FSrcBillNo | 源单编号 | string | |
FLOT | 调出批号 | string | |
FEntryNote | 备注 | string | |
FSRCBILLNAME | 源单单据类型 | string | |
FSrcBillDate | 源单日期 | string | |
FDestLot | 调入批号 | string | |
FBusinessDate | 入库日期 | string | |
FExtAuxUnitQty | 调入数量(辅单位) | string | |
FThirdSrcEntryId | 第三方源单分录编码 | string | |
FRowId | 行标识 | string | |
FParentRowId | 父行标识 | string | |
F_ABCD_BaseProperty | SKU | string | |
F_ABCD_guihao | 发票号 | string | |
F_ABCD_InvoiceNo | 柜号 | string | |
F_ABCD_UnitPrice | 单价 | string | |
F_ABCD_supplier1 | 供应商 | string | |
FOwnerIdHead | 调出货主 | string | |
易仓接口明细
- 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 FSupplierId_FNumber from 63ee9b42-379b-3b79-bd7e-e2f253d9f334 where FBillNo={{FBillNo}} | 供应商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数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:易仓与金蝶云星空之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。

