从金蝶云星空到四化智造MES(API)通过接口配置打通数据
数据源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接通系统:四化智造MES(API)
MES建立统一平台上通过物料防错防错、流程防错、生产统计、异常处理、信息采集和全流程追溯等精益生产和精细化管理,帮助企业合理安排生产排程、优化工艺流程、改善产品质量、降低能源损耗、降低制造成本,提高执行效率,全面提升和改善企业制造能力,为企业打造可视化、透明化、数字化、智能化工厂。通过手机移动APP实时的数据查询和分析报表,为企业高层提供快速决策支持,以便针对市场变化快速准确地作出反应,综合提升企业的市场竞争力。
数据集成方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:逐个单据查询,目标系统:四化智造MES(API),目标系统 API新增客户联系人。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 接口:ExecuteBillQuery
- 接口名称:逐个单据查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
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 |
响应参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
DocumentStatus | 单据状态 | string | |
ForbidStatus | 禁用状态 | string | |
Name | 客户名称 | string | |
Number | 客户编码 | string | |
Description | 备注 | string | |
CreateOrgId_Id | 创建组织Id | string | |
CreateOrgId_Name | 创建组织_名称 | string | |
CreateOrgId_Number | 创建组织编码 | string | |
UseOrgId_Id | 使用组织_Id | string | |
UseOrgId_Name | 使用组织名称 | string | |
UseOrgId_Number | 使用组织_编码 | string | |
CreatorId_Id | 创建人Id | string | |
CreatorId_Name | 创建人_名称 | string | |
CreatorId_Number | 创建人编码 | string | |
ModifierId_Id | 修改人_Id | string | |
ModifierId_Name | 修改人名称 | string | |
ModifierId_Number | 修改人_编码 | string | |
CreateDate | 创建日期 | string | |
FModifyDate | 修改日期 | string | |
ShortName | 简称 | string | |
COUNTRY | 国家 | string | |
PROVINCIAL | 地区 | string | |
FZIP | 邮政编码 | string | |
TEL | 联系电话 | string | |
FTAXREGISTERCODE | 纳税登记号 | string | |
FAX | 传真 | string | |
FGROUPCUSTID_Id | 对应集团客户Id | string | |
FGROUPCUSTID_Name | 对应集团客户_名称 | string | |
FGROUPCUSTID_Number | 对应集团客户编码 | string | |
FSUPPLIERID_Id | 对应供应商_Id | string | |
FSUPPLIERID_Name | 对应供应商名称 | string | |
FSUPPLIERID_Number | 对应供应商_编码 | string | |
TRADINGCURRID_Id | 结算币别Id | string | |
TRADINGCURRID_Name | 结算币别_名称 | string | |
TRADINGCURRID_Number | 结算币别编码 | string | |
SALDEPTID_Id | 销售部门_Id | string | |
SALDEPTID_Name | 销售部门名称 | string | |
SALDEPTID_Number | 销售部门_编码 | string | |
SALGROUPID_Id | 销售组Id | string | |
SALGROUPID_Name | 销售组_名称 | string | |
SALGROUPID_Number | 销售组编码 | string | |
SELLER_Id | 销售员_Id | string | |
SELLER_Name | 销售员名称 | string | |
SELLER_Number | 销售员_编码 | string | |
TRANSLEADTIME | 运输提前期 | string | |
PRICELISTID_Id | 价目表Id | string | |
PRICELISTID_Name | 价目表_名称 | string | |
PRICELISTID_Number | 价目表编码 | string | |
DISCOUNTLISTID_Id | 折扣表_Id | string | |
DISCOUNTLISTID_Name | 折扣表名称 | string | |
DISCOUNTLISTID_Number | 折扣表_编码 | string | |
SETTLETYPEID_Id | 结算方式Id | string | |
SETTLETYPEID_Name | 结算方式_名称 | string | |
SETTLETYPEID_Number | 结算方式编码 | string | |
RECEIVECURRID_Id | 收款币别_Id | string | |
RECEIVECURRID_Name | 收款币别名称 | string | |
RECEIVECURRID_Number | 收款币别_编码 | string | |
RECCONDITIONID_Id | 收款条件Id | string | |
RECCONDITIONID_Name | 收款条件_名称 | string | |
RECCONDITIONID_Number | 收款条件编码 | string | |
FISCREDITCHECK | 启用信用管理 | string | |
APPROVERID_Id | 审核人_Id | string | |
APPROVERID_Name | 审核人名称 | string | |
APPROVERID_Number | 审核人_编码 | string | |
APPROVEDATE | 审核日期 | string | |
FORBIDDERID_Id | 禁用人Id | string | |
FORBIDDERID_Name | 禁用人_名称 | string | |
FORBIDDERID_Number | 禁用人编码 | string | |
FORBIDDATE | 禁用日期 | string | |
TaxType | 税分类 | string | |
CustTypeId | 客户类别 | string | |
ADDRESS | 通讯地址 | string | |
WEBSITE | 公司网址 | string | |
FGroup_Id | 客户分组_Id | string | |
FGroup_Name | 客户分组名称 | string | |
FGroup_Number | 客户分组_编码 | string | |
CompanyScale | 公司规模 | string | |
CompanyType | 公司类别 | string | |
CompanyNature | 公司性质 | string | |
CorrespondOrgId_Id | 对应组织Id | string | |
CorrespondOrgId_Name | 对应组织_名称 | string | |
CorrespondOrgId_Number | 对应组织编码 | string | |
Priority | 客户优先级 | string | |
InvoiceType | 发票类型 | string | |
TaxRate_Id | 默认税率_Id | string | |
TaxRate_Name | 默认税率名称 | string | |
TaxRate_Number | 默认税率_编码 | string | |
IsDefPayer | 默认付款方 | string | |
CPAdminCode | 订货平台管理员 | string | |
IsGroup | 集团客户 | string | |
INVOICETITLE | 发票抬头 | string | |
INVOICEBANKNAME | 开户银行 | string | |
INVOICEBANKACCOUNT | 银行账号 | string | |
INVOICETEL | 开票联系电话 | string | |
INVOICEADDRESS | 开票通讯地址 | string | |
IsTrade | 是否交易客户 | string | |
UncheckExpectQty | 不校验可发量 | string | |
F_lyzx_CheckBox | 以对账时价目交易 | string | |
BD_CUSTLOCATION | 联系人信息 | array | |
BD_CUSTLOCATION.ContactId | 联系人编码 | string | |
BD_CUSTLOCATION.CONTACT | 联系人名称 | string | |
BD_CUSTLOCATION.Job | 职务 | string | |
BD_CUSTLOCATION.BIZLOCNUMBER | 地点编码 | string | |
BD_CUSTLOCATION.BIZLOCATION | 地点名称 | string | |
BD_CUSTLOCATION.MOBILEPHONE | 移动电话 | string | |
BD_CUSTLOCATION.ContactEmail | 邮箱 | string | |
BD_CUSTLOCATION.BizAddress | 详细地址 | string | |
BD_CUSTLOCATION.IsDefaultConsigneeCT | 默认收货地址 | string | |
BD_CUSTLOCATION.ForbidContactStatus | 禁用状态 | string | |
BD_CUSTLOCATION.BD_CUSTBANK | 银行信息 | array | |
BD_CUSTLOCATION.BD_CUSTBANK.BANKCODE | 银行账号 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Id | 币别Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Name | 币别_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.CURRENCYID_Number | 币别编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.ACCOUNTNAME | 账户名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.ISDEFAULT | 默认 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.COUNTRY | 开户国家 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.OPENBANKNAME | 开户银行 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Id | 收款银行_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Name | 收款银行名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankTypeRec_Number | 收款银行_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.OpenAddressRec | 开户行地址 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.CNAPS | 联行号 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.FTextBankDetail | 网点名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Id | 银行网点Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Name | 银行网点_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BankDetail_Number | 银行网点编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT | 地址信息 | array | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.NUMBER | 地点编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.NAME | 地点名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.ADDRESS | 详细地址 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TRANSLEADTIME | 运输提前期 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TAXRATE | 税率 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultConsignee | 默认收货地址 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultSettle | 默认开票地址 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultPayer | 默认付款地址 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TTel | 固定电话 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.EMail | 电子邮箱 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.IsUsed | 启用 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Id | 联系人_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Name | 联系人名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.TContact_Number | 联系人_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.MOBILE | 移动电话 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.FLocationStatus | 地址禁用状态 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG | 订货组织 | array | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Id | 订货组织Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Name | 订货组织_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Number | 订货组织编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.ISDEFAULT | 默认 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT | 商务信息 | object | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.EnableSL | 启用商联在线 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeStatus | 冻结状态 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeLimit | 冻结范围 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Id | 冻结人_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Name | 冻结人名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Number | 冻结人_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeDate | 冻结日期 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.PROVINCE | 省份 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.CITY | 城市 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Id | 默认收货地点Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Name | 默认收货地点_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Number | 默认收货地点编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Id | 默认开票地点_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Name | 默认开票地点名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Number | 默认开票地点_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Id | 默认付款地点Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Name | 默认付款地点_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Number | 默认付款地点编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Id | 默认联系人_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Name | 默认联系人名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Number | 默认联系人_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.MarginLevel | 保证金比例(%) | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FDebitCard | 结算卡 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Id | 结算方Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Name | 结算方_名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Number | 结算方编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Id | 付款方_Id | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Name | 付款方名称 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Number | 付款方_编码 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FALLOWJOINZHJ | 允许对接智慧订货 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.IsContractMustInPut | 联系人必录 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ContractCount | 联系人数量 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT | 对应子账户信息 | array | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNTTYPE | 子账户类型 | string | |
BD_CUSTLOCATION.BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.BD_CUSTSUBACCOUNT.FSUBACCOUNT | 子账户号 | string |
四化智造MES(API)接口明细
- API:/api/createContactInfo
- NAME:新增客户联系人
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
---|---|---|---|
customerNo | 客户编码 | {{Number}} | |
contactInfos | 联系人信息 | BD_CUSTCONTACT | |
contactInfos.contactUuid | 联系人UUID | {{BD_CUSTCONTACT.Id}} | |
contactInfos.contactName | 联系人 | {{BD_CUSTCONTACT.TContact_Name}} | |
contactInfos.contactAddress | 地址 | {{BD_CUSTCONTACT.ADDRESS}} | |
contactInfos.contactPhone | 联系电话 | _function case '{{BD_CUSTCONTACT.MOBILE}}' when '' then '无' else '{{BD_CUSTCONTACT.MOBILE}}' end | |
contactInfos.email | 邮箱 | {{BD_CUSTCONTACT.EMail}} | |
contactInfos.position | 职位 | ||
contactInfos.contactCode | 联系人编码 | {{BD_CUSTCONTACT.TContact_Number}} | |
contactInfos.locationCode | 地点编码 | {{BD_CUSTCONTACT.NUMBER}} | |
contactInfos.locationName | 地点名称 | {{BD_CUSTCONTACT.NAME}} |
系统数据集成价值
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。