5010-查询发票用途状态

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5010

Authorization

string

可选

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

示例值:

bearer token

userName

string

可选

2.0.14新加字段-电子税务局账号

示例值:

zhangsan

channelType

string

可选

2.0.14新加字段-管理方式
0-电子税局；1-乐企；
不传默认1-乐企。

示例值:

0

Body 参数application/json

creditCode

string

纳税人识别号

必需

即销方税号： E税云管理平台纳税人设置中维护的纳税人识别号

invoiceType

string

发票种类

必需

发票种类 0(纸质专用发票);2(纸质普通发票);12(机动车销售统一发票);51(电子普通发票);52(电子专用发票);61(数电电子普票);62(数电电子专票)

invoiceCode

string

发票代码

可选

数电发票发票代码可为空

invoiceNum

string

发票号码

必需

数电发票，发票号码20 位

invoiceDate

string

发票日期

必需

2.0.14修改为：管理方式为1-乐企时，支持两种格式：yyyy-MM-dd 或yyyy-MM-dd HH:mm:ss。
管理方式为0-电子税局时，仅支持传yyyy-MM-dd HH:mm:ss
（原参数-开票日期格式：yyyy-MM-dd）

custCreditCode

string

购方纳税人识别号

可选

2.0.14新加字段-购方纳税人识别号管理方式为1-乐企时，非必填；管理方式为0-电子税局时，必填。

示例

{
    "creditCode": "56",
    "invoiceType": "01",
    "invoiceNum": "98",
    "invoiceDate": "2021-03-09",
    "invoiceCode": "29"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost' \
--header 'SID: 5010' \
--header 'Authorization: bearer token' \
--header 'userName: zhangsan' \
--header 'channelType: 0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "creditCode": "56",
    "invoiceType": "01",
    "invoiceNum": "98",
    "invoiceDate": "2021-03-09",
    "invoiceCode": "29"
}'

返回响应

🟢200成功

application/json

Body

invoiceCode

string

发票代码

可选

数电发票发票代码为空

invoiceNum

string

发票号码

必需

数电发票，发票号码20 位

invoiceDate

string

开票日期

必需

2.0.14修改为：开票日期
格式：yyyy-MM-dd或YYYY-MM-DD HH:MM:SS。
根据入参返回。
（原格式- 开票日期格式：yyyy-MM-dd）

invoiceStatus

string

发票状态

可选

1 正常 2 作废 3 全部红冲 4 部分红冲 5 已红冲
管理方式为0-电子税局时不返回。

abnormalVoucherStatus

string

异常凭证状态

可选

01-正常 02-异常凭证 03-疑似异常凭证
管理方式为0-电子税局时不返回。

redLockFlag

string

红字锁定标识

可选

红字锁定标识 Y-锁定；N-未锁定
管理方式为0-电子税局时不返回。

invoicePurpose

string

发票用途

可选

2.0.14修改为：00：已勾选未确认 01：已确认 03：未勾选
（原枚举-0：未使用 1：已申请抵扣 2：已申请退税 3：已申请代办退税 4：已勾选不抵扣（历史数据） 5：已申请代办退税（历史数据） 6：已申请不抵扣 7：内销转出口 8：出口转内销 9：准予退税 10：不予退税 11：冬奥退税）

accountStatus

string

入账状态

可选

2.0.14修改为：
00：未入账 01：已入账 02：已入账撤销
（原记录枚举-01：未入账 02：已入账 03：已入账撤销）

oilAbnormality

string

成品油异常标识

可选

9-正常；1-成品油单价异常；2-成品油超库存异常;8-正常，需全额红冲
管理方式为0-电子税局时不返回。

exportTaxRefundCode

string

出口退税类代码

可选

01：增值税专用发票可用于代办退税标签（仅用于代办退税）
管理方式为0-电子税局时不返回。

vatPreferencePurpose

string

增值税优惠用途（农产品加计扣除）

可选

0：未使用 1：全部项目加计 2：全部项目不加计 3：部分项目加计
管理方式为0-电子税局时不返回。

consumptionTaxPurposes

string

消费税用途

可选

00：未勾选库存 01：已勾选库存

vatCheckPeriod

string

增值税勾选属期

可选

2.0.14新加字段-管理方式为1-乐企时不返回。

entryDate

string

入账时间

可选

2.0.14新加字段-管理方式为1-乐企时不返回。

etCheckPeriod

string

消费税勾选属期

可选

2.0.14新加字段-管理方式为1-乐企时不返回。

downloadCount

string

发票下载次数

可选

2.0.14新加字段-管理方式为1-乐企时不返回。

示例

{
    "invoiceNum": "61",
    "invoiceDate": "2009-01-13",
    "exportTaxRefundCode": "21",
    "accountStatus": "ut id ut culpa consequat",
    "invoiceCode": "86",
    "invoicePurpose": "et nostrud irure",
    "redLockFlag": "aliqua adipisicing",
    "consumptionTaxPurposes": "cupidatat irure laboris ea",
    "abnormalVoucherStatus": "labore in",
    "oilAbnormalityIdentificatio": "88",
    "vatPreferencePurpose": "exercitation velit anim",
    "invoiceStatus": "id exercitation eiusmod magna consectetur"
}

🟢200通用返回报文

🟢200开票