金蝶云星空和巨益OMS集成接口设计

接入系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标平台:巨益OMS
深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳,专注为中大型零售品牌企业提供全渠道电商中台服务,经过7年多时间的业务沉淀,已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型,服务口碑获得了客户的一致好评。截至目前,巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业,并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。
数据接口配置
数据集成平台对应的配置金蝶云星空与巨益OMS的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与巨益OMS之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。



金蝶云星空接口明细
- 调用接口: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}}' and FUseOrgId.FNumber in ('101','102','118','110') |
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 | |
巨益OMS接口明细
- 调用接口:qok9k0wo6r.greatonce.oms.supplier.synchronize
- 接口名称:供应商同步-OMS
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
address | 地址 | string | |
bank | 开户行 | string | |
bankAccountName | 开户帐号名称 | string | |
bankAccountNo | 开户帐号 | string | |
code | 供应商编码 | string | {{FNumber}} |
companyName | 公司名称 | string | |
contact | 联系人 | string | |
email | 邮箱 | string | |
mobile | 手机 | string | |
name | 供应商名称 | string | {{FName}} |
remark | 备注 | string | |
settlementType | 供应商结算方式 | string | 月结 |
shortName | 供应商简称 | string | |
telephone | 电话 | string | |
系统数据集成价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到巨益OMS之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。


