乐企数电红字确认单申请API

API说明:本接口用于乐企数电红字确认信息单的申请
调用方式:HTTP协议
API编码:ECXML.QDFP.HZQRDSQ
调用方法:POST(XML文件流)
注意:数电发票蓝字发票仅允许存在一张有效的红字确认信息单,如果已经存在有效且未使用的红字确认信息单,再次申请红字确认单信息时会返回该红字确认信息单。
如果需要申请新的红字确认信息单,可以对当前有效的红字确认信息单进行使用、撤销或者作废处理后再申请。

请求报文规范

<REQUEST_QDHZSQ class="REQUEST_QDHZSQ">
    <QQLSH>请求流水号</QQLSH>
    <NSRSBH>纳税人识别号</NSRSBH>
    <LRFSF>录入方身份</LRFSF>
    <XSFNSRSBH>销售方纳税人识别号</XSFNSRSBH>
    <XSFMC>销售方名称</XSFMC>
    <GMFNSRSBH>购买方纳税人识别号</GMFNSRSBH>
    <GMFMC>购买方名称</GMFMC>
    <LZFPPZ>蓝字发票票种</LZFPPZ>
    <LZSFZZFP>蓝字是否纸质发票</LZSFZZFP>
    <LZKPRQ>蓝字开票日期</LZKPRQ>
    <LZFPDM>蓝字发票代码</LZFPDM>
    <LZFPHM>蓝字发票号码</LZFPHM>
    <LZFPJE>蓝字发票金额</LZFPJE>
    <LZFPSE>蓝字发票税额</LZFPSE>
    <LZFPTDYSLXDM>蓝字发票特定要素类型代码</LZFPTDYSLXDM>
    <CHYY>冲红原因</CHYY>
    <HZCXJE>红字冲销金额</HZCXJE>
    <HZCXSE>红字冲销税额</HZCXSE>
    <QDHZSQ_XMXXS class="QDHZSQ_XMXX;" size="1">
        <QDHZSQ_XMXX>
            <HH>行号</HH>
            <LZFPHH>蓝字发票行号</LZFPHH>
            <XMMC>项目名称</XMMC>
            <GGXH>规格型号</GGXH>
            <DW>单位</DW>
            <SL>数量</SL>
            <DJ>单价</DJ>
            <JE>金额</JE>
            <SE>税额</SE>
            <SLV>税率</SLV>
            <SPFWSSFLBM>商品服务税收分类编码</SPFWSSFLBM>
        </QDHZSQ_XMXX>
    </QDHZSQ_XMXXS>
</REQUEST_QDHZSQ>

字段说明

数据项 名称 类型 长度 必须 说明
QQLSH 请求流水号 varchar 50 调用端保证唯一性
NSRSBH 纳税人识别号 varchar 20
LRFSF 录入方身份 varchar 2 01:销方
02:购方
XSFNSRSBH 销售方纳税人识别号 varchar 20
XSFMC 销售方名称 varchar 180
GMFNSRSBH 购买方纳税人识别号 varchar 20
GMFMC 购买方名称 varchar 180
LZFPPZ 蓝字发票票种 varchar 2 01:增值税专用发票
02:普通发票
03:机动车统一销售发票
04:二手车统一销售发票
LZSFZZFP 蓝字是否纸质发票 varchar 1 Y:纸质发票
N:电子发票
LZKPRQ 蓝字开票日期 varchar 19 yyyy-MM-dd HH:mm:ss
LZFPDM 蓝字发票代码 varchar 12
LZFPHM 蓝字发票号码 varchar 20
LZFPJE 蓝字发票金额 double 20 小数点后2位,以元为单位精确到分
LZFPSE 蓝字发票税额 double 20 小数点后2位,以元为单位精确到分
LZFPTDYSLXDM 蓝字发票特定要素类型代码 varchar 2 详见特定要素代码
CHYY 冲红原因 varchar 2 1:开票有误
2:销货退回
3:服务终止
4:销售转让
HZCXJE 红字冲销金额 double 20 小数点后2位,以元为单位精确到分
HZCXSE 红字冲销税额 double 20 小数点后2位,以元为单位精确到分
ITEMS 明细信息 List
HH 行号 number 10
LZFPHH 蓝字发票行号 number 10
XMMC 项目名称(折让项目名称) varchar 92
GGXH 规格型号 varchar 40
DW 单位 varchar 22 dw、sl、dj同时为空或同时不为空
DJ 单价(不含税) double 24
SL 数量 double 24 值为负数
JE 金额(不含税) double 20 值为负数
SE 税额 double 20 值为负数
SLV 税率 double 22
SPFWSSFLBM 商品服务税收分类编码 varchar 20

返回报文规范

<RESPONSE_QDHZSQ class="RESPONSE_QDHZSQ">
    <QQLSH>请求流水号</QQLSH>
    <HZQRXXDBH>红字确认信息单编号</HZQRXXDBH>
    <HZQRDUUID>红字确认单UUID</HZQRDUUID>
    <HZQRXXZT>红字确认信息状态</HZQRXXZT>
</RESPONSE_QDHZSQ>

字段说明

数据项 名称 类型 长度 说明
QQLSH 请求流水号 varchar 50
HZQRXXDBH 红字确认信息单编号 varchar 32
HZQRDUUID 红字确认单uuid varchar 32
HZQRXXZT 红字确认信息状态 varchar 2 01:无需确认;
02:销方录入待购方确认;
03:购方录入待销方确认;
04:购销双方已确认;
05:作废(销方录入购方否认);
06:作废(购方录入销方否认);
07:作废(超72小时未确认);
08:发起方撤销

示例报文

请求报文示例

<?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.HZQRDSQ</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_SHHZSQ class="REQUEST_QDHZSQ">
                <QQLSH>LmPfg55Aara953K6Lvne</QQLSH>
                <NSRSBH>913101010000000090</NSRSBH>
                <LRFSF>01</LRFSF>
                <XSFNSRSBH>913101010000000090</XSFNSRSBH>
                <XSFMC>上海航信测试90</XSFMC>
                <GMFNSRSBH>123456789012345000</GMFNSRSBH>
                <GMFMC>上海申北测试</GMFMC>
                <LZFPPZ>02</LZFPPZ>
                <LZSFZZFP>N</LZSFZZFP>
                <LZKPRQ>2023-02-15 13:55:16</LZKPRQ>
                <LZFPDM></LZFPDM>
                <LZFPHM>23446000000000000002</LZFPHM>
                <LZFPJE>22.64</LZFPJE>
                <LZFPSE>1.36</LZFPSE>
                <LZFPTDYSLXDM></LZFPTDYSLXDM>
                <CHYY>02</CHYY>
                <HZCXJE>22.64</HZCXJE>
                <HZCXSE>1.36</HZCXSE>
                <QDHZSQ_XMXXS class="QDHZSQ_XMXX" size="1">
                    <QDHZSQ_XMXX>
                        <HH>1</HH>
                        <LZFPHH>1</LZFPHH>
                        <XMMC>*医疗服务*体检费</XMMC>
                        <GGXH></GGXH>
                        <DW>次</DW>
                        <SL>1</SL>
                        <DJ>8.49</DJ>
                        <JE>6.6</JE>
                        <SE>0.4</SE>
                        <SLV>0.06</SLV>
                        <SPFWSSFLBM>3070202000000000000</SPFWSSFLBM>
                    </QDHZSQ_XMXX>
                </QDHZSQ_XMXXS>
            </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>ZZS_PT_DZFP</appId>
        <version>2.0</version>
        <interfaceCode>ECXML.QDFP.HZQRDSQ</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_QDHZSQ class="RESPONSE_QDHZSQ">
                <QQLSH>LmPfg55Aara953K6Lvne</QQLSH>
                <HZQRXXDBH>44201422081000000301</HZQRXXDBH>
                <HZQRDUUID>87c9cba6ccdd4b99a3f908c3dd991c54</HZQRDUUID>
                <HZQRXXZT>01</HZQRXXZT>
            </RESPONSE_QDHZSQ>
        </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.HZQRDSQ</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>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-03-31 16:08:29

results matching ""

    No results matching ""