红字发票申请表审核下载接口API
API说明：红字发票申请表审核下载
调用方式：HTTP协议
API编码：ECXML_HZFPSQBXZ
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_HZFPSQBXZ class="REQUEST_HZFPSQBXZ">
<FPZL_DM>发票种类代码</FPZL_DM>
<FJH>分机号</FJH>
<YQZT>逾期状态</YQZT>
<TKRQ_Q>填开日期起</TKRQ_Q>
<TKRQ_Z>填开日期止</TKRQ_Z>
<GFSH>购方税号</GFSH>
<XFSH>销方税号</XFSH>
<XXBBH>信息表编号</XXBBH>
<XXBFW>信息表下载范围</XXBFW>
<PAGENO>页号</PAGENO>
<PAGESIZE>每页记录数</PAGESIZE>
<BYZD1>备用字段</BYZD1>
<BYZD2>备用字段</BYZD2>
</REQUEST_HZFPSQBXZ>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| FPZL_DM | 发票种类代码 | varchar | 是 | 0：专票 4：电子专票 |
|
| FJH | 分机号 | varchar | 是 | 金税盘：范围0-65535 UKey：传设备编号 | |
| YQZT | 逾期状态 | varchar | 1 | 是 | N：非逾期 Y：逾期 |
| TKRQ_Q | 填开日期起 | varchar | 8 | 否 | 可空，申请表上传到税局的日期，YYYYMMDD |
| TKRQ_Z | 填开日期止 | varchar | 8 | 否 | 可空，申请表上传到税局的日期，YYYYMMDD |
| GFSH | 购方税号 | varchar | 20 | 否 | 可空 |
| XFSH | 销方税号 | varchar | 20 | 否 | 可空 |
| XXBBH | 信息表编号 | varchar | 否 | 可空 | |
| XXBFW | 信息表下载范围 | varchar | 是 | 0：全部 1：本企业申请 2：其它企业申请 |
|
| PAGENO | 页号 | varchar | 是 | 从1开始 | |
| PAGESIZE | 每页记录数 | varchar | 是 | 最大支持每页10条记录 | |
| BYZD1 | 备用字段1 | varchar | 不定 | 否 | 该字段为平台预留字段，不可用 |
| BYZD2 | 备用字段2 | varchar | 不定 | 否 | 该字段为平台预留字段，不可用 |
返回报文规范
<RESPONSE_COMMON_HZFPSQBSHXZ class="RESPONSE_COMMON_HZFPSQBSHXZ">
<ALLCOUNT>成功获取的个数</ALLCOUNT>
<REDINVREQBILL class="REDINVREQBILLXX;" size="1">
<REDINVREQBILLXX>
<REQBILLNO>申请单号</REQBILLNO>
<RESBILLNO>信息表编号</RESBILLNO>
<STATUSDM>信息表状态</STATUSDM>
<STATUSMC>信息表状态描述</STATUSMC>
<BILLTYPE>信息表类型</BILLTYPE>
<YFPDM>对应蓝票代码</YFPDM>
<YFPHM>对应蓝票号码</YFPHM>
<SZLB>税种类别</SZLB>
<ISMUTIRATE>多税率标志</ISMUTIRATE>
<DATE>填开日期</DATE>
<XFSH>销方税号</XFSH>
<XFMC>销方名称</XFMC>
<GFSH>购方税号</GFSH>
<GFMC>购方税号</GFMC>
<HJJE>合计金额</HJJE>
<HJSE>合计税额</HJSE>
<REQMEMO>申请说明</REQMEMO>
<BMBBH>商品编码版本号</BMBBH>
<YYSBZ>营业税标志</YYSBZ>
<REDINVREQBILLMX class="GOODSMX;" size="1">
<GOODSMX>
<XMMC>名称</XMMC>
<JLDW>单位</JLDW>
<GGXH>规格型号</GGXH>
<XMDJ>单价</XMDJ>
<XMJE>商品金额</XMJE>
<XMSL>商品数量</XMSL>
<SL>税率</SL>
<SE>商品税额</SE>
<SPBM>商品编码</SPBM>
<QYZXBM>企业自编码</QYZXBM>
<SFYHZC>是否享受优惠政策</SFYHZC>
<YHZCNR>优惠政策内容</YHZCNR>
<LSLBS>零税率标识</LSLBS>
</GOODSMX>
</REDINVREQBILLMX>
</REDINVREQBILLXX>
</REDINVREQBILL>
</RESPONSE_COMMON_HZFPSQBSHXZ>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| ALLCOUNT | 纳税人识别号 | varchar | 是 | ||
| REDINVREQBILL | 可能为多个,最多支持10个 | ||||
| REQBILLNO | 申请单号 | varchar | 24 | 是 | |
| RESBILLNO | 信息表编号 | varchar | 是 | ||
| STATUSDM | 信息表状态 | varchar | 是 | TZD0000、TZD1000表示可以填开红票 | |
| STATUSMC | 信息表状态描述 | varchar | 是 | ||
| BILLTYPE | 信息表类型 | varchar | 1 | 是 | 0：正常 1：逾期 |
| YFPDM | 对应蓝票代码 | varchar | 12 | 是 | |
| YFPHM | 对应蓝票号码 | varchar | 8 | 是 | |
| SZLB | 税种类别 | varchar | 1 | 是 | 0：营业税 1：增值税（目前全部为1） |
| ISMUTIRATE | 多税率标志 | varchar | 1 | 是 | 0：一票一税率 1：一票多税率 |
| DATE | 填开时间 | varchar | 8 | 是 | YYYYMMDD |
| XFSH | 销方税号 | varchar | 20 | 是 | |
| XFMC | 销方名称 | varchar | 是 | ||
| GFSH | 购方税号 | varchar | 20 | 是 | |
| GFMC | 购方名称 | varchar | 是 | ||
| HJJE | 合计金额 | varchar | 是 | 带负号,不含税 | |
| HJSE | 合计税额 | varchar | 是 | 带负号 | |
| REQMEMO | 申请说明 | varchar | 10 | 是 | 按局端的规则代码，含正常和逾期，具体见下表说明 |
| BMBBH | 商品编码版本号 | varchar | |||
| YYSBZ | 营业税标志 | varchar | 是 | 0000000010：1.5%税率 0000000020：差额税 0000000060：农产品收购 0000000090：成品油 0000000000：其他 |
|
| REDINVREQBILLMX | 明细信息 | varchar | 是 | ||
| XMMC | 名称 | varchar | 100 | 是 | |
| JLDW | 单位 | varchar | 22 | ||
| GGXH | 规格型号 | varchar | 40 | ||
| XMDJ | 单价 | varchar | |||
| XMJE | 商品金额 | varchar | 是 | 带负号,不含税 | |
| XMSL | 商品数量 | varchar | 带负号 | ||
| SL | 税率 | varchar | 是 | ||
| SE | varchar | 是 | |||
| SPBM | 商品编码 | varchar | |||
| QYZXBM | 企业自编码 | varchar | |||
| SFYHZC | 是否享受优惠政策 | varchar | 是 | 0：不使用 1：使用 |
|
| YHZCBS | 优惠政策标识 | varchar | |||
| LSLBS | 零税率标识 | varchar | 空：非零税率 0：出口退税 1：免税 2：不征收 3：普通零税率 |
示例报文
请求报文示例
<?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>DZFP</appId>
<version>1.0</version>
<interfaceCode>ECXML_HZFPSQBXZ</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>17-04-07 16:40:30</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>12183218361820170407eXl4EymmJ</dataExchangeId>
<userName>P1000001</userName>
<passWord></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>
<REQUEST_HZFPSQBXZ class="REQUEST_HZFPSQBXZ">
<FPZL_DM>0</FPZL_DM>
<FJH>7</FJH>
<YQZT>N</YQZT>
<TKRQ_Q></TKRQ_Q>
<TKRQ_Z></TKRQ_Z>
<GFSH></GFSH>
<XFSH></XFSH>
<XXBBH>1234567890123456</XXBBH>
<XXBFW>0</XXBFW>
<PAGENO>1</PAGENO>
<PAGESIZE>10</PAGESIZE>
<BYZD1></BYZD1>
<BYZD2></BYZD2>
</REQUEST_HZFPSQBXZ>
</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>DZFP</appId>
<version>1.0</version>
<interfaceCode>ECXML_HZFPSQBXZ</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 09:40:30</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>adaewredsaf20170407eXl4EymmJ</dataExchangeId>
<userName>P1000001</userName>
<passWord></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_COMMON_HZFPSQBSHXZ class="RESPONSE_COMMON_HZFPSQBSHXZ">
<ALLCOUNT>1</ALLCOUNT>
<REDINVREQBILL class="REDINVREQBILLXX;" size="1">
<REDINVREQBILLXX>
<REQBILLNO>xxxxxx</REQBILLNO>
<RESBILLNO>xxxxxx</RESBILLNO>
<STATUSDM>TZD0074</STATUSDM>
<STATUSMC>已核销</STATUSMC>
<BILLTYPE>0</BILLTYPE>
<YFPDM></YFPDM>
<YFPHM></YFPHM>
<SZLB>1</SZLB>
<ISMUTIRATE>0</ISMUTIRATE>
<DATE>20211022</DATE>
<XFSH>913101010000000090</XFSH>
<XFMC>测试税号</XFMC>
<GFSH>913101010000000090</GFSH>
<GFMC>测试税号</GFMC>
<HJJE>-18568.41</HJJE>
<HJSE>-2413.90</HJSE>
<REQMEMO>Y</REQMEMO>
<BMBBH>39.0</BMBBH>
<YYSBZ>1</YYSBZ>
<REDINVREQBILLMX class="GOODSMX;" size="1">
<GOODSMX>
<XMMC>*光学仪器*销售折让</XMMC>
<JLDW></JLDW>
<GGXH></GGXH>
<XMDJ></XMDJ>
<XMJE>-1123.85</XMJE>
<XMSL></XMSL>
<SL>0.13</SL>
<SE>-146.10</SE>
<SPBM>1090619050000000000</SPBM>
<QYZXBM>014</QYZXBM>
<SFYHZC></SFYHZC>
<YHZCNR/>
<LSLBS></LSLBS>
</GOODSMX>
</REDINVREQBILLMX>
</REDINVREQBILLXX>
</REDINVREQBILL>
</RESPONSE_COMMON_HZFPSQBSHXZ>
</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>DZFP</appId>
<version>1.0</version>
<interfaceCode>ECXML_HZFPSQBXZ</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>17-04-07 16:40:30</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>