技术对接文档

1 业务场景

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

2 登录测试环境

PC端访问税务云测试系统,地址:https://yesfp.yonyoucloud.com/cas/login 公用测试账号密码(sw4test/123456a)

  1. 企业用户登录:用于企业开票受票业务的API对接
  2. 个人用户登录:用于个人票夹相关业务的API对接

税务云测试系统界面

平台操作开票和受票

平台开票页面

3 示例代码使用

3.1 代码说明

代码提供了测试环境的所需要的配置文件和签名算法,测试类几乎涵盖了接口的所有测试案例,会不定期进行更新,同时也非常欢迎大家对测试代码提出优化建议和想法

3.2 下载示例代码

点击下载 最新示例代码

老代码地址(推荐:因为所有接口调用示例都包含):https://gitee.com/ufida-customer-success/yesfp-demo

新代码地址(有回调、企业微信以及钉钉对接个人票夹示例):https://gitee.com/ecological-technology/taxcloud-demo

3.3 运行示例代码调试接口

3.3.1 和 3.3.2 任选一个即可
根据新老代码提供对应的操作,新代码适用于熟悉springboot的技术人员;老代码适用于使用原生java开发的技术人员

3.3.1 新代码相关操作流程

以 开票-开蓝票接口 为例

代码的README.md文档详细介绍了该示例代码的使用说明,直接在InvoiceApplyTest.java类中,运行对应的测试案例即可

开票测试类展示

3.3.2 老代码相关操作流程

以 开票-开蓝票接口 为例

税务云OpenAPI中复制开票URL关键字:invoiceApply/insertWithArray

开蓝票关键URL

URLConfigEnum.java 类中寻找对应的接口:INSERT_WITH_ARRAY_URL

代码中的开票枚举

Ctrl+H 全局搜索开票枚举的接口测试类

全局搜索开票枚举

运行程序

开票测试类展示

返回结果展示

开票运行结果展示

3.3.3 平台页面展示

平台页面展示 -> 企业开票 -> 已开票 -> 输入流水号查询

平台开票页面展示

3.4 postman工具联调

postman工具联调,将示例代码返回的curl复制,打开postman工具(点击下载) -> 选择导入 -> 选择Raw text -> 粘贴 -> Continue

postman联调说明

报流水号已经存在,只需要重新赋值fpqqlsh字段即可

postman接口返回展示

3.5 正式环境的配置文件

原示例代码的配置文件和税务云测试环境是相对应的,如果需要切换其他环境只需要修改 URLConfigEnum.java的配置参数:KEY_PATH,PASSWORD,APPID,DOMAIN

示例代码配置参数信息

接口的正式环境域名(DOMAIN)

  1. 税务云:fapiao.yonyoucloud.com
  2. YonBIP/YonSuite:tax.diwork.com

APPID和对应证书文件及密码:
正式环境APPID获取方式(点击进入)

正式环境的接口问题请提工单

4 税务云OpenAPI常用说明

OpenAPI系统说明:https://fapiao.yonyoucloud.com/apidoc/system/

  • 提供了各个环境的域名信息、OpenAPI连通测试、返回状态码的说明和解决方法

OpenAPI地址:https://fapiao.yonyoucloud.com/apidoc/api/

  • 提供了销项开票、个人票夹、进项受票、OFD等接口文档

OpenAPI附录:https://fapiao.yonyoucloud.com/apidoc/appendix/

  • 提供了各票种的JSON示例和字段的枚举值

OpenAPI测试工具:https://fapiao.yonyoucloud.com/apidoc/testTools/

  • 税务云OpenAPI线上测试工具
Copyright © 用友 -【生态技术部】 2021 all right reserved,powered by Gitbook修订时间: 2022-06-29 15:37:46

results matching ""

    No results matching ""