5001-查询发票额度

可通过此接口查询E税云管理平台本地的发票额度信息。
1.E税云管理平台定时调税局乐企接口查询发票额度（包含总发票额度、可用额度、已下载额度、已下载未使用额度等），并保存到本地，同时根据本地发票额度管理（下载/退回发票额度）以及发票数据上传（上传后计算更新本地发票额度）更新本地发票额度。
2.E税云或其他外部系统通过管理平台的“查询发票额度”接口查询管理平台本地的发票额度，用于开票/业务系统查看发票额度和自校验。

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5001

Authorization

string

可选

获取token接口返回token类型加token

示例值:

bearer token

Body 参数application/json

creditCode

string

纳税人识别号/统一社会信用代码

必需

默认值:

L3874688YYLJC8EBF3

正则匹配:

^[^_IOZSVa-z\W]{2}\d{6}[^_IOZSVa-z\W]{10}$

示例

{
    "creditCode": "L3874688YYLJC8EBF3"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

authAmount

number

本月总发票额度

必需

当前属期的总发票额度。税局查询后E税云管理平台本地保存。

residualAmount

number

本月可用剩余额度

必需

当前属期在税局电子发票服务平台实际可用发票额度。

downAmount

number

本月已下载额度

必需

本月乐企1.5已下载的全部发票额度。税局查询后E税云管理平台本地保存。

downloadedAmount

number

本月可下载额度

必需

本月总发票额度减本月已下载额度，减电子税局手工开具的开票日期为本月的发票的总金额。

unusedAmount

number

本月已下载未使用

必需

本月乐企1.5已下载的全部发票额度减已上传的开票日期为本月的发票总金额。

localDownAmount

number

本月本地已下载额度

必需

本月管理平台已下载的全部发票额度。

uploadAmount

number

本月本地已上传额度

必需

本月管理平台已上传的开票日期为本月的发票的总金额。

unUploadedAmount

number

本月本地未上传额度

必需

本月管理平台未上传的开票日期为本月的发票的总金额

localUsableAmount

number

本月本地可使用额度

必需

本月管理平台本地离线未使用的额度。

period

string

属期

必需

管理平台已下载的发票额度属期，格式yyyy-MM

正则匹配:

\d{4}-\d{2}

amountRangeStart

string

发票额度使用区间起

必需

管理平台下载发票额度时，有此节点数电发票开票日期在发票额度使用区间（含）时才可以使用，格式：yyyymmdd

正则匹配:

\d{4}\d{2}\d{2}

amountRangeEnd

string

发票额度使用区间止：

必需

管理平台下载发票额度时，有此节点数电发票开票日期在发票额度使用区间（含）时才可以使用，格式：yyyymmdd

正则匹配:

\d{4}\d{2}\d{2}

mark

enum<string>

暂停赋额标志

必需

暂停赋额标志

枚举值:

updateTime

string

更新时间

必需

最近一次从局端同步数据的时间,yyyy-MM-dd HH:mm:ss 乐企前置通道：查询乐企前置。乐企直连通道：本地记录。

示例

{
    "authAmount": 19,
    "residualAmount": 41,
    "downAmount": 50,
    "downloadedAmount": 19,
    "unusedAmount": 50,
    "localDownAmount": 26,
    "uploadAmount": 56,
    "unuploadedAmount": 68,
    "localUsableAmount": 26,
    "period": "3922-09",
    "amountRangeStart": "29677430",
    "amountRangeEnd": "64622447",
    "mark": "Y",
    "updateTime": "2024-04-09 09:26:28"
}

🟢200通用返回报文