5003-数电发票开具结果查询

E税云/其他外部系统可通过此接口查询数电发票开具结果，开具成功后回传完整发票信息。

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5003

Authorization

string

可选

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

示例值:

bearer token

Body 参数application/json

invoiceSerialNumber

string <uuid>

发票请求流水号

必需

creditCode

string

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

必需

正则匹配:

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

示例

{
    "invoiceSerialNumber": "eFAecC27-67cC-cbFD-FF9b-Cdaf6b29dC93",
    "creditCode": "59266363PWCCXPHH9T"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

invoiceSerialNumber

string <uuid>

发票请求流水号

必需

发票唯一标识。长度不能超过64个字符，且不能为中文

invoiceNature

enum<string>

发票性质

必需

0：蓝字发票；1：红字发票

枚举值:

invoiceDate

string

开票日期

必需

格式：yyyy-MM-dd HH:mm:ss

invoiceNum

string

发票号码

必需

>= 8 字符<= 8 字符

正则匹配:

^[0-9]{1,8}$

invoiceType

enum<string>

发票种类

必需

61(数电电子普票)；62(数电电子专票) 1.购方纳税人为“个人”时，不允许开具专票。

枚举值:

6162

creditCode

string

纳税人识别号

必需

即销方税号： E税云管理平台纳税人设置中维护的纳税人识别号。(2023-04-04)

正则匹配:

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

saleAddress

string

销方地址

可选

saleName

string

销方名称

可选

salePhone

string

销方电话

可选

saleBank

string

销方开户银行

可选

saleBankAccount

string

销方银行账号

可选

creditType

enum<string>

购方企业类型

可选

购方企业类型：1（企业）；3（个人）。 1.为空时，若购方名称≥9字节时，判断为企业。为空时，若购方名称<9字节时，判断为个人。

枚举值:

custName

string

购方名称

必需

custCreditCode

string

购方纳税人信用代码/身份证件号码

必需

1.数电电子专票：必填； 2.数电电子普票：购方纳税人类型为“个人”时，允许为空，其他必填； 3.长度为15 17 18 20的任意大写字母和数字；自动将小写字母转大写字母。

custAddress

string

购方地址

可选

custPhone

string

购方电话

可选

custBank

string

购方开户银行

可选

custBankAccount

string

购方银行账号

可选

custEmail

string

购方邮箱

可选

manager

string

购买方经办人姓名

可选

managerIdNo

string

购买方经办人证件号码

可选

managerPhone

string

购买方经办人联系电话

可选

payeeBankName

string

收款银行名称

可选

payeeBankAccount

string

收款银行账号

可选

settleType

enum<string>

结算方式

可选

01：现金；02：银行转账；03：票据；04：第三方支付；05：预付卡；99：其他

枚举值:

10203040599

taxVenue

string

应税行为发生地

可选

openPeople

string

开票人

必需

openPeopleIdNo

string

开票人证件号码

可选

openPeopleIdType

string

开票人证件类型

可选

invoiceRemark

string

发票备注

可选

specificBizTypeCode

string

特定业务类型代码

可选

空：非特定要素；01：成品油发票；02：稀土发票；03：建筑服务发票；04：货物运输服务发票；05：不动产销售服务发票；06：不动产租赁服务发票；07：代收车船税；08：通行费；09：旅客运输服务发票；10：医疗服务（住院）发票；11：医疗服务（门诊）发票；12：自产农产品销售发票；13 拖拉机和联合收割机发票；14：机动车；15：二手车；16：农产品收购发票；17：光伏收购发票；18：卷烟发票目前仅支持空和06

differenceTax

string

差额征税类型代码

可选

空：非差额发票 01：差额开票 02：全额开票目前仅支持空（非差额发票）

purchaseInvoiceCategory

string

收购发票类型代码

可选

空：非收购发票 01：农产品收购发票 02：光伏收购发票 03：二手车收购发票目前仅支持空（非收购发票）

exportTaxRebateType

string

出口业务适用政策代码

可选

空：非出口业务 01：退税政策 02：免税政策 03：征税政策目前仅支持空（非出口业务）

vatTaxRetreatCode

string

增值税即征即退代码

可选

空：非增值税即征即退；01：软件产品发票；02：资源综合利用产品发票；03：管道运输服务发票；04：有形动产融资租赁服务；05：有形动产融资性售后回租服务发票；06：新型墙体材料发票；07：风力发电产品发票；08：光伏发电产品发票；09：动漫软件产品发票；10：飞机维修劳务发票；11：黄金发票；12：铂金发票

totalAmt

number <double>

合计金额

必需

默认值:

taxAmt

number <double>

合计税额

必需

tolAmtIncl

number <double>

价税合计

必需

isTax

enum<string>

是否含税：

必需

0(否)；1(是)

枚举值:

detailItemList

object

必需

serialNo

string

明细行序号

必需

matName

string

项目名称

必需

spec

string

规格型号

可选

unit

string

单位

可选

如“数量”“单价”栏次非空，则本栏次必须非空

quantity

string

数量

可选

如“单价”“单位”栏次非空，则本栏次必须非空

price

string

单价

可选

如“数量”“单位”栏次非空，则本栏次必须非空

amt

number <double>

金额

必需

taxRate

number <double>

增值税税率/ 征收率

必需

默认值:

示例值:

0.06

taxAmount

number <double>

税额

必需

amountIncludeTax

number <double>

含税金额

可选

balance

number <double> | null

扣除额

可选

revenueCode

string

商品和服务税收分类合并编码

必需

lineNature

string

发票行性质

必需

00：正常行；01：折扣行；02：被折扣行

privilegeType

string

优惠政策标识

必需

01：简易征收；02：稀土产品；03：免税；04：不征税；05：先征后退；06：100%先征后退；07：50%先征后退；08：按3%简易征收；09：按5%简易征收；10：按5%简易征收减按1.5%计征；11：即征即退30%；12：即征即退50%；13：即征即退70%；14：即征即退100%；15：超税负3%即征即退；16：超税负8% 即征即退；17：超税12%即征即退；18：超税负6%即征即退

correrialNo

string

对应蓝字发票明细序号

必需

是否蓝字发票标志为1 时，此节点有内容红票预留字段

additionalElementList

object

附加要素信息列表

可选

additionalElementName

string

附加要素名称

可选

additionalElementType

string

附加要素类型

可选

additionalElementValue

string

附加要素值

可选

blueInvoiceNum

string

对应蓝字发票号码

可选

红票预留字段

正则匹配:

^[0-9]{1,8}$

confirmNo

string

红字确认信息单编号

必需

是否蓝字发票标志为1 时，此节点有内容红票预留字段

confirmUuId

string

红字确认单uuid

必需

是否蓝字发票标志为1 时，此节点有内容红票预留字段

specificElementList

特定要素信息

可选

Any of

建筑服务特定要素

不动产租赁特定要素

货物运输服务特定要素

specificElementsConstructionServices

object

建筑服务特定要素

可选

isShowSaleAccount

string

是否展示销售方银行账号标签

必需

Y：展示；N：不展示

isShowCustAccount

string

是否展示购买方银行账号标签

必需

Y：展示；N：不展示

payee

string

收款人姓名

必需

checker

string

复核人姓名

必需

invoiceStatus

string

发票状态

必需

0：待开；1：正常；2：已作废；3：已红冲-全额；4：已红冲-部分

openStatus

string

开票状态

必需

0：未开具；1：已开具；2：开具失败；3开具中

openResultDesc

string

开票失败原因

必需

uploadStatus

string

上传状态

必需

（1）-1：未上传；00：成功；01：处理中（含有超时）；02：失败；03：重复上传；04：重新上传（2）非总部交付时返回；（3）总部交付时不返回。

uploadResultDesc

string

上传失败原因

必需

xmlUrl

string

xml下载地址

必需

pdfUrl

string

pdf下载地址

必需

ofdUrl

string

ofd下载地址

必需

示例

{
    "invocieSerialNumber": "36fb1f19-cbEc-7e1C-C7E8-2bAA7d9a8590",
    "invoiceType": "61",
    "invoiceCreditCode": "FP438559ABXM69X9TU",
    "custName": "林明",
    "custCreditCode": "82",
    "openPeople": "江勇",
    "specificBizTypCodee": "28",
    "differenceTax": "Ut velit amet",
    "purchaseInvoiceCategory": "dolore consectetur Lorem sint esse",
    "exportTaxRebateType": "adipisicing occaecat",
    "vATTaxRetreatCode": "38",
    "totalAmt": 81,
    "taxAmt": 92,
    "tolAmtIncl": 27,
    "istax": "0",
    "detailItemList": {
        "serialNo": "in",
        "matName": "开美没转",
        "amt": 68,
        "taxRate": 91,
        "taxAmount": 43,
        "revenueCode": "35",
        "lineNature": "nostrud",
        "privilegeType": "irure",
        "balance": 59,
        "unit": "occaecat",
        "quantity": "86",
        "price": "97",
        "amountIncludeTax": 15,
        "spec": "Duis pariatur velit"
    },
    "invoiceNature": "1",
    "invoiceNum": "40922864",
    "invoiceDate": "2005-05-05 05:51:45",
    "confirmNo": "fugiat et",
    "confirmId": "59",
    "custAddress": "湖南省 长沙市 雨花区",
    "custEmail": "p.lwejzx@qub.sb",
    "blueInvoiceNum": "74136",
    "settleType": "99",
    "saleAddress": "江苏省 无锡市 江阴市",
    "custBankAccount": "13648886239",
    "salePhone": "57203520871130222X",
    "invoiceRemark": "心部由系就周象",
    "openPeopleIdNo": "68343419251023243x",
    "managerIdNo": "86946719160818419x",
    "openPeopleIdType": "96",
    "manager": "秦超",
    "saleBankAccount": "18632496740",
    "custPhone": "656286180805307235",
    "creditType": "1",
    "additionalElementList": {
        "additionalElementName": "顾秀兰",
        "additionalElementValue": "劳于音华称阶",
        "additionalElementType": "附加要素类型"
    },
    "payeeBankAccount": "18184290736",
    "saleBank": "广西壮族自治区 防城港市 东兴市",
    "taxVenue": "上海市",
    "custBank": "福建省 厦门市 海沧区",
    "payeeBankName": "格元发革示而",
    "managerPhone": "18662231752"
}

🟢200通用返回报文

🟢200开票