TreeviewCopyright © aleen42 all right reserved, powered by aleen42
税务云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线上测试工具