税务云3.0接口技术对接文档

1 业务场景

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

2 登录测试环境

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

  • 1.企业用户登录:用于企业开票受票业务的API对接(需要有用友VPN才能登录,点击【获取验证码】后再输入验证码666666即可登录成功)
  • 2.个人用户登录:用于个人票夹相关业务的API对接

税务云测试系统界面

平台操作开票和受票

平台开票页面

3 示例代码使用

3.1 代码说明

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

3.2 下载示例代码

点击下载

3.3 运行示例代码调试接口

3.3.1 代码示例相关操作流程

以 开票-开蓝票接口 为例

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

开票测试类展示

3.3.2 平台页面展示

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

平台开票页面展示

3.4 postman工具联调

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

postman联调说明

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

postman接口返回展示

3.5 正式环境的配置文件

接口的正式环境域名

正式环境申请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 © 用友 -【生态技术部】 2022-2023 all right reserved,powered by Gitbook修订时间: 2023-03-14 11:13:47

results matching ""

    No results matching ""