发票明细下载(新)API

API说明:发票信息获取(包含明细,文件类型)
调用方式:HTTP协议
API编码:ECXML.WJXZ.CX.E_INV
调用方法:POST(XML文件流)

报文规范

<REQUEST_WJXZ class="REQUEST_WJXZ">
    <FPQQLSH>发票请求唯一流水号</FPQQLSH>
    <DSPTBM>平台编码</DSPTBM>
    <NSRSBH>开票方识别号</NSRSBH>
    <XZFS>下载方式</XZFS>
    <WJLX>文件类型</WJLX>
</REQUEST_WJXZ>

字段说明

数据项 名称 类型 长度 必须 说明
FPQQLSH 发票请求唯一流水号 varchar 50
DSPTBM 平台编码 varchar 8
NSRSBH 开票方识别号 varchar 20
XZFS 下载方式 varchar 1 0:发票开具状态查询
1:文件和链接地址都返回
WJLX 文件类型 varchar 5 PDF/OFD/XML,传XML返回的是压缩过的.zip文件,解压后是.xml格式文件,不传默认为PDF

返回报文规范

<RESPONSE_WJXZ class="RESPONSE_WJXZ ">
    <FPQQLSH>发票请求唯一流水号</FPQQLSH>
    <DDH>订单号</DDH>
    <KPLSH>开票流水号</KPLSH>
    <FPZL_DM>发票种类代码</FPZL_DM>
    <FP_DM>发票代码</FP_DM>
    <FP_HM>发票号码</FP_HM>
    <KPRQ>开票日期</KPRQ>
    <KPLX>开票类型</KPLX>
    <HJBHSJE>不含税金额</HJBHSJE>
    <KPHJSE>税额</KPHJSE>
    <FILE>Base64(文件)</FILE>
    <URL>文件下载链接</URL>
    <WJLX>文件类型</WJLX>
    <KCE>扣除额</KCE>
    <GHFMC>购货方名称</GHFMC>
    <GHF_NSRSBH>购货方识别号</GHF_NSRSBH>
    <GHF_DZDH>购货方地址、电话</GHF_DZDH>
    <GHF_YHZH>购货方银行、账号</GHF_YHZH>
    <GHF_SJ>购货方手机号</GHF_SJ>
    <GHF_EMAIL>购货方邮箱</GHF_EMAIL>
    <KPHJJE>开票合计金额(价税合计)</KPHJJE>
    <XHF_NSRSBH>销方税号</XHF_NSRSBH>
    <XHFMC>销方名称</XHFMC>
    <XHF_DZDH>销方地址、电话</XHF_DZDH>
    <XHF_YHZH>销方银行、账号</XHF_YHZH>
    <KPY>开票员</KPY>
    <SKY>收款员</SKY>
    <FHR>复核人</FHR>
    <BZ>备注</BZ>
    <YFP_DM>原发票代码</YFP_DM>
    <YFP_HM>原发票号码</YFP_HM>
    <FPMW>密文</FPMW>
    <JYM>校验码</JYM>
    <JQBH>机器编号</JQBH>
    <BMB_BBH>编码表版本号</BMB_BBH>
    <ZZFP_HM>全电纸票发票号码</ZZFP_HM>
    <HZTZDH>红字通知单号</HZTZDH>
    <HZQRDUUID>红字确认单uuid</HZQRDUUID>
    <GHFQYLX>购货方企业类型</GHFQYLX>
    <FPMXXZ_XMXXS class="FPMXXZ_XMXX;" size="1">
        <FPMXXZ_XMXX>
            <HH>行号</HH>
            <XMMC>项目名称</XMMC>
            <XMDW>项目单位</XMDW>
            <GGXH>规格型号</GGXH>
            <XMSL>项目数量</XMSL>
            <XMDJ>项目单价</XMDJ>
            <XMJE>项目金额</XMJE>
            <SL>税率</SL>
            <SE>税额</SE>
            <SWBM>税务编码</SWBM>
            <FPHXZ>发票行性质</FPHXZ>
            <LSLBS>零税率标识</LSLBS>
            <YHZCBS>优惠政策标识</YHZCBS>
            <ZZSTSGL>增值税特殊管理</ZZSTSGL>
            <ZXBM>自行编码</ZXBM>
        </FPMXXZ_XMXX>
    </FPMXXZ_XMXXS>
    <RETURNCODE>结果代码</RETURNCODE>
    <RETURNMESSAGE>结果描述</RETURNMESSAGE>
</RESPONSE_WJXZ>

字段说明

数据项 名称 类型 长度 必须 说明
FPQQLSH 发票请求唯一流水号 varchar 50
DDH 订单号 varchar 50
KPLSH 开票流水号 varchar 20
FPZL_DM 发票种类代码 varchar 5 0:专票
2:普票
4:电子专票
5:机动车发票
41:卷票
51:电子发票
61:数电专票
62:数电普票
85:数电纸票专票
86:数电纸票普票
FP_DM 发票代码 varchar 12
FP_HM 发票号码 varchar 8
KPRQ 开票日期 datetime 格式YYYYMMDDHHMISS(RETURNCODE不为0000为空)
KPLX 开票类型 number 1 1:正票
2:红票
HJBHSJE 不含税金额 double 20
KPHJSE 税额 double 20
FILE Base64(文件) varchar 不定长 文件下载方式(XZFS字段)为1时必填
URL 文件下载路径 varchar 不定长 文件下载方式(XZFS字段)为1时必填
RETURNCODE 结果代码 varchar 4
RETURNMESSAGE 结果描述 varchar 128 错误原因
KCE 扣除额 double 扣除额
GHFMC 购货方名称 varchar 100 购货方名称,即发票抬头。
GHF_NSRSBH 购货方识别号 varchar 20 企业消费,如果填写识别号,需要传输过来
GHF_DZDH 购货方地址、电话 varchar 100
GHF_YHZH 购货方银行、账号 varchar 100
GHF_SJ 购货方手机 varchar 20
GHF_EMAIL 购货方邮箱 varchar 50
KPHJJE 开票合计金额(价税合计 double 20
XHF_NSRSBH 销方税号 varchar 20
XHFMC 销方名称 varchar 100
XHF_DZDH 销方地址、电话 varchar 100
XHF_YHZH 销方银行、账号 varchar 100
KPY 开票员 varchar 8
SKY 收款员 varchar 8
FHR 复核人 varchar 8
BZ 备注 varchar 200
YFP_DM 原发票代码 varchar 12
YFP_HM 原发票号码 varchar 8
FPMW 密文 varchar 112
JYM 校验码 varchar 20
JQBH 机器编号 varchar 12
BMB_BBH 编码表版本号 varchar 20
WJLX 文件类型 varchar 5 PDF:返回的文件为PDF文件,
OFD:返回的文件为OFD文件
ZZFP_HM 全电纸票发票号码 varchar 20 开具全电纸票时返回
HZTZDH 红字通知单号 varchar 32 开具全电红票时返回
HZQRDUUID 红字确认单uuid varchar 32 开具全电红票时返回
GHFQYLX 购货方企业类型 varchar 2 01:企业
02:机关事业单位
03:个人
04:其它
XMXX 项目信息 List 发票明细列表
HH 行号 varchar 10 数电发票返回
XMMC 项目名称 varchar 90
XMDW 项目单位 varchar 20
GGXH 规格型号 varchar 40
XMSL 项目数量 double 24
XMDJ 项目单价 double 24 单价(不含税)
XMJE 项目金额 double 16 金额(不含税)
SL 税率 varchar 10
SE 税额 double 20
SWBM 税务编码 varchar 19 税务编码
FPHXZ 发票行性质 varchar 1 0:正常行
1:折扣行
2:被折扣行
YHZCBS 优惠政策标识 varchar 1 0:不使用
1:使用
LSLBS 零税率标识 varchar 1 空:非零税率
1:免税
2:不征税
3:普通零税率
ZZSTSGL 增值税特殊管理 varchar 50 当YHZCBS为1时必填(如:免税、不征税)
ZXBM 自行编码 varchar 20

示例报文

请求报文示例

<?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>1.42</version>
        <interfaceCode>ECXML.WJXZ.CX.E_INV</interfaceCode>
        <requestCode>P1000001</requestCode>
        <requestTime>2016-11-28 10:19:16</requestTime>
        <responseCode>121</responseCode>
        <dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20161128eXl4EymmJ</dataExchangeId>
        <userName>P1000001</userName>
        <passWord></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_WJXZ class='REQUEST_WJXZ'>
                <FPQQLSH>P1000001test_000000001</FPQQLSH>
                <DSPTBM>P1000001</DSPTBM>
                <NSRSBH>913101010000000090</NSRSBH>
                <XZFS>1</XZFS>
                <WJLX>PDF</WJLX>
            </REQUEST_WJXZ>
        </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.WJXZ.CX.E_INV</interfaceCode>
        <requestCode>P1000001</requestCode>
        <requestTime>17-04-07 16:40:30</requestTime>
        <responseCode>121</responseCode>
        <dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20170407eXl4EymmJ</dataExchangeId>
        <userName>P1000001</userName>
        <passWord></passWord>
        <taxpayerId>913101010000000090</taxpayerId>
        <authorizationCode>NH873FG4KW</authorizationCode>
    </globalInfo>
    <returnStateInfo>
        <returnCode>0000</returnCode>
        <returnMessage>5o6l5pS25byA56Wo5pWw5o2u5oiQ5Yqf77yB</returnMessage>
    </returnStateInfo>
    <Data>
        <dataDescription>
            <zipCode>0</zipCode>
            <encryptCode>1</encryptCode>
            <codeType>3DES</codeType>
        </dataDescription>
        <content>
            <RESPONSE_FPMXXZ class="RESPONSE_FPMXXZ">
                <FPQQLSH>P1000001test_000000001</FPQQLSH>
                <DDH>2492684718573093</DDH>
                <KPLSH>03100160021121221340</KPLSH>
                <FPZL_DM>51</FPZL_DM>
                <FP_DM>031001600211</FP_DM>
                <FP_HM>21221340</FP_HM>
                <KPRQ>2019-04-12 13:50:03</KPRQ>
                <KPLX>1</KPLX>
                <HJBHSJE>18.87</HJBHSJE>
                <KPHJSE>1.13</KPHJSE>
                <KPHJJE>20.0</KPHJJE>
                <FILE>Base64(文件)</FILE>
                <URL>https://testhttps.51fapiao.cn:8181/FPFX/actions/bde0ebd1af0e81fa77613e24e0b3fdc59411a5</URL>
                <WJLX>PDF</WJLX>
                <KCE>0.0</KCE>
                <BYZD1></BYZD1>
                <BYZD2></BYZD2>
                <BYZD3></BYZD3>
                <BYZD4></BYZD4>
                <BYZD5></BYZD5>
                <FPMXXZ_XMXXS class="FPMXXZ_XMXX;" size="1">
                    <FPMXXZ_XMXX>
                        <XMMC>*谷物*米</XMMC>
                        <XMDW></XMDW>
                        <GGXH></GGXH>
                        <XMSL>1.0</XMSL>
                        <XMDJ>18.87</XMDJ>
                        <XMJE>18.87</XMJE>
                        <SL>0.06</SL>
                        <SE>1.13</SE>
                        <SWBM>1010101030000000000</SWBM>
                        <FPHXZ>0</FPHXZ>
                        <LSLBS></LSLBS>
                        <YHZCBS>0</YHZCBS>
                        <ZZSTSGL></ZZSTSGL>
                        <ZXBM></ZXBM>
                    </FPMXXZ_XMXX>
                </FPMXXZ_XMXXS>
                <RETURNCODE>0000</RETURNCODE>
                <RETURNMESSAGE />
                <GHFMC>个人</GHFMC>
                <GHF_NSRSBH></GHF_NSRSBH>
                <GHF_DZDH></GHF_DZDH>
                <GHF_YHZH></GHF_YHZH>
                <GHF_SJ></GHF_SJ>
                <GHF_EMAIL></GHF_EMAIL>
                <XHF_NSRSBH>913101010000000090</XHF_NSRSBH>
                <XHFMC>上海航信测试90</XHFMC>
                <XHF_DZDH>xxxxxx 213132</XHF_DZDH>
                <XHF_YHZH />
                <KPY>财务一</KPY>
                <SKY></SKY>
                <FHR></FHR>
                <BZ></BZ>
                <YFP_DM></YFP_DM>
                <YFP_HM></YFP_HM>
                <FPMW>9365557/+0*+-27/8&lt;*80&gt;&gt;93&lt;7**&gt;32-094/*265/&gt;*4&lt;19509/560890*6/&lt;113&lt;+0*&lt;&gt;27/8&lt;*80&gt;&gt;97&lt;7&lt;3032-094/*265/&gt;*4&lt;70+4</FPMW>
                <JYM>56437176152527282054</JYM>
                <JQBH>661568674680</JQBH>
                <BMB_BBH>12.0</BMB_BBH>
            </RESPONSE_FPMXXZ>
        </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.WJXZ.CX.E_INV</interfaceCode>
        <requestCode>P1000001</requestCode>
        <requestTime>17-04-07 16:40:30</requestTime>
        <responseCode>121</responseCode>
        <dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20170407eXl4EymmJ</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 ""