红字发票信息表申请接口API
API说明:企业红冲电子专票时,可通过该接口申请获取红字通知单信息
调用方式:HTTP协议
API编码:ECXML.RED.HZTZSQ
调用方法:POST(XML文件流)
请求报文规范
<REQUEST_SHHZSQ class="REQUEST_SHHZSQ">
<HZTZLSH>红字通知单申请流水号</HZTZLSH>
<NSRSBH>纳税人识别号</NSRSBH>
<FJH>分机号</FJH>
<FPZL>发票种类</FPZL>
<XXBLSH>信息表流水号</XXBLSH>
<XXBLX>信息表类型</XXBLX>
<YFPDM>对应蓝票代码</YFPDM>
<YFPHM>对应蓝票号码</YFPHM>
<SZLB>税种类别</SZLB>
<KPRQ>对应蓝字发票开票日期</KPRQ>
<DATE>填开时间</DATE>
<XFSH>销方税号</XFSH>
<XFMC>销方名称</XFMC>
<GFSH>购方税号</GFSH>
<GFMC>购方名称</GFMC>
<HJJE>合计金额</HJJE>
<HJSE>合计税额</HJSE>
<REQMEMO>申请说明</REQMEMO>
<BMBBH>商品编码版本号</BMBBH>
<YYSBZ>营业税标志</YYSBZ>
<JBR>经办人</JBR>
<CZLX>操作类型</CZLX>
<BYZD1>备用字段</BYZD1>
<BYZD2>备用字段</BYZD2>
<BYZD3>备用字段</BYZD3>
<BYZD4>备用字段</BYZD4>
<BYZD5>备用字段</BYZD5>
<BYZD6>备用字段</BYZD6>
<BYZD7>备用字段</BYZD7>
<BYZD8>备用字段</BYZD8>
<SHHZSQMXS class="SHHZSQMX;" size="1">
<SHHZSQMX>
<XMMC>项目名称</XMMC>
<XMDW>项目单位</XMDW>
<GGXH>规格型号</GGXH>
<XMSL>项目数量</XMSL>
<XMDJ>项目单价</XMDJ>
<XMJE>项目金额</XMJE>
<SL>税率</SL>
<SE>税额</SE>
<KCE>扣除额</KCE>
<SWBM>税务编码</SWBM>
<LSLBS>零税率标识</LSLBS>
<YHZCBS>优惠政策标识</YHZCBS>
<ZZSTSGL>增值税特殊管理</ZZSTSGL>
<ZXBM>自行编码</ZXBM>
<BYZD1>备用字段</BYZD1>
<BYZD2>备用字段</BYZD2>
<BYZD3>备用字段</BYZD3>
<BYZD4>备用字段</BYZD4>
<BYZD5>备用字段</BYZD5>
</SHHZSQMX>
</SHHZSQMXS>
</REQUEST_SHHZSQ>
字段说明
数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|---|
HZTZLSH | 红字通知单申请流水号 | varchar | 40 | 是 | 唯一,8位电商平台编码+17位请求时间yyyymmddhhmmssSSS)+15位随机数,申请成功后,用该流水号获取结果。 |
NSRSBH | 纳税人识别号 | varchar | 20 | 是 | |
FJH | 分机号 | number | 否 | 金税盘: 0是主机 非0是分机。 范围0-65535 UKey:传设备编号 |
|
FPZL | 发票种类 | varchar | 是 | 0-专票 4-电子专票 |
|
XXBLSH | 信息表流水号 | varchar | 24 | 是 | 24位申请单号,和HZTZLSH对应 |
XXBLX | 信息表类型 | varchar | 是 | 0正常 1逾期(仅销方开具) |
|
YFPDM | 对应蓝票代码 | double | 12 | 是 | |
YFPHM | 对应蓝票号码 | varchar | 8 | 是 | |
SZLB | 税种类别 | varchar | 1 | 是 | 0营业税 1增值税(目前全部为1) |
KPRQ | 对应蓝字发票开票日期 | varchar | 14 | 否 | 请求报文reqmemo字段为1100000000时(购方已抵扣),kprq为非必填; reqmemo为其他值时,kprq必填,格式为YYYYMMDDHHMMSS |
DATE | 填开时间 | varchar | 14 | 是 | YYYYMMDDHHMMSS |
XFSH | 销方税号 | varchar | 20 | 是 | |
XFMC | 销方名称 | varchar | 100 | 是 | |
GFSH | 购方税号 | varchar | 20 | 是 | |
GFMC | 购方名称 | varchar | 100 | 是 | |
HJJE | 合计金额 | varchar | 是 | 带负号,不含税,2位小数 | |
HJSE | 合计税额 | varchar | 否 | 带负号,2位小数 | |
REQMEMO | 申请说明 | varchar | 是 | 十位数字表示的申请说明,含正常和逾期,reqmemo字段取值范围见《reqmemo字段10位申请说明规则表》 | |
BMBBH | 商品编码版本号 | varchar | 是 | ||
YYSBZ | 营业税标志 | varchar | 10 | 是 | 0000000010:中外合作油气田(原海洋石油)5%税率、1.5%税率; 0000000020:差额税; 0000000000:其他。 |
JBR | 经办人 | varchar | 是 | 申请人 | |
CZLX | 操作类型 | varchar | 1 | 是 | 0:是新增(目前仅支持新增) |
BYZD1 | 备用字段1 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD2 | 备用字段2 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD3 | 备用字段3 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD4 | 备用字段4 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD5 | 备用字段5 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD6 | 备用字段6 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD7 | 备用字段7 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
BYZD8 | 备用字段8 | varchar | 不定 | 否 | 该字段为平台预留字段,不可用 |
XMXX | 项目信息 | List | 否 | 发票明细列表 | |
XMMC | 项目名称 | varchar | 100 | 是 | |
XMDW | 项目单位 | varchar | 22 | 否 | 单位名称 |
GGXH | 规格型号 | varchar | 40 | 否 | 规格型号 |
XMSL | 项目数量 | double | 否 | 带负号 | |
XMDJ | 项目单价 | double | 否 | ||
XMJE | 项目金额 | double | 是 | 带负号,不含税,2位小数 | |
SL | 税率 | varchar | 是 | ||
SE | 税额 | varchar | 是 | ||
KCE | 扣除额 | varchar | 否 | 单位:元(2位小数) 非商品编码版本:不处理; 商品编码版本:不为空则按照差额征税发票处理。 |
|
SWBM | 税务编码 | varchar | 19 | 是 | 税务编码 |
LSLBS | 零税率标识 | varchar | 1 | 否 | 空:非零税率 1:免税 2:不征税 3:普通零税率 |
YHZCBS | 优惠政策标识 | varchar | 1 | 是 | 0:不使用 1:使用 |
ZZSTSGL | 增值税特殊管理 | varchar | 50 | 否 | 优惠政策内容 |
ZXBM | 自行编码 | varchar | 20 | 否 | |
BYZD1 | 备用字段1 | varchar | 不定 | 否 | |
BYZD2 | 备用字段2 | varchar | 不定 | 否 | |
BYZD3 | 备用字段3 | varchar | 不定 | 否 | |
BYZD4 | 备用字段4 | varchar | 不定 | 否 | |
BYZD5 | 备用字段5 | varchar | 不定 | 否 |
示例报文
请求报文示例
<?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.RED.HZTZSQ</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_SHHZSQ class="REQUEST_SHHZSQ">
<HZTZLSH>V5TQEACC20210621143524123456789012306</HZTZLSH>
<NSRSBH>913101010000000090</NSRSBH>
<FJH>1</FJH>
<FPZL>0</FPZL>
<XXBLSH>667003178627210622092859</XXBLSH>
<XXBLX>0</XXBLX>
<YFPDM>031002000113</YFPDM>
<YFPHM>00432107</YFPHM>
<SZLB>1</SZLB>
<KPRQ>20210622092859</KPRQ>
<DATE>20210622093325</DATE>
<XFSH>913101047989613362</XFSH>
<XFMC>上海爱信诺航天信息有限公司</XFMC>
<GFSH>91310112MA1GE1BY01</GFSH>
<GFMC>上海纳六信息技术有限公司</GFMC>
<HJJE>-10.0</HJJE>
<HJSE>-0.6</HJSE>
<REQMEMO>0000000100</REQMEMO>
<BMBBH>33.0</BMBBH>
<YYSBZ>0000000000</YYSBZ>
<JBR>开票员</JBR>
<CZLX>0</CZLX>
<BYZD1></BYZD1>
<BYZD2></BYZD2>
<BYZD3></BYZD3>
<BYZD4></BYZD4>
<BYZD5></BYZD5>
<BYZD6></BYZD6>
<BYZD7></BYZD7>
<BYZD8></BYZD8>
<SHHZSQMXS class="SHHZSQMX;" size="1">
<SHHZSQMX>
<XMMC>软件服务费</XMMC>
<XMDW></XMDW>
<GGXH></GGXH>
<XMSL>-1</XMSL>
<XMDJ>10</XMDJ>
<XMJE>-10</XMJE>
<SL>0.06</SL>
<SE>-0.6</SE>
<KCE></KCE>
<SWBM>3040201030000000000</SWBM>
<LSLBS></LSLBS>
<YHZCBS>0</YHZCBS>
<ZZSTSGL></ZZSTSGL>
<ZXBM></ZXBM>
<BYZD1></BYZD1>
<BYZD2></BYZD2>
<BYZD3></BYZD3>
<BYZD4></BYZD4>
<BYZD5></BYZD5>
</SHHZSQMX>
</SHHZSQMXS>
</REQUEST_SHHZSQ>
</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.RED.HZTZSQ</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/>
</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.RED.HZTZSQ</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>