发票开具API
API说明：企业向开票服务推送开具电子发票的数据信息
调用方式：HTTP协议
API编码：ECXML.FPKJ.BC.E_INV
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_FPKJXX class="REQUEST_FPKJXX">
<FPKJXX_FPTXX class="FPKJXX_FPTXX">
<FPQQLSH>发票请求唯一流水号</FPQQLSH>
<DSPTBM>平台编码</DSPTBM>
<NSRSBH>开票方识别号</NSRSBH>
<NSRMC>开票方名称</NSRMC>
<FJH>分机号</FJH>
<NSRDZDAH>开票方电子档案号</NSRDZDAH>
<SWJG_DM>税务机构代码</SWJG_DM>
<DKBZ>代开标志</DKBZ>
<SGBZ>收购标志</SGBZ>
<PYDM>票样代码</PYDM>
<KPXM>主要开票项目</KPXM>
<BMB_BBH>编码表版本号</BMB_BBH>
<XHF_NSRSBH>销货方识别号</XHF_NSRSBH>
<XHFMC>销货方名称</XHFMC>
<XHF_DZ>销货方地址</XHF_DZ>
<XHF_DH>销货方电话</XHF_DH>
<XHF_YHZH>销货方银行账号</XHF_YHZH>
<GHFMC>购货方名称</GHFMC>
<GHF_NSRSBH>购货方识别号</GHF_NSRSBH>
<GHF_SF>购货方省份</GHF_SF>
<GHF_DZ>购货方地址</GHF_DZ>
<GHF_GDDH>购货方固定电话</GHF_GDDH>
<GHF_SJ>购货方手机</GHF_SJ>
<GHF_EMAIL>购货方邮箱</GHF_EMAIL>
<GHFQYLX>购货方企业类型</GHFQYLX>
<GHF_YHZH>购货方银行、账号</GHF_YHZH>
<HY_DM>行业代码</HY_DM>
<HY_MC>行业名称</HY_MC>
<KPY>开票员</KPY>
<SKY>收款员</SKY>
<FHR>复核人</FHR>
<KPRQ>开票日期</KPRQ>
<KPLX>开票类型</KPLX>
<YFP_DM>原发票代码</YFP_DM>
<YFP_HM>原发票号码</YFP_HM>
<CZDM>操作代码</CZDM>
<QD_BZ>清单标志</QD_BZ>
<QDXMMC>清单发票项目名称</QDXMMC>
<YFPZL_DM>原发票种类代码</YFPZL_DM>
<YKPRQ>原开票日期</YKPRQ>
<CHYY>冲红原因</CHYY>
<TSCHBZ>特殊冲红标志</TSCHBZ>
<KPHJJE>价税合计金额</KPHJJE>
<HJBHSJE>合计不含税金额</HJBHSJE>
<HJSE>合计税额</HJSE>
<BZ>备注</BZ>
<FPLX>发票类型</FPLX>
<HZTZD>红票通知单编号</HZTZD>
<SGFPBQ>收购发票标签</SGFPBQ>
<TDYS>特定要素</TDYS>
<CKYWSYZCD>出口业务适用政策代码</CKYWSYZCD>
<ZZSJZJTDM>增值税即征即退代码</ZZSJZJTDM>
<HZQRDUUID>红字确认单uuid</HZQRDUUID>
<ZPFP_DM>数电纸票发票种类代码</ZPFP_DM>
<CEZSBQ>差额征税标签</CEZSBQ>
<KPDBM>开票点编码</KPDBM>
<DFGTGMBZ>多方共同购买标志</DFGTGMBZ>
</FPKJXX_FPTXX>
<FPKJXX_XMXXS class="FPKJXX_XMXX;" size="1">
<FPKJXX_XMXX>
<XMMC>项目名称</XMMC>
<XMDW>项目单位</XMDW>
<GGXH>规格型号</GGXH>
<XMSL>项目数量</XMSL>
<HSBZ>含税标志</HSBZ>
<XMDJ>项目单价</XMDJ>
<FPHXZ>发票行性质</FPHXZ>
<SPBM>商品编码</SPBM>
<ZXBM>自行编码</ZXBM>
<YHZCBS>优惠政策标识</YHZCBS>
<LSLBS>零税率标识</LSLBS>
<ZZSTSGL>增值税特殊管理</ZZSTSGL>
<KCE>扣除额</KCE>
<XMJE>项目金额</XMJE>
<SL>税率</SL>
<SE>税额</SE>
<HH>行号</HH>
<LZFPHH>蓝字发票行号</LZFPHH>
</FPKJXX_XMXX>
</FPKJXX_XMXXS>
<FPKJXX_DDXX class="FPKJXX_DDXX">
<DDH>订单号</DDH>
<THDH>退货单号</THDH>
<DDDATE>订单时间</DDDATE>
</FPKJXX_DDXX>
<FPKJXX_ZFXXS class="FPKJXX_ZFXX;" size="1">
<FPKJXX_ZFXX>
<ZFQDDM>支付渠道</ZFQDDM>
<JYDH>交易单号</JYDH>
</FPKJXX_ZFXX>
</FPKJXX_ZFXXS>
<FPKJXX_JDCXX class="FPKJXX_JDCXX">
<VEHICLETYPE>车辆类型</VEHICLETYPE>
<BRANDMODEL>厂牌型号</BRANDMODEL>
<PRODUCTORIGIN>原产地</PRODUCTORIGIN>
<CERTIFICATE>合格证号</CERTIFICATE>
<IMPORTCERNUM>进出口证明书号</IMPORTCERNUM>
<INSODDNUM>商检单号</INSODDNUM>
<ENGINENUM>发动机号码</ENGINENUM>
<VEHICLECODE>车辆识别代号</VEHICLECODE>
<UUID>机动车台账车辆识别代号uuid</UUID>
<INTACTCERNUM>完税证明号码</INTACTCERNUM>
<TONNAGE>吨位</TONNAGE>
<MAXCAPACITY>限乘人数</MAXCAPACITY>
<MANUFACTURERNAME>生产企业名称</MANUFACTURERNAME>
<TAXOFFICENAME>主管税务机关名称</TAXOFFICENAME>
<TAXOFFICECODE>主管税务机关代码</TAXOFFICECODE>
</FPKJXX_JDCXX>
<FPKJXX_BDCZL class="FPKJXX_BDCZL">
<BDCZLDZ>不动产地址</BDCZLDZ>
<ZLQQ>租赁期起</ZLQQ>
<ZLQZ>租赁期止</ZLQZ>
<KDSBZ>跨地（市）标志</KDSBZ>
<CQZSBH>产权证书/不动产权证号</CQZSBH>
<DW>面积单位</DW>
<BDCZLDZS>不动产坐落地址（省）</BDCZLDZS>
<BDCZLDZS1>不动产坐落地址（市）</BDCZLDZS1>
<CPH>车牌号</CPH>
</FPKJXX_BDCZL>
<FPKJXX_BDCZL_NEWS class="FPKJXX_BDCZL_NEW;" size="1">
<FPKJXX_BDCZL_NEW>
<BDCZLDZ>不动产地址</BDCZLDZ>
<ZLQQ>租赁期起</ZLQQ>
<ZLQZ>租赁期止</ZLQZ>
<KDSBZ>跨地（市）标志</KDSBZ>
<CQZSBH>产权证书/不动产权证号</CQZSBH>
<DW>面积单位</DW>
<BDCZLDZS>不动产坐落地址（省）</BDCZLDZS>
<BDCZLDZS1>不动产坐落地址（市）</BDCZLDZS1>
<CPH>车牌号</CPH>
</FPKJXX_BDCZL_NEW>
</FPKJXX_BDCZL_NEWS>
<FPKJXX_BDCXS class="FPKJXX_BDCXS">
<WQHTBABH>不动产单元代码/网签合同备案编号（乐企该字段表示网签合同备案编号）</WQHTBABH>
<BDCDZ>不动产地址</BDCDZ>
<KDSBZ>跨地(市)标志</KDSBZ>
<TDZZSXMBH>土地增值税项目编号</TDZZSXMBH>
<HDJSJG>核定计税价格</HDJSJG>
<SJCJHSJE>实际成交含税金额</SJCJHSJE>
<CQZSH>房屋产权证书号/不动产权证号</CQZSH>
<DW>面积单位</DW>
<BDCDWDM>不动产单位代码（乐企）</BDCDWDM>
<DFGTGMBZ>多方共同购买标志（乐企）</DFGTGMBZ>
<GTGMF>共同购买方（乐企）</GTGMF>
<ZJLX>证件类型（乐企）</ZJLX>
<ZJHM>证件号码（乐企）</ZJHM>
</FPKJXX_BDCXS>
<FPKJXX_BDCXS_NEWS class="FPKJXX_BDCXS_NEW;" size="1">
<FPKJXX_BDCXS_NEW>
<WQHTBABH>不动产单元代码/网签合同备案编号（乐企该字段表示网签合同备案编号）</WQHTBABH>
<BDCDZ>不动产地址</BDCDZ>
<KDSBZ>跨地(市)标志</KDSBZ>
<TDZZSXMBH>土地增值税项目编号</TDZZSXMBH>
<HDJSJG>核定计税价格</HDJSJG>
<SJCJHSJE>实际成交含税金额</SJCJHSJE>
<CQZSH>房屋产权证书号/不动产权证号</CQZSH>
<DW>面积单位</DW>
<BDCDWDM>不动产单位代码（乐企）</BDCDWDM>
<BDCZLDZS>不动产坐落地址（省）</BDCZLDZS>
<BDCZLDZS1>不动产坐落地址（市）</BDCZLDZS1>
</FPKJXX_BDCXS_NEW>
</FPKJXX_BDCXS_NEWS>
<FPKJXX_BDCXS_GTGMFXXS class="FPKJXX_BDCXS_GTGMFXX;" size="1">
<FPKJXX_BDCXS_GTGMFXX>
<GTGMF>共同购买方</GTGMF>
<ZJLX>证件类型</ZJLX>
<ZJHM>证件号码</ZJHM>
</FPKJXX_BDCXS_GTGMFXX>
</FPKJXX_BDCXS_GTGMFXXS>
<REQUEST_HWYSS class="REQUEST_HWYS;" size="1">
<REQUEST_HWYS>
<XH>序号</XH>
<YSGJZL>运输工具种类</YSGJZL>
<YSGJHP>运输工具号牌</YSGJHP>
<QYD>起运地</QYD>
<DDD>到达地</DDD>
<YSHWMC>运输货物名称</YSHWMC>
</REQUEST_HWYS>
</REQUEST_HWYSS>
<REQUEST_LKYSS class="REQUEST_LKYS;" size="1">
<REQUEST_LKYS>
<XH>序号</XH>
<CXR>出行人</CXR>
<CXRQ>出行日期</CXRQ>
<CXRZJLX>出行人证件类型</CXRZJLX>
<SFZJHM>身份证件号码</SFZJHM>
<CFD>出发地</CFD>
<DDD>到达地</DDD>
<ZWDJ>座位等级</ZWDJ>
<JTGJLX>交通工具类型</JTGJLX>
</REQUEST_LKYS>
</REQUEST_LKYSS>
<FPKJXX_JZFP class="FPKJXX_JZFP">
<TDZZSXMBH>土地增值税项目编号</TDZZSXMBH>
<KDSBZ>跨地市标志</KDSBZ>
<JZFWFSD>建筑服务发生地</JZFWFSD>
<JZXMMC>建筑项目名称</JZXMMC>
<XZQHSZDM>行政区划设置代码</XZQHSZDM>
<XXDZ>详细地址</XXDZ>
<KQYSSSXBYGLBH>跨区域涉税事项报验管理编号</KQYSSSXBYGLBH>
</FPKJXX_JZFP>
<FPKJXX_CEPZMXS class="FPKJXX_CEPZMX;" size="1">
<FPKJXX_CEPZMX>
<PZLX>凭证类型</PZLX>
<FPDM>发票代码</FPDM>
<FPHM>发票号码</FPHM>
<PZHM>凭证号码</PZHM>
<KJRQ>差额凭证的开具日期</KJRQ>
<HJJE>发票的价税合计</HJJE>
<KCE>扣除额</KCE>
<BZ>差额录入页面手动录入的备注</BZ>
</FPKJXX_CEPZMX>
</FPKJXX_CEPZMXS>
</REQUEST_FPKJXX>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| FPQQLSH | 发票请求唯一流水号 | varchar | 50 | 是 | 每张发票的发票请求唯一流水号无重复，由企业定义。前8位是企业的DSPTBM值。长度限制20~50位,可由数字,字母和下划线组成,不能有特殊字符(如中文,单斜杠,双斜杠等) |
| DSPTBM | 平台编码 | varchar | 8 | 是 | 由诺e票电子发票平台提供，生产环境详见《交付表》 |
| NSRSBH | 开票方识别号 | varchar | 20 | 是 | 开票金税盘的销方纳税人识别号，由企业提供，测试环境由平台提供 |
| NSRMC | 开票方名称 | varchar | 200 | 是 | 开票金税盘的销方纳税人全称，由企业提供，测试环境由平台提供 |
| FJH | 分机号 | number | 3 | 否 | 默认：空； 可指定分机盘开票 |
| NSRDZDAH | 开票方电子档案号 | varchar | 20 | 否 | 可不填 |
| SWJG_DM | 税务机构代码 | varchar | 11 | 否 | 可不填 |
| DKBZ | 代开标志 | varchar | 1 | 是 | 0：自开 1：代开 默认为自开 |
| SGBZ | 收购标志 | varchar | 1 | 否 | 1、收购票（Y），代开标志为1时，不能填Y 2、非收购票：此字段为空 3、收购票扣除额必须为空 4、收购票税率必须为0 5、成品油发票必须为C（大写） 6、成品油票不支持代开 |
| PYDM | 票样代码 | varchar | 10 | 否 | 可不填 |
| KPXM | 主要开票项目 | varchar | 200 | 是 | 主要开票商品，或者第一条商品，取项目信息中第一条数据的项目名称（或传递大类例如：办公用品） |
| BMB_BBH | 编码表版本号 | varchar | 20 | 是 | 编码表版本号。该字段为税收分类编码版本号，最新版本号可关注上海爱信诺微信公众号的开票软件升级公告 |
| XHF_NSRSBH | 销方识别号 | varchar | 20 | 是 | 开票金税盘的销方纳税人识别号，由企业提供，测试环境由平台提供 |
| XHFMC | 销方名称 | varchar | 100 | 是 | 必填，纳税人名称 |
| XHF_DZ | 销方地址 | varchar | 80 | 是 | |
| XHF_DH | 销方电话 | varchar | 20 | 否 | |
| XHF_YHZH | 销方银行、账号 | varchar | 100 | 否 | 数电发票必须传，且销方银行名称和账号以空格分隔，其他位置不能有空格 |
| GHFMC | 购货方名称 | varchar | 100 | 是 | 购货方名称，即发票抬头。 |
| GHF_NSRSBH | 购货方税号 | varchar | 20 | 否 | 企业消费，如果填写识别号，需要传输过来 |
| GHF_DZ | 购货方地址 | varchar | 80 | 否 | |
| GHF_SF | 购货方省份 | varchar | 20 | 否 | |
| GHF_GDDH | 购货方固定电话 | varchar | 20 | 否 | |
| GHF_SJ | 购货方手机 | varchar | 20 | 否 | 只能传一个手机号码 |
| GHF_EMAIL | 购货方邮箱 | varchar | 50 | 否 | 只能传 一个邮箱地址 |
| GHFQYLX | 购货方企业类型 | varchar | 2 | 是 | 01：企业 02：机关事业单位 03：个人 04：其它 |
| GHF_YHZH | 购货方银行、账号 | varchar | 100 | 否 | 开具数电发票时，购方银行名称和账号同时传或不传，若有值，则以空格分隔 |
| HY_DM | 行业代码 | varchar | 10 | 否 | 可不填 |
| HY_MC | 行业名称 | varchar | 40 | 否 | 可不填 |
| KPY | 开票员 | varchar | 8 | 是 | |
| SKY | 收款员 | varchar | 8 | 否 | |
| FHR | 复核人 | varchar | 8 | 否 | |
| KPRQ | 开票日期 | datetime | 否 | 格式YYYY-MM-DD HH:MI:SS(由开票系统生成) | |
| KPLX | 开票类型 | number | 1 | 是 | 1：正票 2：红票 |
| YFP_DM | 原发票代码 | varchar | 12 | 否 | 如果CZDM不是10或KPLX为红票时候都是必录，数电发票不传 |
| YFP_HM | 原发票号码 | varchar | 20 | 否 | 如果CZDM不是10或KPLX为红票时候都是必录 |
| TSCHBZ | 特殊冲红标志 | varchar | 1 | 否 | 可不填，若存在特殊红冲，填1 |
| CZDM | 操作代码 | varchar | 2 | 是 | 10：正票正常开具 20：退货折让红票 |
| QD_BZ | 清单标志 | varchar | 1 | 是 | 默认为0(商品明细大于8行，平台自动生成清单)。 |
| QDXMMC | 清单发票项目名称 | varchar | 200 | 否 | 清单标识（QD_BZ）为0不进行处理。 |
| YFPZL_DM | 原发票种类代码 | varchar | 2 | 否 | 冲红时必须填写，发票种类代码为41（卷票）时，原发票种类代码只能为41（卷票）； 发票种类代码为2（普票）或51（电子发票）时，原发票种类代码允许为2（普票）、41（卷票）、51（电子发票）、其他普票，原发票种类代码、原开票日期、冲红原因须都为空或都非空 |
| YKPRQ | 原开票日期 | varchar | 8 | 否 | 冲红时必须填写，格式为yyyyMMdd，原发票种类代码、原开票日期、冲红原因须都为空或都非空 |
| CHYY | 冲红原因 | varchar | 1 | 否 | 冲红时必须填写， 1：销货退回 2：开票有误 3：服务中止 4：发生销售折让 原发票种类代码、原开票日期、冲红原因须都为空或都非空 |
| KPHJJE | 价税合计金额 | number | 16 | 是 | 小数点后2位，以元为单位精确到分，传值与商品明细值不一致时，以商品明细为准 |
| HJBHSJE | 合计不含税金额 | number | 20 | 是 | 小数点后2位，以元为单位精确到分（单行商品金额之和），传值与商品明细值不一致时，以商品明细为准；可传0，由平台处理价税分离， |
| HJSE | 合计税额 | number | 20 | 是 | 小数点后2位，以元为单位精确到分(单行商品税额之和)，传值与商品明细值不一致时，以商品明细为准；可传0，由平台处理价税分离， |
| BZ | 备注 | varchar | 200 | 否 | 蓝票长度：200 红票长度：144 |
| FPLX | 发票类型 | varchar | 2 | 否 | 0：专票 2：普票 4：电子专票 5：机动车发票 41：卷票 51：电子发票 61：数电专票 62：数电普票 85：数电纸票专票 86：数电纸票普票 默认为51：电子发票。 |
| HZTZD | 红字信息表编号 | varchar | 32 | 否 | 开具专票时填写；乐企数电红冲时填写，乐企数电红冲时如果不填写，如果是全额红冲，则平台会自动申请红字通知单 |
| SGFPBQ | 收购发票标签 | varchar | 2 | 否 | 使用乐企开具数电发票时选填， 00：非收购（默认） 01：农产品收购 02：光伏收购 03：二手车收购 |
| TDYS | 特定要素 | varchar | 2 | 否 | 使用乐企开具数电发票时选填， 详见特定要素代码说明 |
| CKYWSYZCD | 出口业务适用政策代码 | varchar | 2 | 否 | 使用乐企开具数电发票时选填， 空：非出口业务（默认） 01：退税政策， 02：免税政策， 03：征税政策 |
| ZZSJZJTDM | 增值税即征即退代码 | varchar | 2 | 否 | 使用乐企开具数电发票时选填， 详见增值税即征即退代码说明 |
| HZQRDUUID | 红字确认单uuid | varchar | 32 | 乐企数电红冲时填写，乐企数电红冲时如果不填写，如果是全额红冲，则平台会红字确认单uuid | |
| ZPFP_DM | 数电纸票发票种类代码 | varchar | 32 | 否 | 电子税局开具数电纸质发票时填写，可从查询全电纸票发票种类接口获取， 04：2016版增值税普通发票（二联折叠票） 05：2016版增值税普通发票（五联折叠票） 1130：增值税专用发票（中文三联无金额限制版） 1160：增值税专用发票（中文六联无金额限制版） |
| CEZSBQ | 差额征税标签 | varchar | 2 | 否 | 空：非差额开票 01：差额开票 02：全额开票 使用乐企开具差额发票时填写，默认为空， 当差额征税类型代码为“02：全额开票”时，扣除额为0时，无需填写差额扣除清单，当扣除额不为0时，必须填写差额扣除清单； 当差额征税类型代码为“01：差额开票”时，必须填写差额扣除清单 |
| KPDBM | 开票点编码 | varchar | 20 | 否 | |
| DFGTGMBZ | 多方共同购买标志 | varchar | 1 | 否 | 开具不动产销售发票传， Y：多方共同购买 N：非多方共同购买 为Y时要填写共同购买方信息。 |
发票明细（List）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| XMMC | 项目名称 | varchar | 90 | 是 | 如FPHXZ=1，则此商品行为折扣行， 此版本折扣行不允许多行折扣， 折扣行必须紧邻被折扣行， 项目名称必须与被折扣行一致。 |
| XMDW | 项目单位 | varchar | 20 | 否 | 单位名称，tdys（特定要素）为05、06时必填，且只能选择平方米、平方千米、公顷、亩、h㎡、k㎡、㎡ |
| GGXH | 规格型号 | varchar | 40 | 否 | 规格型号 |
| XMSL | 项目数量 | number | 24 | 否 | 小数点后8位, 小数点后都是0时，PDF上只显示整数， 和单价同时填或者不填 |
| HSBZ | 含税标志 | varchar | 1 | 是 | 表示项目单价和项目金额是否含税。 0表示都不含税， 1表示都含税。 |
| FPHXZ | 发票行性质 | varchar | 1 | 是 | 0：正常行 1：折扣行 2：被折扣行 |
| XMDJ | 项目单价 | number | 24 | 否 | 小数点后8位小数点后都是0时，PDF上只显示2位小数； 否则只显示至最后一位不为0的数字； （正票和红票单价都大于‘0’），和数量同时填或者不填 |
| SPBM | 商品编码 | varchar | 19 | 是 | 商品税收分类编码，由企业提供，技术人员 需向企业财务核实，不足19位后面补‘0’， 需与企业实际销售商品相匹配，也可关注 “上海爱信诺”微信公众号的升级通知。 |
| ZXBM | 自行编码 | varchar | 16 | 否 | |
| YHZCBS | 优惠政策标识 | varchar | 1 | 是 | 0：不使用 1：使用 |
| LSLBS | 零税率标识 | varchar | 1 | 否 | 空：非零税率 1：免税 2：不征税 3：普通零税率 |
| ZZSTSGL | 增值税特殊管理 | varchar | 50 | 否 | 税收优惠政策内容， 当YHZCBS为1时必填， LSLBS为0填写出口零税， LSLBS为1填写免税， LSLBS为2填写不征税， 其它优惠政策内容为： 简易征收，稀土产品，先征后退，100%先征后退， 50%先征后退，按3%简易征收，按5%简易征收， 按5%简易征收减按1.5%计征，即征即退30%， 即征即退50%，即征即退70%，即征即退100%， 超税负3%即征即退，超税负8%即征即退， 超税负12%即征即退，超税负6%即征即退 |
| KCE | 扣除额 | number | 20 | 否 | 单位元，小数点2位小数 不能大于不含税金额 说明如下： 1.差额征税的发票如果没有折扣的话， 只能允许一条商品行；数电发票只能允许一行。 2.具体差额征税发票的计算方法如下： 税额 = ((含税金额-扣除额)/(1+税率))*税率 3.如果需要开具差额征税且扣除额为0的票， 蓝票则需要在备注中以： '差额征税：+扣除额。'开头;红票需要在备注中以： '差额征税。'开头;扣除额为0，备注不添加上述内容， 则开具非差额征税的票。 |
| XMJE | 项目金额 | number | 16 | 是 | 小数点后2位，以元为单位精确到分。 等于=单价*数量，根据含税标志， 确定此金额是否为含税金额。 |
| SL | 税率 | varchar | 10 | 是 | 商品的税率，如0.03，0.06等 |
| SE | 税额 | number | 20 | 否 | 小数点后2位，以元为单位精确到分 |
| HH | 行号 | varchar | 10 | 否 | 使用乐企开具数电发票时按顺序（1,2,3,4......）填写， 红冲时使用数电发票全额红冲接口时不需填写 |
| LZFPHH | 蓝字发票行号 | varchar | 10 | 否 | 开具数电蓝字发票时为空，使用乐企开具 数电红字发票时填写，红冲时使用数电发票 全额红冲接口时不需填写 |
订单信息（FPKJXX_DDXX）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| DDH | 订单号 | varchar | 50 | 是 | |
| THDH | 退货单号 | varchar | 20 | 否 | |
| DDDATE | 订单时间 | datetime | 否 |
支付信息（FPKJXX_ZFXXS）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| JYDH | 交易单号 | varchar | 40 | 否 | 交易单号与支付渠道必须同时为空或同时不为空。 |
| ZFQDDM | 支付渠道 | varchar | 3 | 否 | 001：现金； 002：银行转账； 003：票据； 004：借记卡； 005：信用卡； 006：购物卡/券； 007：优惠券； 008：商场积分； 009：支付宝； 010：微信支付； 011：云闪付； 012：Apple Pay； 013：Samsung Pay； 099：其他。 |
机动车发票信息（开具机动车发票传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| VEHICLETYPE | 车辆类型 | varchar | 40 | 是 | 车辆类型，同明细中商品名称，开具机动车发票时明细有且仅有一行，商品名称为车辆类型且不能为空 |
| BRANDMODEL | 厂牌型号 | varchar | 40 | 是 | |
| PRODUCTORIGIN | 原产地 | varchar | 32 | 否 | |
| CERTIFICATE | 合格证号 | varchar | 50 | 否 | |
| IMPORTCERNUM | 进出口证明书号 | varchar | 36 | 否 | |
| INSODDNUM | 商检单号 | varchar | 32 | 否 | |
| ENGINENUM | 发动机号码 | varchar | 160 | 是 | |
| VEHICLECODE | 车辆识别代号 | varchar | 23 | 是 | |
| UUID | 机动车台账车辆识别代号uuid | varchar | 50 | 是 | |
| INTACTCERNUM | 完税证明号码 | varchar | 32 | 否 | |
| TONNAGE | 吨位 | varchar | 8 | 否 | 货车必填，普通车辆非必填 |
| MAXCAPACITY | 限乘人数 | varchar | 2 | 是 | |
| MANUFACTURERNAME | 生产企业名称 | varchar | 100 | 是 | |
| TAXOFFICENAME | 主管税务机关名称 | varchar | 80 | 否 | |
| TAXOFFICECODE | 主管税务机关代码 | varchar | 11 | 否 |
不动产租赁信息（开不动产租赁发票传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| BDCZLDZ | 不动产地址 | varchar | 80 | 是 | 必须包含'街'、'路'、'村'、'乡'、'镇'、'道'关键词 |
| ZLQQ | 租赁期起 | varchar | 40 | 是 | 格式：yyyy-MM-dd，商品编码为3040502020200000000 时，租赁期起止格式为yyyy-MM-dd hh:mm，中间用英文空格隔开 |
| ZLQZ | 租赁期起止 | varchar | 40 | 是 | 格式：yyyy-MM-dd，商品编码为3040502020200000000 时，租赁期起止格式为yyyy-MM-dd hh:mm，中间用英文空格隔开 |
| KDSBZ | 跨地（市）标志 | varchar | 1 | 是 | Y：是 N：否 |
| CQZSBH | 产权证书/不动产权证号 | varchar | 40 | 是 | |
| DW | 面积单位 | varchar | 30 | 是 | 可以填平方千米、平方米、公顷、亩、h㎡、k㎡、㎡ |
| BDCZLDZS | 不动产坐落地址（省） | varchar | 20 | 否 | 必须以省、自治区、特别行政区、北京市、天津市、上海市、重庆市任意一个关键词结尾。如果不传，平台根据所传详细地址提取（可能存在错误） |
| BDCZLDZS1 | 不动产坐落地址（市） | varchar | 20 | 否 | 当“不动产坐落地址（省）”为香港特别行政区、澳门特别行政区、台湾省时，“不动产坐落地址（市）”可为空，其他情况必填。必须以市、盟、自治州、地区、区、县任意一个关键词结尾，且仅当“不动产坐落地址（省）”为海南省或重庆市时，“不动产坐落地址（市）”可以由关键词“县”结尾。 |
| CPH | 车牌号 | varchar | 50 | 否 | 可以支持多个车牌号，最多支持三个，以','隔开，如：沪B1234,沪A1234 |
不动产销售信息（开不动产销售发票传）（老版,只能支持一条不动产信息及共同购买方明细，不建议使用）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| WQHTBABH | 不动产单元代码/网签合同备案编号（乐企开票时该字段表示网签合同备案编号），“不动产单位代码”和“网签合同备案编号”两者只能填一个。 | varchar | 28 | 否 | 不动产单元代码/网签合同备案编号，乐企开票时该字段表示网签合同备案编号，可选填，其它途径开票必传，“不动产单位代码”和“网签合同备案编号”两者只能填一个。 |
| BDCDZ | 不动产地址 | varchar | 120 | 是 | 不动产地址必须包含街、路村、乡、镇、道等关键词之一 |
| KDSBZ | 跨地（市）标志 | varchar | 1 | 是 | Y：是 N：否 |
| TDZZSXMBH | 土地增值税项目编号 | varchar | 16 | 否 | |
| HDJSJG | 核定计税价格 | varchar | 20 | 否 | |
| SJCJHSJE | 实际成交含税金额 | varchar | 20 | 否 | |
| CQZSH | 房屋产权证书号/不动产权证号 | varchar | 20 | 否 | |
| DW | 面积单位 | varchar | 30 | 是 | |
| BDCDWDM | 不动产单位代码（乐企开票时选填）,“不动产单位代码”和“网签合同备案编号”两者只能填一个 | varchar | 28 | 否 | 不动产单位代码，乐企开票时选填，其它途径开票为空,“不动产单位代码”和“网签合同备案编号”两者只能填一个 |
| DFGTGMBZ | 多方共同购买标志（乐企开票时选填） | varchar | 1 | 否 | 多方共同购买标志，乐企开票时选填，其它途径开票为空 |
| GTGMF | 共同购买方（乐企开票时选填） | varchar | 20 | 否 | 共同购买方，乐企开票时选填，其它途径开票为空 |
| ZJLX | 证件类型（乐企开票时选填） | varchar | 3 | 否 | 证件类型，乐企开票时选填，其它途径开票为空 |
| ZJHM | 证件号码（乐企开票时选填） | varchar | 20 | 否 | 证件号码，乐企开票时选填，其它途径开票为空 |
不动产销售信息（开不动产销售发票传）（支持多个不动产信息及共同购买方，建议使用）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| WQHTBABH | 不动产单元代码/网签合同备案编号（乐企开票时该字段表示网签合同备案编号），“不动产单位代码”和“网签合同备案编号”两者只能填一个。 | varchar | 28 | 否 | 不动产单元代码/网签合同备案编号，乐企开票时该字段表示网签合同备案编号，可选填，其它途径开票必传，“不动产单位代码”和“网签合同备案编号”两者只能填一个。 |
| BDCDZ | 不动产地址 | varchar | 120 | 是 | 不动产地址必须包含街、路村、乡、镇、道等关键词之一 |
| KDSBZ | 跨地（市）标志 | varchar | 1 | 是 | Y：是 N：否 |
| TDZZSXMBH | 土地增值税项目编号 | varchar | 16 | 否 | |
| HDJSJG | 核定计税价格 | varchar | 20 | 否 | |
| SJCJHSJE | 实际成交含税金额 | varchar | 20 | 否 | |
| CQZSH | 房屋产权证书号/不动产权证号 | varchar | 20 | 否 | |
| DW | 面积单位 | varchar | 30 | 是 | |
| BDCDWDM | 不动产单位代码（乐企开票时选填）,“不动产单位代码”和“网签合同备案编号”两者只能填一个 | varchar | 28 | 否 | 不动产单位代码，乐企开票时选填，其它途径开票为空,“不动产单位代码”和“网签合同备案编号”两者只能填一个 |
| BDCZLDZS | 不动产坐落地址（省） | varchar | 20 | 是 | 必须以省、自治区、特别行政区、北京市、天津市、上海市、重庆市任意一个关键词结尾。 |
| BDCZLDZS1 | 不动产坐落地址（市） | varchar | 20 | 否 | 当“不动产坐落地址（省）”为香港特别行政区、澳门特别行政区、台湾省时，“不动产坐落地址（市）”可为空，其他情况必填。必须以市、盟、自治州、地区、区、县任意一个关键词结尾，且仅当“不动产坐落地址（省）”为海南省或重庆市时，“不动产坐落地址（市）”可以由关键词“县”结尾。 |
| XZQHSZDM | 行政区划设置代码 | varchar | 6 | 否 | 乐企开票不用传，其它开票传，该值可从官网查询，地址为：https://www.stats.gov.cn/sj/tjbz/tjyqhdmhcxhfdm/2023/index.html，取前6位 |
共同购买方（开具不动产销售发票选传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| GTGMF | 共同购买方 | varchar | 100 | 否 | 共同购买方，乐企开票时选填，其它途径开票为空 |
| ZJLX | 证件类型 | varchar | 3 | 否 | |
| ZJHM | 证件号码 | varchar | 20 | 否 |
货物运输信息（开货物运输发票传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| XH | 序号 | varchar | 11 | 是 | |
| YSGJZL | 运输工具种类，乐企开票传：铁路运输，公路运输，水路运输，航空运输，管道运输 | varchar | 30 | 是 | |
| YSGJHP | 运输工具号牌 | varchar | 40 | 是 | |
| QYD | 起运地 | varchar | 300 | 是 | |
| DDD | 到达地 | varchar | 300 | 是 | |
| YSHWMC | 运输货物名称 | varchar | 150 | 是 |
旅客运输信息（开旅客运输发票传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| XH | 序号 | varchar | 11 | 是 | |
| CXR | 出行人 | varchar | 20 | 是 | |
| CXRQ | 出行日期 | varchar | 10 | 是 | yyyy-MM-dd |
| CXRZJLX | 出行人证件类型 | varchar | 40 | 是 | 详见出行人证件类型代码说明 |
| SFZJHM | 身份证件号码 | varchar | 20 | 是 | |
| CFD | 出发地 | varchar | 80 | 是 | |
| DDD | 到达地 | varchar | 80 | 是 | |
| ZWDJ | 座位等级 | varchar | 20 | 否 | |
| JTGJLX | 交通工具类型 | varchar | 80 | 是 | 1：飞机 2：火车 3：长途汽车 4：公共交通 5：出租车 6：汽车 7：船舶 8：其他 |
建筑服务发票（开建筑服务发票传）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| TDZZSXMBH | 土地增值税项目编号 | varchar | 16 | 否 | 为房地产企业建设房产需要填写。 |
| KDSBZ | 跨地市标志 | varchar | 1 | 是 | Y：是 N：否 |
| JZFWFSD | 建筑服务发生地 | varchar | 120 | 是 | 乐企：建筑服务发生地县（市、区）名称； 电子税局：填写省、市、区信息 |
| JZXMMC | 建筑项目名称 | varchar | 80 | 是 | |
| XZQHSZDM | 行政区划设置代码 | varchar | 6 | 否 | 乐企开票不用传，其它开票传，该值可从官网查询，地址为： https://www.stats.gov.cn/sj/tjbz/tjyqhdmhcxhfdm/2023/index.html 取前6位 |
| XXDZ | 详细地址 | varchar | 120 | 否 | 电子税局开票填写 |
| KQYSSSXBYGLBH | 跨区域涉税事项报验管理编号 | varchar | 100 | 否 | 跨地市标志为Y时，必填（电子税局开票填写） |
差额凭证明细列表，（开具数电发票时填写）
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| PZLX | 凭证类型 | varchar | 2 | 是 | 01:数电发票 02:增值税专用发票 03:增值税普通发票 04:营业税发票 05:财政票据 06:法院裁决书 07:契税完税凭证 08:其他发票类 09:其他扣除凭证 |
| FPDM | 发票代码 | varchar | 12 | 否 | |
| FPHM | 发票号码 | varchar | 20 | 否 | |
| PZHM | 凭证号码 | varchar | 否 | 除数电发票、纸质发票的其他凭证类型时的凭证号 | |
| KJRQ | 差额凭证的开具日期 | varchar | 10 | 是 | YYYY-MM-DD |
| HJJE | 发票的价税合计 | varchar | 18 | 是 | 凭证的合计金额，小数点后2位，以元为单位精确到分。 |
| KCE | 扣除额 | varchar | 18 | 是 | 凭证的本次扣除额，小数点后2位，以元为单位精确到分。 |
| BZ | 差额录入页面手动录入的备注 | varchar | 否 | 备注 |
示例报文
请求报文示例
<?xml version="1.0" encoding="utf-8"?>
<interface
xmlns=""
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
version="DZFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>1.0</version>
<interfaceCode>ECXML.FPKJ.BC.E_INV</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 09:40:30</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_FPKJXX class="REQUEST_FPKJXX">
<FPKJXX_FPTXX class="FPKJXX_FPTXX">
<FPQQLSH>P1000001test_000000001</FPQQLSH>
<DSPTBM>P1000001</DSPTBM>
<NSRSBH>913101010000000090</NSRSBH>
<NSRMC>上海航信测试90</NSRMC>
<FJH></FJH>
<NSRDZDAH></NSRDZDAH>
<SWJG_DM></SWJG_DM>
<DKBZ>0</DKBZ>
<PYDM></PYDM>
<KPXM>米</KPXM>
<BMB_BBH>12.0</BMB_BBH>
<XHF_NSRSBH>913101010000000090</XHF_NSRSBH>
<XHFMC>上海航信测试90</XHFMC>
<XHF_DZ>xxxxxx</XHF_DZ>
<XHF_DH>213132</XHF_DH>
<XHF_YHZH></XHF_YHZH>
<GHFMC>个人</GHFMC>
<GHF_NSRSBH></GHF_NSRSBH>
<GHF_SF></GHF_SF>
<GHF_DZ></GHF_DZ>
<GHF_GDDH></GHF_GDDH>
<GHF_SJ></GHF_SJ>
<GHF_EMAIL>test_001@qq.com</GHF_EMAIL>
<GHFQYLX>01</GHFQYLX>
<GHF_YHZH></GHF_YHZH>
<HY_DM></HY_DM>
<HY_MC></HY_MC>
<KPY>财务一</KPY>
<SKY></SKY>
<FHR></FHR>
<KPRQ></KPRQ>
<KPLX>1</KPLX>
<YFP_DM></YFP_DM>
<YFP_HM></YFP_HM>
<CZDM>10</CZDM>
<QD_BZ>0</QD_BZ>
<QDXMMC></QDXMMC>
<CHYY></CHYY>
<TSCHBZ></TSCHBZ>
<KPHJJE>20</KPHJJE>
<HJBHSJE>0</HJBHSJE>
<HJSE>0</HJSE>
<BZ></BZ>
</FPKJXX_FPTXX>
<FPKJXX_XMXXS class="FPKJXX_XMXX;" size="1">
<FPKJXX_XMXX>
<XMMC>米</XMMC>
<XMDW></XMDW>
<GGXH></GGXH>
<XMSL>1</XMSL>
<HSBZ>1</HSBZ>
<FPHXZ>0</FPHXZ>
<XMDJ>20</XMDJ>
<SPBM></SPBM>
<ZXBM></ZXBM>
<YHZCBS>0</YHZCBS>
<LSLBS></LSLBS>
<ZZSTSGL></ZZSTSGL>
<KCE>0</KCE>
<XMJE>20</XMJE>
<SL>0.06</SL>
<SE>1.13</SE>
</FPKJXX_XMXX>
</FPKJXX_XMXXS>
<FPKJXX_DDXX class="FPKJXX_DDXX">
<DDH>2492684718573093</DDH>
<THDH/>
<DDDATE/>
</FPKJXX_DDXX>
</REQUEST_FPKJXX>
</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.FPKJ.BC.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></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/>
</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.FPKJ.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>