发票明细下载(新)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<*80>>93<7**>32-094/*265/>*4<19509/560890*6/<113<+0*<>27/8<*80>>97<7<3032-094/*265/>*4<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>