快速集成
按照以下步骤,就可以快速集成我们的功能:
1、请联系我们 获取appKey、appSecret
开放接口的技术服务,如需合作咨询,请联系我们。
2、下载并引入最新的sdk
1)使用以下方式添加maven依赖
<dependency>
<groupId>com.qixiangyun</groupId>
<artifactId>edf-agg-sdk</artifactId>
<version>{$version}</version>
</dependency>
2)添加依赖组件 HttpClient、fastjson
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.4.1</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.70</version>
</dependency>
最新的sdk版本和说明>>这里查看<<
3、编写集成代码,初始化sdk
参考以下代码,使用获取的appKey、appSecret初始化sdk>>这里查看<<
AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
apiHost是openapi接口的服务端域名 各个联调环境的域名请从 >>这里查看<<
4、需要先创建企业
在我们产品里,所有数据都基于企业来存储,所以在做业务之前,请首先创建企业
AggOpenAPI ttkOpenAPI = AggOpenApiClientFactory.getTtkOpenAPI(apiHost,appKey,appSecret);
//创建企业
JSONObject jsonObjectForOrg = new JSONObject();
jsonObjectForOrg.put("aggOrgName", "AAA");
jsonObjectForOrg.put("nsrsbh", "");
JSONObject jsonObject= ttkOpenAPI.createOrg(jsonObjectForOrg.toJSONString());
//jsonObject的格式参考文档的对应接口上的说明
if (jsonObject.getJSONObject("result").getBooleanValue("success")) {
TestParameter.orgId = Long.parseLong(jsonObject.getJSONObject("value").getString("aggOrgId"));
}
- 更多企业信息相关的接口和说明,请>>这里查看<<
5、打开申报清册页
获取集成页面的地址,嵌入到自己产品里就好了(例如在前端使用iframe嵌入页面)
AggOpenAPI ttkOpenAPI = AggOpenApiClientFactory.getTtkOpenAPI(apiHost,appKey,appSecret);
Long orgId = TestParameter.orgId;
String url = ttkOpenAPI.getWebUrl("ttk-tax-app-rpa-declare-payment",String.valueOf(orgId),null);
System.out.println("通用网页获取地址:" + url);
- 也可以根据规则自己组装跳转链接,跳转到企业可被集成的页面>>参考这里<<