常见问题

接口异常

解决方案

接口返回通常有三种情况，成功、失败、异常。

失败一般不需要关注，可以按响应码和响应描述（或者转为自己的提示语）进行页面提示

异常可以提供接口响应里的traceId给到发票云进行问题定位

备注

异常情况，通常提示语是“网络繁忙”

解决方案

在系统服务器端进行网络测试

如遇超时连接不通，请联系您系统的运维或者开发人员，将发票云的域名添加至信任访问的域名白名单

解决方案

在接入发票云系统的时候，由于域名、端口与您系统的不同，跨域（Cross-Origin）可能是最经常遇到的问题。
以下提供几种不同方式的处理方案供您参考。

修改Nginx配置文件，添加跨域响应头
在Nginx的配置文件（通常为nginx.conf或站点的特定配置文件，位于/etc/nginx/sites-available/目录下）中，可以为需要处理跨域请求的location块添加如下指令来设置相应的跨域响应头：

使用ngx_http_cors_module模块
Nginx从1.19.5版本开始内置了ngx_http_cors_module模块，可以更方便地配置CORS相关的参数。如果您的Nginx版本支持此模块，可以在配置文件中启用并配置它：

在Spring Boot应用中，可以通过配置类处理跨域问题

或直接在控制器中添加注解

前端通常为请求的最后一环，处理跨域问题应在前两环解决，对接页面我们推荐使用iframe + websocket的方式，这样不会遇到跨域问题。

如使用nodejs等框架遇到跨域问题，可以使用搜索引擎据框架关键字+跨域检索对应的解决方案。

解决方案

出现这个提示语的时候，通常伴随着HTTP CODE 429的返回，意味着因为短时间内大量请求发票云服务器，被网关进行了限流，通常无需额外处理，可以试着降低请求频率或者合并一些请求。

解决方案

目前接口和文档处于一个快速迭代的阶段，由于历史跨度的问题，有些字段可能出现名称不一致的情况，例如发票流水号有fid和serialNo，报销单ID有expenseId和bxd_key，对应的都是一个东西，目前没有办法强行统一，以当前对接的接口参数为准。