发票数据规范
变更历史
| 日期 | 变更描述 | 变更人 | 版本 |
|---|---|---|---|
| 2018/12/21 | 编写发票数据规范初稿 | 李创 | V1.01 |
| 2019/04/02 | 1、销项发票返回新增校验码、订单号和第一条明细商品名称字段；2、进项发票返回新增客运票、轮船票和过路过桥费发票，以及部分发票新增所在地字段 | 李创 | V1.02 |
| 2020/07/04 | 更新进项发票字段长度 | 李创 | V2.00 |
| 2022/03/14 | 更新进项票种全电发票 | 凌文豪 | V2.01 |
| 2022/03/14 | 新增电子航空客票、电子铁路客票发票信息 | 李创 | V2.02 |
| 2024/08/7 | 拆分文档，规范最新发票名，添加跳转链接，现在可以直接点击发票类型跳转 | 陈焕威 | V2.03 |
| 2025/07/15 | 新增票种数电发票（机动车销售统一发票）、数电发票（二手车销售统一发票） | 王雅迪 | V2.04 |
| 2025/11/19 | 新增票种数电发票（通行费发票） | 陈远丹 | V2.05 |
概述
发票类型编码
| 发票类型编码 | 发票类型名称 |
|---|---|
| 1 | 电子普通发票 |
| 2 | 电子专用发票 |
| 3 | 纸质普通发票 |
| 4 | 纸质专用发票 |
| 5 | 普通纸质卷票 |
| 7 | 通用机打纸质发票 |
| 8 | 的士票 |
| 9 | 火车票 |
| 10 | 飞机票 |
| 11 | 其他票 |
| 12 | 机动车销售发票 |
| 13 | 二手车销售发票 |
| 14 | 定额发票 |
| 15 | 通行费电子发票 |
| 16 | 客运发票 |
| 17 | 过路桥费发票 |
| 19 | 完税证明 |
| 20 | 轮船票 |
| 21 | 海关缴款书 |
| 23 | 通用机打电子发票 |
| 24 | 火车票退票凭证 |
| 25 | 财政电子票据 |
| 26 | 数电票（普通发票） |
| 27 | 数电票（增值税专用发票） |
| 28 | 数电票（航空运输电子客票行程单） |
| 29 | 数电票（铁路电子客票） |
| 72 | 数电发票（通行费发票） |
| 83 | 数电发票（机动车销售统一发票） |
| 84 | 数电发票（二手车销售统一发票） |
销项发票数据格式
增值税发票
| 参数 | 长度 | 描述 |
|---|---|---|
serialNo | 20 | 开票请求唯一流水号 |
type | 1 | 0蓝票，1红票 |
invoiceCode | 12 | 发票代码 |
invoiceNo | 18 | 发票号码 |
invoiceDate | 12 | 开票日期，格式2015-11-12 17:43:51 |
invoiceAmount | 20 | 不含税金额 |
taxAmount | 20 | 税额 |
totalAmount | 20 | 价税合计金额 |
totalAmountCn | 150 | 价税合计金额繁体 |
drawer | 8 | 开票员 |
payee | 8 | 收款员 |
reviewer | 8 | 复核人 |
originalInvoiceCode | 12 | 原发票代码 |
originalInvoiceNo | 8 | 原发票号码 |
remark | 200 | 备注 |
salerTaxNo | 20 | 销货方识别号 |
salerName | 80 | 销货方名称 |
salerAddressPhone | 100 | 销货方地址、固定电话 |
salerAccount | 100 | 销货方银行账号 |
buyerTaxNo | 20 | 购货方方识别号 |
buyerName | 80 | 购货方名称 |
buyerAddressPhone | 100 | 购货方地址、固定电话 |
buyerAccount | 100 | 购货方银行账号 |
buyerMobilePhone | 11 | 购货方手机 |
checkCode | 20 | 随机码 |
fwm | 20 | 防伪码/校验码 |
wxCardBagUrl | 250 | 微信卡包链接 |
pdfUrl | 250 | 发票pdf下载地址 |
snapshotUrl | 250 | 快照地址 |
invoiceType | 2 | 发票种类：1、普通电子发票；2、电子发票专票；3、普通纸质发票；4、专用纸质发票；5、普通纸质卷票 |
invoiceStatus | 2 | 发票状态0:正常、1：失控、2：作废、3：红冲、4：异常 |
invoiceChannel | 2 | 1:托管,2:单机 |
cipherArea | 200 | 密码区 |
sgfp | 1 | 收购发票标志 0 其他增值税普通发票 1 农产品销售发票 2 农产品收购发票 |
invalidDate | 作废日期 | |
machineNo | 50 | 机器编码 |
buyerEmail | 50 | 购方邮箱 |
orderNo | 50 | 订单号 |
qsbz | 1 | 清单标志，0：根据项目名称字数，自动产生清单，保持目前逻辑不变，1：区清单对应票面内容字段打印到发票票面上，将项目信息XMXX打印到清单上，默认为0 |
taxFlag | 1 | 含税标志（1：含税，0：不含税） |
itemName | 90 | 第一个明细名称 |
items | 发票内容明细数组 |
items 发票明细| 字段 | 长度 | 描述 |
|---|---|---|
unit | 20 | 项目单位 |
specModel | 44 | 规格型号 |
taxAmount | 20 | 税额（计算税额请注意总价是否含税）(小数点后2位,以元为单位精确到分) |
goodsName | 项目名称 | |
unitPrice | 24 | 项目单价（根据hsbz确定是否含税）(小数点后6位,四舍五入) |
num | 24 | 项目数量 |
detailAmount | 16 | 项目金额（根据hsbz确定是否含税）(小数点后2位,以元为单位精确到分.等于=单价*数量,根据含税标志，确定此金额是否为含税金额) |
taxRate | 10 | 税率 |
goodsCode | 64 | 商品编码 |
zeroTaxRateFlag | 10 | 零税率标识 |
discountType | 1 | 折扣行 |
preferentialPolicy | 2 | 优惠政策标识 |
vatException | 2 | 增 值税特殊管理 |
修改于 2025-11-21 03:13:37