发票信息推送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<*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>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>