会计科目Open API 接口(包含会计科目及科目表)原创
向阳者
9人赞赏了该文章
747次浏览
编辑于2021年07月06日 09:25:07
概述：会计科目（会计科目，科目表）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>"
}
}