管理平台
  1. 对外接口-导出
管理平台
  • 对外接口
    • 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-保存入账信息
    • 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-用户信息同步
    • 5000-获取token
    • 5001-查询发票额度
    • 5002-开具数电蓝字发票
    • 5003-数电发票开具结果查询
    • 5004-下载发票版式文件
    • 5005-下载发票xml文件
    • 5006-开具数电红字发票
    • 5007-红字确认单申请
    • 5008-红字确认单确认/拒绝
    • 5009-查询红字确认单(含主体和明细)
    • 5010-查询发票用途状态
    • 5102-单张发票实时查验 (全票通和乐企都支持)
    • 5103-发票主体查询请求
    • 5116-发票详情查询
    • 5104-批量数电票(xml)文件申请下载
    • 5105- 批量数电票文件申请结果反馈
    • 5101- 获取企业档案信息
    • 5106-发票认证 (勾选) 请求
  • 对外接口-导出
    • 5000-获取token
      POST
    • 5001-查询发票额度
      POST
    • 5002-开具数电蓝字发票
      POST
    • 5003-数电发票开具结果查询
      POST
    • 5004-下载发票pdf版式文件
      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
    • 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
  1. 对外接口-导出

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/12
红字确认单
最后修改时间:2024-05-07 02:30:53
责任人:cyx123
通过此接口对取得的各类发票发起查验申请,系统根据查验申请反馈查验结果。(暂只支持对本单位开具取得的发票进行查验,适用于乐企版本)。
发票种类代码 发票种类
0-增值税专用发票
2-增值税普通发票
12-机动车销售统一发票
14-通行费电子发票
15-二手车销售统一发票
17-海关缴款书
41-增值税普通发票(卷式)
51-增值税电子普通发票
52-增值税电子专用发票
61-数电发票(普通发票)
62-数电发票(增值税专用发票)
63-数电发票(铁路电子客票)
64-数电发票(航空运输客票电子行单)
65-数电发票(二手车销售电子统一发票)
66-数电纸质发票(增值税专用发票)
67-数电纸质发票(普通发票)
68-数电纸质发票(二手车销售统一发票)
增值税发票包含以下发票类型:
"增值税专用发票"
"增值税普通发票"
"增值税电子专用发票"
"增值税电子普通发票"
增值税普通发票(卷式)
"电子发票(增值税专用发票)
"电子发票(普通发票) "
"纸质发票(增值税专用发票)
"纸质发票(普通发票) "

请求参数

Header 参数
SID
string 
对应接口方法编号
必需
示例值:
5102
Authorization
string 
必需
获取token接口返回token类型加token
示例值:
bearer token
creditCode
string 
税号必传
必需
示例值:
440300087980448
userName
string 
可选
子税局登录账号用户名,当管理平台-进项配置-平台类型为“电子税局”时,必传
Body 参数application/json
invoiceType
enum<string> 
必需
发票类型 0-增值税专用发票 2-增值税普通发票 12-机动车销售统一发票 14-通行费电子发票 15-二手车销售统一发票 17-海关缴款书 41-增值税普通发票(卷式) 51-增值税电子普通发票 52-增值税电子专用发票 61-数电发票(普通发票) 62-数电发票(增值税专用发票) 63-数电发票(铁路电子客票) 64-数电发票(航空运输客票电子行单) 65-数电发票(二手车销售电子统一发票) 66-数电纸质发票(增值税专用发票) 67-数电纸质发票(普通发票) 68-数电纸质发票(二手车销售统一发票)
<= 2 字符
枚举值:
010203040810111415818285865161
invoiceCode
string 
发票代码
可选
<= 12 字符
invoiceNumber
string 
必需
发票号码 发票类型为:61、62、63、64传20位数字化电子发票号码,
<= 20 字符
invoiceDate
string 
必需
开票日期 yyyyMMdd
<= 8 字符
正则匹配:
^[0-9]{8}$
invoiceCheckCode
string 
可选
校验码 当发票类型为2/51/41/14/67必填
<= 32 字符
invoiceAmount
string 
可选
发票金额 税控票为不含 税金 额,数电 票为价税 合计
<= 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/12' \
--header 'SID: 5102' \
--header 'Authorization: bearer token' \
--header 'creditCode: 440300087980448' \
--header 'userName;' \
--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 
发票代码
可选
10/12 位,数字化电子发票发票代码可为空, 数字化纸票返回纸质发票代码
invoiceNum
string 
发票号码
必需
8/20位,数字化电子发票,发票号码2 0 位数字化纸票返回纸质发票号码
electronicInvoiceNum
string 
数电发票号码
可选
invoiceType
enum<string> 
发票类型
必需
本批次请求的发票类型: "0":"增值税专用发票" "12":"机动车销售统一发票" "2":"增值税普通发票" "52":"增值税电子专用发票" "51":"增值税电子普通发票" "41": 增值税普通发票(卷式) "14":"通行费电子发票" "15":"二手车销售统一发票" "17":"海关缴款书" "61":"数电发票(普通发票) " "62":"数电发票(增值税专用发票) " "63":"数电发票(铁路电子客票) " "64":"数电发票(航空运输客票电子行单)" "65":"数电发票(二手车销售电子统一发票)" "66":"数电纸质发票(增值税专用发票) "67":"数电纸质发票(普通发票) " "68":"数电纸质发票(二手车销售统一发票) "
枚举值:
0252514161626667
custName
string 
购方名称
必需
custCreditCode
string 
购方税号
可选
custAddressPhone
string 
购方地址电话
可选
custBankAccount
string 
购方银行账号
可选
saleName
string 
销方名称
可选
saleCreditCode
string 
销方税号
可选
saleAddressPhone
string 
销方地址电话
可选
saleBankAccount
string 
销方银行账号
可选
invoiceDate
string 
开票日期
必需
yyyyMMdd
totalAmt
number 
合计金额
必需
taxAmt
number 
合计税额
必需
tolAmtIncl
number 
价税合计
必需
remark
string 
备注
可选
invoiceCheckCode
string 
校验码
可选
invoiceStatus
enum<string> 
发票状态
必需
0正常 1失控 2作废 3已红冲 9异常 7部分红冲 8全额红冲 10 红字发票待确认
枚举值:
012378910
checkStatus
enum<string> 
勾选状态
可选
0-未勾选 10-已勾选
枚举值:
010
checkDate
string 
勾选日期
可选
yyyyMMdd
taxPeriod
string 
税款所属期
可选
yyyyMM
isAgentRebate
enum<string> 
是否代办退税
可选
0-否 1-是
枚举值:
01
checkType
enum<string> 
勾选类型
可选
1-抵扣 2-退税 3-代理退税 0-未认证 4-不抵扣
枚举值:
01234
infoSource
enum<string> 
信息来源
可选
0 扫描认证 1 系统推送 2 出口转内销 3 异常凭 证转入
枚举值:
0123
effectiveTaxAmount
number 
有效税额
可选
legalizeTaxAmount
number 
抵扣税额
可选
isAbnormalCredentials
enum<string> 
是否异常凭证
可选
01 正常 02 异常凭证 03 疑似异常凭证
枚举值:
010203
riskStatus
enum<string> 
风险状态
可选
00-正常 03-正常 04-正常 02-待查 01-涉嫌违规 05-确认风险 06-确认风险 07-异常发票
枚举值:
0001020304050607
detailList
array[object (发票明细数据) {11}] 
发票明细列表
必需
serialNo
string 
序号
可选
matName
string 
项目名称
可选
revenueCode
string 
商品和服务税收分类合并编码
可选
shortName
string 
商品服务简称
可选
spec
string 
规格型号
可选
unit
string 
计量单位
可选
quantity
number 
数量
可选
price
number 
单价
可选
amount
number 
金额
可选
taxAmount
number 
税额
可选
taxRate
string 
税率
可选
示例
{
    "invoiceNum": "52",
    "invoiceType": "61",
    "custName": "构确较",
    "invoiceDate": "2014-05-22",
    "totalAmt": 24,
    "taxAmt": 96,
    "tolAmtIncl": 46,
    "invoiceStatus": "0",
    "detailList": [
        {
            "taxRate": "ex exercitation nulla minim",
            "serialNo": "elit qui aute culpa non",
            "shortName": "如酸况实正记型",
            "spec": "sint aliquip do velit ullamco",
            "quantity": 1,
            "price": 91,
            "revenueCode": "97",
            "taxAmount": 68,
            "unit": "aliqua",
            "matName": "么装务示土",
            "amount": 64
        },
        {
            "spec": "in dolore voluptate Ut",
            "taxAmount": 36,
            "taxRate": "consequat in",
            "amount": 37,
            "shortName": "商最北达社再世",
            "matName": "当的例",
            "quantity": 43,
            "revenueCode": "80",
            "serialNo": "eiusmod",
            "price": 77,
            "unit": "sunt in dolor dolor"
        },
        {
            "revenueCode": "67",
            "taxAmount": 44,
            "shortName": "片她高上效意时",
            "unit": "non occaecat",
            "price": 11,
            "amount": 64,
            "spec": "Excepteur",
            "matName": "连区江争际",
            "quantity": 20,
            "serialNo": "nostrud nisi in eu",
            "taxRate": "dolor esse quis"
        }
    ],
    "checkStatus": "0",
    "saleName": "领状报断",
    "saleBankAccount": "exercitation Duis laboris",
    "infoSource": "0",
    "custAddressPhone": "18147237156",
    "legalizeTaxAmount": 93,
    "remark": "do eiusmod laborum",
    "saleCreditCode": "63",
    "taxPeriod": "esse ea laboris",
    "saleAddressPhone": "18163504276",
    "invoiceCheckCode": "17",
    "invoiceCode": "76",
    "riskStatus": "06",
    "custBankAccount": "et",
    "custCreditCode": "86",
    "isAgentRebate": "0",
    "checkType": "1",
    "checkDate": "2015-09-06",
    "isAbnormalCredentials": "03",
    "electronicInvoiceNum": "21",
    "effectiveTaxAmount": 24
}
🟢200机动车销售统一发票
🟢200通行费电子发票
🟢200海关缴款书
🟢200二手车销售统一发票
🟢200通用返回报文
🟢200开票
上一页
5010-查询发票用途状态
下一页
5103-发票主体查询请求
Built with