查询数字化电子红字确认单列表信息

1、接口及场景描述

接口描述：向企业提供查询全电红字确认单列表信息的功能，企业可以通过购买方纳税人识别号、销售方纳税人识别号、蓝字发票号码、录入日期起、录入日期止等条件查询全电确认单列表信息，并将查询的结果保存在本地。使用此信息可以在申请全电红字确认单时校验全电蓝字发票是否可以红冲；在开具全电红字发票时校验是否有全电红字确认单

2、请求参数

名称	必选	类型	描述
method	是	String	固定值cxszhdzhzqrdlbxx
object	是	object
yhjslx	是	string	用户角色类型：0：销方1：购方
xsfnsrsbh	否	string	销售方纳税人识别号：条件必录，作为销方必录
xsfmc	否	string	销售方名称：条件必录，作为销方，必录
gmfnsrsbh	否	string	购方纳税人识别号：条件必录，作为购方必录
gmfmc	否	string	购方名称：条件必录，作为购方必录
lrfsf	否	string	录入方身份：0：销方1：购方
lrrqq	否	string	录入日期起：格式：yyyy-MM-dd
lrrqz	否	string	录入日期止：格式：yyyy-MM-dd
lzfpdm	否	string	蓝字发票代码
lzfphm	否	string	蓝字发票号码
hzfpxxqrdbh	否	string	红字确认单编号
hzqrxxztDm	否	string	红字确认信息状态代码：01：无需确认 02：销方录入待购方确认03：购方录入待销方确认 04：购销双方已确认05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超72 小时未确认） 08：作废（发起方撤销）09：作废（确认后撤销） 10 作废（异常凭证）
fppzDm	否	string	发票票种代码：01: 增值税专用发票02: 普通发票
pageNumber	否	string	页码：每页条数范围在1~100之间
pageSize	否	string	每页数量：每页条数范围在1~100之间

3、返回参数

名称	必选	类型	描述
code	是	integer	返回代码 0成功3004:失败
msg	是	string	返回消息
data	否	object	返回数据
pageNumber	否	string	页码
pageSize	否	string	每页数量
total	是	string	总数
list	是	string	列表集合
uuid	是	string	红字确认单 UUID
hzfpxxqrdbh	否	string	红字发票信息确认单编号
lrfsf	是	string	录入方身份：0：销方1：购方
xsfnsrsbh	否	string	销售方纳税人识别号
xsfmc	是	string	销售方名称
gmfnsrsbh	否	string	购买方纳税人识别号
gmfmc	是	string	购买方名称
lzfpdm	否	string	蓝字发票发票代码
lzfphm	否	string	蓝字发票发票号码
sfzzfpbz	是	string	是否纸质发票标志：Y:纸质发票N:电子发票
lzkprq	否	string	蓝字发票开票日期:格式：yyyy-MM-dd HH:mm:ss
lzhjje	否	string	蓝字发票合计金额
lzhjse	否	string	蓝字发票合计税额
lzfppzDm	否	string	蓝字发票发票票种代码:01: 增值税专用发票 02: 普通发票
lzfpTdyslxDm	否	string	蓝字发票特定要素类型代码
hzcxje	是	string	红字冲销金额
hzcxse	是	string	红字冲销税额
hzqrdmxsl	是	string	红字确认单明细数量
chyyDm	是	string	红字发票冲红原因代码:01：开票有误02：销货退回03：服务中止04：销售折让
hzqrxxztDm	是	string[]	红字确认信息状态代码:01：无需确认 02：销方录入待购方确认03：购方录入待销方确认 04：购销双方已确认05：作废（销方录入购方否认） 06：作废（购方录入销方否认）07：作废（超72 小时未确认） 08：作废（发起方撤销）09：作废（确认后撤销） 10 作废（异常凭证）
qrrq	否	string	确认日期:格式：yyyy-MM-dd HH:mm:ss
ykjhzfpbz	否	string	已开具红字发票标志 Y：已开具 N：未开具
hzfphm	否	string	红字发票号码
hzkprq	是	string	红字开票日期
yxbz	是	string	有效标志:Y:有效N:无效

4、返回code码表

代码(code)	描述
0	成功
31017	用户角色类型不能为空
31018	当用户角色类型为销方时，销方纳税人识别号、销方名称不能为空
31019	当用户角色类型为购方时，购方纳税人识别号、购方名称不能为空

请求参数

Body 参数application/json

示例

{
    "method": "cxszhdzhzqrdlbxx",
    "object": {
        "yhjslx": "用户角色类型",
        "xsfnsrsbh": "（销售方）统一社会信用代码/纳税人识别号/身份证件号码",
        "xsfmc": "（销售方） 名称",
        "gmfnsrsbh": "（购买方） 统一社会信用代码 / 纳税人识别号 / 身份证件号码",
        "gmfmc": "（购买方） 名称",
        "lrfsf": "录入方身份",
        "lrrqq": "录入日期起",
        "lrrqz": "录入日期止",
        "lzfpdm": "蓝字发票代码",
        "lzfphm": "蓝字发票号码",
        "hzfpxxqrdbh": "红字确认单编号",
        "hzqrxxztDm": "红字确认信息状态代码",
        "fppzDm": "发票票种代码",
        "pageNumber": "页码",
        "pageSize": "每页数量"
    }
}

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "pageNumber": "页码",
        "pageSize": "页数",
        "total": "总数",
        "list": [
            {
                "uuid": "红字确认单 UUID",
                "hzfpxxqrdbh": "红字发票信息确认单编号",
                "lrfsf": "录入方身份",
                "xsfnsrsbh": "（销售方）统一社会信用代码/纳税人识别号 / 身份证件号码",
                "xsfmc": "（销售方） 名称",
                "gmfnsrsbh": "（购买方） 统一社会信用代码 / 纳税人识别号 / 身份证件号码",
                "gmfmc": "（购买方） 名称",
                "lzfpdm": "蓝字发票发票代码",
                "lzfphm": "蓝字发票发票号码",
                "sfzzfpbz": "是否纸质发票标志",
                "lzkprq": "蓝字发票开票日期",
                "lzhjje": "蓝字发票合计金额",
                "lzhjse": "蓝字发票合计税额",
                "lzfppzDm": "蓝字发票发票票种代码",
                "lzfpTdyslxDm": "蓝字发票特定要素类型代码",
                "hzcxje": "红字冲销金额",
                "hzcxse": "红字冲销税额",
                "hzqrdmxsl": "红字确认单明细数量",
                "chyyDm": "红字发票冲红原因代码",
                "hzqrxxztDm": "红字确认信息状态代码",
                "qrrq": "确认日期",
                "ykjhzfpbz": "已开具红字发票标志",
                "hzfphm": "红字发票号码",
                "hzkprq": "红字开票日期",
                "yxbz": "有效标志"
            }
        ]
    }
}

查询数字化电子红字确认单列表信息

1、接口及场景描述#

2、请求参数#