金蝶云星空对接打通易仓分布式调出单查询接口与创建采购单接口
数据源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:易仓
易仓作为一家专门服务于跨境电商行业的纯软件服务商，为了更好的服务跨境电商，易仓旗下服务平台“跨境眼”可以帮助卖家轻松对接到各个仓储物流服务商、同时支持财税业务的对接。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的分布式调出单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为易仓，并且选择对应连接器。选择对应的创建采购单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星空接口明细
- 接口：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 | |
易仓接口明细
- 接口：syncPurchaseOrders
- 接口名称：创建采购单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| action_type | 采购单操作类型 | string | 采购单操作类型 ADD：创建；EDIT：编辑；默认 ADD |
| warehouse_id | 采购仓库ID | string | 采购仓库ID |
| to_warehouse_id | 中转仓库ID | string | 中转仓库ID |
| po_type | 补货方式： | string | 补货方式： |
| suppiler_id | 供应商ID | string | 供应商ID |
| is_rebate_tax | 是否退税 | string | 是否退税 0：否 1：是 |
| operator_purchase | 采购员ID | string | 采购员ID |
| operation_type | 运营方式： | string | 运营方式： |
| account_type | 结算方式： | string | 结算方式： |
| account_proportion | 预付比例 | string | 预付比例(结算方式为款到发货时可选填） |
| is_1688 | 是否是1688采购单 | string | 是否是1688采购单，0：否1：是。注：1688采购单只能是待确认状态 |
| payment_cycle | 支付周期（beta) | string | 支付周期（beta) |
| currency_code | 币种 | string | 币种 |
| pay_type | 支付方式： | string | 支付方式： |
| supplier_pay_type | 供应商收款方式😐 | string | 供应商收款方式😐 |
| shipping_method_id_head | 供应商运输方式： | string | 供应商运输方式： |
| alipay_account | 支付宝账户 | string | 支付宝账户(当支付方式为在线时，可选填) ,提供接口getPaymentAccount |
| bk_id | 支付银行 | string | 支付银行(当支付方式银行卡时，可选填) ,提供接口getPaymentAccount |
| ba_id | 支付银行卡账号 | string | 支付银行卡账号(当支付方式为银行卡时，可选填),提供接口getPaymentAccount |
| alipay_supplier_account | 供应商支付宝账户 | string | 供应商支付宝账户(当供应商收款方式为在线时，可选填) ,接口getSupplierInfo |
| supplier_bk_id | 收款银行 | string | 收款银行(当供应商收款方式为银行卡时，可选填),接口getSupplierInfo |
| supplier_ba_id | 支付方式ID | string | 支付方式ID(当供应商收款方式为银行卡时，可选填),接口getSupplierInfo |
| pts_oprater | 跟单员ID | string | 跟单员ID |
| po_code | 采购单号 | string | 采购单号，采购单操作类型为1（编辑）时，必填 |
| po_status | 操作类型 | string | 1：待确认，2:待审核，3:已审核 默认值：待确认 |
| company | 采购公司 | string | 采购公司 |
| receiver | 收件人ID | string | 收件人ID |
| tracking_no | 跟踪单号 | string | 跟踪单号 |
| ref_no | 参考号 | string | 参考号 |
| date_eta | 预计到货时间 | string | 预计到货时间 |
| pay_ship_amount | 运费 | string | 运费 |
| transaction_no | 支付单号 | string | 支付单号 |
| date_expected | 预计出厂时间 | string | 预计出厂时间 |
| date_create | 创建时间 | string | 创建时间，默认当前时间 |
| po_is_net | 是否网采 | string | 是否网采，0 |
| single_net_number | 网采单号 | string | 网采单号（可填多个，当是否网采为1时可选填），格式：["101508120001","101508120001"] |
| po_is_has_tax | 采购是否含税 | string | 采购是否含税 0：否 1：是 |
| organization_id | 组织机构Id | string | 组织机构Id |
| pro_code | 申购单号 | string | 申购单号（分销系统用） |
| productList | 采购产品明细 | array | 采购产品明细，具体见下表 |
| productList.product_sku | 产品代码 | string | 产品代码 |
| productList.qty_expected | 产品数量 | string | 产品数量 |
| productList.currency_code | 币种 | string | 币种 |
| productList.unit_price | 不含税单价 | string | 不含税单价 该值需大于0，is_free字段传1后，该值会默认为0，但传值仍需大于0 |
| productList.contract_price | 含税单价 | string | 含税单价 |
| productList.sp_reference_unit_price | 采购参考价 | string | 采购参考价 |
| productList.is_qc | 是否质检 | string | 是否质检 是（1）否（0） |
| productList.is_free | 是否赠品， | string | 是否赠品，1为赠品 |
| productList.qty_free | 赠品数量 | string | 赠品数量 |
| 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架构。
