获取开票结果

开票异步处理

由于电子发票需要调用税控设备这类的硬件，也要调用税务局系统接口完成发票开具和上传。

这些硬件或者软件存在一些业务上或者系统上闸口，在达到一定阈值之后，会出现不允许开具的情况，并且这些软硬件系统本身也存在较多的异常，因此瑞宏网设计的发票开具相关的接口都是采用异步的方式，这样可以保证系统的效率和最终发票可以开出。

第三方系统，通过订单接口或者发票接口将开票请求推送给瑞宏网，瑞宏网调用企业的税控设备进行发票开具，有可能成功，也有可能失败。这时第三方系统有两种方式可以获取到开票状态：

利用回调获取开票结果

1. 调用方在调用接口时，需要传入参数callbackUrl，这样瑞宏网在开票成功后，会将开票结果推送到该 url；

{
  ...
  ...
  "dynamicParams": {
    "callbackUrl": "回调地址"
  }
}

1. 瑞宏网开具发票后，将开票结果以POST方式提交到该回调URL。调用方收到回调报文后，需要双方约定响应字符串表示成功（譬如success、OK、{“code”:”0”, “message”:”成功”}等），上线前请瑞宏网同学在后台进行配置。

   注意：

   如果回调失败，瑞宏网会分别在30分钟、60分钟、90分钟后尝试再次发送开票结果，最多重试3次.

2. 如果长时间没有收到开票响应，检查税控设备是否运行正常，并且可以调用查询接口查询发票开具情况；

利用查询接口获取开票结果

1. 调用方以定时任务的方式调用查询接口查询开票结果；
2. 提供图形界面，让用户可以操作获取开票结果；

开发建议

采用回调方式能够更方便、更快捷的获取开票结果。

如果查询接口一直返回开票中，请参阅长期处于开票中的处理方案