发票明细下载API

API说明：发票信息获取(包含明细)
调用方式：HTTP协议
API编码：ECXML.FPMXXZ.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文件和链接地址都返回

返回报文规范

<RESPONSE_FPMXXZ class="RESPONSE_FPMXXZ ">
    <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>
    <PDF_FILE>Base64（文件）</PDF_FILE>
    <PDF_URL>文件下载链接</PDF_URL>
    <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>
    <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>
    <RETURNCODE>结果代码</RETURNCODE>
    <RETURNMESSAGE>结果描述</RETURNMESSAGE>
</RESPONSE_FPMXXZ>

字段说明

数据项 名称 类型 长度 必须 说明
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 是
PDF_FILE Base64（文件） varchar 不定长 否 文件下载方式（PDF_XZFS字段）为1或3时必填
PDF_URL 文件下载路径 varchar 不定长 否 文件下载方式（PDF_XZFS字段）为2或3时必填
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 是
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 否
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.FPMXXZ.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.FPMXXZ.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>
            <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>
                <PDF_FILE>Base64(文件)</PDF_FILE>
                <PDF_URL>https://testhttps.51fapiao.cn:8181/FPFX/actions/bde0ebd1af0e81fa77613e24e0b3fdc59411a5</PDF_URL>
                <KCE>0.0</KCE>
                <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.FPMXXZ.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>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间： 2025-03-31 16:08:29

results matching ""

    No results matching ""