概述:会计科目(会计科目,科目表)OpenApi文档
适用版本:EAS8.6.1
需更新补丁 PTM158682
一. 模块:会计科目Open API 接口
1. 新增会计科目到EAS的接口方法--String importAccountViewData(String xmlData);
接口名称:ImportAccountViewFacade-importAccountViewData
元数据别名:会计科目webService接口
接口简介:导入会计科目数据,用于第三方系统向EAS同步会计科目数据
接口描述:导入会计科目,用于第三方系统向EAS同步会计科目,目前参数类型为xml格式,请参照调用示例参数编写。
1.1 参数
入参:
参数名称 | 必录 | 类型 | 描述 |
---|---|---|---|
xmlData | 是 | String | 对应body的 参数1 ,参数值是一段xml字符串,入参示例见请求示例 |
如下是具体的 入参 xmlData中元素的含义:
参数名称 | 必录 | 描述 |
bostype | 是 | 会计科目提示对应BosType ,一般为9DA99826 |
CU | 是 | 所属管理单元 |
creator | 是 | 创建人(用户编码) |
name | 是 | 科目名称 |
number | 是 | 科目编码 |
level | 是 | 科目级次 |
companyID | 是 | 创建财务组织编码 |
DC | 是 | 科目余额方向 -1贷;1借 |
isCash | 是 | 是否现金科目 |
isBank | 是 | 是否银行科目 |
isCashEquivalent | 是 | 是否现金等价物 |
controlLevel | 是 | 控制级次 |
PLType | 是 | 损益类别(查看对应枚举图片) |
diffType | 是 | 差异化类别(查看对应枚举图片) |
longNumber | 是 | 长编码 |
accrualDirection | 是 | 发生额方向(查看对应枚举图片) |
createTime | 否 | 创建时间 |
displayName | 否 | 默认展示名称 |
accountTableID | 是 | 科目表编码 |
accountTypeID | 是 | 科目类型编码 |
parent | 是 | 上级科目 |
出参:
参数名称 | 类型 | 参数说明 |
---|---|---|
errorCode | int | 调用openapi标识,0:成功;1:失败 |
errMsg | String | 记录调用openapi操作信息 |
data | String | 是一段xml信息,存储业务操作记录,xml信息如下表: |
data中的xml字段:
参数名称 | 参数说明 |
---|---|
retstatus | 业务返回标示,0:成功;1:失败 |
errorMessage | 记录业务操作失败信息 |
损益类别对应枚举值:
差异化类别对应枚举值:
发生额方向对应枚举值:
1.2 调用样例
String ip = "172.17.6.176"; int port = 8080; String userName = "zj003"; String password = ""; String dcName = "EAS860NEW"; String language = "l2"; String xmlData = "<DataInfo bostype=\"9DA99826\" op=\"4\"> <DataHead> <creator>user</creator> <createTime>2012-06-11 09:28:46</createTime> <CU>01</CU> <number>1001</number> <name>损益科目</name> ... </DataHead> </DataInfo>"; EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port, new CommonLogin.Builder(userName, password, dcName, language) //.appid("test") .build()) .https(false)//是否https .build(); OpenApiInfo info = new OpenApiInfo(); info.setApi("ImportAccountViewFacade-importAccountViewData"); info.setData("示例中的xmlData数据"); OpenApi openApi = OpenApiFactory.getService(loginCtx); String result = openApi.invoke(info); System.out.println("----------result:" + result);
第三方依赖包:
openapi-server.jar
sp-openapi-server.jar
log4j-1.2.15.jar
fastjson-1.2.58.jar
PS:
OpenAPI用户手册可参考 https://vip.kingdee.com/article/98349464997083392
1.3 请求样例
{ "api": "ImportAccountViewFacade-importAccountViewData", "data": [ "<DataInfo bostype=\"9DA99826\" op=\"4\"> <DataHead> <creator>user</creator> <CU>01</CU> <name>1008.01</name> <number>1008.01</number> <level>2</level> <companyID>01</companyID> <DC>1</DC> <isCash>true</isCash> <isBank>false</isBank> <isCashEquivalent>false</isCashEquivalent> <controlLevel>2</controlLevel> <PLType>0</PLType> <accountingcurrency>0</accountingcurrency> <diffType>0</diffType> <longNumber>1008!1008.01</longNumber> <accrualDirection>10</accrualDirection> <createTime>2021-04-12 00:00:00</createTime> <displayName>库存现金</displayName> <accountTableID>01</accountTableID> <accountTypeID>001</accountTypeID> <longName>库存现金</longName> <parent>1001</parent> </DataHead> </DataInfo>" ] }
1.4 返回样例:
{ "errCode": 0, "errMsg":" 执行成功", "data":{ "<Result> <retstatus>0</retstatus> <errorMessages> <errorMessage number=”zhaosi”> 如:编码重复; </errorMessage> </errorMessages> </Result>" } }
2. ImportAccountTableFacade-importAccountTableData(导入科目表)
接口名称:
元数据别名:科目表webService接口
接口简介:导入科目表数据,用于第三方系统向EAS同步科目表数据
接口描述:导入科目表,用于第三方系统向EAS同步科目表,目前参数类型为xml格式,请参照调用示例参数编写。
2.1 参数
入参:
参数名称 | 必录 | 类型 | 描述 |
---|---|---|---|
xmlData | 是 | String | 对应body的 参数 ,参数值是一段xml字符串,入参示例见请求示例 |
如下是具体的 入参 xmlData中元素的含义:
参数名称 | 必录 | 描述 |
bostype | 是 | 科目表提示对应BosType ,一般为9DA99826 |
CU | 是 | 所属管理单元 |
creator | 是 | 创建人(用户编码) |
name | 是 | 科目表名称 |
number | 是 | 科目表编码 |
isUserLevel | 是 | 用户自定义级次(只能设为false) |
simpleName | 否 | 简称 |
description | 否 | 描述 |
isUseSeparator | 是 | 是否使用分隔符 |
separator | 是 | 分隔符 |
isControlNumber | 是 | 是否控制编码(只能设为false) |
company | 是 | 创建财务组织 |
出参:
参数名称 | 类型 | 参数说明 |
---|---|---|
errorCode | int | 调用openapi标识,0:成功;1:失败 |
errMsg | String | 记录调用openapi操作信息 |
data | String | 是一段xml信息,存储业务操作记录,xml信息如下表: |
data中的xml字段:
参数名称 | 参数说明 |
---|---|
retstatus | 业务返回标示,0:成功;1:失败 |
errorMessage | 记录业务操作失败信息 |
2.2 调用样例
String ip = "172.17.6.176"; int port = 8080; String userName = "zj003"; String password = ""; String dcName = "EAS860NEW"; String language = "l2"; String xmlData = "<DataInfo bostype=\"17698E6D\" op=\"4\"> <DataHead> <creator>user</creator> <createTime>2012-06-11 09:28:46</createTime> <CU>01</CU> <number>001</number> <name>集团科目表</name> ... </DataHead> </DataInfo>"; EASLoginContext loginCtx = new EASLoginContext.Builder(ip, port, new CommonLogin.Builder(userName, password, dcName, language) //.appid("test") .build()) .https(false)//是否https .build(); OpenApiInfo info = new OpenApiInfo(); info.setApi("ImportAccountTableFacade-importAccountTableData"); info.setData("示例中的xmlData数据"); OpenApi openApi = OpenApiFactory.getService(loginCtx); String result = openApi.invoke(info); System.out.println("----------result:" + result);
第三方依赖包:
openapi-server.jar
sp-openapi-server.jar
log4j-1.2.15.jar
fastjson-1.2.58.jar
PS:
OpenAPI用户手册可参考 https://vip.kingdee.com/article/98349464997083392
2.3 请求样例
{ "api": "ImportAccountTableFacade-importAccountTableData", "data": [ "<DataInfo bostype=\"17698E6D\" op=\"4\"> <DataHead> <creator>user</creator> <CU>01</CU> <name>openAPI科目表</name> <number>20210412</number> <isUserLevel>false</isUserLevel> <createTime>2021-04-12 00:00:00</createTime> <simpleName>openAPI科目表</simpleName> <description></description> <isUseSeparator>1</isUseSeparator> <separator>-</separator> <isControlNumber>false</isControlNumber> <company>01</company> </DataHead> </DataInfo>" ] }
2.4 返回样例:
{ "errCode": 0, "errMsg":" 执行成功", "data":{ "<Result> <retstatus>0</retstatus> <errorMessages> <errorMessage number=”zhaosi”> 如:编码重复; </errorMessage> </errorMessages> </Result>" } }