taxcloud-openapi-demo

使用步骤

自建应用接入模式

第一步：配置application.properties

配置以下信息

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

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

#获取租户所在数据中心域名
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=343543654fdsfsf5344536
ucf.mdd.open-api.app-secret=343543654fdsfsf
# TODO：api调用的应用信息------------end


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

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

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

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