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

对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
集成系统:易仓
易仓作为一家专门服务于跨境电商行业的纯软件服务商,为了更好的服务跨境电商,易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。
系统对接接口配置
在轻易云平台进行集成方案的配置时,为了实现快速搭建,轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案,参考市场主流所进行的字段配置完成集成方案的自定义化快速配置,即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置,让配置更加清晰,首先确定该方方案的对接内容,第二歩获取筛选数据源平台的数据,第三步数据源与写入目标形成映射关系配置。完成配置后一键启用


金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:分布式调出单查询
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| 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 | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| 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 | 下单原因 | | 下单原因 |
系统数据集成价值
使用全界面可视化配置集成流,快速应对企业的集成需求使得金蝶云星空与易仓之间的数据接口一站式的快速集成能力,构建企业数据通道,解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准,完成数据的采集、统一、分发、清洗、归集等,帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统,同时具备快速适配新系统的能力,集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统,都可以通过接口相互集成。
