企享云API(适配版本)
  1. 发票查验
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
        • 自然人异步登录发送验证码接口
        • 异步登录校验税局缓存是否有效
        • 异步登录税局【发送短信验证码】
        • 扫码登录税局(二维码获取)
        • 扫码登录税局(二维码登录)
        • 异步登录税局【上传短信验证码登录】
        • 自然人异步登录税局【上传短信验证码登录】
        • 上传cookie接口
      • 校验appkey是否账户自持
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 发票查验
      • 简介
      • 发票查验
        POST
      • 税号版数电票查验及版式文件下载
        POST
      • 发票查验版式文件下载结果查询
        POST
    • 发票认证
      • 简介
      • 发票勾选/代购代缴完税凭证勾选
      • 进项发票勾选结果查询
      • 海关缴款书勾选
      • 海关缴款书勾选结果查询
      • 申请统计接口
      • 发票同步
      • 海关缴款书同步
      • 申请统计
      • 申请统计结果查询
      • 抵扣统计结果获取
      • 多票采集接口
      • 申请确认
      • 申请确认结果查询
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 发票查验

税号版数电票查验及版式文件下载

开发中
POST
/v2/invoice/customizedCheck

接口描述#

该接口用于数电票查验及版式文件下载。查验结果与国家税务总局全国增值税查验平台保持一致,版式文件下载结果与电票平台版式文件保持一致。
💡
注意:不同的数电票价税合计取值不同
传入的税号必须先订购了税号版发票查验版式文件下载产品(0013-发票查验+版式文件下载(税号版)或0014-发票查验+版式文件下载(实时税号版))才会发起版式文件下载任务。

错误码#

错误代码错误信息说明
CheckInvoiceForTheSameFrequent当前发票正在查验中,请不要频繁请求当前发票正在查验中,请稍后重试
CheckInvoicesOverOneYears仅可查验最近一年内开具的财政电子票据!请检查开票日期!
IllegalParameter请求参数不正确
bswjFplx中存在暂不支持发票查验版式文件下载的发票类型!
本次查验发票类型不支持发票查验版式文件下载!
bswjLx中存在不支持的版式文件类型!
税号版发票查验版式文件下载时纳税人不可为空!
请核对请求参数
IllegalParameter.IllegalInvoiceCode请求参数不正确,参数fpdm发票代码不正确!请核对fpdm发票代码是否符合参数规范
IllegalParameter.IllegalInvoiceNumber请求参数不正确,参数fphm发票号码不正确!请核对fphm发票号码是否符合参数规范
IllegalParameter.IllegalBillingDate请求参数不正确,参数kprq开票日期不正确!请核对kprq开票日期是否符合参数规范
IllegalParameter.IllegalCheckCode参数jym[发票校验码后6位]不正确请核对jym校验码是否符合参数规范
IllegalParameter.IllegalTotalAmount参数je[不含税金额]不正确请核对je金额是否符合参数规范
IllegalParameter.IllegalTotalAmountIincludingTax请求参数不正确,价税合计为空!请核对jshj价税合计是否符合参数规范
IllegalParameter.IllegalXfsbh请求参数不正确,销售方识别号为空!请核对xfsbh销方识别号是否符合参数规范
IllegalParameter.IllegalArea请求参数不正确,参数dq地区不正确!请核对dq地区是否符合参数规范
CheckInvoicesMoreThanToday开票日期超过当前日期请核对开票日期是否正确
CheckInvoicesOverFiveYears超过五年的发票不能查验请核对开票日期是否正确
CheckInvoiceNotSupport暂不支持该(省市)电子票据查验该地区暂不支持该票种查验
CheckInvoicesOverOneYears仅可查验最近一年内开具的财政电子票据!请检查开票日期!
CheckInvoiceMoreFiveTimes超过该张票当天查验次数请确认在调用接口前是否已经通过官方平台查验超过5次
CheckInvoiceNotExistence查验成功所查发票不存在发票代码或发票号码在税局查不到,请核对代码、号码是否正确
CheckInvoiceNotSame查验成功所查发票不一致请检查四要素是否与真实票面一致,传入金额是否为不含税金额(非二手车)或该发票是否为假票
CheckInvoiceNotStandard查询发票不规范请核对四要素是否符合发票规范
CheckInvoiceRequestNonStandard请求不规范请核对请求参数
CheckAuthorityVerification未开通发票查验版式文件下载权限!
未订购税号版发票查验版式文件下载产品!
请联系管理员
CheckInvoiceException税局服务异常,建议15-20分钟后重试税局服务异常,建议15-20分钟后重试
CheckAbnormal查验异常(错误信息不固定)税局服务异常,建议15-20分钟后重试
CheckExceedingLimit查验发票张数超过限制发票剩余查验量不足,请与运营负责人沟通确认
CheckInvoiceSingular请求太频繁或超过服务器最大请求数,请稍后访问!当前请求数达到服务最大并发数
ServerError服务器异常,请稍后重试服务器异常
InternalServerError服务遇到未知错误,请稍后重试请联系管理员
RemoteDataException税局数据异常请联系管理员
RemoteResultFail调用税局异常,请稍后重试。请联系管理员
50008字段文件名称不能为空(name)请联系管理员
50014超过并发限制请降低并发
59999未知异常请联系管理员

请求参数

Header 参数
access_token
string 
必需
通过调用access_token接口返回的access_token值
示例值:
{{access_token}}
req_date
string 
必需
当前时间转为的毫秒数
示例值:
{{req_date}}
req_sign
string 
签名算法得到的签名
必需
示例值:
{{req_sign}}
Content-Type
string 
可选
默认值:
application/json
Body 参数application/json
invoiceNumber
string 
发票号码
必需
数电发票传20位发票号码
billingDate
string 
开票日期
必需
格式为YYYY-MM-DD
totalAmount
string 
价税合计
必需
数电发票价税合计
nsrsbh
string 
纳税人识别号
必需
作为该次查验加版式文件下载归到哪个税号下计费的标识。注意:传入的税号必须先订购了税号版发票查验版式文件下载产品(0013-发票查验+版式文件下载(税号版)或0014-发票查验+版式文件下载(实时税号版))才会发起版式文件下载任务,否则不会发起。
bswjFplx
enum<string> 
需要从电票平台获取版式文件的发票类型范围
必需
支持多个,以“,”分隔。此字段为需要获取版式文件的范围,用于与当次查验结果的发票类型进行比较,如本次查验的发票类型在本字段传入的发票类型范围中,则会发起版式文件下载任务,否则不会发起。注:如需版式文件下载则本参数为必传字段。示例:"0910,0920,61,83"
枚举值:
091009206183
示例值:
0910,0920,61,83
bswjLx
enum<string>  | enum<null> 
需要获取的版式文件类型(PDF、OFD、XML)
可选
支持多个,以“,”分隔。bswjFplx值为空则本字段有值也不进行版式文件下载;bswjFplx值不为空时本字段不传默认取全部版式文件,即XML,OFD,PDF版式文件都下载。示例:“XML,OFD,PDF”
枚举值:
XMLOFDPDF
默认值:
XML,OFD,PDF
示例值:
XML,OFD,PDF
示例
{
    "invoiceNumber": "24****************58",
    "billingDate": "2018-04-05",
    "totalAmount": "2376.7",
    "nsrsbh": "93*******************2G",
    "bswjFplx": "0910,0920,61,83",
    "bswjLx": "PDF,OFD,XML"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/invoice/customizedCheck' \
--header 'access_token: {{access_token}}' \
--header 'access_token;' \
--header 'req_date: {{req_date}}' \
--header 'req_date;' \
--header 'req_sign: {{req_sign}}' \
--header 'req_sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceNumber": "24****************58",
    "billingDate": "2018-04-05",
    "totalAmount": "2376.7",
    "nsrsbh": "93*******************2G",
    "bswjFplx": "0910,0920,61,83",
    "bswjLx": "PDF,OFD,XML"
}'

返回响应

🟢200电子发票(普通发票)查验成功
application/json
Body
data
object (Dzh数电票查验及版式文件下载结果) 
查验结果
必需
invoiceCode
string 
发票代码
必需
10或12位的发票代码,数电纸质专票和数电纸质普票(85、86),仍按照税控发票查验。
invoiceNumber
string 
发票号码
必需
8位数字的发票号码 数电发票传20位发票号码(09、90、81、82、51、61)。数电纸质专票和数电纸质普票按照税控发票查验。
billingDate
string 
开票日期
必需
格式为YYYY-MM-DD
checkCode
string 
校验码
必需
发票校验码后6位。发票类型为04、10、11、14、86时此项不可为空。数电纸质普票校验码为数电发票号码后六位。
totalAmount
number 
发票金额
必需
发票类型为 01、03、15、20时不可为空;01、03、20填写发票不含税金额;15填写发票车价合计。数电发票(09、90、81、82、51、61)价税合计。
amountTax
integer 
价税合计
必需
totalTax
number 
税额
必需
invoiceType
string 
发票类型
必需
state
string 
发票状态(0 正常,1 失控,2 作废,3 红冲)
必需
tspzbz
string 
特殊票种标识
必需
purchaserTaxNo
string 
购方税号
必需
purchaserName
string 
购方名称
必需
purchaserBank
string 
购方开户行账户
必需
purchaserAddressPhone
string 
购方地址电话
必需
salesTaxNo
string 
销方税号
必需
salesName
string 
销方名称
必需
salesBank
string 
销方银行账号
必需
salesAddressPhone
string 
销方地址电话
必需
refinedOilState
string 
成品油标志 Y成品油发票 N⾮成品油发票
必需
checkTime
string 
查验时间
必需
remarks
string 
备注
必需
requestId
string 
发票
必需
machineCode
string 
机器编码
必需
items
array [object {10}] 
货物明细
必需
bswjxzTaskId
string  | null 
版式文件下载的任务id
可选
数电票第一次查验及获取版式文件时返回,可通过发票查验版式文件下载结果查询接口使用该taskId查询到版式文件下载的结果(任务执行状态及下载成功的版式文件信息)。
同一张数电票同样参数第n次(n>1)查验及获取版式文件时,如果跟第一次请求在同一天内,第一次任务成功且客户未通过版式文件下载结果查询接口取走结果则返回上一次的taskId;如果跟第一次请求不在同一天内,则发起新的任务,返回新的taskId。
每个taskId在通过结果查询接口获取版式文件下载结果前同样有效,在通过结果查询接口获取版式文件下载结果后同样失效。
每个taskId30天内均可通过发票查验版式文件下载结果查询接口使用该taskId查询到版式文件下载的结果(任务执行状态及下载成功的版式文件信息)。
pdfUrl
string  | null 
pdf文件地址
可选
ofdUrl
string  | null 
ofd文件地址
可选
xmlUrl
string  | null 
xml文件地址
可选
success
boolean 
查验是否成功
必需
示例
{
    "data": {
        "qd_hzxx": "",
        "totalTax": 377.26,
        "salesBank": "中国建设银行股份有限公司佛山汾江支行",
        "requestId": "4e1842e9dec34c6e91200ef34972a935",
        "invoiceNumber": "22441000000000018530",
        "invoiceType": "10xdp",
        "tspzbz": "",
        "purchaserAddressPhone": "",
        "state": "8",
        "qd_fjxx": "",
        "purchaserBank": "",
        "machineCode": "",
        "refinedOilState": "N",
        "salesTaxNo": "91440604666516302L",
        "invoiceCode": "",
        "url": "",
        "purchaserName": "中国太平洋人寿保险股份有限公司佛山中心支公司",
        "checkCode": "",
        "totalAmount": 6287.74,
        "billingDate": "2022-03-14",
        "salesAddressPhone": "",
        "checkTime": "2024-05-23 10:20:02",
        "salesName": "佛山市恒安瑞士酒店管理有限公司",
        "purchaserTaxNo": "914406007375878701",
        "items": [
            {
                "unitPrice": "6287.73584906",
                "rowNo": 1,
                "amount": 6287.74,
                "quantity": "1",
                "specialPolicySign": "",
                "specificationModel": "次",
                "realTax": 377.26,
                "taxClassifyCode": "3070401000000000000",
                "tax": "377.26",
                "taxRate": "6",
                "unit": "次",
                "realTaxRate": 0.06,
                "commodityName": "*餐饮服务*餐费"
            }
        ],
        "remarks": "",
        "amountTax": 6665,
        "bswjxzTaskId": 30704010000000,
        "pdfUrl": "",
        "ofdUrl": "",
        "xmlUrl": ""
    },
    "success": true
}
🟢200电子发票(增值税专用发票)查验成功
🟢200电子发票(铁路电子客票)查验成功
🟢200电子发票(航空运输电子客票行程单)查验成功
修改于 2025-05-10 09:10:25
上一页
发票查验
下一页
发票查验版式文件下载结果查询
Built with