CESA-2021-1-033 电子发票应用接口规范 征求意见稿

ICS

CCS

团体标准

T/CESAXXXX—202X

电子发票应用接口规范

Specificationforapplicationofelectronicinvoice

征求意见稿

在提交反馈意见时，请将您知道的相关专利连同支持性文件一并附上。

已授权的专利证明材料为专利证书复印件或扉页，已公开但尚未授权的专利申

请证明材料为专利公开通知书复印件或扉页，未公开的专利申请的证明材料为专利

申请号和申请日期。

202X-XX-XX发布202X-XX-XX实施

中国电子工业标准化技术协会发布

T/CESAXXXX—20XX

前  言

本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起

草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本文件由XXXXX提出。

本文件由中国电子工业标准化技术协会归口。

本标准起草单位：

本标准主要起草人：

III

T/CESAXXXX—20XX

电子发票应用接口规范

1范围

本文件规定了电子发票公共服务应用接口，包括应用场景和要求、接口描述等内容。

本文件适用于电子发票公共服务的设计、开发和实施，不适用于接口内部的具体实现。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB/T17295国际贸易计量单位代码

GB/T36609-2018电子发票基础信息规范

ISO/IEC19501:2005信息技术开发分布式处理统一建模语言（UML）（版本1.4.2）【Information

technology-Opendistributedprocessing-UnifiedModelingLanguage(version1.4.2)】

ISO24156-1:2014术语工作与UML关系中概念模型的图形符号第1部分：术语工作中使用统一建模

语言符号的指南【Graphicnotationsforconceptmodellinginterminologyworkandits

relationshipwithUML-Part1:GuidelinesforusingUMLnotationinterminologywork】

3术语和定义

下列术语和定义适用于本文件。

3.1

电子发票应用公共服务electronicinvoiceapplicationpublicservice

经过行业主管部门认定、可向公众提供的与电子发票应用相关服务，例如：电子发票的开具、交付、

查询、查验、状态管理等。

3.2

应用服务提供方applicationserviceprovider

1

T/CESAXXXX-20XX

运营和管理电子发票应用公共服务软件系统、并向其他用户提供功能调用的单位或个人。例如第三

方的服务公司，在主机上部署、治理、维护应用程序，通过网络，向客户提供软件的计算能力。

3.3

应用服务消费方applicationserviceconsumer

接受应用服务提供方的服务的单位或个人。例如使用远端计算能力的客户。

4缩略语

下列缩略语适用于本文件。

EI：电子发票（ElectronicInvoice）

REST：即表述性状态传递（RepresentationalStateTransfer）

EIASP：电子发票应用服务提供方(ElectronicInvoiceApplicationServiceProvider)

EIASC：电子发票应用服务消费方(ElectronicInvoiceApplicationServiceConsumer)

JSON：JavaScript对象表示法（JavaScriptObjectNotation）

API:应用程序编程接口(ApplicationProgrammingInterface)

5电子发票应用接口概述

电子发票的广泛应用和落地在于数以千万计的企业和数以亿计的民众。企业要规范、便捷地实现

电子发票的开具、接收、查验、报销、记账、报税等相关操作，个人对发票的接收、流转、状态查询和

便捷管理，都需要接入电子发票的监管和服务体系。因此，制定应用服务提供方和应用服务消费者之间

的接口规范，目标就是实现电子发票应用的服务提供方和服务消费方之间服务的共享和数据的交换，推

进企业和个人人电子发票相关应用的开放性，促进全社会参与的电子发票应用“生态链”的建设，提高

企业和个人电子发票相关应用的规范性和便利性。

6电子发票应用场景和要求

6.1应用接口定位及交互关系

电子发票应用接口与标准体系中其他相关标准的定位关系见图1。

2

T/CESAXXXX—20XX

图1电子发票应用接口在标准体系中的定位

电子发票应用服务提供方与消费方之间的交互关系见下图2。

图2电子发票应用服务提供方与消费方的交互关系

6.1.1电子发票创建接口

3

T/CESAXXXX-20XX

电子发票应用服务消费方（EIASC）向电子发票应用服务提供方（EIASP）提交发票开具信息，EIASP

生成电子发票，并返回开票操作结果信息。

6.1.2电子发票冲红接口

EIASC向EIASP提交红字发票开具信息，EIASP生成冲红电子发票，并返回开票操作结果信息。

6.1.3电子发票交付接口

EIASP将开具成功的电子发票信息，通过邮箱、短信、App长链接等方式，发送到EIASC。

6.1.4电子发票查询接口

EIASC向EIASP提交提交电子发票的标识信息及验证信息，EIASP返回电子发票信息。

6.1.5电子发票下载接口

EIASC向EIASP提交提交电子发票的标识信息及验证信息，EIASP返回电子发票版式文件。

6.1.6电子发票查验接口

EIASC向EIASP提交提交电子发票的标识信息及验证信息，EIASP返回电子真伪等电子发票信息。

6.1.7电子发票状态查询接口

EIASC向EIASP提交电子发票状态查询请求，EIASP返回电子发票的状态信息。

6.1.8电子发票状态更新接口

EIASC向EIASP提交电子发票状态更改请求，EIASP返回更改操作结果信息。

6.2应用接口协议

6.2.1接口形式

电子发票应用服务接口使用超文本传输安全协议（HTTPS），支持跨语言，跨操作系统的调用。

6.2.2编码方式

接口调用时请求和响应的字符应符合GB/T18030的强制部分要求。

6.2.3消息格式

应用接口的返回值通用结构说明见表1。

表1接口返回值通用结构

返回键数据类型及格式说明

errcodeC40000：成功，其他：失败

descriptionC..200说明

data

4

T/CESAXXXX—20XX

invoiceIdC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

inIssuTimeYYYYMMDDhhmmss开票时间

6.2.4返回代码描述

应用接口的返回值中的代码码段约定见表2。

表2返回值代码码段约定

代码段描述

0000-1000操作成功段代码

1001-2000操作失败段代码

2001-3000操作异常段代码

3001-4000传递参数错误段代码

10001-20000自定义区段

6.2.5安全要求

接口规范采用数字签名、时间戳、正则检查等技术，实现互联网传输的安全保障，防止跨站脚本攻

击(XSS)、跨站请求伪造(CRSF)、SQL注入（SQL-Injection）、重放（Replay）等网络攻击。

7应用接口参数要求

7.1电子发票创建接口

接口原型：

Stringcreate(instringpatams)

电子发票创建接口的输入参数见表3。

表3电子发票创建接口输入参数

参数约束/条件数据类型及格式描述

invoiceTypeCode0C5发票种类代码

inIssuTypeMC1开票类型

inIssuTimeMYYYYMMDDhhmmss开票时间

totalAmWithoutTaxMN..22,2合计不含税金额

5

T/CESAXXXX-20XX

totalTaxAmMN..22,2合计税额

totalTax-includedAmMN..22,2价税合计金额

agentIssuSignMC1代开标志

agentIssuNameMC..200代开单位名称

purchaseSignMC1收购标志

orlEICodeMC12原发票代码

orlEINumMN8原发票号码

rushRedReason0C..200冲红原因

sellerIdNumMC10..20销售方识别号

sellerNameMC1..200销售方名称

sellerTelNum0C..30销售方电话

sellerAddrMC..100销售方地址

sellerBankNameMC..100销售方开户银行名称

sellerBankAccNumMC..100销售方开户银行帐号

buyerTypeMC2购买方类型

buyerNum0C10..20购买方识别号

buyerNameMC..200购买方名称

buyerTelNum0C..30购买方电话

buyerMobPhoneNum0C..30购买方手机号码

buyerAddr0C..200购买方地址

buyerE-mail0C..100购买方电子邮箱

buyerBankName0C..200购买方开户银行名称

buyerBankAccNum0C..200购买方开户银行帐号

itemNameMC..200项目名称

specMod0C..200规格型号

meaUnits0C..30计量单位

taxSignMC1含税标志

6

T/CESAXXXX—20XX

quantity0N..22,8数量

unPrice0N..22,8单价

amountMN..22,2金额

taxRateMN..12,6税率

taxClassificationCode0C..30税收分类编码

taxPreferMark0C..1税收优惠标识

taxPreferDescripCC..500优惠说明

zeroTaxRateMark0C..1零税率标识

deduction0N..22,2扣除额

remark0C..500备注

remarkImg0BY备注图片

orderId0C..50订单号

payOrderNum0C..50支付流水号

payMethod0C..30支付方式

payPlatformName0C..200支付平台名称

payPlatformCode0C5..15支付平台编码

waybillNum0C..30物流运单号

logisticsPlatformName0C..200物流平台名称

logisticsPlatformCode0C5..15物流平台编码

drawerIdNumCC10..20开具方识别号

drawerNameCC1..200开具方名称

drawerTelNumCC..30开具方电话

drawerAddrCC..100开具方地址

drawerBankNameCC..100开具方开户银行名称

drawerBankAccNumCC..100开具方开户银行账号

invOwnNumMN8所有人编号

invOwnPhoneNum0C30收票人手机号

7

T/CESAXXXX-20XX

invOwnE-mail0C100收票人电子邮箱

submitterNum0N8报销提交人编号

assistantReiId0C30辅助ID

businessCardNum0C30公务卡号

issuOrgPubKey0C100颁发机构公钥

issuOrgSign0C100颁发机构签名

sellerPubKey0C100开具方公钥

sellerSign0C100开具方签名

platformPubKey0C100开票平台公钥

platformSign0C100开票平台签名

revOrgPubKey0C100核准机构公钥

revOrgSign0C100核准机构签名

revOrgIdNum0C100核准机构识别号

revOrgName0C200核准机构名称

checkCode0C100校验码

ciperCode0C200防伪密文

开票项目信息见表4。

表4开票项目信息字段描述

参数约束/条件数据类型及格式描述

itemPropertyCodeMC1发票行性质代码

itemNameMC..200项目名称

specMod0C..200规格型号

meaUnits0C..30计量单位

taxSignMC1含税标志

8

T/CESAXXXX—20XX

quantity0N..22,8数量

unPrice0N..22,8单价

amountMN..22,2金额

taxRateMN..12,6税率

comTaxAmMN..22,2税额

taxClassificationCode0C..30税收分类编码

taxPreferMark0C..1税收优惠标识

taxPreferDescripCC..500优惠说明

zeroTaxRateMark0C..1零税率标识

deduction0N..22,2扣除额

发票关联信息见表5。

表5发票关联信息字段描述

参数约束/条件数据类型及格式描述

orderId0C..50订单号

payOrderNum0C..50支付流水号

payMethod0C..30支付方式

payPaltformName0C..200支付平台名称

payPaltformCode0C5..15支付平台编码

waybillNum0C..30物流运单号

logisticsPlatformName0C..200物流平台名称

logisticsPlatformCode0C5..15物流平台编码

9

T/CESAXXXX-20XX

platformName0C200发票开具服务平台名称

platformCode0C5..15发票开具服务平台编码

创建电子发票接口的返回值参数同的表1，其返回数据细节说明见表6。

表6电子发票输出data参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

layoutFileURLC..200版式文件URL地址

layoutFileC..200发票版式文件base64格式

eventLog异常汇聚对象

globalId全局ID

parentReid父请求ID

电子发票创建接口的调用参数示例参见附录A中的A.1。

7.2电子发票冲红接口

接口原型：

Stringinvalid(instringpatams)

电子发票冲红接口的输入参数见表7。

表7电子发票冲红接口输入参数

参数数据类型及格式描述

invoiceIDC32原发票ID

invoiceCodeC12原蓝票发票代码

10

T/CESAXXXX—20XX

invoiceNumN8原蓝屏发票号码

电子发票冲红接口的返回值参数同5.2.3节中的表1，其返回数据细节说明见表8。

表8电子发票冲红接口输出data参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

layoutFileURLC..200版式文件URL地址

layoutFileC..200发票版式文件base64格式

eventLog异常汇聚对象

globalId全局ID

parentReid父请求ID

电子发票冲红接口的调用参数示例参见附录A中的A.2。

7.3电子发票交付接口

接口原型

Stringdeliver(instringpatams)

电子发票交付分为短信、邮件和APP长链接等三种，每种交付方式输入参数细节不同。

其中短信交付接口输入参数说明见表9。

表9电子发票短信交付接口输入参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

11

T/CESAXXXX-20XX

invOwnPhoneNumC30收票人手机号

invoiceMsgC..200短信交付内容

电子发票短信交付接口的调用参数示例参见附录A中的A.3.1。

邮箱交付接口输入参数见表10。

表10电子发票邮箱交付接口输入参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

invOwnE-mailC100收票人电子邮箱

layoutFileBY_PDF版式文件

电子发票电子邮箱交付接口的调用参数示例参见附录A中的A.3.2。

应用小程序（APP）交付接口输入参数见表11。

表11电子发票APP交付接口输入参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

电子发票应用小程序（APP）交付接口的调用参数示例参见附录A中的A.3.3。

电子发票交付接口输出参数均相同，其接口参数说明见表12。

表12电子发票交付接口输出参数

参数数据类型及格式描述

errcodeC40000：成功，其他：失败

（更多状态码的详请见表A.9)

descriptionC..200说明成功或失败原因

12

T/CESAXXXX—20XX

（更多描述的详请见表A.9)

eventLog异常汇聚对象

globalId全局ID

parentReid

父请求ID

7.4电子发票查询接口

接口原型：

Stringquery(instringpatams)

电子发票信息查询输入参数见表13。

目前支持的查询有电子凭据多条件筛选查询输入发票代码，发票号码开票开始时间和结束时间

四要素查询输入发票代码，发票号码开票时间

表13电子发票信息查询输入参数

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

inIssuTimeBeginyyyymmdd开票开始时间

inIssuTimeEnd

yyyymmdd开票结束时间

inIssuTime

yyyymmdd开票时间

checkCode

C12效验码

13

T/CESAXXXX-20XX

invoiceMoney

N8不含税金额

电子发票信息查询接口的返回值结构见表1，其中的明细信息说明见表3、开票项目信息见表4、

发票关联信息参见表5。

电子发票查询接口的调用示例参数参见附录A中的A.4。

7.5电子发票下载接口

接口原型

Stringdownload(instringpatams)

电子发票下载接口支持发票版式文件下载

发票备注图片下载

发票版式文件批量下载

发票备注图片批量下载

电子发票下载接口输入参数见表14。

表14电子发票下载接口输入参数（单张下载）

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

表14电子发票下载接口输入参数（批量下载）

电子发票下载批量下载调用示例参数参见附录A中的A.6。

参数数据类型及格式描述

invoiceIDC32发票ID

invoiceCodeC12发票代码

invoiceNumN8发票号码

invoiceIdListArray发票信息集合数组

电子发票下载接口的返回值结构见表1，其中的详细信息说明见表15。

表15电子发票下载接口输出data参数

14

T/CESAXXXX—20XX

电子发票下载接口的调用示例参数参见附录A中的A.5。

参数数据类型及格式

layoutFileURLC..200版式文件URL地址

layoutFileC..200版式文件

invoiceIdC32发票ID

eventLog异常汇聚对象

globalId全局ID

parentReid父请求ID

7.6电子发票查验接口

接口原型：

Stringverify(instringpatams)

电子发票四要素查验或批量异步查验接口的输入参数见表16和16.2。

电子发票识别查验接口的输入参数见表16.3

7.6.1电子发票四要素查验接口

表16电子发票四要素查验接口输入参数

参数是否必须描述

invoiceCode是发票代码

invoiceNo是发票号码

invoiceDate是开票日期（如20161210）

invoiceMoney否查验纸质专用发票、机动车发票时必填不含

税金额，否则可不填

checkCode否查验纸质普通发票、电子普通发票必填发校

验码后6位，否则可不填

表16.1电子发票四要素查验接口多张查验输入参数

电子发票四要素查验的多张查验调用参数示例参见附录A中的表16.1。

15

T/CESAXXXX-20XX

参数是否必须描述

invoiceCode是发票代码

invoiceNo是发票号码

invoiceDate是开票日期（如20161210）

invoiceMoney否查验纸质专用发票、机动车发票时必填不含税金

额，否则可不填

checkCode否查验纸质普通发票、电子普通发票必填发校验码

后6位，否则可不填

list是发票信息集合数组包括发票代码，发票号码，效

验码等信息

7.6.2电子发票识别查验接口

表16.2电子发票识别查验接口输入参数

电子发票识别查验调用参数示例参见附录A中的表16.2。

参数是否必须数据类型及格式描述

file是form-data电子普通发票PDF上传

7.6.3电子发票离线查验接口

表16.3电子发票离线查验接口输入参数

电子发票离线查验调用参数示例参见附录A中的表16.3。

电子发票离线查验的输入参数如下表所示

参数约束/条件数据类型及格式描述

invoiceTypeCode0C5发票种类代码

inIssuTypeMC1开票类型

inIssuTimeMYYYYMMDDhhmmss开票时间

16

T/CESAXXXX—20XX

totalAmWithoutTaxMN..22,2合计不含税金额

totalTaxAmMN..22,2合计税额

totalTax-includedAmMN..22,2价税合计金额

agentIssuSignMC1代开标志

agentIssuNameMC..200代开单位名称

purchaseSignMC1收购标志

orlEICodeMC12原发票代码

orlEINumMN8原发票号码

rushRedReason0C..200冲红原因

sellerIdNumMC10..20销售方识别号

sellerNameMC1..200销售方名称

sellerTelNum0C..30销售方电话

sellerAddrMC..100销售方地址

sellerBankNameMC..100销售方开户银行名称

sellerBankAccNumMC..100销售方开户银行帐号

buyerTypeMC2购买方类型

buyerNum0C10..20购买方识别号

buyerNameMC..200购买方名称

buyerTelNum0C..30购买方电话

buyerMobPhoneNum0C..30购买方手机号码

buyerAddr0C..200购买方地址

buyerE-mail0C..100购买方电子邮箱

buyerBankName0C..200购买方开户银行名称

buyerBankAccNum0C..200购买方开户银行帐号

itemNameMC..200项目名称

specMod0C..200规格型号

meaUnits0C..30计量单位

17

T/CESAXXXX-20XX

taxSignMC1含税标志

quantity0N..22,8数量

unPrice0N..22,8单价

amountMN..22,2金额

taxRateMN..12,6税率

taxClassificationCode0C..30税收分类编码

taxPreferMark0C..1税收优惠标识

taxPreferDescripCC..500优惠说明

zeroTaxRateMark0C..1零税率标识

deduction0N..22,2扣除额

remark0C..500备注

remarkImg0BY备注图片

orderId0C..50订单号

payOrderNum0C..50支付流水号

payMethod0C..30支付方式

payPlatformName0C..200