金蝶云星空与积加ERP对接集成供应商查询打通录入供应商信息

数据源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:积加ERP
深圳市积加跨境网络科技有限公司,是国内跨境电商数字基础设施服务商,为跨境精品卖家提供全闭环的电商解决方案。积加致力于让入门级卖家成长,中大型卖家发展,成就精品全渠道商家。企业简介深圳市积加跨境网络科技有限公司(简称积加)
数据集成方案配置
使用轻易云系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的供应商查询作为数据对接来源。然后再通过写入目标平台配置目标系统为积加ERP,并且选择对应连接器(关于积加ERP的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的录入供应商信息接口作为数据写入动作,既可以完成第一步的数据对接配置。


金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:供应商查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FSupplierId | FSupplierId | string | FSupplierId |
FNumber | 编码 | string | FNumber |
FName | 名称 | string | FName |
FCreateOrgId_FNumber | 创建组织 | string | FCreateOrgId.FNumber |
FUseOrgId_FNumber | 使用组织 | string | FUseOrgId.FNumber |
FDescription | 描述 | string | FDescription |
FShortName | 简称 | string | FShortName |
FMinPOValue | 最小订单量 | string | FMinPOValue |
FCountry_FNumber | 国家 | string | FCountry.FNumber |
FBusinessStatus | 业务状态 | string | FBusinessStatus |
FProvincial_FNumber | 地区 | string | FProvincial.FNumber |
FFreezeLimit | 冻结范围 | string | FFreezeLimit |
FAddress | 通讯地址 | string | FAddress |
FZip | 邮政编码 | string | FZip |
FFreezeDate | 冻结日期 | string | FFreezeDate |
FPurchaserGroupId_FNumber | 采购组 | string | FPurchaserGroupId.FNumber |
FParentSupplierId_FNumber | 汇总公司 | string | FParentSupplierId.FNumber |
FLanguage_FNumber | 语言 | string | FLanguage.FNumber |
FWebSite | 公司网址 | string | FWebSite |
FCustomerId_FNumber | 对应客户 | string | FCustomerId.FNumber |
FPayCurrencyId_FNumber | 结算币别 | string | FPayCurrencyId.FNumber |
FSettleTypeId_FNumber | 结算方式 | string | FSettleTypeId.FNumber |
FPayCondition_FNumber | 付款条件 | string | FPayCondition.FNumber |
FSettleId_FNumber | 结算方 | string | FSettleId.FNumber |
FPayAdvanceAmount | 单次预付额度 | string | FPayAdvanceAmount |
FTaxType_FNumber | 税分类 | string | FTaxType.FNumber |
FTaxRegisterCode | 税务登记号 | string | FTaxRegisterCode |
FTendType_FNumber | 经营类型 | string | FTendType.FNumber |
FChargeId_FNumber | 收款方 | string | FChargeId.FNumber |
FInvoiceType | 发票类型 | string | FInvoiceType |
FTaxRateId_FNumber | 默认税率 | string | FTaxRateId.FNumber |
FFinanceDesc | 描述 | string | FFinanceDesc |
FTrade_FNumber | 行业 | string | FTrade.FNumber |
FPRICELISTID_FNumber | 默认价目表 | string | FPRICELISTID.FNumber |
FDiscountListId_FNumber | 默认折扣表 | string | FDiscountListId.FNumber |
FFoundDate | 创立日期 | string | FFoundDate |
FNeedConfirm | 需要确认 | string | FNeedConfirm |
FProviderId_FNumber | 供货方 | string | FProviderId.FNumber |
FLegalPerson | 法人代表 | string | FLegalPerson |
FWipStockId_FNumber | 默认WIP仓库 | string | FWipStockId.FNumber |
FRegisterFund | 注册资金(万元) | string | FRegisterFund |
FRegisterCode | 工商登记号 | string | FRegisterCode |
FVmiBusiness | VMI业务 | string | FVmiBusiness |
FSOCIALCRECODE | 统一社会信用代码 | string | FSOCIALCRECODE |
FTendPermit | 生产经营许可证 | string | FTendPermit |
FVmiStockId_FNumber | VMI仓库 | string | FVmiStockId.FNumber |
FRegisterAddress | 注册地址 | string | FRegisterAddress |
FDeptId_FNumber | 负责部门 | string | FDeptId.FNumber |
FStaffId_FNumber | 负责人 | string | FStaffId.FNumber |
FSupplierClassify_FNumber | 供应商分类 | string | FSupplierClassify.FNumber |
FSupplyClassify | 供应类别 | string | FSupplyClassify |
FSupplierGrade_FNumber | 供应商等级 | string | FSupplierGrade.FNumber |
FGroup | 供应商分组 | string | FGroup |
FCompanyClassify_FNumber | 公司类别 | string | FCompanyClassify.FNumber |
FCompanyNature_FNumber | 公司性质 | string | FCompanyNature.FNumber |
FCompanyScale_FNumber | 公司规模 | string | FCompanyScale.FNumber |
FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
FStartDate | 生效日期 | string | FStartDate |
FEndDate | 失效日期 | string | FEndDate |
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | FAuditDate>='{{LAST_SYNC_TIME dateTime}}' |
FieldKeys | 需查询的字段key集合 | array | |
FormId | 业务对象表单Id | string | BD_Supplier |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FSupplierId | FSupplierId | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FCreateOrgId_FNumber | 创建组织 | string | |
FUseOrgId_FNumber | 使用组织 | string | |
FDescription | 描述 | string | |
FShortName | 简称 | string | |
FMinPOValue | 最小订单量 | string | |
FCountry_FNumber | 国家 | string | |
FBusinessStatus | 业务状态 | string | |
FProvincial_FNumber | 地区 | string | |
FFreezeLimit | 冻结范围 | string | |
FAddress | 通讯地址 | string | |
FZip | 邮政编码 | string | |
FFreezeDate | 冻结日期 | string | |
FPurchaserGroupId_FNumber | 采购组 | string | |
FParentSupplierId_FNumber | 汇总公司 | string | |
FLanguage_FNumber | 语言 | string | |
FWebSite | 公司网址 | string | |
FCustomerId_FNumber | 对应客户 | string | |
FPayCurrencyId_FNumber | 结算币别 | string | |
FSettleTypeId_FNumber | 结算方式 | string | |
FPayCondition_FNumber | 付款条件 | string | |
FSettleId_FNumber | 结算方 | string | |
FPayAdvanceAmount | 单次预付额度 | string | |
FTaxType_FNumber | 税分类 | string | |
FTaxRegisterCode | 税务登记号 | string | |
FTendType_FNumber | 经营类型 | string | |
FChargeId_FNumber | 收款方 | string | |
FInvoiceType | 发票类型 | string | |
FTaxRateId_FNumber | 默认税率 | string | |
FFinanceDesc | 描述 | string | |
FTrade_FNumber | 行业 | string | |
FPRICELISTID_FNumber | 默认价目表 | string | |
FDiscountListId_FNumber | 默认折扣表 | string | |
FFoundDate | 创立日期 | string | |
FNeedConfirm | 需要确认 | string | |
FProviderId_FNumber | 供货方 | string | |
FLegalPerson | 法人代表 | string | |
FWipStockId_FNumber | 默认WIP仓库 | string | |
FRegisterFund | 注册资金(万元) | string | |
FRegisterCode | 工商登记号 | string | |
FVmiBusiness | VMI业务 | string | |
FSOCIALCRECODE | 统一社会信用代码 | string | |
FTendPermit | 生产经营许可证 | string | |
FVmiStockId_FNumber | VMI仓库 | string | |
FRegisterAddress | 注册地址 | string | |
FDeptId_FNumber | 负责部门 | string | |
FStaffId_FNumber | 负责人 | string | |
FSupplierClassify_FNumber | 供应商分类 | string | |
FSupplyClassify | 供应类别 | string | |
FSupplierGrade_FNumber | 供应商等级 | string | |
FGroup | 供应商分组 | string | |
FCompanyClassify_FNumber | 公司类别 | string | |
FCompanyNature_FNumber | 公司性质 | string | |
FCompanyScale_FNumber | 公司规模 | string | |
FCorrespondOrgId_FNumber | 对应组织 | string | |
FStartDate | 生效日期 | string | |
FEndDate | 失效日期 | string | |
积加ERP接口明细
- 调用接口:api/v2/setting/createsupplier
- 接口名称:录入供应商信息
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
supplierCodeList | 供应商码集合 | string | |
contractTemplateId | 合同模板ID | string | |
contractUpdateAt | 更换合同模板时间 | string | |
supplierWarehouse | 是否作为供应商仓 | string | |
permissionGroupIds | 权限组ID集合 | string | |
code | 供应商编码 | string | {{FNumber}} |
name | 供应商名称 | string | {{FName}} |
state | 状态(0:启用;1:停用;) | string | |
type | 类别,区分为supplier、logistics、service | string | supplier |
contact | 供应商联系人 | string | |
phone1 | 联系人电话 | string | |
phone2 | 已作废 | string | |
email | 邮箱 | string | |
addr | 供应商地址 | string | |
paymentType | 结算方式(1:现结;2:月结;) | string | |
buyerManager | 采购员名称 | string | |
buyerManagerId | 采购负责人id | string | |
creater | 创建人名称 | string | |
createrId | 创建人ID | string | |
createdAt | 创建时间 | string | |
updaterId | 更新人ID | string | |
updateAt | 更新时间 | string | |
faxNumber | 传真号 | string | |
qqNumber | QQ号 | string | |
postCode | 邮编 | string | |
detailedAddr | 仓库详细地址 | string | |
description | 备注 | string | |
paymentRate | 预付比例 | string | |
paymentCycle | 结算周期 | string | |
paymentDate | 付款日 每月几日结算 | string | |
paymentDesc | 结算描述 | string | |
logisticsTimeliness | 物流时效 | string | |
licensePlateNumber | 车牌号 | string | |
receiptInfo | 收款信息 | string | |
feeSubjectId | 费用承担组织ID | string | |
系统对接概况
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。


