金蝶云星空和四化智造MES（API）接口打通对接实战

来源系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

接通系统：四化智造MES（API）

MES建立统一平台上通过物料防错防错、流程防错、生产统计、异常处理、信息采集和全流程追溯等精益生产和精细化管理，帮助企业合理安排生产排程、优化工艺流程、改善产品质量、降低能源损耗、降低制造成本，提高执行效率，全面提升和改善企业制造能力，为企业打造可视化、透明化、数字化、智能化工厂。通过手机移动APP实时的数据查询和分析报表，为企业高层提供快速决策支持，以便针对市场变化快速准确地作出反应，综合提升企业的市场竞争力。

多系统对接方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：四化智造MES（API），把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

• API：ExecuteBillQuery

• NAME：逐个单据查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	BD_Customer	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
DocumentStatus	单据状态
ForbidStatus	禁用状态
Name	客户名称
Number	客户编码
Description	备注
CreateOrgId_Id	创建组织Id
CreateOrgId_Name	创建组织_名称
CreateOrgId_Number	创建组织编码
UseOrgId_Id	使用组织_Id
UseOrgId_Name	使用组织名称
UseOrgId_Number	使用组织_编码
CreatorId_Id	创建人Id
CreatorId_Name	创建人_名称
CreatorId_Number	创建人编码
ModifierId_Id	修改人_Id
ModifierId_Name	修改人名称
ModifierId_Number	修改人_编码
CreateDate	创建日期
FModifyDate	修改日期
ShortName	简称
COUNTRY	国家
PROVINCIAL	地区
FZIP	邮政编码
TEL	联系电话
FTAXREGISTERCODE	纳税登记号
FAX	传真
FGROUPCUSTID_Id	对应集团客户Id
FGROUPCUSTID_Name	对应集团客户_名称
FGROUPCUSTID_Number	对应集团客户编码
FSUPPLIERID_Id	对应供应商_Id
FSUPPLIERID_Name	对应供应商名称
FSUPPLIERID_Number	对应供应商_编码
TRADINGCURRID_Id	结算币别Id
TRADINGCURRID_Name	结算币别_名称
TRADINGCURRID_Number	结算币别编码
SALDEPTID_Id	销售部门_Id
SALDEPTID_Name	销售部门名称
SALDEPTID_Number	销售部门_编码
SALGROUPID_Id	销售组Id
SALGROUPID_Name	销售组_名称
SALGROUPID_Number	销售组编码
SELLER_Id	销售员_Id
SELLER_Name	销售员名称
SELLER_Number	销售员_编码
TRANSLEADTIME	运输提前期
PRICELISTID_Id	价目表Id
PRICELISTID_Name	价目表_名称
PRICELISTID_Number	价目表编码
DISCOUNTLISTID_Id	折扣表_Id
DISCOUNTLISTID_Name	折扣表名称
DISCOUNTLISTID_Number	折扣表_编码
SETTLETYPEID_Id	结算方式Id
SETTLETYPEID_Name	结算方式_名称
SETTLETYPEID_Number	结算方式编码
RECEIVECURRID_Id	收款币别_Id
RECEIVECURRID_Name	收款币别名称
RECEIVECURRID_Number	收款币别_编码
RECCONDITIONID_Id	收款条件Id
RECCONDITIONID_Name	收款条件_名称
RECCONDITIONID_Number	收款条件编码
FISCREDITCHECK	启用信用管理
APPROVERID_Id	审核人_Id
APPROVERID_Name	审核人名称
APPROVERID_Number	审核人_编码
APPROVEDATE	审核日期
FORBIDDERID_Id	禁用人Id
FORBIDDERID_Name	禁用人_名称
FORBIDDERID_Number	禁用人编码
FORBIDDATE	禁用日期
TaxType	税分类
CustTypeId	客户类别
ADDRESS	通讯地址
WEBSITE	公司网址
FGroup_Id	客户分组_Id
FGroup_Name	客户分组名称
FGroup_Number	客户分组_编码
CompanyScale	公司规模
CompanyType	公司类别
CompanyNature	公司性质
CorrespondOrgId_Id	对应组织Id
CorrespondOrgId_Name	对应组织_名称
CorrespondOrgId_Number	对应组织编码
Priority	客户优先级
InvoiceType	发票类型
TaxRate_Id	默认税率_Id
TaxRate_Name	默认税率名称
TaxRate_Number	默认税率_编码
IsDefPayer	默认付款方
CPAdminCode	订货平台管理员
IsGroup	集团客户
INVOICETITLE	发票抬头
INVOICEBANKNAME	开户银行
INVOICEBANKACCOUNT	银行账号
INVOICETEL	开票联系电话
INVOICEADDRESS	开票通讯地址
IsTrade	是否交易客户
UncheckExpectQty	不校验可发量
BD_CUSTBANK	银行信息
BD_CUSTBANK.BANKCODE	银行账号

四化智造MES（API）接口明细

• API：/api/createCustomer

• NAME：新增客户信息

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
customerName	客户名称	{{ShortName.0.Value}}
customerFullName	客户全称	{{Name}}
contactName	联系人名称	{{BD_CUSTCONTACT.TContact_Name}}
contactPhone	联系人电话	{{BD_CUSTCONTACT.MOBILE}}
customerCode	客户简码	{{Number}}
currency	币种(1:人民币,2:美元,3:欧元)	1
taxPoints	税分类(1:3%,2:6%,3:12%,4:22%)	0.13
customerNo	客户流水号	{{Number}}
contactInfos	联系人信息	BD_CUSTCONTACT
contactInfos.contactUuid	联系人UUID	{{BD_CUSTCONTACT.Id}}
contactInfos.contactName	联系人	{{BD_CUSTCONTACT.TContact_Name}}
contactInfos.contactAddress	地址	{{BD_CUSTCONTACT.ADDRESS}}
contactInfos.contactPhone	联系电话	{{BD_CUSTCONTACT.MOBILE}}
contactInfos.email	邮箱	{{BD_CUSTCONTACT.EMail}}
contactInfos.position	职位
contactInfos.contactCode	联系人编码	{{BD_CUSTCONTACT.TContact_Number}}
contactInfos.locationCode	地点编码	{{BD_CUSTCONTACT.NUMBER}}
contactInfos.locationName	地点名称	{{BD_CUSTCONTACT.NAME}}

系统对接总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。