平台Api对接
  1. 红字发票
平台Api对接
  • 错误编码信息
  • 开发指南
    • 开发前必读
    • 对接地址
    • 接口调用规则
    • 认证鉴权
    • 认证鉴权
      POST
  • 发票夹业务
    • 介绍
    • 票夹发票查询
      POST
    • 发票使用状态推送
      POST
    • 同步组织(单位、部门、人员)结构接口
      POST
    • 邮局邮件获取
      POST
  • 进项业务
    • 介绍
    • 获取税款所属期
    • 进项发票采集
    • 进项发票勾选
    • 海关缴款书采集
    • 海关缴款书勾选
    • 申请发票统计
    • 发票统计确认签名
    • 撤销发票统计(统计确认签名)
  • 税局登陆业务
    • 介绍
    • 电子税务局账户登录接口(手机号短信)
    • 电子税务局账户上传短信验证码
  • 发票归集
    • 发票信息获取
  • 发票文件下载
    • 单张发票板式文件下载
  • 发票开具
    • 介绍
    • 红字发票
      • 红字确认单列表查询
        POST
      • 获取红字确认单明细信息
        POST
      • 红字确认单申请
        POST
      • 红字确认单确认操作
        POST
      • 红字确认单撤销操作
        POST
      • 红字发票概况统计查询
        POST
      • 红字发票开具
        POST
    • 附加要素
      • 获取附加要素列表
      • 附加要素添加
      • 附加要素编辑
      • 附加要素删除
    • 获取人脸识别认证二维码(税务app)
      POST
    • 获取人脸识别认证结果(税务app)
      POST
    • 获取企业基本信息
      POST
    • 获取开票统计信息
      POST
    • 发票开具申请
      POST
    • 获取开票结果
      POST
    • 发票邮件交付接口
      POST
    • 已开发票列表查询
      POST
    • 已开发票明细查询
      POST
    • 数电已开发票版式文件下载(单个)
      POST
    • 开票刷脸状态查询
      POST
  • 智能编码
    • 商品编码智能匹配
    • 企业名称模糊查询
  • 企业相关接口
    • 企业授权模块查询
  • 票据识别
    • 票据识别OCR
  • 发票查验
    • 增值税发票查验
  1. 红字发票

获取红字确认单明细信息

POST
/InvoiceKP/getHzqrxx/1.0
对数电发票红冲时,需先完成红字信息确认单申请,本接口可通过红字信息UUID查询对应的信息确认单处理(红冲)状态。

请求参数

Body 参数application/json
hzuuid
string 
红字信息UUID
必需
默认值:
xsfNsrsbh
string 
销方纳税人识别号
必需
默认值:
accountId
string 
多账号下的账号唯一标识
可选
示例
{
    "hzuuid": "",
    "xsfNsrsbh": "",
    "accountId": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/InvoiceKP/getHzqrxx/1.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hzuuid": "",
    "xsfNsrsbh": "",
    "accountId": "string"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
业务代码
必需
0:成功,非0:失败
message
string 
业务消息
必需
默认值:
requestID
string 
业务流水号
必需
默认值:
timestamp
integer 
业务提交时间戳
必需
token
string 
登陆Token
必需
只有登陆接口有返回数据
默认值:
codeType
integer 
业务返回编码格式
必需
data数据内容编码格式,0:明文,2:AES,3:Base64
iszip
integer 
业务返回数据压缩标记
必需
data数据是否压缩,1:zip压缩
data
object 
业务返回数据
必需
hzuuid
string 
红字确认单UUID
必需
默认值:
hzqrdbh
string 
红字确认单编号
必需
默认值:
lrfsf
string 
录入方身份
必需
0:销方,1:购方
默认值:
xsfNsrsbh
string 
销售方纳税人识别号
必需
默认值:
xsfNsrmc
string 
销售方纳税人名称
必需
默认值:
gmfNsrsbh
string 
购买方纳税人识别号
必需
默认值:
gmfNsrmc
string 
购买方纳税人名称
必需
默认值:
hzqrztDm
string 
红字确认状态代码
必需
01:无需确认(全电大多数情况是自动01) 02:销方录入待购方确认 03:购方录入待销方确认 04:购销双方已确认 05:作废(销方录入购方否认) 06:作废(购方录入销方否认) 07:作废(超 72 小时未确认) 08:发起方撤销 09:确认后撤销
默认值:
qrrq
string 
确认日期
必需
默认值:
lrrq
string 
发起时间
必需
格式 yyyy-MM-dd HH:mm:ss
默认值:
qrjkp
string 
确认即开票
必需
Y-是,N-否
默认值:
hzkjBz
string 
红字开具标志
必需
Y已开票,N或空为未开票
默认值:
hcyydm
string 
红冲原因代码
必需
01-开票有误,02-销货退回 , 03-服务中止,04-销售折让
默认值:
lzFplxdm
string 
蓝字发票类型代码
必需
030-普通发票,032-专票
默认值:
lzFpdm
string 
蓝字发票代码
必需
数电时为空
默认值:
lzFphm
string 
蓝字发票号码
必需
默认值:
lzKprq
string 
蓝字开票日期
必需
默认值:
lzHjje
string 
蓝字合计金额
必需
默认值:
lzHjse
string 
蓝字合计税额
必需
默认值:
lzTdyslxDm
string 
蓝字发票特定要素类型代码
可选
默认值:
hzFpdm
string 
红字发票代码
可选
数电时为空
默认值:
hzFphm
string 
红字发票号码
必需
默认值:
hzKprq
string 
红字开票日期
必需
默认值:
hzHjje
string 
红字合计金额
必需
默认值:
hzHjse
string 
红字合计税额
必需
默认值:
bz
string 
备注
必需
默认值:
ydkse
string 
已抵扣税额
必需
默认值:
yjjdkncpse
string 
已加计抵扣农产品进项税额
必需
默认值:
rzzt
string 
入账状态
必需
00:未入账 01 已入账
默认值:
zzsYtzt
string 
增值税用途状态
必需
00-已勾选未确认、01-已确认、03-未勾选
默认值:
xfsYtZt
string 
消费税用途状态
必需
00-未勾选、01-已勾选
默认值:
xmmx
array [object {15}] 
项目明细
必需
示例
{
    "code": 0,
    "message": "",
    "requestID": "",
    "timestamp": 0,
    "token": "",
    "codeType": 0,
    "iszip": 0,
    "data": {
        "hzuuid": "",
        "hzqrdbh": "",
        "lrfsf": "",
        "xsfNsrsbh": "",
        "xsfNsrmc": "",
        "gmfNsrsbh": "",
        "gmfNsrmc": "",
        "hzqrztDm": "",
        "qrrq": "",
        "lrrq": "",
        "qrjkp": "",
        "hzkjBz": "",
        "hcyydm": "",
        "lzFplxdm": "",
        "lzFpdm": "",
        "lzFphm": "",
        "lzKprq": "",
        "lzHjje": "",
        "lzHjse": "",
        "lzTdyslxDm": "",
        "hzFpdm": "",
        "hzFphm": "",
        "hzKprq": "",
        "hzHjje": "",
        "hzHjse": "",
        "bz": "",
        "ydkse": "",
        "yjjdkncpse": "",
        "rzzt": "",
        "zzsYtzt": "",
        "xfsYtZt": "",
        "xmmx": [
            {
                "xh": "",
                "uuid": "",
                "spbm": "",
                "spmc": "",
                "xmmc2": "",
                "xmmc": "",
                "djlw": "",
                "ggxh": "",
                "sl": "",
                "dj": "",
                "je": "",
                "slv": "",
                "se": "",
                "kce": "",
                "lzMxxh": ""
            }
        ]
    }
}
修改于 2025-05-27 12:51:08
上一页
红字确认单列表查询
下一页
红字确认单申请
Built with