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

1.前言

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

2.简介

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

3.回调配置流程

  • 与税务云进行对接,一般都是先在测试环境调通,再上正式环境。

  • 那么在测试环境开票时,首先得保证开票状态是成功或者失败,而不是处于开票中的状态。

  • 如下图,就是利用测试代码拟写好的示例,调用开票接口(如果报流水号重复更改下fpqqlsh字段即可)

图一

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

4.1.通过开票状态查询接口

图二

4.2.税务云平台进行查询

登录税务云测试平台,企业登录-> 企业开票 -> 已开票 -> 输入流水号 即可

图三

  • 那么开票接口请求成功后,并且开票状态成功或失败,税务云就会立马通知回调服务,如果访问超时或失败,则会继续发起请求,最多三次。

  • 当回调服务接收到税务云发送的请求数据时,如下图,则表示整个开票流程已经调试通畅。

图四

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

  • 1.检查自身服务是否正常,外网可访问
  • 2.检查请求数据回调服务配置是否正确
  • 3.检查开票状态是否是成功或失败
  • 4.平台查询是否有回调数据,税务云系统查看接口交付菜单

首先得确定回调服务是否符合规范(公网可访问的POST请求),可以用postman程序进行测试,状态码为200即可,如下图,只有在确定不是自身服务的问题,问题定位才会到税务云相关,切记,一定要先进行测试,排除此种可能(很多小伙伴在此出现问题)

图五

在确定不是自身服务问题后,然后查询开票状态,一定得是开票成功或失败(一半小伙伴在此倒下),测试环境在开票接口中存在autoAudit传true即可,传false则需要在平台进行人工审核或者调用审核接口。

正式环境由于需要开启税盘和开票助手,所以期间会存在其他因素导致开票状态一直处于开票中,那么税务云则不会向回调服务发起请求。

回调服务返回结果可以在 企业开票->交付查询->接口交付 进行查询,并且可以重新发起回调服务的请求,如下图(可用于回调服务的调试哦,也是一个小技巧)

图六

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

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

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

Copyright © 用友 -【生态技术部】 2022-2023 all right reserved,powered by Gitbook修订时间: 2023-05-16 10:08:51

results matching ""

    No results matching ""