关于税务云销项开票的回调问题解决方案

1.前言

经常会有开发问到:老师,调税务云开票接口,我的回调服务为什么没有接收到请求?老师,我的服务挂掉了,税务云还会再进行回调吗?等等...问题,其实这些问题的根本原因还是对开票流程的不熟悉。那么今天我们就来一一盘点下税务云开票配置回调时踩过的坑。

2.简介

回调服务:调用开票接口成功后,开票状态码为开票成功或开票失败,税务云会向回调配置对应的服务地址最多发起三次POST请求,传输开票相关的数据和信息,时间间隔三分钟,第一次成功就不会再发起。

3.回调配置流程

与税务云进行对接,一般都是先在 测试环境(点击获取) 调通,再上正式环境。
那么在测试环境开票时,首先得保证开票状态是成功或者失败,而不是处于开票中的状态。
如下图,就是利用测试代码拟写好的示例,调用开票接口(如果报流水号重复更改下fpqqlsh字段即可)
图一

确认开票状态是否成功,有两种方式

  1. 通过开票状态查询接口 图二
  2. 税务云平台进行查询,登录税务云测试平台,企业登录-> 企业开票 -> 已开票 -> 输入流水号 即可
    图三
    那么开票接口请求成功后,并且开票状态成功或失败,税务云就会立马通知回调服务,如果访问超时或失败,则会继续发起请求,最多三次。当回调服务接收到税务云发送的请求数据时,如下图,则表示整个开票流程已经调试通畅。
    图四

4.回调服务未收到数据怎么办

  1. 检查自身服务是否正常
  2. 检查请求数据回调服务配置是否正确
  3. 检查开票状态是否是成功或失败
  4. 平台查询是否有回调数据

首先得确定回调服务是否符合规范(公网可访问的POST请求),可以用postman程序进行测试,状态码为200即可,如下图,只有在确定不是自身服务的问题,问题定位才会到税务云相关,切记,一定要先进行测试,排除此种可能(很多小伙伴在此出现问题)
图五
在确定不是自身服务问题后,然后查询开票状态,一定得是开票成功或失败(一半小伙伴在此倒下),测试环境在开票接口中存在autoAudit传true即可,传false则需要在平台进行人工审核或者调用审核接口,正式环境由于需要开启税盘和开票助手,所以期间会存在其他因素导致开票状态一直处于开票中,那么税务云则不会向回调服务发起请求。回调服务返回结果可以在 企业开票->交付查询->接口交付 进行查询,并且可以重新发起回调服务的请求,如下图(可用于回调服务的调试哦,也是一个小技巧)
图六

5.回调服务进行了验签或加密怎么办

目前仅支持在url后面拼接参数,其他方式暂不支持。

6.回调服务是内网怎么办

需要将税务云出口ip配置到白名单,点击获取税务云IP地址

Copyright © 用友 -【生态技术部】 2021 all right reserved,powered by Gitbook修订时间: 2021-12-28 09:37:21

results matching ""

    No results matching ""