红字发票信息表申请接口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>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-03-31 16:08:29

results matching ""

    No results matching ""