5002-开具数电蓝字发票

开发环境

http://192.168.51.174

POST

http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost

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

责任人：cyx123

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

请求参数

Header 参数

SID

string

对应接口方法编号

可选

示例值:

5002

Authorization

string

可选

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

示例值:

bearer token

Body 参数application/json

invoiceSerialNumber

string <uuid>

发票请求流水号

必需

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

invoiceType

enum<string>

发票种类

必需

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

枚举值:

6162

invoiceMethod

string

开票方式

必需

开票方式 0-异步开票，1-同步开票不传默认异步开票非总部交付（乐企直连）时，传入无效总部交付（乐企前置）时，传入有效

creditCode

string

纳税人识别号

必需

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

正则匹配:

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

saleAddress

string

销方地址

可选

salePhone

string

销方电话

可选

saleBank

string

销方开户银行

可选

saleBankAccount

string

销方银行账号

可选

creditType

enum<string>

购方企业类型

可选

购方企业类型（1）购方企业类型：1（企业）；2（非企业单位）；3（个人）。（2）购方企业类型有传值时，以传入为准；（3）购方企业类型为空时，根据购方税号传值判断： ① 若购方税号为空，默认为非企业单位； ② 若购方税号有值，默认为企业。（4）如需开具发票给自然人，购方企业类型字段必传，需传“3”。（5）开具数电电子普票时，允许传入2、3。（6）开具数电电子专票时，只能传1。

枚举值:

custName

string

购方名称

必需

custCreditCode

string

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

可选

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

custAddress

string

购方地址

可选

custPhone

string

购方电话

可选

custBank

string

购方开户银行

可选

custBankAccount

string

购方银行账号

可选

custEmail

string

购方邮箱

可选

购方邮箱：总部交付时，可传。校验格式：@.*** 非总部交付时，传入无效。

custMobile

string

购方手机

可选

购买方手机总部交付时，可传。非总部交付时，传入无效。

custWeChat

string

购方微信

可选

购买方微信总部交付时，交付方式3 微信卡包：必传。非总部交付时，非必传，传入无效。

manager

string

购买方经办人姓名

可选

managerIdNo

string

购买方经办人证件号码

可选

managerPhone

string

购买方经办人联系电话

可选

payeeBankName

string

收款银行名称

可选

payeeBankAccount

string

收款银行账号

可选

settleType

enum<string>

结算方式

可选

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

枚举值:

010203040599

taxVenue

string

应税行为发生地

可选

openPeople

string

开票人

必需

openPeopleIdNo

string

开票人证件号码

可选

openPeopleIdType

string

开票人证件类型

可选

invoiceRemark

string

发票备注

可选

isShowCustAccount

string

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

必需

N-否，Y-是

isShowSaleAccount

string

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

必需

N-否，Y-是

payee

string

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

必需

checker

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 含税用于标识该笔开票订单内商品是含税价还是不含税价。标志为1：请求报文中所有明细行金额、明细行单价都必须为含税价。标志为0：请求报文中所有明细行金额、明细行单价都必须为不含税价

枚举值:

detailItemList

object

商品信息列表

必需

serialNo

string

明细行序号

必需

matName

string

项目名称

必需

spec

string

规格型号

可选

unit

string

单位

可选

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

quantity

string

数量

可选

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

price

string

单价

可选

如 “数量”“单位” 栏次非空，则本栏次必须非空含税标志为 0 时，为不含税单价含税标志为 1 时，为含税单价

amt

number <double>

金额

必需

含税标志为 0 时，为不含税金额含税标志为 1 时，为含税金额

taxRate

number <double>

增值税税率/ 征收率

必需

默认值:

示例值:

0.06

taxAmount

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%即征即退

additionalElementList

object

附加要素信息列表

可选

additionalElementName

string

附加要素名称

可选

additionalElementType

string

附加要素类型

可选

additionalElementValue

string

附加要素值

可选

specificElementList

特定要素信息

可选

Any of

建筑服务特定要素

不动产租赁特定要素

货物运输服务特定要素

specificElementsConstructionServices

object

建筑服务特定要素

可选

deliverType

string

交付方式

可选

总部交付时，交付方式取值：0 或空不交付；1 邮箱；2 短信；3 微信插卡包；5 定制。非总部交付时，传入无效。

示例

{
    "invoiceSerialNumber": "484F9FD6-7aAE-5f2F-ED5F-d94A9E6FD9c3",
    "invoiceType": "61",
    "creditCode": "P5239285NFK5DBX09J",
    "custName": "陆霞",
    "openPeople": "邹超",
    "totalAmt": 88,
    "taxAmt": 30,
    "tolAmtIncl": 71,
    "isTax": "0",
    "detailItemList": {
        "serialNo": "ut sunt laborum Excepteur",
        "matName": "但子界外",
        "amt": 73,
        "taxRate": 39,
        "taxAmount": 74,
        "revenueCode": "59",
        "lineNature": "commodo non eu",
        "privilegeType": "Ut consequat",
        "price": "73",
        "quantity": "67",
        "amountIncludeTax": 2,
        "balance": 90,
        "spec": "exercitation qui pariatur",
        "unit": "est eiusmod"
    },
    "taxVenue": "石嘴山市",
    "custCreditCode": "92",
    "invoiceRemark": "族思类",
    "custAddress": "广西壮族自治区 百色市 德保县",
    "saleBankAccount": "18196736426",
    "deliverType": "nisi",
    "salePhone": "88014319181012878x",
    "settleType": "02",
    "vatTaxRetreatCode": "32",
    "additionalElementList": {
        "additionalElementValue": "引族治三",
        "additionalElementType": "附加要素类型",
        "additionalElementName": "汪杰"
    },
    "purchaseInvoiceCategory": "ex deserunt ut",
    "saleAddress": "香港特别行政区 九龙 黄大仙区",
    "openPeopleIdType": "66",
    "creditType": "3",
    "specificBizTypeCode": "55",
    "manager": "龙磊",
    "payeeBankName": "先主压使出重",
    "payeeBankAccount": "18640185976",
    "differenceTax": "adipisicing quis dolore",
    "custMobile": "13119198855",
    "managerIdNo": "887063207105255638",
    "custPhone": "364477182211306594",
    "specificElementList": "eu aliqua",
    "custBank": "甘肃省 天水市 秦州区",
    "exportTaxRebateType": "mollit",
    "saleBank": "吉林省 四平市 铁东区",
    "custWeChat": "dolor ex",
    "managerPhone": "18148748674",
    "openPeopleIdNo": "48732820310628791X",
    "custEmail": "m.hvwmybsamd@khrpoeg.mt",
    "custBankAccount": "18166148894"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost' \
--header 'SID: 5002' \
--header 'Authorization: bearer token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceSerialNumber": "484F9FD6-7aAE-5f2F-ED5F-d94A9E6FD9c3",
    "invoiceType": "61",
    "creditCode": "P5239285NFK5DBX09J",
    "custName": "陆霞",
    "openPeople": "邹超",
    "totalAmt": 88,
    "taxAmt": 30,
    "tolAmtIncl": 71,
    "isTax": "0",
    "detailItemList": {
        "serialNo": "ut sunt laborum Excepteur",
        "matName": "但子界外",
        "amt": 73,
        "taxRate": 39,
        "taxAmount": 74,
        "revenueCode": "59",
        "lineNature": "commodo non eu",
        "privilegeType": "Ut consequat",
        "price": "73",
        "quantity": "67",
        "amountIncludeTax": 2,
        "balance": 90,
        "spec": "exercitation qui pariatur",
        "unit": "est eiusmod"
    },
    "taxVenue": "石嘴山市",
    "custCreditCode": "92",
    "invoiceRemark": "族思类",
    "custAddress": "广西壮族自治区 百色市 德保县",
    "saleBankAccount": "18196736426",
    "deliverType": "nisi",
    "salePhone": "88014319181012878x",
    "settleType": "02",
    "vatTaxRetreatCode": "32",
    "additionalElementList": {
        "additionalElementValue": "引族治三",
        "additionalElementType": "附加要素类型",
        "additionalElementName": "汪杰"
    },
    "purchaseInvoiceCategory": "ex deserunt ut",
    "saleAddress": "香港特别行政区 九龙 黄大仙区",
    "openPeopleIdType": "66",
    "creditType": "3",
    "specificBizTypeCode": "55",
    "manager": "龙磊",
    "payeeBankName": "先主压使出重",
    "payeeBankAccount": "18640185976",
    "differenceTax": "adipisicing quis dolore",
    "custMobile": "13119198855",
    "managerIdNo": "887063207105255638",
    "custPhone": "364477182211306594",
    "specificElementList": "eu aliqua",
    "custBank": "甘肃省 天水市 秦州区",
    "exportTaxRebateType": "mollit",
    "saleBank": "吉林省 四平市 铁东区",
    "custWeChat": "dolor ex",
    "managerPhone": "18148748674",
    "openPeopleIdNo": "48732820310628791X",
    "custEmail": "m.hvwmybsamd@khrpoeg.mt",
    "custBankAccount": "18166148894"
}'

返回响应

🟢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

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

必需

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

发票备注

可选

isShowCustAccount

string

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

必需

N-否，Y-是

isShowSaleAccount

string

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

必需

N-否，Y-是

payee

string

收款人姓名

必需

checker

string

复核人姓名

必需

pdfUrl

string

pdf下载地址

必需

xmlUrl

string

xml下载地址

必需

ofdUrl

string

ofd下载地址

必需

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>

是否含税：

必需

枚举值:

invoiceStatus

string

发票状态

必需

01：正常；02：已作废；03：已红冲-全额；04：已红冲-部分

openStatus

string

开票状态

必需

0：未开票；1：开票成功；2：开票失败；3开票中

openResultDesc

string

开票失败原因

必需

uploadStatus

string

上传状态

必需

-1：未上传；00：成功；01：处理中（含有超时）；02：失败；03：重复上传；04：重新上传

detailItemList

object

数电发票明细行列表

必需

serialNo

string

明细行序号

必需

matName

string

项目名称

必需

spec

string

规格型号

可选

unit

string

单位

可选

特定业务类型代码为“06：不动产租赁服务发票”时，必填，只能是平方米、平方千米、公顷、亩、h㎡、k㎡、㎡等。

quantity

string

数量

可选

如“单价”“单位”栏次非空，则本栏次必须非空特定业务类型代码为“06：不动产租赁服务发票”时，必填，填写租赁的不动产的面积。

price

string

单价

可选

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

amt

number <double>

金额

必需

taxRate

number <double>

增值税税率/ 征收率

必需

默认值:

示例值:

0.06

taxAmount

number <double>

税额

必需

amountIncludeTax

string

含税税额

必需

balance

number <double> | null

扣除额

可选

revenueCode

string

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

必需

lineNature

string

发票行性质

必需

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

privilegeType

string

优惠政策标识

必需

additionalElementList

object

附加要素信息列表

可选

additionalElementName

string

附加要素名称

可选

additionalElementType

string

附加要素类型

可选

additionalElementValue

string

附加要素值

可选

specificElementList

特定要素信息

可选

Any of

建筑服务特定要素

object

货物运输服务特定要素

specificElementsConstructionServices

object

建筑服务特定要素

可选

示例

{
    "invoiceSerialNumber": "d0Ac2eFC-21e0-B104-188A-bd43A9f5CfC3",
    "invoiceType": "62",
    "creditCode": "8N024371WWL0AUFU8D",
    "custName": "方艳",
    "custCreditCode": "76",
    "openPeople": "郑静",
    "totalAmt": 30,
    "taxAmt": 62,
    "tolAmtIncl": 35,
    "isTax": "1",
    "detailItemList": {
        "serialNo": "100",
        "matName": "期精广给",
        "amt": 75,
        "taxRate": 60,
        "taxAmount": 60,
        "revenueCode": "74",
        "lineNature": "eiusmod proident voluptate",
        "privilegeType": "do est dolor",
        "balance": 22,
        "amountIncludeTax": 86,
        "spec": "ad ut dolor",
        "quantity": "36",
        "price": "11",
        "unit": "consectetur aliqua Ut elit fugiat"
    },
    "invoiceNature": "0",
    "invoiceNum": "42864632",
    "invoiceDate": "1976-12-27 23:52:05",
    "custBank": "贵州省 贵阳市 观山湖区",
    "saleBankAccount": "18168956474",
    "managerIdNo": "78260818710610753X",
    "taxVenue": "九龙",
    "custPhone": "52333619891024224X",
    "custBankAccount": "18125715752",
    "managerPhone": "18670573413",
    "saleAddress": "吉林省 白城市 通榆县",
    "specificBizTypCodee": "43",
    "settleType": "1",
    "vatTaxRetreatCode": "21",
    "purchaseInvoiceCategory": "nisi enim tempor ipsum",
    "exportTaxRebateType": "et occaecat esse ad",
    "additionalElementList": {
        "additionalElementType": "附加要素类型",
        "additionalElementName": "邵静",
        "additionalElementValue": "油件内同认个调"
    },
    "salePhone": "81327319250710477X",
    "manager": "马艳",
    "payeeBankAccount": "18194587360",
    "openPeopleIdType": "74",
    "openPeopleIdNo": "39468718861108957X",
    "differenceTax": "quis est ad sit occaecat",
    "custEmail": "e.trrgfcxxx@qfretjhr.tt",
    "custAddress": "河北省 廊坊市 固安县",
    "invoiceRemark": "内外间",
    "payeeBankName": "来克海整最",
    "saleBank": "上海 上海市 青浦区",
    "creditType": "1"
}

🟢200通用返回报文

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

5001-查询发票额度

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