管理平台
  1. 对外接口 Copy
管理平台
  • 对外接口
    • 5000-获取token
    • 5001-查询发票额度
    • 5002-开具数电蓝字发票
    • 5003-数电发票开具结果查询
    • 5004-下载发票版式文件
    • 5005-下载发票xml文件
    • 5006-开具数电红字发票
    • 5007-红字确认单申请
    • 5008-红字确认单确认/拒绝
    • 5009-查询红字确认单(含主体和明细)
    • 5010-查询发票用途状态
    • 5102-单张发票实时查验 (全票通和乐企都支持)
    • 5103-发票主体查询请求
    • 5116-发票详情查询
    • 5104-批量数电票(xml)文件申请下载
    • 5105- 批量数电票文件申请结果反馈
    • 5101- 获取企业档案信息
    • 5106-发票认证 (勾选) 请求
    • 5124-保存入账信息
    • 5126-调整入账信息
    • 5125-入账信息查询
    • 5107-发票认证 (勾选) 结果获取
    • 5108-统计结果查询
    • 5109-申请/撤销统计
    • 5110-获取统计信息
    • 5111-申请/撤销确认信息
    • 5112-确认结果查询
    • 5113-单张海关缴款书采集
    • 5114-海关缴款书认证(勾选)请求
    • 5115-海关缴款书认证 (勾选) 结果获取
    • 5201-登录第一步
    • 5203-退出登录
    • 5202-登录第二步-短信验证码
    • 5117-发票主体查询结果获取
    • 5119-用户身份及关联企业信息查询
    • 5118-企业切换
    • 5120-发票明细批量查询
    • 5121-发票批量下载申请
    • 5122-批量任务进度查询
    • 5123-发票批量下载
    • 5301-企业信息同步
    • 5011-红字确认单撤销
    • 5012-红字确认单主体信息
    • 5013-红字确认单明细信息
    • 5014-发票作废接口
    • 5127-发票入账/取消入账(乐企)
    • 5128-乐企入账结果查询
    • 5303-用户信息同步
  • 对外接口 Copy
    • 5122-批量任务进度查询
    • 5123-发票批量下载
    • 5301-企业信息同步
    • 5011-红字确认单撤销
    • 5012-红字确认单主体信息
    • 5013-红字确认单明细信息
    • 5014-发票作废接口
    • 5127-发票入账/取消入账(乐企)
    • 5128-乐企入账结果查询
    • 5303-用户信息同步
    • 5000-获取token
    • 5001-查询发票额度
    • 5002-开具数电蓝字发票
    • 5003-数电发票开具结果查询
    • 5004-下载发票版式文件
    • 5005-下载发票xml文件
    • 5006-开具数电红字发票
    • 5007-红字确认单申请
    • 5008-红字确认单确认/拒绝
    • 5009-查询红字确认单(含主体和明细)
    • 5010-查询发票用途状态
    • 5102-单张发票实时查验 (全票通和乐企都支持)
    • 5103-发票主体查询请求
    • 5116-发票详情查询
    • 5104-批量数电票(xml)文件申请下载
    • 5105- 批量数电票文件申请结果反馈
    • 5101- 获取企业档案信息
    • 5106-发票认证 (勾选) 请求
    • 5124-保存入账信息
    • 5126-调整入账信息
    • 5125-入账信息查询
    • 5107-发票认证 (勾选) 结果获取
    • 5108-统计结果查询
    • 5109-申请/撤销统计
    • 5110-获取统计信息
    • 5111-申请/撤销确认信息
    • 5112-确认结果查询
    • 5113-单张海关缴款书采集
    • 5114-海关缴款书认证(勾选)请求
    • 5115-海关缴款书认证 (勾选) 结果获取
    • 5201-登录第一步
    • 5203-退出登录
    • 5202-登录第二步-短信验证码
    • 5117-发票主体查询结果获取
    • 5119-用户身份及关联企业信息查询
    • 5118-企业切换
    • 5120-发票明细批量查询
    • 5121-发票批量下载申请
  • 对外接口 Copy
    • 5124-保存入账信息
      POST
    • 5126-调整入账信息
      POST
    • 5125-入账信息查询
      POST
    • 5107-发票认证 (勾选) 结果获取
      POST
    • 5108-统计结果查询
      POST
    • 5109-申请/撤销统计
      POST
    • 5110-获取统计信息
      POST
    • 5111-申请/撤销确认信息
      POST
    • 5112-确认结果查询
      POST
    • 5113-单张海关缴款书采集
      POST
    • 5114-海关缴款书认证(勾选)请求
      POST
    • 5115-海关缴款书认证 (勾选) 结果获取
      POST
    • 5201-登录第一步
      POST
    • 5203-退出登录
      POST
    • 5202-登录第二步-短信验证码
      POST
    • 5117-发票主体查询结果获取
      POST
    • 5119-用户身份及关联企业信息查询
      POST
    • 5118-企业切换
      POST
    • 5120-发票明细批量查询
      POST
    • 5121-发票批量下载申请
      POST
    • 5122-批量任务进度查询
      POST
    • 5123-发票批量下载
      POST
    • 5301-企业信息同步
      POST
    • 5011-红字确认单撤销
      POST
    • 5012-红字确认单主体信息
      POST
    • 5013-红字确认单明细信息
      POST
    • 5014-发票作废接口
      POST
    • 5127-发票入账/取消入账(乐企)
      POST
    • 5128-乐企入账结果查询
      POST
    • 5303-用户信息同步
      POST
    • 5000-获取token
      POST
    • 5001-查询发票额度
      POST
    • 5002-开具数电蓝字发票
      POST
    • 5003-数电发票开具结果查询
      POST
    • 5004-下载发票版式文件
      POST
    • 5005-下载发票xml文件
      POST
    • 5006-开具数电红字发票
      POST
    • 5007-红字确认单申请
      POST
    • 5008-红字确认单确认/拒绝
      POST
    • 5009-查询红字确认单(含主体和明细)
      POST
    • 5010-查询发票用途状态
      POST
    • 5102-单张发票实时查验 (全票通和乐企都支持)
      POST
    • 5103-发票主体查询请求
      POST
    • 5116-发票详情查询
      POST
    • 5104-批量数电票(xml)文件申请下载
      POST
    • 5105- 批量数电票文件申请结果反馈
      POST
    • 5101- 获取企业档案信息
      POST
    • 5106-发票认证 (勾选) 请求
      POST
  • 对外接口-导出
    • 5000-获取token
    • 5001-查询发票额度
    • 5002-开具数电蓝字发票
    • 5003-数电发票开具结果查询
    • 5004-下载发票pdf版式文件
    • 5005-下载发票xml文件
    • 5006-开具数电红字发票
    • 5007-红字确认单申请
    • 5008-红字确认单确认/拒绝
    • 5009-查询红字确认单(含主体和明细)
    • 5010-查询发票用途状态
    • 5102-单张发票实时查验 (全票通和乐企都支持)
    • 5103-发票主体查询请求
    • 5116-发票详情查询
    • 5104-批量数电票(xml)文件申请下载
    • 5105- 批量数电票文件申请结果反馈
    • 5101- 获取企业档案信息
    • 5106-发票认证 (勾选) 请求
    • 5124-保存入账信息
    • 5126-调整入账信息
    • 5125-入账信息查询
    • 5107-发票认证 (勾选) 结果获取
    • 5108-统计结果查询
    • 5109-申请/撤销统计
    • 5110-获取统计信息
    • 5111-申请/撤销确认信息
    • 5112-确认结果查询
    • 5113-单张海关缴款书采集
    • 5114-海关缴款书认证(勾选)请求
    • 5115-海关缴款书认证 (勾选) 结果获取
    • 5201-登录第一步
    • 5203-退出登录
    • 5202-登录第二步-短信验证码
    • 5117-发票主体查询结果获取
    • 5119-用户身份及关联企业信息查询
    • 5118-企业切换
    • 5120-发票明细批量查询
    • 5121-发票批量下载申请
    • 5122-批量任务进度查询
    • 5123-发票批量下载
    • 5301-企业信息同步
    • 5011-红字确认单撤销
    • 5012-红字确认单主体信息
    • 5013-红字确认单明细信息
  1. 对外接口 Copy

5102-单张发票实时查验 (全票通和乐企都支持)

开发中
开发环境
http://192.168.51.174
开发环境
http://192.168.51.174
POST
http://192.168.51.174
http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost
红字确认单
最后修改时间:2024-08-27 07:24:34
责任人:cyx123
通过此接口对取得的各类发票发起查验申请,系统根据查验申请反馈查验结果。(暂只支持对本单位开具取得的发票进行查验,适用于乐企版本)。
发票种类代码 发票种类
发票类型
0-纸质专用发票 2-纸质普通发票 12-机动车销售统一发票 14-通行费电子发票 15-二手车销售统一发票 35-货物运输业增值税专用发票 41-卷式发票 51-电子普通发票 52-电子专用发票 61-数电电子普票 62-数电电子专票 63-数电发票(铁路电子客票) 64-数电发票(航空运输客票电子行单) 65-数电电票(二手车销售统一发票) 66-数电纸质专票 67-数电纸质普票 68-数电纸票(二手车销售统一发票) 69-数电电票(机动车销售统一发票) 70-数电纸票(机动车销售统一发票)
发票类型为63、64、65、68、69、70时,仅支持乐企查验

请求参数

Header 参数
SID
string 
对应接口方法编号
必需
示例值:
5102
Authorization
string 
必需
获取token接口返回token类型加token
示例值:
bearer token
creditCode
string 
税号必传
必需
示例值:
440300087980448
userName
string 
可选
子税局登录账号用户名,当管理平台-进项配置-平台类型为“电子税局”时,必传
verifyType
string 
可选
查验通道 0-原查验通道 1-乐企查验通道 不传默认0-原查验通道
Body 参数application/json
invoiceType
enum<string> 
发票类型
必需
发票类型 0-纸质专用发票 2-纸质普通发票 12-机动车销售统一发票 14-通行费电子发票 15-二手车销售统一发票 35-货物运输业增值税专用发票 41-卷式发票 51-电子普通发票 52-电子专用发票 61-数电电子普票 62-数电电子专票 63-数电发票(铁路电子客票) 64-数电发票(航空运输客票电子行单) 65-数电电票(二手车销售统一发票) 66-数电纸质专票 67-数电纸质普票 68-数电纸票(二手车销售统一发票) 69-数电电票(机动车销售统一发票) 70-数电纸票(机动车销售统一发票) 发票类型为63、64、65、68、69、70时,仅支持乐企查验
<= 2 字符
枚举值:
010203040810111415818285865161
invoiceCode
string 
发票代码
可选
发票类型为0、2、12、14、15、35、41、51、52、66、67、68、70传纸质发票代码; 发票类型为61、62、63、64、65、69时可为空。
<= 12 字符
invoiceNumber
string 
发票号码
必需
发票类型为0、2、12、14、15、35、41、51、52、66、67、68、70传纸质发票号码; 发票类型为61、62、63、64、65、69传20位数字化电子发票号码。
<= 20 字符
invoiceDate
string 
开票日期
必需
开票日期 yyyyMMdd
<= 8 字符
正则匹配:
^[0-9]{8}$
invoiceCheckCode
string 
校验码
可选
发票类型为2、51、41、14、67时必填,传校验码(后六位),发票类型为67时传数电发票号码后6位。
<= 32 字符
invoiceAmount
string 
发票金额
可选
发票类型为0、52、66时,传开具金额(不含税); 发票类型为12、69、70时,传不含税价; 发票类型为15、65、68时,传车价合计; 发票类型为61、62、63、64时,传价税合计。
<= 20 字符
creditCode
string 
纳税人识别号
必需
纳税人识别号 本企业纳税人识别号
<= 20 字符
示例
{
    "invoiceType": "15",
    "invoiceNumber": "-1",
    "invoiceDate": "04188380",
    "creditCode": "20",
    "invoiceCode": "",
    "invoiceCheckCode": "3.141592653589793",
    "invoiceAmount": "8"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://etax-sanbox.szhtxx.com/eTaxManage/openApi/apiPost' \
--header 'SID: 5102' \
--header 'Authorization: bearer token' \
--header 'creditCode: 440300087980448' \
--header 'userName;' \
--header 'verifyType;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoiceType": "15",
    "invoiceNumber": "-1",
    "invoiceDate": "04188380",
    "creditCode": "20",
    "invoiceCode": "",
    "invoiceCheckCode": "3.141592653589793",
    "invoiceAmount": "8"
}'

返回响应

🟢200数电增值税
application/json
Body
invoiceCode
string 
纸质发票代码
可选
发票类型为66、67时返回
invoiceNum
string 
纸质发票号码
可选
发票类型为66、67时返回
electronicInvoiceNum
string 
数电发票号码
可选
发票类型为61、62时返回
invoiceType
enum<string> 
发票类型
必需
61-数电电子普票、62-数电电子专票、66-数电纸质专票、67-数电纸质普票
枚举值:
0252514161626667
custName
string 
购方名称
可选
custCreditCode
string 
购方税号
可选
custAddress
string 
购买方地址
可选
购买方地址 乐企通道返回地址,DZDZ通道返回地址+电话
custBank
string 
购方开户银行
可选
购买方开户行 乐企通道返回开户行,DZDZ通道返回开户行+账号
saleName
string 
销方名称
可选
saleCreditCode
string 
销方税号
必需
saleAddress
string 
销货方地址
可选
销货方地址 乐企通道返回地址,DZDZ通道返回地址+电话
saleBank
string 
销售方开户行
可选
销售方开户行 乐企通道返回开户行,DZDZ通道返回开户行+账号
invoiceDate
string 
开票日期
必需
格式:yyyy-MM-dd
totalAmt
number 
合计金额
必需
taxAmt
number 
合计税额
必需
tolAmtIncl
number 
价税合计
可选
remark
string 
备注
可选
isList
string 
清单标志
可选
仅DZDZ通道返回 0:无清单;1:有清单
tdyslxDm
string 
特定要素类型代码
可选
仅乐企通道返回
sflzfp
string 
是否蓝字发票
必需
仅乐企通道返回 Y:是 N:否
kjhzfpdydlzfphm
string 
开具红字发票对应的蓝字发票号码
必需
仅乐企通道返回
kjhzfpdydzzfpDm
string 
开具红字发票对应的纸质发票代码
必需
仅乐企通道返回
kjhzfpdydzzfphm
string 
开具红字发票对应的纸质发票号码
必需
仅乐企通道返回
jshjdx
string 
价税合计(大写)
必需
仅乐企通道返回
deduction
string 
扣除额
必需
仅乐企通道返回
settleType
string 
结算方式
必需
仅乐企通道返回
openPeople
string 
开票人
必需
仅乐企通道返回
detailNum
string 
明细行数
必需
仅乐企通道返回
vatTaxRetreatCode
string 
增值税即征即退代码
必需
仅乐企通道返回
exportTaxRefundCode
string 
出口退税类代码
必需
仅乐企通道返回
checker
string 
复核人姓名
必需
仅乐企通道返回
payee
string 
收款人姓名
必需
仅乐企通道返回
taxpayerType
string 
销方纳税人类型代码
必需
仅乐企通道返回 1:一般纳税人 2:小规模纳税人 3:转登记小规模纳税人 4:辅导期一般纳税人
oilAbnormality
string 
成品油异常标识
必需
仅乐企通道返回 9:正常 1:成品油单价异常 2:成品油超库存异常
additionalElementList
string 
附加要素信息列表
必需
仅乐企通道返回
invoiceTime
string 
发票开具时间
必需
仅乐企通道返回 格式:HH:mm:ss
detailList
array[object (发票明细数据) {13}] 
发票明细列表
必需
serialNo
string 
序号
可选
仅乐企通道返回
matName
string 
货物或应税劳务、服务名称
可选
格式:商品服务简称项目名称
revenueCode
string 
商品和服务税收分类合并编码
可选
仅乐企通道返回
shortName
string 
商品服务简称
可选
仅乐企通道返回
spec
string 
规格型号
可选
unit
string 
计量单位
可选
quantity
string 
数量
可选
price
string 
单价
可选
amount
number 
金额
可选
taxAmount
number 
税额
可选
taxRate
string 
税率
可选
deduction
string 
扣除额
可选
仅乐企通道返回
itemName
string 
项目名称
可选
仅乐企通道返回
示例
{
    "invoiceCode": "string",
    "invoiceNum": "string",
    "electronicInvoiceNum": "string",
    "invoiceType": "0",
    "custName": "string",
    "custCreditCode": "string",
    "custAddress": "string",
    "custBank": "string",
    "saleName": "string",
    "saleCreditCode": "string",
    "saleAddress": "string",
    "saleBank": "string",
    "invoiceDate": "string",
    "totalAmt": 0,
    "taxAmt": 0,
    "tolAmtIncl": 0,
    "remark": "string",
    "isList": "string",
    "tdyslxDm": "string",
    "sflzfp": "string",
    "kjhzfpdydlzfphm": "string",
    "kjhzfpdydzzfpDm": "string",
    "kjhzfpdydzzfphm": "string",
    "jshjdx": "string",
    "deduction": "string",
    "settleType": "string",
    "openPeople": "string",
    "detailNum": "string",
    "vatTaxRetreatCode": "string",
    "exportTaxRefundCode": "string",
    "checker": "string",
    "payee": "string",
    "taxpayerType": "string",
    "oilAbnormality": "string",
    "additionalElementList": "string",
    "invoiceTime": "string",
    "detailList": [
        {
            "serialNo": "string",
            "matName": "string",
            "revenueCode": "string",
            "shortName": "string",
            "spec": "string",
            "unit": "string",
            "quantity": "string",
            "price": "string",
            "amount": 0,
            "taxAmount": 0,
            "taxRate": "string",
            "deduction": "string",
            "itemName": "string"
        }
    ]
}
🟢200税控增值税
🟢200数电航空
🟢200税控卷式
🟢200数电机动车
🟢200数电二手车
🟢200税控通行费
🟢200机动车销售
🟢200二手车销售
⚪0数电铁路
🟢200通用返回报文
上一页
5010-查询发票用途状态
下一页
5103-发票主体查询请求
Built with