5006-开具数电红字发票

开发环境

http://192.168.51.174

POST

/eTaxManage/openApi/apiPost

最后修改时间：2024-08-27 07:25:18

责任人：luohan

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

购方邮箱

可选

交付方式为邮箱必传

issueType

string

开票方式

可选

2.0.6迭代新增 0-异步开票，1-同步开票不传默认异步开票非总部交付时，传入无效总部交付时，传入有效

blueInvoiceCode

string

蓝字发票代码

可选

blueInvoiceNumber

string

蓝字发票号码

可选

blueInvoiceDate

string

蓝字发票日期

可选

日期格式 yyyy-MM-dd HH:mm:ss

totalAmt

number

合计金额

可选

taxAmt

number

合计税额

可选

tolAmtIncl

number

价税合计

可选

isTax

string

含税标志

可选

0(否)；1(是)

invoiceType

string

发票票种

可选

61(数电电子普票)；62(数电电子专票)

creditType

string

购方企业类型

可选

1（企业）；2（非企业单位）；3（个人）

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：铂金发票

saleName

string

(销售方)名称

可选

saleAddress

string

销售方地址

可选

salePhone

string

销售方电话

可选

saleBank

string

销售方开户行

可选

saleBankAccount

string

销售方账号

可选

custName

string

购买方名称

可选

custCreditCode

string

购买方统一社会信用代码/纳税人识别号/身份证件号码

可选

custAddress

string

购买方地址

可选

custPhone

string

购买方电话

可选

custBank

string

购买方开户行

可选

custBankAccount

string

购买方账号

可选

manager

string

购买方经办人姓名

可选

managerIdNo

string

购买方经办人证件号码

可选

managerPhone

string

购买方经办人联系电话

可选

payeeBankName

string

收款银行名称

可选

payeeBankAccount

string

收款银行账号

可选

settleType

string

结算方式

可选

taxVenue

string

应税行为发生地

可选

isShowSaleAccount

string

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

可选

N-否，Y-是

isShowCustAccount

string

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

可选

N-否，Y-是

payee

string

收款人姓名

可选

checker

string

复核人姓名

可选

specificElementList

特定要素信息

可选

Any of

建筑服务特定要素

不动产特定要素信息

货物运输服务特定要素

specificElementsConstructionServices

object

建筑服务特定要素

可选

detailItemList

object

商品信息列表

可选

serialNo

integer

明细行序号

必需

blueSerialNo

integer

对应明细行序号

可选

matName

string

项目名称

必需

spec

string

规格型号

可选

unit

string

单位

可选

quantity

string

数量

可选

price

number <double>

单价

可选

折扣发票红冲时，单价可与蓝票不一致，为折后金额/数量反算

amt

number <double>

金额

必需

taxRate

number <double>

增值税税率/ 征收率

必需

默认值:

示例值:

0.06

taxAmount

number <double>

税额

必需

balance

number <double> | null

扣除额

可选

须与对应蓝字发票保持一致。有传入时，以传入为准；未传入时，取本地蓝票。

revenueCode

string

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

必需

lineNature

string

发票行性质

必需

00：正常行；红票无折扣行，只能传商品行，为空时默认商品行。

privilegeType

string

优惠政策标识

可选

须与对应蓝字发票保持一致。有传入时，以传入为准；未传入时，取本地蓝票。

示例

{
    "invoiceSerialNumber": "C413BeDe-281b-EEfa-2B3b-7baEAc5C1cBe",
    "creditCode": "ullamco eu quis",
    "redConfirmNo": "e829A930-93Ee-Ee6D-9ded-3c1bb9f360fe",
    "redConfirmUuid": "a6e5758e-ed49-19d7-356c-FeB93dC618dc",
    "redConfirmSerialNumber": "D4C4d921-2725-AB85-9DFC-4ed5B9653BE3",
    "openPeople": "磊",
    "openPeopleIdNo": "97854619270718485X",
    "openPeopleIdType": "aute ut quis amet aliqua",
    "deliverType": "adipisicing ullamco",
    "custMobile": "18100371775",
    "custWeChat": "sunt nisi velit",
    "custEmail": "d.sppyugam@enxusyk.kn",
    "issueType": "sint do eu in ex",
    "blueInvoiceCode": "adipisicing dolor sed",
    "blueInvoiceNumber": "dolore aute mollit in",
    "blueInvoiceDate": "do ad",
    "totalAmt": -41091816.43228319,
    "taxAmt": 58114106.6314899,
    "tolAmtIncl": -55379182.83634191,
    "isTax": "proident",
    "invoiceType": "veniam",
    "creditType": "non",
    "specificBizTypeCode": "exercitation nulla deserunt esse",
    "differenceTax": "sed cillum in aute",
    "purchaseInvoiceCategory": "do",
    "exportTaxRebateType": "elit officia consequat exercitation nisi",
    "vatTaxRetreatCode": "Ut Lorem ut voluptate aute",
    "saleName": "occaecat non dolore in",
    "saleAddress": "reprehenderit deserunt",
    "salePhone": "irure Lorem",
    "saleBank": "mollit",
    "saleBankAccount": "non minim ex laborum",
    "custName": "laborum",
    "custCreditCode": "esse Excepteur occaecat fugiat velit",
    "custAddress": "consequat et",
    "custPhone": "Excepteur",
    "custBank": "magna ex est",
    "custBankAccount": "officia non in do",
    "manager": "qui ea irure magna",
    "managerIdNo": "minim voluptate aliquip enim in",
    "managerPhone": "dolore laborum officia",
    "payeeBankName": "dolore",
    "payeeBankAccount": "deserunt consequat tempor velit dolore",
    "settleType": "nisi culpa consectetur",
    "taxVenue": "nostrud qui aliquip do consectetur",
    "isShowSaleAccount": "exercitation",
    "isShowCustAccount": "Ut exercitation labore",
    "payee": "nostrud proident ut mollit",
    "checker": "magna",
    "specificElementList": {
        "specificElementsConstructionServices": {
            "landValueTaxItemNumber": "Excepteur aliqu",
            "crossRegionalSign": "N",
            "constructionServicesLocation": "id",
            "constructionProjectName": "anim"
        }
    },
    "detailItemList": {
        "serialNo": 72668680,
        "blueSerialNo": 74169019,
        "matName": "est Lorem aute",
        "spec": "amet mollit Ut laborum",
        "unit": "sint quis reprehenderit proident incididunt",
        "quantity": "ad",
        "price": -13314614.896444514,
        "amt": 71947690.35559592,
        "taxRate": 7043200.347635016,
        "taxAmount": -46272967.586504474,
        "balance": 1761401.548267156,
        "revenueCode": "eiusmod tempor laborum",
        "lineNature": "qui deserunt reprehenderit quis commodo",
        "privilegeType": "laboris"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://192.168.51.174/eTaxManage/openApi/apiPost' \
--header 'SID: 5006' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceSerialNumber": "C413BeDe-281b-EEfa-2B3b-7baEAc5C1cBe",
    "creditCode": "ullamco eu quis",
    "redConfirmNo": "e829A930-93Ee-Ee6D-9ded-3c1bb9f360fe",
    "redConfirmUuid": "a6e5758e-ed49-19d7-356c-FeB93dC618dc",
    "redConfirmSerialNumber": "D4C4d921-2725-AB85-9DFC-4ed5B9653BE3",
    "openPeople": "磊",
    "openPeopleIdNo": "97854619270718485X",
    "openPeopleIdType": "aute ut quis amet aliqua",
    "deliverType": "adipisicing ullamco",
    "custMobile": "18100371775",
    "custWeChat": "sunt nisi velit",
    "custEmail": "d.sppyugam@enxusyk.kn",
    "issueType": "sint do eu in ex",
    "blueInvoiceCode": "adipisicing dolor sed",
    "blueInvoiceNumber": "dolore aute mollit in",
    "blueInvoiceDate": "do ad",
    "totalAmt": -41091816.43228319,
    "taxAmt": 58114106.6314899,
    "tolAmtIncl": -55379182.83634191,
    "isTax": "proident",
    "invoiceType": "veniam",
    "creditType": "non",
    "specificBizTypeCode": "exercitation nulla deserunt esse",
    "differenceTax": "sed cillum in aute",
    "purchaseInvoiceCategory": "do",
    "exportTaxRebateType": "elit officia consequat exercitation nisi",
    "vatTaxRetreatCode": "Ut Lorem ut voluptate aute",
    "saleName": "occaecat non dolore in",
    "saleAddress": "reprehenderit deserunt",
    "salePhone": "irure Lorem",
    "saleBank": "mollit",
    "saleBankAccount": "non minim ex laborum",
    "custName": "laborum",
    "custCreditCode": "esse Excepteur occaecat fugiat velit",
    "custAddress": "consequat et",
    "custPhone": "Excepteur",
    "custBank": "magna ex est",
    "custBankAccount": "officia non in do",
    "manager": "qui ea irure magna",
    "managerIdNo": "minim voluptate aliquip enim in",
    "managerPhone": "dolore laborum officia",
    "payeeBankName": "dolore",
    "payeeBankAccount": "deserunt consequat tempor velit dolore",
    "settleType": "nisi culpa consectetur",
    "taxVenue": "nostrud qui aliquip do consectetur",
    "isShowSaleAccount": "exercitation",
    "isShowCustAccount": "Ut exercitation labore",
    "payee": "nostrud proident ut mollit",
    "checker": "magna",
    "specificElementList": {
        "specificElementsConstructionServices": {
            "landValueTaxItemNumber": "Excepteur aliqu",
            "crossRegionalSign": "N",
            "constructionServicesLocation": "id",
            "constructionProjectName": "anim"
        }
    },
    "detailItemList": {
        "serialNo": 72668680,
        "blueSerialNo": 74169019,
        "matName": "est Lorem aute",
        "spec": "amet mollit Ut laborum",
        "unit": "sint quis reprehenderit proident incididunt",
        "quantity": "ad",
        "price": -13314614.896444514,
        "amt": 71947690.35559592,
        "taxRate": 7043200.347635016,
        "taxAmount": -46272967.586504474,
        "balance": 1761401.548267156,
        "revenueCode": "eiusmod tempor laborum",
        "lineNature": "qui deserunt reprehenderit quis commodo",
        "privilegeType": "laboris"
    }
}'

返回响应

🟢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

发票备注

可选

specificBizTypeCode

string

特定业务类型代码

可选

differenceTax

string

差额征税类型代码

可选

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

purchaseInvoiceCategory

string

收购发票类型代码

可选

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

exportTaxRebateType

string

出口业务适用政策代码

可选

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

vatTaxRetreatCode

string

增值税即征即退代码

可选

totalAmt

number <double>

合计金额

必需

默认值:

taxAmt

number <double>

合计税额

必需

tolAmtIncl

number <double>

价税合计

必需

isTax

enum<string>

是否含税：

必需

0(否)；1(是)

枚举值:

additionalElementList

object

附加要素信息列表

可选

additionalElementName

string

附加要素名称

可选

additionalElementType

string

附加要素类型

可选

additionalElementValue

string

附加要素值

可选

blueInvoiceNum

string

对应蓝字发票号码

可选

红票预留字段

正则匹配:

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

confirmNo

string

红字确认信息单编号

必需

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

confirmUuId

string

红字确认单uuid

必需

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

ofdUrl

string

ofd下载地址

必需

pdfUrl

string

pdf下载地址

必需

xmlUrl

string

xml下载地址

必需

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

specificElementList

特定要素信息

可选

Any of

建筑服务特定要素

不动产租赁特定要素

货物运输服务特定要素

specificElementsConstructionServices

object

建筑服务特定要素

可选

示例

{
    "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开票

修改于 2024-08-27 07:25:18

5005-下载发票xml文件

5007-红字确认单申请