技术对接文档

1 业务场景

前提条件:已经确定好和税务服务对接的实施方案。
第三方和用友开放平台税务服务集成,进行进销项业务相关的API对接。

2 注册应用

PC端访问生产环境系统地址:https://yonsuite.diwork.com/#/

登录账号密码:19903888888/yonyou@1988@2021,租户名称:1009税务旗舰上线

以上为测试账户信息,仅供调试使用,实际对接中建议用户使用自己的账户信息进行调试

2.1按照入门先进行应用注册、接口服务授权、以及下载demo

开放平台接口调用视频资料
YonSuite生产环境登录页面

切换租户页面

切换租户页面

3 示例代码使用

3.1 代码说明

代码提供了生产环境的所需要的配置文件和获取token的方法,com.yonyou.isv.demo.openapi.api.tax.apitest包下的测试类涵盖了税务服务接口的所有测试案例,会不定期进行更新,同时也非常欢迎大家对测试代码提出优化建议和想法

3.2 代码介绍

1.配置文件切换为生产环境的配置文件,以及将配置文件中红框内的信息替换为您自己的租户和应用信息,包括:code、key、secret、租户id

配置文件介绍

2.如何获取code、key、secret? 操作步骤:菜单-搜索-我的应用-列表搜索应用名称-开放平台按钮-Api授权.结果如下图 code、key、secret

3.如何获取租户id? 操作步骤:菜单-搜索-企业信息.结果如下图 租户id

4.调用接口代码位置 税务服务接口调用示例

5.测试类代码位置 测试工具类

6.生成token代码位置 获取token方法

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.正式环境的接口问题请提工单

Copyright © 用友 -【生态技术部】 2021 all right reserved,powered by Gitbook修订时间: 2022-07-28 18:43:24

results matching ""

    No results matching ""