乐企红字确认单信息查询API
API说明：本接口支持以纳税人信息、红字信息单编号查询红字确认单信息
调用方式：HTTP协议
API编码：ECXML.QDFP.HZQRDXXCX
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_QDHZQRDXXCX class="REQUEST_QDHZQRDXXCX">
<YHJSLX>用户角色类型</YHJSLX>
<XSFNSRSBH>销售方纳税人识别号</XSFNSRSBH>
<XSFMC>销售方名称</XSFMC>
<GMFNSRSBH>购买方纳税人识别号</GMFNSRSBH>
<GMFMC>购买方名称</GMFMC>
<LZFPDM>蓝字发票代码</LZFPDM>
<LZFPHM>蓝字发票号码</LZFPHM>
<HZQRXXDBH>红字确认信息单编号</HZQRXXDBH>
</REQUEST_QDHZQRDXXCX>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| 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时必填 |
| LZFPDM | 蓝字发票代码 | varchar | 12 | 否 | 非数电发票时必填 |
| LZFPHM | 蓝字发票号码 | varchar | 20 | 是 | |
| HZQRXXDBH | 红字确认信息单编号 | varchar | 32 | 是 |
返回报文规范
<RESPONSE_QDHZQRDXXCX class="RESPONSE_ QDHZQRDXXCX">
<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>
<CHYY>冲红原因</CHYY>
<HZQRXXZT>红字确认信息状态</HZQRXXZT>
<QRRQ>确认日期</QRRQ>
<YKJHZFPBZ>已开具红字发票标志</YKJHZFPBZ>
<HZFPHM>红字发票号码</HZFPHM>
<HZKPRQ>红字开票日期</HZKPRQ>
<YXBZ>有效标志</YXBZ>
</RESPONSE_QDHZQRDXXCX>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| 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 | 否 | |
| 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：无效 |
示例报文
请求报文示例
<?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.QDFP.HZQRDXXCX</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2023-02-18 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode />
<returnMessage />
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<REQUEST_QDHZQRDXXCX class="REQUEST_QDHZQRDXXCX">
<YHJSLX>0</YHJSLX>
<XSFNSRSBH>913101010000000090</XSFNSRSBH>
<XSFMC>上海航信测试90</XSFMC>
<GMFNSRSBH>123456789012345000</GMFNSRSBH>
<GMFMC>上海申北测试</GMFMC>
<LZFPDM></LZFPDM>
<LZFPHM>23446000000000000000</LZFPHM>
<HZQRXXDBH>44201422081000000301</HZQRXXDBH>
</REQUEST_QDHZQRDXXCX>
</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.QDFP.HZQRDXXCX</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2023-02-18 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord />
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>0000</returnCode>
<returnMessage>5aSE55CG5oiQ5Yqf</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RESPONSE_QDHZQRDXXCX class="RESPONSE_ QDHZQRDXXCX">
<HZQRDUUID>87c9cba6ccdd4b99a3f908c3dd991c54</HZQRDUUID>
<HZQRXXDBH>44201422081000000301</HZQRXXDBH>
<LRFSF>1</LRFSF>
<XSFNSRSBH>913101010000000090</XSFNSRSBH>
<XSFMC>上海航信测试90</XSFMC>
<GMFNSRSBH>123456789012345000</GMFNSRSBH>
<GMFMC>上海申北测试</GMFMC>
<LZFPDM></LZFPDM>
<LZFPHM>23446000000000000000</LZFPHM>
<LZSFZZFP>N</LZSFZZFP>
<LZKPRQ>2023-02-15 13:55:16</LZKPRQ>
<LZHJJE>22.64</LZHJJE>
<LZHJSE>1.36</LZHJSE>
<LZFPPZ>02</LZFPPZ>
<LZFPTDYSLXDM></LZFPTDYSLXDM>
<HZCXJE>22.64</HZCXJE>
<HZCXSE>1.36</HZCXSE>
<CHYY>03</CHYY>
<HZQRXXZT>01</HZQRXXZT>
<QRRQ>2023-02-18 10:30:42</QRRQ>
<YKJHZFPBZ>N</YKJHZFPBZ>
<HZFPHM></HZFPHM>
<HZKPRQ></HZKPRQ>
<YXBZ>Y</YXBZ>
</RESPONSE_QDHZQRDXXCX >
</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.QDFP.HZQRDXXCX</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2023-02-18 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>21ewqdsafafx20170407eXl4EymmJ</dataExchangeId>
<userName>P1000001</userName>
<passWord></passWord>
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</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>