企享云API(适配版本)
  1. 快速开始
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
        • 自然人异步登录发送验证码接口
        • 异步登录校验税局缓存是否有效
        • 异步登录税局【发送短信验证码】
        • 扫码登录税局(二维码获取)
        • 扫码登录税局(二维码登录)
        • 异步登录税局【上传短信验证码登录】
        • 自然人异步登录税局【上传短信验证码登录】
        • 上传cookie接口
      • 校验appkey是否账户自持
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 发票查验
      • 简介
      • 发票查验
      • 税号版数电票查验及版式文件下载
      • 发票查验版式文件下载结果查询
    • 发票认证
      • 简介
      • 发票勾选/代购代缴完税凭证勾选
      • 进项发票勾选结果查询
      • 海关缴款书勾选
      • 海关缴款书勾选结果查询
      • 申请统计接口
      • 发票同步
      • 海关缴款书同步
      • 申请统计
      • 申请统计结果查询
      • 抵扣统计结果获取
      • 多票采集接口
      • 申请确认
      • 申请确认结果查询
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 快速开始

SDK集成

SDK说明#

  为简化ISV接入操作步骤,我们提供了服务端SDK,SDK是企享云提供给ISV的软件开发工具包,降低ISV接入难度,聚焦业务数据,快速开发上线。使用SDK可以提升开发效率,主要原因包括:
SDK提供了结构化的API请求入参,对API调用提供了公共调用结构化封装。
SDK提供了完整的访问凭证(access_token)生命周期管理能力,无需开发者自己获取并刷新访问凭证。
SDK内API和事件上都添加了文字注释方便调用。
SDK提供了简洁明了、易懂的使用文档。
  目前我们仅提供了Java语言的SDK,核心文件edf-agg-sdk.jar,其他语言后续提供支持。在使用SDK的过程中,如果遇到问题,请联系我们的客服。

SDK调用#

下载SDK#

SDK下载 1.0.13(https://repo1.maven.org/maven2/io/github/qixiangyun/edf-agg-sdk/1.0.13/edf-agg-sdk-1.0.13.jar)

引入SDK#

1)使用以下方式添加maven依赖
<dependency>
    <groupId>io.github.qixiangyun</groupId>
    <artifactId>edf-agg-sdk</artifactId>
    <version>1.0.13</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调用#

参考以下代码,使用获取的appKey、appSecret初始化sdk
    AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
参数名称参数类型说明
apiHostString对接地址
appKeyString分配的账号
appSecretString分配的秘钥

调用示例#

AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
JSONObject param = new JSONObject();
JSONObject result = new JSONObject();
JSONArray fpcyQueryList = new JSONArray();
JSONObject fpcy = new JSONObject();
fpcyQueryList.add(fpcy);
fpcy.put("fpdm", "11002121**");
fpcy.put("fphm", "092841**");
fpcy.put("kprq", "2021-09-06");
fpcy.put("je", 123.45);
param.put("cyList", fpcyQueryList);
// 通用接口调用,传入接口地址和业务参数(json 格式字符串)
result = openAPI.rest("/v2/invoice/cy", param.toJSONString());
System.out.println(JSON.toJSONString(result));
AggOpenAPI 处理了 access token 的缓存,请保持单例调用,不要多次实例化
上一页
对接地址
下一页
认证鉴权
Built with