红字确认单列表查询API
API说明：本接口支持查询红字确认单列表信息。
调用方式：HTTP协议
API编码：ECXML.HZQRDLB.QUERY
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_HZQRDLB class="REQUEST_HZQRDLB">
<YHJSLX>用户角色类型</YHJSLX>
<XSFNSRSBH>销售方纳税人识别号</XSFNSRSBH>
<XSFMC>销售方名称</XSFMC>
<GMFNSRSBH>购买方纳税人识别号</GMFNSRSBH>
<GMFMC>购买方名称</GMFMC>
<QRDZT>确认单状态</QRDZT>
<LRRQQ>录入日期起</LRRQQ>
<LRRQZ>录入日期止</LRRQZ>
<LRFSF>录入方身份</LRFSF>
<PAGENUMBER>当前页码</PAGENUMBER>
<PAGESIZE>每页条数</PAGESIZE>
</REQUEST_HZQRDLB>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| YHJSLX | 用户角色类型 | varchar | 1 | 是 | 0：销方 1：购方 |
| XSFNSRSBH | 销售方纳税人识别号 | varchar | 26 | 否 | YHJSLX为0时必填 |
| XSFMC | 销售方名称 | varchar | 180 | 否 | YHJSLX为0时必填 |
| GMFNSRSBH | 购买方纳税人识别号 | varchar | 20 | 否 | YHJSLX为1时必填 |
| GMFMC | 购买方名称 | varchar | 180 | 否 | YHJSLX为1时必填 |
| QRDZT | 确认单状态 | varchar | 2 | 否 | 01：无需确认 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超72小时未确认） 08：发起方撤销 09：作废（确认后撤销） |
| LRRQQ | 录入日期起 | varchar | 10 | 是 | 格式：yyyy-MM-dd |
| LRRQZ | 录入日期止 | varchar | 10 | 是 | 格式：yyyy-MM-dd |
| LRFSF | 录入方身份 | varchar | 1 | 是 | 0：销方 1：购方 |
| PAGENUMBER | 当前页码 | int | 4 | 是 | YHJSLX为1时必填 |
| PAGESIZE | 每页条数 | int | 4 | 是 | YHJSLX为1时必填 |
返回报文规范
<RESPONSE_HZQRDLB class="RESPONSE_HZQRDLB">
<PAGENUMBER>当前页码</PAGENUMBER>
<PAGESIZE>每页条数</PAGESIZE>
<TOTAL>总条数</TOTAL>
<HZQRDLB_ITEMS class="HZQRDLB_ITEM;" size="1">
<HZQRDLB_ITEM>
<HZQRDUUID>红字确认单UUID</HZQRDUUID>
<HZQRXXDBH>红字发票信息确认单编号</HZQRXXDBH>
<LRFSF>录入方身份</LRFSF>
<XSFNSRSBH>销售方纳税人识别号</XSFNSRSBH>
<XSFMC>销售方名称</XSFMC>
<GMFNSRSBH>购买方纳税人识别号</GMFNSRSBH>
<GMFMC>购买方名称</GMFMC>
<LZFPDM>蓝字发票代码</LZFPDM>
<LZFPHM>蓝字发票号码</LZFPHM>
<LZSFZZFP>蓝字发票是否是纸质发票</LZSFZZFP>
<LZKPRQ>蓝字发票开票日期</LZKPRQ>
<LZHJJE>蓝字发票合计金额</LZHJJE>
<LZHJSE>蓝字发票合计税额</LZHJSE>
<LZFPPZ>蓝字发票票种</LZFPPZ>
<LZFPTDYSLXDM>蓝字发票特定要素类型代码</LZFPTDYSLXDM>
<HZCXJE>红字冲销金额</HZCXJE>
<HZCXSE>红字冲销税额</HZCXSE>
<HZQRDMXSL>红字确认单明细数量</HZQRDMXSL>
<CHYY>冲红原因</CHYY>
<HZQRXXZT>红字确认信息状态</HZQRXXZT>
<QRRQ>确认日期</QRRQ>
<YKJHZFPBZ>已开具红字发票标志</YKJHZFPBZ>
<HZFPHM>红字发票号码</HZFPHM>
<HZKPRQ>红字开票日期</HZKPRQ>
<YXBZ>有效标志</YXBZ>
<LRRQ>录入日期</LRRQ>
</HZQRDLB_ITEM>
</HZQRDLB_ITEMS>
</RESPONSE_HZQRDLB>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| HZQRDUUID | 红字确认单uuid | varchar | 32 | 是 | |
| HZQRXXDBH | 红字确认信息单编号 | varchar | 32 | 是 | |
| LRFSF | 录入方身份 | varchar | 1 | 是 | 0：销方 1：购方 |
| XSFNSRSBH | 销售方纳税人识别号 | varchar | 26 | 否 | |
| XSFMC | 销售方名称 | varchar | 300 | 否 | |
| GMFNSRSBH | 购买方纳税人识别号 | varchar | 26 | 否 | |
| GMFMC | 购买方名称 | varchar | 300 | 否 | |
| LZFPDM | 蓝字发票代码 | varchar | 12 | 否 | |
| LZFPHM | 蓝字发票号码 | varchar | 20 | 否 | |
| LZSFZZFP | 蓝字是否纸质发票 | varchar | 1 | 是 | Y：纸质发票 N：电子发票 |
| LZKPRQ | 蓝字开票日期 | varchar | 20 | 否 | 格式：yyyy-MM-dd HH:mm:ss |
| LZFPJE | 蓝字发票金额 | double | 18,2 | 否 | |
| LZFPSE | 蓝字发票税额 | double | 20 | 否 | |
| LZFPPZ | 蓝字发票票种 | varchar | 2 | 否 | 01： 增值税专用发票 02： 普通发票 03：机动车统一销售发票 04：二手车统一销售发票 |
| LZFPTDYSLXDM | 蓝字发票特定要素类型代码 | varchar | 2 | 否 | 详见特定要素代码 |
| HZCXJE | 红字冲销金额 | double | 18,2 | 否 | |
| HZCXSE | 红字冲销税额 | double | 18,2 | 否 | |
| HZQRDMXSL | 红字确认单明细数量 | INT | 4 | 是 | |
| CHYY | 冲红原因 | varchar | 2 | 是 | 1：开票有误 2：销货退回 3：服务终止 4：销售转让 |
| HZQRXXZT | 红字确认信息状态 | varchar | 2 | 是 | 01：无需确认； 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超72小时未确认） 08：发起方撤销 |
| QRRQ | 确认日期 | varchar | 20 | 否 | 格式：yyyy-MM-dd HH:mm:ss |
| YKJHZFPBZ | 已开具红字发票标志 | varchar | 1 | 否 | Y：已开具 N：未开具 |
| HZFPHM | 红字发票号码 | varchar | 20 | 否 | |
| HZKPRQ | 红字开票日期 | varchar | 20 | 否 | 格式：yyyy-MM-dd HH:mm:ss |
| YXBZ | 有效标志 | varchar | 1 | 是 | Y：有效 N：无效 |
| LRRQ | 录入日期 | varchar | 20 | 是 | 格式：yyyy-MM-dd HH:mm:ss |
示例报文
请求报文示例
<?xml version='1.0' encoding='utf-8'?>
<interface
xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:schemaLocation='http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd' version='DZFP1.0'>
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.HZQRDLB.QUERY</interfaceCode>
<requestCode>H5PTS003</requestCode>
<requestTime>2024-04-19 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>H5PTS003</userName>
<passWord />
<taxpayerId>91440604MA4UJ2LA6H</taxpayerId>
<authorizationCode>8L45WTQAHG</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode />
<returnMessage />
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RREQUEST_HZQRDLB class="REQUEST_HZQRDLB">
<YHJSLX>0</YHJSLX>
<XSFNSRSBH>91440604MA4UJ2LA6H</XSFNSRSBH>
<XSFMC>佛山宝尔特斯密封技术有限公司</XSFMC>
<GMFNSRSBH></GMFNSRSBH>
<GMFMC></GMFMC>
<QRDZT></QRDZT>
<LRRQQ>2024-01-01</LRRQQ>
<LRRQZ>2024-04-01</LRRQZ>
<LRFSF></LRFSF>
<PAGENUMBER>1</PAGENUMBER>
<PAGESIZE>2</PAGESIZE>
</RREQUEST_HZQRDLB>
</content>
</Data>
</interface>
返回报文示例（成功）
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.HZQRDLB.QUERY</interfaceCode>
<requestCode>H5PTS003</requestCode>
<requestTime>2024-04-19 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>H5PTS003</userName>
<passWord />
<taxpayerId>91440604MA4UJ2LA6H</taxpayerId>
<authorizationCode>8L45WTQAHG</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>0000</returnCode>
<returnMessage>5aSE55CG5oiQ5Yqf</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RESPONSE_HZQRDLB class="RESPONSE_HZQRDLB">
<PAGENUMBER>1</PAGENUMBER>
<PAGESIZE>2</PAGESIZE>
<TOTAL>399</TOTAL>
<HZQRDLB_ITEMS class="HZQRDLB_ITEM;" size="2">
<HZQRDLB_ITEM>
<HZQRDUUID>9bff9924e0634efcb20637c904ddc93a</HZQRDUUID>
<HZQRXXDBH>44060424041000000650</HZQRXXDBH>
<LRFSF>0</LRFSF>
<XSFNSRSBH>91440604MA4UJ2LA6H</XSFNSRSBH>
<XSFMC>佛山宝尔特斯密封技术有限公司</XSFMC>
<GMFNSRSBH>91410105551627635F</GMFNSRSBH>
<GMFMC>河南省维百福轴承机械有限公司</GMFMC>
<LZFPDM></LZFPDM>
<LZFPHM>24442000000000141684</LZFPHM>
<LZSFZZFP>N</LZSFZZFP>
<LZKPRQ>2024-03-13 11:38:41</LZKPRQ>
<LZHJJE>3.0</LZHJJE>
<LZHJSE>0.09</LZHJSE>
<LZFPPZ>02</LZFPPZ>
<LZFPTDYSLXDM></LZFPTDYSLXDM>
<HZCXJE>-3.0</HZCXJE>
<HZCXSE>-0.09</HZCXSE>
<HZQRDMXSL>3</HZQRDMXSL>
<CHYY>02</CHYY>
<HZQRXXZT>01</HZQRXXZT>
<QRRQ></QRRQ>
<YKJHZFPBZ>Y</YKJHZFPBZ>
<HZFPHM>24442000000000193833</HZFPHM>
<HZKPRQ>2024-04-01 18:12:33</HZKPRQ>
<YXBZ>Y</YXBZ>
<LRRQ>2024-04-01 18:12:23</LRRQ>
</HZQRDLB_ITEM>
<HZQRDLB_ITEM>
<HZQRDUUID>b5d66b87b83146e784de3d7601d6dd7d</HZQRDUUID>
<HZQRXXDBH>44060424031001801031</HZQRXXDBH>
<LRFSF>0</LRFSF>
<XSFNSRSBH>91440604MA4UJ2LA6H</XSFNSRSBH>
<XSFMC>佛山宝尔特斯密封技术有限公司</XSFMC>
<GMFNSRSBH></GMFNSRSBH>
<GMFMC>HUANG</GMFMC>
<LZFPDM></LZFPDM>
<LZFPHM>24442000000000188283</LZFPHM>
<LZSFZZFP>N</LZSFZZFP>
<LZKPRQ>2024-03-27 16:06:25</LZKPRQ>
<LZHJJE>19.0</LZHJJE>
<LZHJSE>2.11</LZHJSE>
<LZFPPZ>02</LZFPPZ>
<LZFPTDYSLXDM></LZFPTDYSLXDM>
<HZCXJE>-19.0</HZCXJE>
<HZCXSE>-2.11</HZCXSE>
<HZQRDMXSL>3</HZQRDMXSL>
<CHYY>01</CHYY>
<HZQRXXZT>01</HZQRXXZT>
<QRRQ></QRRQ>
<YKJHZFPBZ>Y</YKJHZFPBZ>
<HZFPHM>24442000000000188669</HZFPHM>
<HZKPRQ>2024-03-27 17:45:01</HZKPRQ>
<YXBZ>Y</YXBZ>
<LRRQ>2024-03-27 17:44:52</LRRQ>
</HZQRDLB_ITEM>
</HZQRDLB_ITEMS>
</RESPONSE_HZQRDLB>
</content>
</Data>
</interface>
返回报文示例（失败）
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.HZQRDLB.QUERY</interfaceCode>
<requestCode>H5PTS003</requestCode>
<requestTime>2024-04-19 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>H5PTS003</userName>
<passWord />
<taxpayerId>91440604MA4UJ2LA6H</taxpayerId>
<authorizationCode>8L45WTQAHG</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>9999(或者是其它错误码)</returnCode>
<returnMessage>Base64(错误信息)</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content/>
</Data>
</interface>