税务数字化管理平台
  1. 数电
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 更新记录
    • 常见问题
    • 接口码表
    • 销项
      • 税控
        • 发票领购查询
        • 发票作废
        • 空白发票作废
        • 红字信息表申请
        • 红字信息表查询
        • 红字信息表撤销
        • 红字信息表准备信息查询
        • 发票开具（专、普、电）
      • 数电
        • 红字确认单申请准备信息查询
          POST
        • 红字确认单申请
          POST
        • 数电快捷全额红冲
          POST
        • 查询红字确认单详细信息
          POST
        • 红字确认单撤销
          POST
        • 红字确认单查询
          POST
        • 红字确认单确认
          POST
        • 异常红字确认单下载
          POST
        • 全电发票开具
          POST
        • 人脸识别二维码
          POST
        • 获取全电开票结果
          POST
        • 获取全电全票面数据
          POST
        • 全电认证
          POST
        • 短信认证
          POST
        • 全电交付
          POST
        • 成品油库存台账查询
          POST
        • 全电纸质发票作废
          POST
        • 获取人脸识别结果
          POST
        • 获取红字确认单申请结果
          POST
        • 获取数电发票下载地址
          POST
        • 红字全电发票开具
          POST
        • 获取纸质发票打印XML
          POST
        • 发送发票数据到控件
          POST
        • 开启打印窗口
          GET
        • 蓝字发票数据统计
          POST
        • 版式文件下载
          POST
        • 批量红字确认单下载
          POST
        • 获取当前发票代码号码(数电纸票)
          POST
        • 查询跨区域涉税事项报验管理编码
          POST
        • 检查账号在线状态
          POST
        • 查询身份授权（用户是否需要人脸认证）状态
          POST
        • 查询行政区划信息
          POST
      • 乐企
        • 获取批量预赋码信息
        • 查询授信额度
        • 下载/退回授信额度
        • 调整授信额度有效期
        • 查询纳税人风险信息
        • 查询纳税人基本信息
        • 查询可用税率信息
        • 查询数字化电子红字确认单列表信息
        • 数字化电子红字确认单确认
        • 查询数字化电子红字确认单明细信息
        • 再次上传数电发票
        • 废弃乐企异常发票
        • 数电发票开具
        • 数电发票开具（实时开票）
        • 数字化电子红字确认单申请
        • 快捷全额红冲
        • 查询成品油库存
        • 下载或退回成品油库存
      • 扫码开票
        • 二维码生成规则
        • 扫码开票订单导入
        • 扫码开票订单查询
        • 扫码开票订单作废
      • 发票查询
        POST
      • 单张发票查询
        POST
      • 商品导入
        POST
      • 客户导入
        POST
      • 批量待开导入
        POST
      • 待开分页查询
        POST
      • 批量单据导入
        POST
      • 单据分页查询
        POST
      • 账号注册
        POST
      • 全票种开具
        POST
      • 抬头联想
        POST
      • 单张发票修复
        POST
  1. 数电

红字确认单申请

POST

1、接口及场景描述#

接口描述： 用于申请全电发票的红字确认单，可以先调用“红字确认单准备信息查询”接口后使用返回参数再调用申请接口，
如果单独调用需要自己拼装所有的请求参数
场景1：可先调用红字确认单准备信息查询接口获取红字确认单申请的请求数据。
场景2：也可单独调用，需要自己拼装所有请求参数
场景3：当返回状态码为11051代表红字确认单申请时与局端交互异常，异常原因请看返回信息，当返回状态码为11051时，请稍后重新申请
场景4：当返回状态码为11001，请看返回信息了解原因，返回数据中data值为taskId代表未获取到红字确认单申请结果，请根据返回的taskId（任务id）调用获取红字确认单申请结果接口
场景5：当返回状态码为11002代表红字确认单申请成功，未获取红字确认单全部信息请根据返回的hzfpxxqrdid（红字确认单id）字段调用红字确认单详细信息查询接口获取详细信息
场景6：当返回状态码为11018代表获取红字发票失败，请根据返回的数据中的hzfphm（红字发票号码）字段和hzkprq（红字开票日期）字段调用获取全电全票面接口

2、请求参数#

名称必选类型长度描述
method是String
object是object
tdyslxdm否string2特定要素类型代码（传空即可） 当蓝票为特定业务时必传
gmfnsrsbh否string26购买方纳税人识别号
yfphm否string20原发票号码
qqlsh否string32请求流水号（当用户不传值时，系统自动生成，用户传值时以用户传值为准，当用户首次申请红字确认单传递qqlsh参数时，没有查询到结果，再次申请红字确认单时qqlsh参数传递首次申请的参数，可以查询到第一次申请的结果，有效性为俩小时内有效）
ykprq是string原开票日期 格式：yyyy-MM-dd HH:mm:ss
hzcxje是string16红字冲销金额
hzcxse是string16红字冲销税额
chyydm是string2冲红原因代码01：开票有误02：销货退回03：服务中止04：销售折让
zsfs否string1征税方式0：普通征税1：减按计征2：差额征税
yzzfpdm否string12原纸质发票代码：原发票为纸质发票时，必填
yzzfphm否string20原纸质发票号码：原发票为纸质发票时，必填
qrjkpbz否string1确认即开票标志
gwmc否string100岗位名称 不填默认为当前调用者默认岗位，否则使用当前填入的岗位名称
hzqrdmxList是object[]红字确认单明细
lzmxxh否string8蓝字发票明细序号
xh是string8序号
spbm是string19商品编码
xmmc是string600商品名称
spjc是string600商品简称
spsl否string25数量
ggxh否string150规格型号
dw否string300单位
spdj否string25单价
je是string16金额
slv是string8税率
se是string16税额
tdzsfsdm否string2特定征税方式（传空即可）
3、返回参数
名称必选类型长度描述
code是integer返回代码
msg是string返回消息
data是object返回数据
sqly是string1申请来源0：销方申请、1：购方申请
tdyslxdm否string2特定要素类型代码（传空即可）
hzcxje是string16红字冲销金额
hzcxse是string16红字冲销税额
chyydm是string2冲红原因代码01：开票有误 02：销货退回
03：服务中止 04：销售折让
hzfpxxqrdbh是string20红字确认单编号
hzfpxxqrdid是string32红字确认单ID
lrrq是string录入日期 格式: yyyy-MM-dd HH:mm:ss
hzfphm否string20红字发票号码
hzqrxxztdm是string2红字确认单状态01：无需确认
02：销方录入待购方确认
03：购方录入待销方确认
04：购销双方已确认
05：作废（销方录入购方否认）
06：作废（购方录入销方否认）
07：作废（超72小时未确认）
08：（发起方撤销）
hzhjje否string16红字合计金额
hzhjse否string16红字合计税额
hzkprq否string红字开票日期 格式：yyyy-MM-dd HH:mm:ss
gmfmc是string300购买方名称
xsfmc是string300销售方名称
gmfnsrsbh是string26购买方纳税人识别号
xsfnsrsbh是string26销售方纳税人识别号
lzfplxdm是string2蓝字发票类型代码
lzhjje是string16蓝字合计金额
lzhjse是string16蓝字合计税额
lzfphm是string20蓝字发票号码
lzkprq是string蓝字开票日期格式：yyyy-MM-dd HH:mm:ss
qqrq否string确认日期格式：yyyy-MM-dd HH:mm:ss
xfsytdm否string100消费税用途代码
fprzztdm否string100发票入账状态代码
zzsytdm否string100增值税用途代码
gxfsf否string1购销方身份
hzqrxxmxList是object[]红字确认单明细
lzmxxh否string8蓝字发票明细序号
xh是string8序号
spbm是string19商品编码
spmc是string600商品名称
spsl否string25数量
ggxh否string150规格型号
dw否string300单位
spdj否string25单价
je是string16金额
slv是string8税率
se是string16税额
tdzsfsdm否string2特定征税方式代码
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "hzqrdsq",
    "object": {
        "tdyslxdm": "特定要素类型代码",
        "gmfnsrsbh": "购买方纳税人识别号",
        "qqlsh": "请求流水号",
        "yfphm": "原发票号码",
        "ykprq": "原开票日期",
        "hzcxje": "红字冲销金额",
        "hzcxse": "红字冲销税额",
        "chyydm": "冲红原因代码",
        "zsfs": "征税方式",
        "yzzfpdm": "原纸质发票代码",
        "yzzfphm": "原纸质发票号码",
        "qrjkpbz": "确认即开票标志",
        "gwmc": "岗位名称",
        "hzqrdmxList": [
            {
                "lzmxxh": "蓝字发票明细序号",
                "xh": "序号",
                "spbm": "商品编码",
                "xmmc": "商品名称",
                "spjc": "商品简称",
                "ggxh": "规格型号",
                "dw": "单位",
                "spdj": "单价",
                "spsl": "数量",
                "je": "金额",
                "slv": "税率",
                "se": "税额",
                "tdzsfsdm": "特定征税方式"
            }
        ]
    }
}'
Response Response Example
{
    "code": 0,
    "msg": "成功",
    "data": {
        "sqly": "申请来源",
        "tdyslxdm": "特定要素类型代码",
        "hzcxje": "红字冲销金额",
        "hzcxse": "红字冲销税额",
        "chyydm": "冲红原因代码",
        "hzfpxxqrdbh": "红字确认单编号",
        "hzfpxxqrdid": "红字确认单ID",
        "lrrq": "录入日期",
        "hzfphm": "红字发票号码",
        "hzqrxxztdm": "红字确认单状态",
        "hzhjje": "红字合计金额",
        "hzhjse": "红字合计税额",
        "hzkprq": "红字开票日期",
        "gmfmc": "购买方名称",
        "xsfmc": "销售方名称",
        "gmfnsrsbh": "购买方纳税人识别号",
        "xsfnsrsbh": "销售方纳税人识别号",
        "lzfplxdm": "蓝字发票类型代码",
        "lzhjje": "蓝字合计金额",
        "lzhjse": "蓝字合计税额",
        "lzfphm": "蓝字发票号码",
        "lzkprq": "蓝字开票日期",
        "qqrq": "确认日期",
        "xfsytdm": "销方税用途代码",
        "fprzztdm": "发票入账状态代码",
        "zzsytdm": "增值税用途代码",
        "gxfsf": "购销方身份",
        "hzqrxxmxList": [
            {
                "lzmxxh": "蓝字发票明细序号",
                "xh": "序号",
                "spbm": "商品编码",
                "spmc": "商品名称",
                "spsl": "数量",
                "ggxh": "规格型号",
                "dw": "单位",
                "spdj": "单价",
                "je": "金额",
                "slv": "税率",
                "se": "税额",
                "tdzsfsdm": "特定征税方式代码"
            }
        ]
    }
}

Request

Body Params application/json
method
string 
必需
固定值hzqrdsq
object
object 
必需
tdyslxdm
string 
特定要素类型代码
可选
特定要素类型代码（传空即可）
qqlsh
string 
请求流水号
可选
当用户不传值时，系统自动生成
gmfnsrsbh
string 
购买方纳税人识别号
可选
购买方纳税人识别号
yfphm
string 
原发票号码
必需
原发票号码
ykprq
string 
原开票日期
必需
原开票日期 格式：yyyy-MM-dd HH:mm:ss
hzcxje
string 
红字冲销金额
必需
红字冲销金额
hzcxse
string 
红字冲销税额
必需
红字冲销税额
chyydm
string 
冲红原因代码
必需
冲红原因代码
01：开票有误
02：销货退回
03：服务中止
04：销售折让
zsfs
string 
征税方式
可选
征税方式
0：普通征税
1：减按计征
2：差额征税
yzzfpdm
string 
原纸质发票代码
可选
原发票为纸质发票时，必填
yzzfphm
string 
原纸质发票号码
可选
原发票为纸质发票时，必填
qrjkpbz
string 
确认即开票标志
可选
确认即开票标志
gwmc
string 
岗位名称
可选
岗位名称 不填默认为当前调用者默认岗位，否则使用当前填入的岗位名称
hzqrdmxList
array [object {13}] 
必需
Examples

Responses

🟢200成功
application/json
Body
code
integer 
返回代码
必需
返回代码
msg
string 
返回消息
必需
返回消息
data
object 
返回数据
必需
返回数据
sqly
string 
申请来源
必需
申请来源
0：销方申请、1：购方申请
tdyslxdm
string 
特定要素类型代码
可选
特定要素类型代码（传空即可）
hzcxje
string 
红字冲销金额
必需
红字冲销金额
hzcxse
string 
红字冲销税额
必需
红字冲销税额
chyydm
string 
冲红原因代码
必需
冲红原因代码01：开票有误 02：销货退回 03：服务中止 04：销售折让
hzfpxxqrdbh
string 
红字确认单编号
必需
红字确认单编号
hzfpxxqrdid
string 
红字确认单ID
必需
红字确认单ID
lrrq
string 
录入日期
必需
录入日期
格式: yyyy-MM-dd HH:mm:ss
hzfphm
string 
红字发票号码
可选
红字发票号码
hzqrxxztdm
string 
红字确认单状态
必需
红字确认单状态
01：无需确认
02：销方录入待购方确认
03：购方录入待销方确认
04：购销双方已确认
05：作废（销方录入购方否认）
06：作废（购方录入销方否认）
07：作废（超72小时未确认）08：（发起方撤销）
hzhjje
string 
红字合计金额
可选
红字合计金额
hzhjse
string 
红字合计税额
可选
红字合计税额
hzkprq
string 
红字开票日期
可选
红字开票日期
格式：yyyy-MM-dd HH:mm:ss
gmfmc
string 
购买方名称
必需
购买方名称
xsfmc
string 
销售方名称
必需
销售方名称
gmfnsrsbh
string 
购买方纳税人识别号
必需
购买方纳税人识别号
xsfnsrsbh
string 
销售方纳税人识别号
必需
销售方纳税人识别号
lzfplxdm
string 
蓝字发票类型代码
必需
蓝字发票类型代码
lzhjje
string 
蓝字合计金额
必需
蓝字合计金额
lzhjse
string 
蓝字合计税额
必需
蓝字合计税额
lzfphm
string 
蓝字发票号码
必需
蓝字发票号码
lzkprq
string 
蓝字开票日期
必需
蓝字开票日期
格式：yyyy-MM-dd HH:mm:ss
qqrq
string 
确认日期格式
可选
确认日期格式：
yyyy-MM-dd HH:mm:ss
xfsytdm
string 
消费税用途代码
可选
消费税用途代码
fprzztdm
string 
发票入账状态代码
可选
发票入账状态代码
zzsytdm
string 
增值税用途代码
可选
增值税用途代码
gxfsf
string 
购销方身份
可选
购销方身份
hzqrxxmxList
array [object {12}] 
红字确认单明细
必需
红字确认单明细
Modified at 2025-05-28 02:13:37
Previous
红字确认单申请准备信息查询
Next
数电快捷全额红冲
Built with