发票信息推送API

API说明:生成完成的发票信息传递给企业
调用方式:HTTP协议
API编码:ECXML.FPKJJG.TS.E_INV
调用方法:POST(XML文件流)

报文规范

<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文件)</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>
    <FPMXXZ_XMXXS class="FPMXXZ_XMXX;" size="1">
        <FPMXXZ_XMXX>
            <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_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
XMXX 项目信息 List 发票明细列表
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="DZFP1.0">
    <globalInfo>
        <appId>A16D8DBD18EDDD80</appId>
        <interfaceCode>ECXML.FPKJJG.TS.E_INV</interfaceCode>
        <terminalCode>0</terminalCode>
        <version>2.0</version>
        <userName>P1000001</userName>
        <passWord>12345678909oyKs7cVo1yYzkuisP9bhA==</passWord>
        <taxpayerId>913101010000000090</taxpayerId>
        <authorizationCode>NH873FG4KW</authorizationCode>
        <requestCode>P1000001</requestCode>
        <requestTime>2019-04-18 15:48:979 979</requestTime>
        <responseCode>121</responseCode>
        <dataExchangeId>P100000120190418154809800</dataExchangeId>
    </globalInfo>
    <returnStateInfo>
        <returnCode />
        <returnMessage />
    </returnStateInfo>
    <Data>
        <dataDescription>
            <zipCode>1</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>20190412135003</KPRQ>
                <KPLX>1</KPLX>
                <HJBHSJE>18.87</HJBHSJE>
                <KPHJSE>1.13</KPHJSE>
                <KPHJJE>20.0</KPHJJE>
                <PDF_FILE>Base64(pdf文件)</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.00000000</XMSL>
                        <XMDJ>18.87000000</XMDJ>
                        <XMJE>18.87</XMJE>
                        <SL>0.06</SL>
                        <SE>1.13</SE>
                        <SWBM>1010101030000000000</SWBM>
                        <YHZCBS>0</YHZCBS>
                        <LSLBS></LSLBS>
                        <ZZSTSGL></ZZSTSGL>
                        <FPHXZ>0</FPHXZ>
                        <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>建设银行12345678</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>A16D8DBD18EDDD80</appId>
        <version>1.0</version>
        <interfaceCode>ECXML.FPKJJG.TS.E_INV</interfaceCode>
        <requestCode>P1000001</requestCode>
        <requestTime>2019-04-18 09:40:30</requestTime>
        <responseCode>121</responseCode>
        <dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20170407eXl4EymmJ</dataExchangeId>
        <userName>P1000001</userName>
        <passWord>12345678909oyKs7cVo1yYzkuisP9bhA==</passWord>
        <taxpayerId>913101010000000090</taxpayerId>
        <authorizationCode>NH873FG4KW</authorizationCode>
    </globalInfo>
    <returnStateInfo>
        <returnCode>0000</returnCode>
        <returnMessage>5o6l5pS25byA56Wo5pWw5o2u5oiQ5Yqf77yB</returnMessage>
    </returnStateInfo>
    <Data>
        <dataDescription>
            <zipCode>0</zipCode>
            <encryptCode>0</encryptCode>
            <codeType>0</codeType>
        </dataDescription>
        <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>A16D8DBD18EDDD80</appId>
        <version>1.0</version>
        <interfaceCode>ECXML.FPKJJG.TS.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>12345678909oyKs7cVo1yYzkuisP9bhA==</passWord>
        <taxpayerId>913101010000000090</taxpayerId>
        <authorizationCode>NH873FG4KW</authorizationCode>
    </globalInfo>
    <returnStateInfo>
        <returnCode>9999(或者是其它错误码)</returnCode>
        <returnMessage>Base64(错误信息)</returnMessage>
    </returnStateInfo>
    <Data>
        <dataDescription>
            <zipCode>0</zipCode>
            <encryptCode>0</encryptCode>
            <codeType>0</codeType>
        </dataDescription>
        <content/>
    </Data>
</interface>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-04-07 16:36:01

results matching ""

    No results matching ""