发票下载金税互联日志分析

栏目:eas cloud知识作者:金蝶来源:金蝶云社区发布:2024-09-22浏览:1

发票下载金税互联日志分析

目录

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)查无此客户端,推送失败--长链接配置不正确





发票下载金税互联日志分析

目录 1 金税互联日志查看入口 2 金税互联日志查看 2.1 查看关键要素 2.2 查看请求发送与返回信息 3 常见问题通过日志...
点击下载文档
上一篇:EAS 下一篇:EAS长链接收票配置介绍
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息