乐企数电红字确认单申请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>