技术对接文档
1 业务场景
前提条件:已经确定好和税务服务对接的实施方案。
第三方和用友开放平台税务服务集成,进行进销项业务相关的API对接。
2 注册应用
PC端访问生产环境系统地址:https://yonsuite.diwork.com/#/
登录账号密码:19903888888/yonyou@1988@2021,租户名称:1009税务旗舰上线
以上为测试账户信息,仅供调试使用,实际对接中建议用户使用自己的账户信息进行调试
2.1按照入门先进行应用注册、接口服务授权、以及下载demo
切换租户页面
3 示例代码使用
3.1 代码说明
代码提供了生产环境的所需要的配置文件和获取token的方法,com.yonyou.isv.demo.openapi.api.tax.apitest包下的测试类涵盖了税务服务接口的所有测试案例,会不定期进行更新,同时也非常欢迎大家对测试代码提出优化建议和想法
3.2 代码介绍
1.配置文件切换为生产环境的配置文件,以及将配置文件中红框内的信息替换为您自己的租户和应用信息,包括:code、key、secret、租户id
2.如何获取code、key、secret? 操作步骤:菜单-搜索-我的应用-列表搜索应用名称-开放平台按钮-Api授权.结果如下图
3.3 运行示例代码调试接口
3.3.1 相关操作流程
以 开票申请-开蓝票 为例
代码的README.md文档详细介绍了该示例代码的使用说明,直接在InvoiceApplyTest.java类中,运行对应的测试案例即可
注意:税务服务接口ContentType总共有三种方式,demo中有三种方式对应的调用示例,如下:
1.application/json 可参考InvoiceApplyTest.insertWithArray()方法
2.application/x-www-form-urlencoded 可参考InvoiceWillTest.notInvoiceResult()方法
3.multipart/form-data 可参考FinancialDataCollectionTest.financeDataUpload()方法
3.3.2 运行日志
3.3.3 返回结果
3.3.4 平台页面展示
平台页面展示 -> 税务服务 -> 销项开票管理 -> 开票管理
3.4 注意事项
1.部分接口有业务上的拦截,需要在后台进行配置,比如
未绑定纳税人和组织 搜索-业务单元
未授权开票类型 搜索-税盘设备管理
未设置开票点 搜索-开票点档案
2.正式环境的接口问题请提工单