税务云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

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

3.5 正式环境的配置文件

接口的正式环境域名

• 1.税务云3.0域名：https://fapiao.yonyoucloud.com
• 2.YB/YS核心一域名：https://yonbip-core1.diwork.com/yonbip-fi-taxgateway
• 3.YB/YS核心二域名：https://tax.diwork.com
• 4.YB/YS核心三域名：https://yonbip-core3.diwork.com/yonbip-fi-taxgateway

正式环境申请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线上测试工具