发票数据规范

变更历史

日期	变更描述	变更人	版本
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

概述

部分收票能力接口返回的发票数据格式较为复杂多样，特撰写本文单独对其做描述。

发票类型编码

发票类型编码	发票类型名称
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	数电票（铁路电子客票）
30	形式发票

销项发票数据格式

增值税发票

参数	长度	描述
`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	增值税特殊管理

最后修改时间： 3 个月前