发票信息(不包含明细)下载API
API说明：发票信息获取
调用方式：HTTP协议
API编码：ECXML.FPXZ.CX.E_INV
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_FPXXXZ_NEW class="REQUEST_FPXXXZ_NEW">
<FPQQLSH>发票请求唯一流水号</FPQQLSH>
<DSPTBM>平台编码</DSPTBM>
<NSRSBH>开票方识别号</NSRSBH>
<DDH>订单号</DDH>
<PDF_XZFS>PDF下载方式</PDF_XZFS>
</REQUEST_FPXXXZ_NEW>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| DDH | 订单号 | varchar | 50 | 是 | |
| FPQQLSH | 发票请求唯一流水号 | varchar | 50 | 是 | |
| DSPTBM | 平台编码 | varchar | 8 | 是 | |
| NSRSBH | 开票方识别号 | varchar | 20 | 是 | |
| PDF_XZFS | PDF下载方式 | number | 1 | 是 | 0：发票开具状态查询 1：PDF文件(PDF_FILE) 2：PDF文件链接地址 3：PDF文件和链接地址都返回 |
返回报文规范
<REQUEST_FPKJXX_FPJGXX_NEW class="REQUEST_FPKJXX_FPJGXX_NEW">
<FPQQLSH>发票请求唯一流水号</FPQQLSH>
<DDH>订单号</DDH>
<KPLSH>开票流水号</KPLSH>
<FWM>校验码</FWM>
<EWM>二维码</EWM>
<FPZL_DM>发票种类代码</FPZL_DM>
<FP_DM>发票代码</FP_DM>
<FP_HM>发票号码</FP_HM>
<KPRQ>开票日期</KPRQ>
<KPLX>开票类型</KPLX>
<HJBHSJE>不含税金额</HJBHSJE>
<KPHJSE>税额</KPHJSE>
<PDF_FILE>Base64（文件）</PDF_FILE>
<PDF_URL>文件下载链接</PDF_URL>
<CZDM>操作代码</CZDM>
<RETURNCODE>结果代码</RETURNCODE>
<RETURNMESSAGE>结果描述</RETURNMESSAGE>
<FPMXXZ_JDCXX class="FPMXXZ_JDCXX">
<VEHICLETYPE>车辆类型</VEHICLETYPE>
<BRANDMODEL>厂牌型号</BRANDMODEL>
<PRODUCTORIGIN>原产地</PRODUCTORIGIN>
<CERTIFICATE>合格证号</CERTIFICATE>
<IMPORTCERNUM>进出口证明书号</IMPORTCERNUM>
<INSODDNUM>商检单号</INSODDNUM>
<ENGINENUM>发动机号码</ENGINENUM>
<VEHICLECODE>车辆识别号码/机动车号码</VEHICLECODE>
<INTACTCERNUM>完税证明号码</INTACTCERNUM>
<TONNAGE>吨位</TONNAGE>
<MAXCAPACITY>限乘人数</MAXCAPACITY>
<IDNUMORGCODE>身份证号码或组织机构代码</IDNUMORGCODE>
<MANUFACTURERNAME>生产厂家</MANUFACTURERNAME>
<TAXOFFICENAME>主管税务机关名称</TAXOFFICENAME>
<TAXOFFICECODE>主管税务机关代码</TAXOFFICECODE>
</FPMXXZ_JDCXX>
</REQUEST_FPKJXX_FPJGXX_NEW>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| FPQQLSH | 发票请求唯一流水号 | varchar | 50 | 是 | |
| DDH | 订单号 | varchar | 50 | 是 | |
| KPLSH | 开票流水号 | varchar | 20 | 是 | |
| FWM | 校验码 | varchar | 20 | 是 | |
| EWM | 二维码 | number | 1000 | 否 | |
| 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 | 是 | |
| PDF_FILE | Base64（文件） | varchar | 不定长 | 否 | 文件下载方式（PDF_XZFS字段）为1或3时必填 |
| PDF_URL | 文件下载路径 | varchar | 不定长 | 否 | 文件下载方式（PDF_XZFS字段）为2或3时必填 |
| CZDM | 操作代码 | varchar | 2 | 是 | 10：蓝票 20：红票 |
| RETURNCODE | 结果代码 | varchar | 4 | 是 | |
| RETURNMESSAGE | 结果描述 | varchar | 128 | 否 | 错误原因 |
| JDCXX | 机动车信息 | FPMXXZ_JDCXX节点，机动车发票有 | |||
| VEHICLETYPE | 车辆类型 | varchar | 40 | 是 | 车辆类型，同明细中商品名称，开具机动车发票时明细有且仅有一行，商品名称为车辆类型且不能为空 |
| BRANDMODEL | 厂牌型号 | varchar | 40 | 是 | |
| PRODUCTORIGIN | 原产地 | varchar | 32 | 是 | |
| CERTIFICATE | 合格证号 | varchar | 50 | 否 | |
| IMPORTCERNUM | 进出口证明书号 | varchar | 36 | 否 | |
| INSODDNUM | 商检单号 | varchar | 32 | 否 | |
| ENGINENUM | 发动机号码 | varchar | 50 | 否 | |
| VEHICLECODE | 车辆识别号码/机动车号码 | varchar | 23 | 是 | |
| INTACTCERNUM | 完税证明号码 | varchar | 32 | 否 | |
| TONNAGE | 吨位 | varchar | 8 | 否 | |
| MAXCAPACITY | 限乘人数 | varchar | 12 | 否 | |
| IDNUMORGCODE | 身份证号码或组织机构代码 | varchar | 20 | 否 | 该字段为空则为2021新版机动车发票，此时购方税号必填（个人填身份证）； 该字段有值，则为老版本机动车发票 |
| MANUFACTURERNAME | 生产厂家 | varchar | 80 | 否 | |
| TAXOFFICENAME | 主管税务机关名称 | varchar | 80 | 否 | |
| TAXOFFICECODE | 主管税务机关代码 | varchar | 11 | 否 |
示例报文
请求报文示例
<?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.FPXZ.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_FPXXXZ_NEW class='REQUEST_FPXXXZ_NEW'>
<FPQQLSH>P1000001test_000000001</FPQQLSH>
<DSPTBM>P1000001</DSPTBM>
<NSRSBH>913101010000000090</NSRSBH>
<DDH>2492684718573093</DDH>
<PDF_XZFS>3</PDF_XZFS>
</REQUEST_FPXXXZ_NEW>
</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.FPXZ.BC.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>
<REQUEST_FPKJXX_FPJGXX_NEW class="REQUEST_FPKJXX_FPJGXX_NEW">
<FPQQLSH>P1000001test_000000001</FPQQLSH>
<DDH>2492684718573093</DDH>
<KPLSH>03100160021121221340</KPLSH>
<FWM>56437176152527282054</FWM>
<EWM />
<FPZL_DM>51</FPZL_DM>
<FP_DM>031001600211</FP_DM>
<FP_HM>21221340</FP_HM>
<KPRQ>20190412135003</KPRQ>
<KPLX>1</KPLX>
<HJBHSJE>18.87</HJBHSJE>
<KPHJSE>1.13</KPHJSE>
<PDF_FILE>Base64(文件)</PDF_FILE> <PDF_URL>https://testhttps.51fapiao.cn:8181/FPFX/actions/bde0ebd1af0e81fa77613e24e0b3fdc59411a5</PDF_URL>
<CZDM>10</CZDM>
<RETURNCODE>0000</RETURNCODE>
<RETURNMESSAGE />
</REQUEST_FPKJXX_FPJGXX_NEW>
</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.FPXZ.BC.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>