开放平台技术对接文档
1 业务场景
已经确定好和税务服务对接的实施方案。第三方和用友开放平台税务服务接口集成,进行发票进销项业务相关的API对接。
2 对接流程
2.1生产环境ys/yb系统地址
2.2阅读文档
按照数据集成文档先添加授权key、授权相关接口
2.3下载示例代码
2.4 税务云常见对接场景接口调用流程图
点击上面标题可预览文件!!!该流程图为常见的业务场景接口调用顺序,仅供参考,实际场景按需选择接口即可,并非必须严格按照此流程。
黄色框为税务云的接口名称,可登录YB/YS,搜索【API文档】,按名称查找。如下图:
注意:票夹为C端产品,开放平台无此类接口。所以票夹场景的接口需要到税务云3.0接口文档 查找,且按照此文档方式进行对接。
3 示例代码使用
3.1 代码说明
请先阅读README.md文件,示例代码会不定期进行更新,同时也非常欢迎大家对测试代码提出优化建议和想法
3.2 配置信息介绍
1.将配置文件的信息替换为您自己环境的租户id和API调用授权key信息,包括:key、secret、租户id
2.如何获取key、secret? 操作步骤:菜单-搜索-API调用--查看.结果如下图
3.如何获取租户id? 首先必须为管理员权限,操作步骤:菜单-搜索-企业信息.结果如下图
3.3 运行示例代码调试接口
3.3.1 相关操作流程
以 开票申请-开蓝票 为例
直接在InvoiceApplyTest.java类中,运行对应的测试案例即可
注意:税务服务接口ContentType总共有三种方式,demo中有三种方式对应的调用示例,如下:
1.application/json 可参考InvoiceApplyTest.notInvoiceResult()方法
2.application/x-www-form-urlencoded 可参考InvoiceWillTest.insertWithArray()方法
3.multipart/form-data 可参考FinancialDataCollectionTest.financeDataUpload()方法
3.3.2 运行日志
通过控制台的请求日志,获取到发票请求流水号(建议保存下来),该流水号是业务方生成的唯一编号,后续相关的查询接口会用到
3.3.3 返回结果
3.3.4 平台页面对应节点
平台页面对应节点: 税务服务 -> 销项开票管理 -> 开票管理
3.3.5 开蓝票接口回调通知示例
由于目前开放平台文档未体现出开票成功或者失败的回调通知示例,故提供该文档地址了解回调的相关字段信息
4 系统基础配置信息
4.1 部分接口有业务上的拦截,需要在后台系统进行相应配置,如下
开票管理查不到开票数据,搜索菜单-授权-用户对应角色分配开票点
纳税主体未启用,搜索菜单-纳税主体启用
未绑定纳税人和组织, 搜索菜单-业务单元
未设置开票点, 搜索菜单-开票点档案
未授权开票类型, 搜索菜单-税盘设备管理
4.2 orgCode字段在销项开票与进项受票的接口中分别代表不同的业务含义
销项开票中orgCode字段代表【开票点编码】,如图:
进项受票中orgCode字段代表【会计主体编码】,如图: