# taxcloud-openapi-demo

**Repository Path**: nsdnsd/taxcloud-openapi-demo

## Basic Information

- **Project Name**: taxcloud-openapi-demo
- **Description**: 对接开放平台的税务服务接口示例代码
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2024-12-16
- **Last Updated**: 2024-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# taxcloud-openapi-demo

## 使用步骤

### 自建应用接入模式

#### 第一步：配置application.properties

配置以下信息

```properties

#本示例仅有商开、生产两个配置文件，通过切换以下参数可切换到不同环境
# TODO:商开：sandbox， 核心1、2、3：production
spring.profiles.active=production

```

根据自己的环境，选择填写信息

```properties

#获取租户所在数据中心域名
ucf.mdd.open-api.gateway-address-url=https://apigateway.yonyoucloud.com/open-auth/dataCenter/getGatewayAddress?tenantId=%s

# TODO：api调用的应用信息------------begin
ucf.mdd.open-api.app-key=3435436******sf5344536
ucf.mdd.open-api.app-secret=3435*****dsfsf
# TODO：api调用的应用信息------------end


#TODO:自建接入tenantId需要填写
ucf.mdd.default-tenantId = 42***432

```

#### 第二步：根据提示重写下列方法

- 多数据中心实现类，不建议每次都调用接口，租户一旦创建所属数据中心不会再改变，建议将租户地址对应关系持久化到数据库和缓存中

com.yonyou.isv.demo.openapi.base.datacenter.impl.QueryDataCenterUrlProviderImpl

- 缓存token实现类，建议对token进行缓存(有效期两个小时，有效期不足半小时后可重新获取刷新token)，不建议每次调用业务接口都获取token

com.yonyou.isv.demo.openapi.base.module.token.OpenApiTokenCacheProviderImpl

#### 第三步：自建接入方式

- 了解基本操作

https://doc.yonisv.com/mybook/selfbuild/1-/selfbuild_enter.html

#### 第四步：测试

- 回到本项目

src/test  找到自己需要的测试类测试即可

## 接口示例

- 税务服务      
	- 销项开票-扫码开票、发票打印、开票申请、红字信息表   /src/test/java/com/yonyou/isv/demo/openapi/api/tax/apitest/InvoiceApplyTest.java                          
    - 销项开票-未开票收入管理测试   /src/test/java/com/yonyou/isv/demo/openapi/api/tax/apitest/InvoiceWillTest.java       
    - 进项受票-报销台账（全票中和非全票种）   /src/test/java/com/yonyou/isv/demo/openapi/api/tax/apitest/ReimburseLedgerTest.java 
    - 财务数据采集-财务数据上传   /src/test/java/com/yonyou/isv/demo/openapi/api/tax/apitest/FinancialDataCollectionTest.java
    - 接收回调通知服务示例   com.yonyou.isv.demo.openapi.controller.CallbackController