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

1 业务场景

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

2 登录测试环境

yesfp测试系统访问地址以及登录方式咨询项目实施。（仅限用友内网登录企业用户）

平台操作开票和受票

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://c1.yonyoucloud.com/yonbip-fi-taxgateway
• 3.YB/YS核心二域名：https://c2.yonyoucloud.com/yonbip-fi-taxgateway
• 4.YB/YS核心三域名：https://c3.yonyoucloud.com/yonbip-fi-taxgateway

正式环境如何申请APPID、证书文件、密钥信息麻烦咨询项目实施

3.6 税务云3.0产品升级为YonBIP\YonSuite产品接口调整内容

• 1.首先只需要替换接口域名、证书、密钥、appid即可
• 2.域名按照您的租户数据中心进行选择。租户属于核心几环境请看订单信息或者找实施确认。
• 3.域名信息见上面3.5章节或者参考此文档：税务云域名信息

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示例和字段的枚举值