5006-开具数电红字发票

E税云/外部系统可通过此接口开具数电红字发票。E税云管理平台接收到数电红票开具请求后，针对传入的发票数据进行本地校验，校验通过后与税局交互进行预赋码并上传。

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5006

Authorization

string

可选

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

示例值:

bearer token

Body 参数application/json

invoiceSerialNumber

string

发票请求流水号

必需

发票请求流水号：发票唯一标识。长度不能超过64个字符，且不能为中文。

creditCode

string

纳税人识别号

必需

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

redConfirmNo

string

红字确认单编号

可选

红字确认单编号、uuid、请求流水号三选一必填，且只能传一个。

redConfirmUuid

string

红字确认单uuid

可选

红字确认单编号、uuid、请求流水号三选一必填，且只能传一个。

redConfirmSerialNumber

string

红字确认单流水号

可选

红字确认单编号、uuid、请求流水号三选一必填，且只能传一个。

openPeople

string

开票人

必需

openPeopleIdNo

string

开票人证件号码

可选

总部通道无此字段，税局乐企有

openPeopleIdType

string

开票人证件类型

可选

总部通道无此字段，税局乐企有

deliverType

string

交付方式

可选

0 或空不交付； 1 邮箱； 2 短信； 3 微信插卡包； 5 定制。

custMobile

string

购方手机

可选

交付方式为短信必传

custWeChat

string

购方微信

可选

交付方式为微信卡包必传

custEmail

string

购方邮箱

可选

交付方式为邮箱必传

示例

{
    "invoiceSerialNumber": "5Ad2Bc7f-cfd3-7fA8-6aFa-Ecc7C034CDce",
    "openPeople": "芳",
    "creditCode": "69",
    "openPeopleIdNo": "70170118940110326X",
    "custWeChat": "consectetur",
    "openPeopleIdType": "7",
    "custEmail": "l.yeloj@omufkeoqy.my",
    "custMobile": "18185749839",
    "redConfirmUuid": "994D3a51-251F-BbBE-5426-f7dfDe4ccE9D",
    "redConfirmNo": "78FD190f-CECe-ca5D-B826-8E9327f8fDb6",
    "redConfirmSerialNumber": "",
    "deliverType": "elit deserunt et sint"
}

示例代码

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

销方地址

可选

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

发票备注

可选

specificBizTypCodee

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 时，此节点有内容红票预留字段

示例

{
    "invoiceSerialNumber": "6Ed5A56c-04a8-D344-0EbA-b975fED7476c",
    "invoiceType": "62",
    "creditCode": "17016853MCX7MGDHCH",
    "custName": "胡刚",
    "custCreditCode": "82",
    "openPeople": "锺娜",
    "totalAmt": 94,
    "taxAmt": 72,
    "tolAmtIncl": 86,
    "isTax": "1",
    "detailItemList": {
        "serialNo": "200",
        "matName": "观太子江市没",
        "amt": 44,
        "taxRate": 67,
        "taxAmount": 65,
        "revenueCode": "40",
        "lineNature": "consequat exercitation",
        "privilegeType": "voluptate",
        "correrialNo": "300",
        "quantity": "83",
        "price": "95",
        "unit": "minim dolore",
        "spec": "velit elit non ad",
        "balance": 81,
        "amountIncludeTax": 57
    },
    "invoiceNature": "1",
    "invoiceNum": "31452678",
    "invoiceDate": "1990-05-30 20:15:54",
    "confirmNo": "magna deserunt esse elit",
    "confirmId": "48",
    "saleBank": "黑龙江省 鸡西市 城子河区",
    "differenceTax": "ut reprehenderit",
    "custEmail": "v.nvjbqtug@gqmqpygmt.ar",
    "settleType": "1",
    "managerPhone": "13830582220",
    "managerIdNo": "91549318560614378X",
    "custBankAccount": "19886745548",
    "taxVenue": "新界",
    "saleAddress": "福建省 厦门市 翔安区",
    "exportTaxRebateType": "ullamco proident elit fugiat",
    "manager": "郝超",
    "custPhone": "28468918991127234X",
    "openPeopleIdType": "48",
    "salePhone": "75288720261220063X",
    "custAddress": "广东省 潮州市 其它区",
    "purchaseInvoiceCategory": "qui adipisicing",
    "blueInvoiceNum": "89",
    "vatTaxRetreatCode": "84",
    "payeeBankName": "几然造少可",
    "invoiceRemark": "见满示",
    "custBank": "新疆维吾尔自治区 博尔塔拉蒙古自治州 温泉县",
    "payeeBankAccount": "18117225652",
    "creditType": "1",
    "openPeopleIdNo": "693247184108101552",
    "saleBankAccount": "19837586843",
    "additionalElementList": {
        "additionalElementValue": "小七内安关",
        "additionalElementType": "附加要素类型",
        "additionalElementName": "孔霞"
    },
    "specificBizTypCodee": "90"
}

🟢200通用返回报文

🟢200开票