# 发票数据结构 # 变更历史 日期 | 变更描述 | 变更人 | 版本 ---- | ---- | ---- | ---- 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/02/28 | 新增税局入账相关信息；数电航空电子客票新增票价字段，invoiceAmount修复为不含税金额 | 王雅迪 | V2.03 | 2025/06/18 | 新增数电发票（机动车销售统一发票）类型 | 王雅迪 | V2.04 | 2025/07/09 | 新增数电发票（二手车销售统一发票）类型 | 王雅迪 | V2.05 | 2025/10/24 | 新增数电发票（通行费发票）类型 | 陈远丹 | V2.06 | 2025/12/08 | selectTime勾选时间说明修正为YYYY-MM-DD； authenticateTime勾选认证时间说明修正为YYYY-MM-DD；recordedPeriod税局入账属期说明修正为YYYY-MM-DD HH:MM:SS| 黄潮鑫 | V2.07 | 2026/01/14 | 通行费电子发票、数电航空电子客票、数电铁路电子客票、增值税代扣代缴完税凭证，补充deductionFlag是否可抵扣、effectiveTaxAmount可抵扣税额字段| 陈远丹 | V2.08 | 2026/03/02 | 海关缴款书、数电机动车、数电二手车发票，补充deductionFlag是否可抵扣、effectiveTaxAmount可抵扣税额字段| 陈远丹 | V2.09 | # 概述 - 部分收票能力接口中的发票数据(做为参数或返回值)格式较为复杂多样，特撰写本文单独对其做描述。比如：[5.01全票池导入](https://open-ultimate.piaozone.com/api-145421046.md) - 可查验发票类型：电子普通发票、 电子专用发票、 纸质普通发票、 纸质专用发票、 普通纸质卷票、 机动车销售发票、二手车销售发票、数电普票、数电专票、数电（航空运输电子客票行程单）、数电（铁路电子客票）、数电（通行费发票）、数电（机动车销售统一发票）、数电（二手车销售统一发票） # 发票类型编码 | 发票类型编码 | 发票类型名称 | |----------|------------------| | 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 | 海外发票 | | 31 | 海外收据 | | 47 | 增值税代扣代缴完税凭证 | | 72 | 数电发票（通行费发票） | | 83 | 数电发票（机动车销售统一发票） | | 84 | 数电发票（二手车销售统一发票） | # 进项发票数据格式 ## 机动车销售统一发票
参数 长度 描述
invoiceType 2 发票类型：12、机动车销售统一发票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
type 1 0-蓝字发票；1-红字发票
invoiceCode 12 发票代码
invoiceNo 8 发票号码
etaxInvoiceNo 20 数电纸票号码
originalInvoiceCode 12 原发票代码
machineNo 30 机器编号
invoiceDate 0 开票日期 2001-01-01
buyerName 100 购方名称
buyerCardno 100 买方身份证号/组织机构代码
buyerTaxNo 20 购方税号
salerName 100 销方名称
salerTaxNo 20 销方税号
salerAccount 150 销方银行账号
salerPhone 30 销方电话号码
salerAddress 150 销方地址
salerBankName 50 销方开户银行
vehicleType 30 车辆类型
brandModel 80 厂牌型号
producingArea 30 产地
certificateNum 32 合格证号
importCertificate 32 进口证明书号
commodityInspectionNum 32 商检单号
engineNum 56 发动机编号
vehicleIdentificationCode 32 车辆识别代码
taxRate 25 税率
totalTaxAmount 23 合计税额
overTaxCode 15 完税凭证号码
taxAuthorityCode 20 税务机关代码
taxAuthorityName 50 税务机关名称
invoiceAmount 23 合计金额（不含税）
totalTon 10 吨位
limitePeople 10 限乘人数
proxyMark 2 代开标示：默认为0,代开为1
drawer 8 开票人
taxPeriod 10 所属税期(如：202104)
remark 200 备注
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，4预勾选，5勾选中，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
authenticateTime 0 勾选认证时间 YYYY-MM-DD
totalAmount 23 价税合计
checkCode 50 校验码
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
invalidDate 作废日期 YYYY-MM-DD
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 火车票
参数 长度 描述
invoiceType 2 发票类型：9、火车票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
printingSequenceNo 32 印刷序号
trainNum 10 车次
invoiceDate 0 乘车日期 2001-01-01
trainTime 10 火车乘车时间 16:20
passengerName 30 乘客姓名
totalAmount 13 票价
seat 10 座位等级
stationGetOn 10 上车站点
stationGetOff 10 下车站点
businessType 1 业务类型 :1.在售票，2.退票
updateTime 更新时间 YYYY-MM-DD HH:MM:SS
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 火车票退票凭证
参数 长度 描述
invoiceType 2 发票类型：24、火车票退票凭证
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
number 32 收据号码
totalAmount 13 票价
companySeal 1 是否有公司印章（0：没有； 1： 有）
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 数电发票（铁路电子客票）
参数 长度 描述
invoiceType 2 发票类型：29、数电发票（铁路电子客票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceStatus 2 发票状态：0:正常、7：部分红冲、8：全额红冲
invoiceNo 32 发票号码
issueDate 开票日期 yyyy-mm-dd
typeOfBusiness 10 业务类型,1-售,2-退
stationGetOn 10 上车站点
stationGetOff 10 下车站点
trainNum 10 车次
invoiceDate - 开票日期 yyyy-mm-dd
carrierDate - 乘车日期 yyyy-mm-dd
departureTime 10 出发时间 16:20
airConditCharacteristics 10 空调特征
seat 10 席别
carriage 10 车厢
seatNo 10 席位
eleTicketNumber 32 电子客票号码
customerIdentityNum 25 证件号码
passengerName 150 乘客姓名
invoiceAmount 13 金额（不含税）
taxRate 13 税率
totalTaxAmount 13 税额
totalAmount 19 价税合计
purchaserName 100 购方名称
purchaserAddressPhoneNum 150 购方地址电话
purchaserDepositBankAccNum 150 购方银行和账号
purchaserUnifiedSocialCreditCode 150 购方税号
salerName 100 销方名称
salerTaxNo 20 销方税号
sellerAddressPhoneNum 150 销方地址电话
sellerDepositBankAndAccountNum 150 购方银行和账号
originalInvoiceNo 280 原发票号码
taxPeriod 10 所属税期(如：202104)
remark 280 备注
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
selectAuthenticateTime 0 勾选认证时间 YYYY-MM-DD
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 财政电子票据
参数 长度 描述
invoiceType 2 发票类型：25、财政电子票据
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceName 100 电子票据名称
invoiceCode 8 电子票据代码
invoiceNo 10 电子票据号码
checkCode 6 校验码
invoiceDate 10 开票日期yyyy_MM_dd
invoiceTime 8 开票时间
totalAmount 18 总金额
invoicingPartyCode 30 开票单位代码
invoicingPartyName 100 开票单位名称
payerPartyType 1 交款人类型
payerPartyCode 30 交款人代码
payerPartyName 200 交款人名称
payMode 2 交款方式
bizCode 32 业务流水号
remark 500 备注
relatedInvoiceCode 8 红票票据代码
relatedInvoiceNo 10 红票票据号码
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 汽车票/轮船票
参数 长度 描述
invoiceCode 32 发票代码
invoiceNo 32 发票号码
invoiceType 2 发票类型：16、汽车票20、轮船票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceDate 乘车日期 2001-01-01
time 乘车时间 16:20
passengerName 20 乘客姓名
seatNo 10 座位号
totalAmount 13 票价
stationGetOn 10 上车站点
stationGetOff 10 下车站点
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 其他票
参数 长度 描述
invoiceType 2 发票类型：11、其他票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceNo 32 发票号码
totalAmount 13 价税合计
remark 200 备注
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 税收完税证明
参数 长度 描述
invoiceType 2 发票类型：19、税收完税证明
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceDate 开票日期 2001-01-01
buyerName 100 购方名称
buyerTaxNo 20 购方税号
taxPaidProofNo 20 完税证明号码（发票号码）
taxAuthorityName 100 税务机关
totalAmount 13 金额
remark 200 备注
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 飞机票
参数 长度 描述
invoiceType 2 发票类型：10、飞机票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
printNum 32 印刷序列号
customerName 32 旅客姓名
customerIdentityNum 25 身份证号
airNum 32 机票编号
invoiceAmount 13 票价
otherTotalTaxAmount 13 其他税费
totalTaxAmount 13 税额
airportConstructionFee 13 民航发展基金
fuelSurcharge 13 燃油附加费
totalAmount 13 合计金额
insurancePremium 13 保险费
invoiceDate 乘车日期 2001-01-01
airTime 10 飞机乘机时间 12:00
fillingUnit 100 填开单位
electronicTicketNum 32 电子客票号码
salesUnitCode 32 销售单位代码
endorsement 32 签注
placeOfDeparture 32 出发地
destination 32 目的地
carrier 32 承运人
flightNum 32 航班号
seatGrade 10 座位等级
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
## 数电发票（航空运输电子客票行程单）
参数 长度 描述
invoiceType 2 发票类型：28、数电发票（航空运输电子客票行程单）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
customerName 150 旅客姓名
customerIdentityNum 25 身份证号
endorsement 32 签注
invoiceNo 32 发票号码
gpOrderNo 32 GP单号
invoiceAmount 13 不含税金额
ticketPrice 23 票价
fuelSurcharge 13 燃油附加费
taxRate 13 增值税税率
totalTaxAmount 13 增值税税额
airportConstructionFee 13 民航发展基金
otherTotalTaxAmount 13 其他税费
totalAmount 13 合计金额
electronicTicketNum 32 电子客票号码
verificationCode 32 验证码
insurancePremium 13 保险费
fillingUnit 100 填开单位
issueDate 填开日期 yyyy-mm-dd
invoiceStatus 2 开具状态：0:正常、7：部分红冲、8：全额红冲
internationalFlag 2 国际航班标识:0、无；1、国内；2、国际
buyerName 100 购方名称
purchaserUnifiedSocialCreditCode 20 购买方统一社会信用代码
salerName 100 销方名称
salerTaxNo 100 销方税号
originalInvoiceNo 32 原票号码
reasonOfRushRed 32 冲红原因
invoiceDate 开票日期 yyyy-mm-dd
carrierDate 乘机日期 yyyy-mm-dd
airTime 10 飞机乘机时间 12:00
placeOfDeparture 32 出发地
destination 32 目的地
carrier 32 承运人
flightNum 32 航班号
seatGrade 10 座位等级
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
taxPeriod 10 所属税期(如：202104)
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
taxPdfUrl 512 税局下载的pdf源文件
taxOfdUrl 512 税局下载的ofd源文件
taxXmlUrl 512 税局下载的xml源文件
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
**items电子航空客票明细**
参数 长度 描述
placeOfDeparture 32 出发地
destination 32 目的地
flightSegment 32 航段
carrier 32 承运人
flightNum 32 航班号
seatGrade 10 座位等级
invoiceDate 乘机日期 yyyy-mm-dd
takePlaneTime 10 乘机时间 12:00
fareBasis 32 客票级别/客票类别
effectiveDate 客票生效日 yyyy-mm-dd
expirationDate 有效截止日 yyyy-mm-dd
freeBaggageAllowance 32 免费行李额
*** ## 出租车票
参数 长度 描述
invoiceType 2 发票类型： 8、出租车票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 12 发票代码
invoiceNo 8 发票号码
licenseNumber 12 车牌号
invoiceDate 0 乘车日期 2001-01-01
place 20 乘车地地名
timeGetOn 10 上车时间 12:00
timeGetOff 10 下车时间 13:00
totalAmount 13 打车金额
price 13 单价
mileage 13 里程
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
snapshotUrl 512 发票快照地址
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 定额发票
参数 长度 描述
invoiceType 2 发票类型：14、定额发票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 32 发票代码
invoiceNo 32 发票号码
salerName 100 销方名称
salerTaxNo 32 销方税号
totalAmount 13 价税合计
remark 200 备注
place 20 发票所在地
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 通用机打发票/通用机打电子发票
参数 长度 描述
invoiceType 2 发票类型：7、通用机打发票;23、通用机打电子发票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 32 发票代码
invoiceNo 32 发票号码
invoiceDate 0 开票日期 2001-01-01
checkCode 32 校验码
totalAmount 13 价税合计
buyerName 100 买方名称
buyerTaxNo 35 买方税号
salerName 100 销方名称
salerTaxNo 20 销方税号
remark 200 备注
drawer 8 开票人
reviewer 8 复核人
payee 8 收款人
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 过路（过桥）费发票
参数 长度 描述
invoiceType 2 发票类型：17、过路（过桥）费发票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 32 发票代码
invoiceNo 32 发票号码
invoiceDate 0 发票日期 2001-01-01
totalAmount 13 价税合计
remark 200 备注
drawer 8 开票人
reviewer 8 复核人
payee 8 收款人
entrance 20 入口
exit 20 出口
ftime 10 发票时间 16:51:32
place 20 发票所在地
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 二手车销售统一发票
参数 长度 描述
invoiceType 2 发票类型：13、二手车销售统一发票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 12 发票代码
invoiceNo 8 发票号码
invoiceDate 0 开票日期 2001-01-01
buyerPhoneNumber 30 购方电话
buyerName 100 购方名称
buyerIdNo 30 购方组织代码/身份证号码
buyerAddress 150 购方地址
salerName 100 销方名称
salerPhoneNumber 30 销方电话
salerIdNo 30 销方组织代码/身份证号码
salerAddress 150 销方地址
licensePlateNumber 20 车牌照号
registrationNumber 30 登记证号
vehicleType 30 车辆类型
vehicleIdentificationNo 30 车辆识别代码/车驾号码
bandModel 30 厂牌型号
vehicleManagementName 50 转入地车辆管理所名称
totalAmount 19 车价合计
auctionName 50 拍卖/经营名称
auctionPhoneNumber 30 拍卖/经营电话
auctionAddress 50 拍卖/经营地址
auctionTaxpayerId 30 拍卖/经营税号
auctionBankAccout 100 拍卖/经营开户银行帐号
marketName 100 二手市场单位
marketPhoneNumber 30 二手市场电话
marketAddress 100 二手市场地址
marketTaxpayerId 30 二手市场税号
marketBankAccout 100 二手市场开户银行帐号
remark 280 备注
invoiceStatus 11 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常
issuingOffice 50 开票单位
drawer 20 开票人
checkCode 30 校验码
machineNo 50 机器编码
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 专票和普票
参数 长度 描述
invoiceType 2 发票类型：1、增值税电子普通发票2、增值税电子专用发票3、增值税普通发票4、增值税专用发票5、增值税普通发票（卷票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
etaxInvoiceNo 20 数电纸票号码
invoiceCode 32 发票代码
invoiceNo 32 发票号码
invoiceDate 0 开票日期 2001-01-01
checkCode 50 校验码
salerName 100 销方名称
salerTaxNo 20 销方税号
salerAddressPhone 150 销方地址电话
salerAccount 150 销方账号
buyerName 100 买方名称
buyerTaxNo 20 买方税号
buyerAddressPhone 150 买方地址电话
buyerAccount 150 买方账号
invoiceAmount 23 合计金额(不含税)
totalTaxAmount 23 合计税额
totalAmount 19 价税合计
remark 280 备注
machineNo 30 机器编号
drawer 30 开票人
reviewer 30 复核人
payee 30 收款人
taxPeriod 10 所属税期(如：202104)
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
invalidDate 作废日期 YYYY-MM-DD
type 1 0-蓝字发票；1-红字发票
originalInvoiceCode 12 原发票代码
originalInvoiceNo 8 原发票号码
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，4预勾选，5勾选中，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
authenticateTime 0 勾选认证时间 YYYY-MM-DD
recordedStatus 2 税局入账状态 01：未入账， 11：入账处理中， 02：已入账(企业所得税税前扣除)， 03：已入账(企业所得税不扣除)， 06：入账撤销
recordedPurpose 2 税局入账用途 02-企业所得税税前扣除， 03-企业所得税不扣除
recordedTime 0 税局入账时间 yyyymmdd
recordedPeriod 0 税局入账属期YYYY-MM-DD HH:MM:SS（兼容历史数据，建议截取YYYY-MM）
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
**items 专票/普票发票明细**
参数 长度 描述
goodsCode 20 商品编码
goodsName 120 商品名称
specModel 50 规格型号
unit 20 单位
unitPrice 35 单价
num 35 数量
taxAmount 23 税额
taxRate 25 税率
detailAmount 19 明细金额
zeroTaxRateFlag 1 零税率标识 空:非零税率1:免税2:不征税3:普通零税率
discountType 1 折扣行：0正常行，1折扣行，2被折扣行
preferentialPolicy 1 优惠政策
versionNo 11 商品编码版本号
*** ## 数电专票和数电普票
参数 长度 描述
invoiceType 2 发票类型：26、数电发票（普通发票）27、数电发票（增值税专用发票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceNo 32 发票号码
invoiceDate 0 开票日期 2001-01-01
salerName 100 销方名称
salerTaxNo 20 销方税号
buyerName 100 买方名称
buyerTaxNo 20 买方税号
invoiceAmount 23 合计金额(不含税)
totalTaxAmount 23 合计税额
totalAmount 19 价税合计
remark 1024 备注
drawer 30 开票人
taxPeriod 10 所属税期(如：202104)
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
specialTypeMark 2 特定业务类型 1：成品油发票 2：稀土发票 3：机动车发票 4：农产品收购发票 5：石脑油发票 6：卷烟发票 7：建筑服务发票 8：货物运输服务发票 9：不动产销售服务发票 10：不动产经营租赁服务 11：代收车船税发票 12：旅客运输服务发票 13：自产农产品销售发票 14：通行费发票 15：医疗服务（住院）发票 16：医疗服务（门诊）发票 17：拖拉机和联合收割机发票 18：二手车发票 19：光伏收购发票 20：出口发票 21：农产品发票 22：稀土矿产品发票 23：稀土产成品发票 24：铁路电子客票 25：航空运输电子客票行程单 26：电子烟 27：正常开具 28：反向开具
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
invalidDate 作废日期 YYYY-MM-DD
type 1 0-蓝字发票；1-红字发票
originalInvoiceCode 12 原发票代码
originalInvoiceNo 8 原发票号码
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，4预勾选，5勾选中，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
authenticateTime 0 勾选认证时间 YYYY-MM-DD
recordedStatus 2 税局入账状态 01：未入账， 11：入账处理中， 02：已入账(企业所得税税前扣除)， 03：已入账(企业所得税不扣除)， 06：入账撤销
recordedPurpose 2 税局入账用途 02-企业所得税税前扣除， 03-企业所得税不扣除
recordedTime 0 税局入账时间 yyyymmdd
recordedPeriod 0 YYYY-MM-DD HH:MM:SS（兼容历史数据，建议截取YYYY-MM）
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
taxPdfUrl 512 税局下载的pdf源文件
taxOfdUrl 512 税局下载的ofd源文件
taxXmlUrl 512 税局下载的xml源文件
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
**items 数电专票/数电普票发票明细**
参数 长度 描述
goodsCode 20 商品编码
goodsName 200 商品名称
specModel 150 规格型号
unit 300 单位
unitPrice 35 单价
num 35 数量
taxAmount 23 税额
taxRate 25 税率
detailAmount 19 明细金额
zeroTaxRateFlag 1 零税率标识 空:非零税率1:免税2:不征税3:普通零税率
discountType 1 折扣行：0正常行，1折扣行，2被折扣行
preferentialPolicy 1 优惠政策
versionNo 11 商品编码版本号
*** ## 增值税电子普通发票（通行费）
参数 长度 描述
invoiceType 2 发票类型：15、增值税电子普通发票（通行费）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceCode 12 发票代码
invoiceNo 8 发票号码
invoiceDate 0 开票日期 2001-01-01
checkCode 50 校验码
salerName 100 销方名称
salerTaxNo 20 销方税号
salerAddressPhone 100 销方地址电话
salerAccount 150 销方账号
buyerName 100 买方名称
buyerTaxNo 20 买方税号
buyerAddressPhone 100 买方地址电话
buyerAccount 150 买方账号
invoiceAmount 23 合计金额(不含税)
totalTaxAmount 23 合计税额
totalAmount 19 价税合计
remark 280 备注
machineNo 30 机器编号
drawer 30 开票人
reviewer 30 复核人
payee 30 收款人
taxPeriod 10 所属税期(如：202104)
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
invalidDate 作废日期 YYYY-MM-DD
type 1 0-蓝字发票；1-红字发票
originalInvoiceCode 12 原发票代码
originalInvoiceNo 8 原发票号码
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
authenticateTime 0 勾选认证时间 YYYY-MM-DD
recordedStatus 2 税局入账状态 01：未入账， 11：入账处理中， 02：已入账(企业所得税税前扣除)， 03：已入账(企业所得税不扣除)， 06：入账撤销
recordedPurpose 2 税局入账用途 02-企业所得税税前扣除， 03-企业所得税不扣除
recordedTime 0 税局入账时间 yyyymmdd
recordedPeriod 0 YYYY-MM-DD HH:MM:SS（兼容历史数据，建议截取YYYY-MM）
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
**items 通行费发票明细**
参数 长度 描述
goodsCode 20 商品编码
goodsName 120 商品名称
taxAmount 23 税额
taxRate 25 税率
detailAmount 19 明细金额
vehPlate 20 车牌号码
specModel 50 类型
startDate 通行起始日期 YYYY-MM-DD
endDate 通行结束日期 YYYY-MM-DD
zeroTaxRateFlag 1 零税率标识 空:非零税率1:免税2:不征税3:普通零税率
discountType 1 折扣行：0正常行，1折扣行，2被折扣行
preferentialPolicy 1 优惠政策
versionNo 11 商品编码版本号
** * ## 海关缴款书
参数 长度 描述
invoiceType 2 发票类型21
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
customDeclarationNo 30 缴款书号码(唯一)
subject 1 科目类型：1-进口增值税；2-进口关税；3-进口消费税
invoiceDate 填开日期2001-01-01
deptName 200 缴款单位一名称
deptTaxNo 25 缴款单位一税号
secondDeptName 200 缴款单位二名称
secondDeptTaxNo 25 缴款单位二税号
deptAccount 50 缴款单位账号
deptBank 58 缴款单位开户银行
declareNo 100 报关单编号
totalTaxAmount 税款金额合计
totalAmount 合计金额
applyDeptNo 100 申请单位编号
contractNo 50 合同批文号
transToolNo 50 运输工具号
payLimitDate 20 缴款期限
dealGoodsNo 50 提/装货单号
getOffice 100 收入机关
modeTrade 20 贸易方式
budgetAccountCode 50 预算科目代码
codeCollectionTreasury 50 收款国库代码
deliveryNo 100 提运单号
portCode 30 进口口岸代码
customsName 20 进口口岸名称
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
taxPeriod 10 所属税期(如：202104)
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
ofdUrl 512 ofd地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，6退税勾选,
deductionPurpose 1 抵扣用途1抵扣2不抵扣3用于退税4用于代办退税5未准予代办退税6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
## 数电发票（机动车销售统一发票）
参数 长度 描述
invoiceType 2 发票类型：83、数电发票（机动车销售统一发票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
type 1 0-蓝字发票；1-红字发票
invoiceNo 20 发票号码
invoiceDate 0 开票日期 2001-01-01
buyerName 370 购方名称
buyerTaxNo 20 购方税号
salerName 300 销方名称
salerTaxNo 20 销方税号
salerAccount 300 销方银行账号
salerPhone 120 销方电话号码
salerAddress 250 销方地址
salerBankName 250 销方开户银行
vehicleType 128 车辆类型
brandModel 210 厂牌型号
producingArea 128 产地
certificateNum 160 合格证号
importCertificate 128 进口证明书号
commodityInspectionNum 128 商检单号
engineNum 128 发动机编号
vehicleIdentificationCode 40 车辆识别代码
taxRate 25 税率
totalTaxAmount 23 合计税额
overTaxCode 200 完税凭证号码
taxAuthorityCode 20 主管税务机关代码
taxAuthorityName 50 主管税务机关名称
invoiceAmount 23 合计金额（不含税）
totalTon 64 吨位
limitePeople 40 限乘人数
proxyMark 2 代开标示：默认为0,代开为1
drawer 8 开票人
taxPeriod 10 所属税期(如：202104)
remark 200 备注
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
authenticateTime 0 勾选认证时间 YYYY-MM-DD
totalAmount 23 价税合计
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
*** ## 数电发票（二手车销售统一发票）
参数 长度 描述
invoiceType 2 发票类型：84、数电发票（二手车销售统一发票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceNo 20 发票号码
invoiceDate 0 开票日期 2001-01-01
specialTypeMark 2 特定业务类型 27：正常开具 28：反向开具
buyerName 150 购方名称
buyerTaxNo 20 购方组织代码/身份证号码
buyerAddress 300 购方地址
buyerPhoneNumber 60 购方电话
salerName 150 销方名称
salerTaxNo 30 销方组织代码/身份证号码
salerAddress 250 销方地址
salerPhoneNumber 60 销方电话
licensePlateNumber 20 车牌照号
registrationNumber 30 登记证号
vehicleType 30 车辆类型
vehicleIdentificationNo 30 车辆识别代码/车驾号码
bandModel 30 厂牌型号
vehicleManagementName 50 转入地车辆管理所名称
totalAmount 19 车价合计
auctionName 60 拍卖/经营名称
auctionPhoneNumber 60 拍卖/经营电话
auctionAddress 300 拍卖/经营地址
auctionTaxpayerId 30 拍卖/经营税号
auctionBankAccout 170 拍卖/经营开户银行及帐号
marketName 300 二手市场单位
marketPhoneNumber 60 二手市场电话
marketAddress 300 二手市场地址
marketTaxpayerId 30 二手市场税号
marketBankAccout 170 二手市场开户银行及帐号
remark 450 备注
invoiceStatus 11 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
drawer 20 开票人
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
## 数电发票（通行费发票）
参数 长度 描述
invoiceType 2 发票类型：72、数电发票（通行费发票）
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceNo 32 发票号码
invoiceDate 0 开票日期 2001-01-01
salerName 100 销方名称
salerTaxNo 20 销方税号
buyerName 100 买方名称
buyerTaxNo 20 买方税号
invoiceAmount 23 合计金额(不含税)
totalTaxAmount 23 合计税额
totalAmount 19 价税合计
remark 1024 备注
drawer 30 开票人
taxPeriod 10 所属税期(如：202104)
invoiceStatus 2 发票状态：0:正常、1：失控、2：作废、3：红冲、4：异常、5：非正常、6：红字发票待确认、7：部分红冲、8：全部红冲
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
specialTypeMark 2 特定业务类型 14：通行费发票
checkStatus 2 查验状态1：通过，2，不通过，3：未查验，4：不查验
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
invalidDate 作废日期 YYYY-MM-DD
type 1 0-蓝字发票；1-红字发票
originalInvoiceCode 12 原发票代码
originalInvoiceNo 8 原发票号码
selectTime 0 勾选时间 YYYY-MM-DD
authenticateFlag 2 认证标志0:未任何认证及勾选，1勾选，2勾选认证，3扫描认证，4预勾选，5勾选中，6退税勾选, 7退税勾选认证
deductionPurpose 1 抵扣用途 1抵扣 2不抵扣 3用于退税 4用于代办退税 5未准予代办退税 6未准予退税
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
authenticateTime 0 勾选认证时间 YYYY-MM-DD
recordedStatus 2 税局入账状态 01：未入账， 11：入账处理中， 02：已入账(企业所得税税前扣除)， 03：已入账(企业所得税不扣除)， 06：入账撤销
recordedPurpose 2 税局入账用途 02-企业所得税税前扣除， 03-企业所得税不扣除
recordedTime 0 税局入账时间 yyyymmdd
recordedPeriod 0 税局入账属期 YYYY-MM-DD HH:MM:SS（兼容历史数据，建议截取YYYY-MM）
xbrlName 1000 开具端xbrl的文件名
xbrlUrl 512 开具端xbrl的下载地址
xbrlType 50 电子凭证类型 evat-增值税电子发票， einvoice-数电发票， financial-财政电子票据， airele-航空运输电子客票行程单， trainele-铁路电子客票， bankreceipt-电子银行回单， bankstatement-电子银行对账单， coveringwarrant-电子非税收入一般缴款书
taxPdfUrl 512 税局下载的pdf源文件
taxOfdUrl 512 税局下载的ofd源文件
taxXmlUrl 512 税局下载的xml源文件
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
**items 数电发票（通行费发票）明细**
参数 长度 描述
goodsCode 20 商品编码
goodsName 120 商品名称
taxAmount 23 税额
taxRate 25 税率
detailAmount 19 明细金额
vehPlate 20 车牌号码
specModel 50 类型
startDate 通行起始日期 YYYY-MM-DD
endDate 通行结束日期 YYYY-MM-DD
zeroTaxRateFlag 1 零税率标识 空:非零税率1:免税2:不征税3:普通零税率
discountType 1 折扣行：0正常行，1折扣行，2被折扣行
preferentialPolicy 1 优惠政策
versionNo 11 商品编码版本号
## 增值税代扣代缴完税凭证 （仅支持税局下载取得，不支持识别）
参数 长度 描述
invoiceType 2 发票类型：47、增值税代扣代缴完税凭证
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
serialNo 36 发票流水号
orgNumber 20 发票组织编码
orgName 120 发票组织名称
originalState 2 签收状态:0-未签收，1-已签收
invoiceDate 填发日期 2001-01-01
buyerName 100 扣缴义务人名称
buyerTaxNo 20 扣缴义务人识别号
salerName 100 被扣缴纳税人名称
salerTaxNo 20 被扣缴纳税人识别号
invoiceNo 20 代扣代缴完税凭证号
invoiceAmount 13 计税金额
totalTaxAmount 13 实缴金额
expendStatus 2 单据状态 :1-未用、30-在用、60-已用、65-已入账，70-已归档
billCreateTime 入库时间 YYYY-MM-DD HH:MM:SS
deductionFlag 1 是否可抵扣：0不可抵扣，1可抵扣
effectiveTaxAmount 20 可抵扣税额
taxPeriod 10 所属税期(如：202104)
downloadUrl 512 原件下载地址
pdfurl 512 pdf下载地址
snapshotUrl 512 发票快照地址
fileName 30 文件名
fileType 2 文件类型：1-pdf,2-图片,4-ofd,9-xml
rotationAngle 4 旋转角度
region 35 发票区域
pixel 20 像素
errorLevel 1 合规性校验结果等级（有合规性校验时返回），0-严格管控，1-中度警示，2-轻度提醒，3-不控制
validateMessage 500 合规性校验结果描述，有合规性校验时返回
attachment Array 发票关联附件，发票查询接口根据是否查询附件参数返回，参见"进项发票附件"
verifyResult Array 合规性校验结果，发票识别、查验等有合规性校验结果的接口返回，参见"进项发票合规行校验结果"
## 进项发票附件
参数 长度 描述
attachCategoryName 20 附件种类名称
attachCategoryNo 20 附件类型编码
attachRemark 120 附件备注
snapshotUrl 150 附件快照
localUrl 150 附件url
attachName 100 附件名称
attachNo 50 附件编码
fileType 2 文件类型：1-PDF,2-图片,4-OFD,5-WORD,6-EXCEL,7-PPT,8-TXT
## 进项发票合规性校验结果
参数 长度 描述
msg 300 合规性校验结果描述信息
name 50 合规性项目名称
configType 40 合规性项目标识
config 2 合规性校验结果等级，0-严格管控，1-中度警示，2-轻度提醒，3-不控制
key 50 合格性校验项目标识
*** # 销项发票数据格式 ## 增值税发票
参数 长度 描述
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、普通纸质卷票
isElectricInvoice 2 是否电票：0-否，1-是
needCheck 2 是否需要查验：0-不需要，1-需要
invoiceStatus 2 发票状态0:正常、1：失控、2：作废、3：红冲、4：异常
invoiceChannel 2 1:托管,2:单机
cipherArea 200 密码区
sgfp 1 收购发票标志 0 其他增值税普通发票 1 农产品销售发票 2 农产品收购发票
invalidDate 作废日期 YYYY-MM-DD
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 增值税特殊管理