目录
1 金税互联日志查看入口
2 金税互联日志查看
2.1 查看关键要素
2.2 查看请求发送与返回信息
3 常见问题通过日志排查
3.1 下载发票数量不正确
3.2 下载报错
1 金税互联日志查看入口
金税互联日志入口:税务管理-》发票管理-》基础设置-》金税互联日志
2 金税互联日志查看
2.1 查看关键要素
发票下载日志主要关注:日志类型、组织名称、日志状态、请求地址即可。
日志类型:发票下载根据有盘模式或者软证书模式会发起不同的请求;有盘模式时,同时发起日志类型为发票下载-V2.0与下载进项发票-V2.0的两种请求,而软证书模式只会发起下载进项发票-V2.0请求。
组织名称:发票下载界面维护的财务组织,查看日志财务组织与下载维护的组织是否一致,以防维护有误下载的不是想要下载的发票。
日志状态:完成--代表请求成功且返回预期结果。失败--代表请求失败,没有返回预期结果,一般返回失败原因。
请求地址:通过查看请求地址,主要可确认下载所走的金税互联设置维护的http地址是否有误,是否是目标税盘地址。
请求地址类型如下:
2.2 查看请求发送与返回信息
双击日志,可打开金税互联日志查看界面,界面有具体的请求发送信息与返回信息。
发送信息:
主要有发票类型、购方税号、销方税号、开始/结束时间、发票状态,发送的这些信息取值来源于发票下载界面所选择的下载条件。当下载发票结果有问题时可通过确认发送的请求信息是否与下票的条件相符,确认下载条件发送无误。
如:{"invoiceTypes":"3","buyerTaxNo":"00000000000000","pageNo":1,"salerTaxNo":"00000000000000","pageSize":300,"startTime":"2021-12-01","endTime":"2021-12-04","invoiceStatus":"0"}
{"发票类型":"增值税普通发票","购方税号":"00000000000000","pageNo":1,"销方税号":"00000000000000","pageSize":300,"开始日期":"2021-12-01","结束日志":"2021-12-04","发票状态":"正常"}
常见参数含义如下:
| 参数名称 | 类型 | 描述 |
---|
startTime | string | 起始时间 <br />(未勾选的发票按照开票日期进行查询;已勾选的按照勾选日期;已认证的按照指定的日期范围(startTime-endTime)月份作为属期范围进行查询) |
|
endTime | string | 截止时间 同startTime |
|
authenticateFlags | string | 勾选认证状态<br />( 空为查询全部,支持多个逗号分隔的字符串,如0,1,2,3对应表示未勾选、已勾选的发票、勾选认证、扫描认证) |
|
salerTaxNo | string | 销方税号 |
|
invoiceCode | string | 发票代码 |
|
invoiceNo | string | 发票号码 |
|
invoiceType | string | 发票类型 (空为全部类型 4:增值税专用发票 12:机动车发票 15:通行费发票 2:增值税电子专用发票 ) |
|
invoiceStatus | string | 发票状态 (空为全部 0:正常 1:失控 2:作废 3:红冲 4:异常) |
|
返回消息:
返回信息主要查看发票下载返回总数量("totalElement":“ ”),正常结果应是是日志返回数量与发票下载界面提示的数量一致。
常见参数含义如下:
| 参数名称 | 类型 | 描述 |
---|
totalNum | int | 发票总份数 |
|
invoiceNo | string | 发票代码 |
|
invoiceStatus | string | 发票状态 -1:全部 0:正常 1:失控 2:作废 3:红冲 4:异常 |
|
salerName | string | 销方名称 |
|
salerTaxNo | string | 销方纳税人识别号 |
|
invoiceType | string | 发票类型 4:增值税专用发票 12:机动车发票 15:通行费发票 2:增值税电子专用发票 |
|
checkFlag | string | 是否勾选 0:未勾选 1:已勾选 |
|
selectTime | string | 勾选日期 |
|
checkAuthenticateFlag | string | 是否已勾选认证 |
|
selectAuthenticateTime | string | 勾选认证日期 |
|
taxPeriod | string | 所属税期 |
|
invoiceAmount | string | 金额 |
|
invoiceDate | string | 开票日期 |
|
taxAmount | string | 税额 |
|
其他发票字段含义可查看发票云的相关接口文档,http://imgdev-master.piaozone.com/docs/market/invoice-component/api-invoicecollect-in-v2.html#item7。
3 常见问题通过日志排查
3.1 下载发票数量不正确
通过查看日志中发票的数量是否与EAS下载成功数量是否一致,进而确定问题是发票云还是EAS的问题。
如EAS下载成功数量与日志返回的数量不一致,请联系总部EAS税务管理研发分析。
如EAS下载成功数量与日志返回的一致,请联系发票云技术支持人员分析。
3.2 下载报错
EAS下载界面弹出报错信息,根据具体报错提示的下载路径(发票云下载或税局下载),查找日志对应的接口日志返回信息(“发票云下载”对应日志类型“下载进项发票”,“税局下载”对应日志类型“发票下载V2.0'')
如EAS报错与日志返回报错一致,则问题是发票云导致,请联系发票云技术支持人员分析。
如EAS报错,而日志响应成功,返回无报错信息,请联系总部EAS税务研发人员分析。
常见报错:
(1)网络繁忙--发票云网络问题
(2)访问超时,请检查金税互联设置或网络连接是否正确--无网络权限
(3)查无此客户端,推送失败--长链接配置不正确