金蝶云星空与畅捷通T+对接集成逐个单据查询打通凭证创建
来源系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:畅捷通T+
“T+”是一款灵动、智慧、时尚的互联网管理软件，主要针对中小型工贸和商贸企业的财务业务一体化应用，融入了社交化、移动化、物联网、电子商务、互联网信息订阅等元素。产品全面适应最新2013《小企业会计准则》，为企业打造全新的生意模式、管理模式、工作模式。与传统管理软件相比，“T+”更强调企业管理向企业经营的转变、等级化管人向平等化用人理念的转变。
系统对接接口配置
数据集成平台对应的配置金蝶云星空与畅捷通T+的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与畅捷通T+之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶云星空接口明细
- API：ExecuteBillQuery
- NAME：逐个单据查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | GL_VOUCHER | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| BillNo | 凭证编号 | | |
| AccountBookID_Id | 账簿Id | | |
| AccountBookID_Name | 账簿_名称 | | |
| AccountBookID_Number | 账簿编码 | | |
| Date | 日期 | | |
| VOUCHERGROUPID_Id | 凭证字_Id | | |
| VOUCHERGROUPID_Name | 凭证字名称 | | |
| VOUCHERGROUPID_Number | 凭证字_编码 | | |
| ATTACHMENTS | 附件数 | | |
| YEAR | 会计年度 | | |
| PERIOD | 期间 | | |
| DEBITTOTAL | 借方总金额 | | |
| FCREDITTOTAL | 贷方总金额 | | |
| Invalid | 作废状态 | | |
| CHECKERID_Id | 审核Id | | |
| CHECKERID_Name | 审核_名称 | | |
| CHECKERID_Number | 审核编码 | | |
| POSTERID_Id | 过账_Id | | |
| POSTERID_Name | 过账名称 | | |
| POSTERID_Number | 过账_编码 | | |
| CASHIERID_Id | 出纳Id | | |
| CASHIERID_Name | 出纳_名称 | | |
| CASHIERID_Number | 出纳编码 | | |
| AuditDate | 审核日期 | | |
| DocumentStatus | 审核状态 | | |
| FCreatorId_Id | 制单_Id | | |
| FCreatorId_Name | 制单名称 | | |
| FCreatorId_Number | 制单_编码 | | |
| FCreateDate | 创建日期 | | |
| ISADJUSTVOUCHER | 是否调整期凭证 | | |
| FSystemID_Id | 来源系统Id | | |
| FSystemID_Name | 来源系统_名称 | | |
| FSystemID_Number | 来源系统编码 | | |
| FSourceBillKey_Id | 业务类型_Id | | |
| FSourceBillKey_Name | 业务类型名称 | | |
| FSourceBillKey_Number | 业务类型_编码 | | |
| FBASECURRENCYID_Id | 本位币(辅助)Id | | |
| FBASECURRENCYID_Name | 本位币(辅助)_名称 | | |
| FBASECURRENCYID_Number | 本位币(辅助)编码 | | |
| ACCBOOKORGID_Id | 核算组织_Id | | |
| ACCBOOKORGID_Name | 核算组织名称 | | |
| ACCBOOKORGID_Number | 核算组织_编码 | | |
| ISCASHFLOW | 已指定现金流量项目 | | |
| IsSplit | 是否拆分 | | |
| VOUCHERGROUPNO | 凭证号 | | |
| FModifierId_Id | 修改人Id | | |
| FModifierId_Name | 修改人_名称 | | |
| FModifierId_Number | 修改人编码 | | |
| FModifyDate | 修改日期 | | |
| F_GL_PrintTimes | 打印次数 | | |
| IMPORTVERSION | 引入版本号 | | |
| DepositIn | 转存信息-转入 | | |
| DepositOut | 转存信息-转出 | | |
| BUSDATE | 业务日期 | | |
| FPostDate | 过账日期 | | |
| FISREDWRITEOFF | 是否已冲销 | | |
| GL_VOUCHERENTRY | 分录 | | |
| GL_VOUCHERENTRY.FEXPLANATION | 摘要 | | |
| GL_VOUCHERENTRY.FACCOUNTID_Id | 科目编码_Id | | |
| GL_VOUCHERENTRY.FACCOUNTID_Name | 科目编码名称 | | |
| GL_VOUCHERENTRY.FACCOUNTID_Number | 科目编码_编码 | | |
| GL_VOUCHERENTRY.FCURRENCYID_Id | 币别Id | | |
| GL_VOUCHERENTRY.FCURRENCYID_Name | 币别_名称 | | |
| GL_VOUCHERENTRY.FCURRENCYID_Number | 币别编码 | | |
| GL_VOUCHERENTRY.EXCHANGERATETYPE_Id | 汇率类型_Id | | |
| GL_VOUCHERENTRY.EXCHANGERATETYPE_Name | 汇率类型名称 | | |
| GL_VOUCHERENTRY.EXCHANGERATETYPE_Number | 汇率类型_编码 | | |
| GL_VOUCHERENTRY.EXCHANGERATE | 汇率 | | |
| GL_VOUCHERENTRY.AMOUNTFOR | 原币金额 | | |
| GL_VOUCHERENTRY.DEBIT | 借方金额 | | |
| GL_VOUCHERENTRY.FCREDIT | 贷方金额 | | |
| GL_VOUCHERENTRY.DC | 借贷方向 | | |
| GL_VOUCHERENTRY.SettleTypeID_Id | 结算方式Id | | |
| GL_VOUCHERENTRY.SettleTypeID_Name | 结算方式_名称 | | |
| GL_VOUCHERENTRY.SettleTypeID_Number | 结算方式编码 | | |
| GL_VOUCHERENTRY.FAmount | 本位币金额 | | |
| GL_VOUCHERENTRY.FSETTLENO | 结算号 | | |
| GL_VOUCHERENTRY.FCASHFLOWITEM | 是否已指定现金流量 | | |
| GL_VOUCHERENTRY.FISMULTICOLLECT | 是否参与多栏账汇总 | | |
| GL_VOUCHERENTRY.Qty | 数量 | | |
| GL_VOUCHERENTRY.Price | 单价 | | |
| GL_VOUCHERENTRY.UnitId_Id | 单位_Id | | |
| GL_VOUCHERENTRY.UnitId_Name | 单位名称 | | |
| GL_VOUCHERENTRY.UnitId_Number | 单位_编码 | | |
| GL_VOUCHERENTRY.AcctUnitQty | 科目单位数量 | | |
| GL_VOUCHERENTRY.BaseUnitQty | 计量单位数量 | | |
| GL_VOUCHERENTRY.EXPORTENTRYID | 现金流量#分录ID | | |
| GL_VOUCHERENTRY.BUSNO | 业务编号 | | |
畅捷通T+接口明细
- 接口：/tplus/api/v2/doc/Create
- 接口名称：凭证创建
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| ExternalCode | 外部编码 | string | 字符串长度<50 |
| DocType | 凭证字 | string | |
| Code | 数字(09)> 0 | string | 数字(09)> 0，必须全部是数字不能有其他符号；长度由系统设置，[系统管理]--[单据设置]—[单据编码设置]—[凭证]—[流水号长度]如果长度不够，前面补0；如果不传值，会按照规则取号 |
| VoucherDate | 制单日期 | string | |
| IsModifiedCode | 是否修改编号 | string | 是否修改编号，取值"true"/"false" |
IsModifiedCode:"true"，则用参数中的Code作为凭证编号；手工编码时必录(IsModifiedCode:"true")|
|AttachedVoucherNum|附单据数|string|数字[0，9999]|
|Memo|备注|string|字符串长度<50|
|DynamicPropertyKeys|表头动态属性|string|表头自定义项列：公用数值自定义项（pubuserdefdecm），公用字符自定义项（pubuserdefnvc），专用数值自定义项 （priuserdefdecm），专用字符自定义项（priuserdefnvc）|
|DynamicPropertyValues|表头动态属性的值|string|表头动态属性的值,与上面DynamicPropertyKeys相对应|
|Entrys|Entrys|array| |
|Entrys.Summary|摘要|string|字符串长度<200|
|Entrys.Account|科目档案|string|必须是末级科目|
|Entrys.ExchangeRate|汇率|string|科目启用外币核算必输，否则默认1|
|Entrys.Currency|货币|string|举例：Currency: { Code: "RMB" }|
|Entrys.AmountCr|贷方本币|string| |
|Entrys.QuantityCr|贷方数量|string| |
|Entrys.AmountDr|借方本币|string| |
|Entrys.QuantityDr|借方数量|string| |
|Entrys.Price|单价|string| |
|Entrys.Unit|计量单位|string| |
|Entrys.AuxInfos|辅助核算项|string| |
|Entrys.dataKey|dataKey|string| |
数据对接效果
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
