附录
1.0 销项服务API列表
| 代码 | 说明 |
|---|---|
| ECXML.FPKJ.BC.E_INV | 发票开具 |
| ECXML.FPXZ.CX.E_INV | 发票主体信息下载 |
| ECXML.EMAILPHONEFPTS.TS.E.INV | 邮箱发票推送 |
| ECXML.FPMXXZ.CX.E_INV | 发票明细信息下载 |
| ECXML.FPKJJG.TS.E_INV | 发票信息推送 |
| ECXML.QY.KYFPSL | 获取企业可用发票数量 |
| ECXML.EMAILPHONEFPTS.TS.RESULT | 邮件发送结果查询 |
| ECXML.DZKPXZ.RESULT | 单张开票限额查询 |
| ECXML.SPXX.JS | 商品信息同步 |
| ECXML.DDXG.BC.E_INV | 订单修改 |
| ECXML.WJXZ.CX.E_INV | 发票明细信息下载（新） |
| ECXML.RED.HZTZSQ | 红字发票信息表申请 |
| ECXML.TAXCONTROLOPERATIONRESULT.QUERY | 红字发票信息表查询 |
| ECXML_HZFPSQBXZ | 红字发票申请表审核下载 |
| ECXML.QY.NEW.FPKCCX | 发票库存查询接口（新） |
| ECXML_SMARTCODE | 税务编码推荐 |
| ECXML.QDEWM.GET | 数电实人认证二维码获取 |
| ECXML.QDEWM.RESULT | 数电实人认证结果查询 |
| ECXML.QDFP.HZQRDSQ | 乐企数电红字确认单申请 |
| ECXML.QDFP.HZQRDQR | 乐企数电红字确认单确认 |
| ECXML.QDFP.HZQRDXXCX | 乐企红字确认单信息查询 |
| ECXML.HZQRDLB.QUERY | 红字确认单列表查询 |
| ECXML.QDFP.QEHCHZQRDSQ | 乐企全额红冲红字确认单申请 |
| ECXML.LQQEHPKJ | 数电发票红冲 |
| ECXML.SDZPZF | 数电纸票作废 |
| ECXML.SDZPDY | 获取全电纸票打印工具下载地址 |
| ECXML.FPDYXMLXZ | 获取数电纸票发票打印xml内容 |
| ECXML.QDZPFPZL.QUERY | 数电纸票发票种类查询 |
| ECXML.JDCCJH.QUERY | 机动车车架号查询 |
| ECXML.DZSJ.LOGIN | 企业登录 |
| ECXML.SXEDCX | 企业授信额度查询 |
1.1 特定要素代码
| 代码 | 说明 |
|---|---|
| 空 | 非特定要素（默认） |
| 01 | 成品油发票 |
| 02 | 稀土发票 |
| 03 | 建筑服务发票 |
| 04 | 货物运输服务发票 |
| 05 | 不动产销售服务发票 |
| 06 | 不动产租赁服务发票 |
| 07 | 代收车船税 |
| 08 | 通行费 |
| 09 | 旅客运输服务发票 |
| 10 | 医疗服务（住院）发票 |
| 11 | 医疗服务（门诊）发票 |
| 12 | 自产农产品销售发票 |
| 13 | 拖拉机和联合收割机发票 |
| 14 | 机动车 |
| 15 | 二手车 |
| 16 | 农产品收购发票 |
| 17 | 光伏收购发票 |
| 18 | 卷烟发票 |
1.2 增值税即征即退代码
| 代码 | 说明 |
|---|---|
| 空 | 非增值税即征即退（默认） |
| 01 | 软件产品发票 |
| 02 | 资源综合利用产品发票 |
| 03 | 管道运输服务发票 |
| 04 | 有形动产融资租赁服务 |
| 05 | 有形动产融资性售后回租服务发票 |
| 06 | 新型墙体材料发票 |
| 07 | 风力发电产品发票 |
| 08 | 光伏发电产品发票 |
| 09 | 动漫软件产品发票 |
| 10 | 飞机维修劳务发票 |
| 11 | 黄金发票 |
| 12 | 铂金发票 |
1.3 出行人证件类型代码
| 代码 | 说明 |
|---|---|
| 101 | 组织机构代码证 |
| 102 | 营业执照 |
| 103 | 税务登记证 |
| 199 | 其他单位证件 |
| 201 | 居民身份证 |
| 202 | 军官证 |
| 203 | 武警警官证 |
| 204 | 士兵证 |
| 205 | 军队离退休干部证 |
| 206 | 残疾人证 |
| 207 | 残疾军人证（1-8级） |
| 208 | 外国护照 |
| 209 | 港澳同胞回乡证 |
| 210 | 港澳居民来往内地通行证 |
| 211 | 台胞证 |
| 212 | 中华人民共和国往来港澳通行证 |
| 213 | 台湾居民来往大陆通行证 |
| 214 | 大陆居民往来台湾通行证 |
| 215 | 外国人居留证 |
| 216 | 外交官证 |
| 217 | 使（领事）馆证 |
| 218 | 海员证 |
| 219 | 香港永久性居民身份证 |
| 220 | 台湾身份证 |
| 221 | 澳门特别行政区永久性居民身份证 |
| 222 | 外国人身份证件 |
| 223 | 高校毕业生自主创业证 |
| 224 | 就业失业登记证 |
| 225 | 退休证 |
| 226 | 离休证 |
| 227 | 中国护照 |
| 228 | 城镇退役士兵自谋职业证 |
| 229 | 随军家属身份证明 |
| 230 | 中国人民解放军军官转业证书 |
| 231 | 中国人民解放军义务兵退出现役证 |
| 232 | 中国人民解放军士官退出现役证 |
| 233 | 外国人永久居留身份证（外国人永久居留证） |
| 234 | 就业创业证 |
| 235 | 香港特别行政区护照 |
| 236 | 澳门特别行政区护照 |
| 237 | 中华人民共和国港澳居民居住证 |
| 238 | 中华人民共和国台湾居民居住证 |
| 239 | 中华人民共和国外国人工作许可证》（A类） |
| 240 | 《中华人民共和国外国人工作许可证》（B类） |
| 241 | 《中华人民共和国外国人工作许可证》（C类） |
| 291 | 医学出生证明 |
| 299 | 其他个人证件 |
2.1 扫码开票异常码
| 异常码 | 错误描述 | 解决方案 |
|---|---|---|
| 9101 | 未匹配的企业唯一标识 | 检查是否使用了航信提供的正确的企业唯一标识 |
| 9102 | 二维码密文内容解析失败 | 加密方式及加密密钥是否正确，可通过【测试工具】->【加密与解密】进行验证 |
| 9103 | 不符合二维码内容组成规范 | 检查明文组成部分是否按照对应的扫码开票方案的要求进行组织 |
| 9104 | 明细行格式不正确 | 检查明文组成部分是否按照对应的扫码开票方案的要求进行组织 |
| 9105 | 明细折扣行不规范 | 检查明文组成部分是否按照对应的扫码开票方案的要求进行组织 |
| 9106 | 发票请求流水号长度不规范 | 检查发票请求流水号长度是否在20至50位之间 |
| 9107 | 日期格式不规范 | 检查日期格式是否是：yyyy-MM-dd HH:mm:ss |
| 9108 | 订单开票时限已过 | 航信测试环境默认二维码有效期是30天，检查是否已超过该有效期 |
| 9109 | 纳税人识别号不规范 | 检查是否是正确的纳税人识别号 |
| 9110 | 纳税人识别号不存在 | 检查是否是正确的纳税人识别号 |
| 9111 | 平台无相应商品信息 | 检查商品编码对应的商品信息是否已经在航信平台进行维护 |
| 9112 | 未匹配的税收分类编码 | 检查是否是正确的税收分类编码 |
| 9113 | 成品油发票开具明细行数不规范 | 成品油发票开具最多支持8行明细 |
| 9114 | 明细行商品数量不规范 | 检查商品数量是否是大于0的数字 |
| 9115 | 订单总金额或明细行金额不规范 | 检查金额数值是否规范 |
| 9116 | 不支持成品油与非成品油商品混合开具 | 检查是否存在成品油与非成品油商品混开 |
| 9117 | 明细项金额合计与总金额不相等 | 检查订单总金额与明细行金额累加之和是否相等 |
| 9118 | 购货方信息不规范 | 检查购货方信息的内容是否正确 |
| 9119 | 优惠政策内容不规范 | 检查YHZCBS、ZZSTSGL字段及其关系是否正确 |
| 9120 | 获取订单信息失败 | 检查对接企业服务地址是否正常可用 |
| 9121 | 数据转换异常 | 检查数值是否规范 |
| 9122 | 不支持的字符编码 | 检查是否有特殊的字符 |
| 9123 | 服务请求失败 | 检查服务是否正常 |
| 9124 | 订单已作废 | 确认订单是否以被作废不可用 |
| 9125 | 服务地址未配置 | |
| 9126 | YXBJ只能为Y或者N | |
| 9127 | YXBJ为N时 GHFMC不能为空 | |
| 9128 | YXBJ为N且GHFQYLX为01时 GHF_NSRSBH不能为空 | |
| 9129 | YXBJ为N时 GHFQYLX不能为空 | |
| 9130 | 数电标志内容不正确 | 检查数电标志的内容是否正确 |
| 9201 | 发票正在开具中 | 开票服务器正在开具发票，稍后可重新扫码查看发票 |
| 9202 | 发票正在开具中 | 开票服务器正在开具发票，稍后可重新扫码查看发票 |
| 9203 | 数据转换异常 | 检查订单中要求传入数字的内容是否有误 |
| 9204 | 扫码开票处理异常 | 联系航信处理 |
| 9205 | 扫码开票处理异常 | 联系航信处理 |
| 9206 | 扫码开票处理异常 | 联系航信处理 |
| 9207 | 扫码开票处理异常 | 联系航信处理 |
| 9208 | 扫码开票处理异常 | 联系航信处理 |
| 9209 | 扫码开票处理异常 | 联系航信处理 |
| 9212 | 平台异常 | 联系航信处理 |
| 9213 | 地址电话含有特殊字符 | 联系航信处理 |
| 9214 | 购方银行、账号长度超长 | 联系航信处理 |
| 9215 | 购方名称长度超长或为空 | 联系航信处理 |
| 9216 | 购货方名称含有特殊字符 | 联系航信处理 |
| 9217 | 购方纳税人识别号错误 | 联系航信处理 |
| 9218 | 含有特殊字符 | 联系航信处理 |
| 9219 | 销方电话地址长度超长 | 联系航信处理 |
| 9220 | 销方信息有特殊字符 | 联系航信处理 |
| 9221 | 销方信息有特殊字符 | 联系航信处理 |
| 9222 | 订单金额大于金税盘限额 | 企业确保订单金额不大于金税盘限额 |
| 9223 | 购方税号错误 | 联系航信处理 |
| 9224 | 金税盘无可开库存发票 | 企业处理、航信协助 |
| 9225 | 金税盘已下架停用 | 联系航信处理 |
| 9226 | 与票源区其他发票重复 | 企业处理，发票退回、重新购买 |
| 9227 | 纳税人税号不匹配 | 联系航信处理 |
| 9228 | 金税盘锁死 | 企业处理、航信协助 |
| 9229 | 金税盘处于报税期 | 企业处理 |
| 9230 | 离线时限0小时 | 联系航信处理 |
| 9231 | 平台处理异常 | 联系航信处理 |
| 9232 | 平台处理异常 | 联系航信处理 |
| 9233 | 平台处理异常 | 联系航信处理 |
| 9234 | 金税盘异常 | 联系航信处理 |
| 9235 | 金税盘异常 | 联系航信处理 |
| 9236 | 金税盘异常 | 联系航信处理 |
| 9237 | 平台处理异常 | 联系航信处理 |
| 9238 | 无电子发票票种 | 企业处理 |
| 9239 | 平台处理异常 | 联系航信处理 |
| 9240 | 平台处理异常 | 联系航信处理 |
| 9241 | 平台处理异常 | 联系航信处理 |
| 9242 | 平台处理异常 | 联系航信处理 |
| 9243 | 平台处理异常 | 联系航信处理 |
| 9244 | 平台处理异常 | 联系航信处理 |
| 9245 | 平台处理异常 | 联系航信处理 |
| 9246 | 平台处理异常 | 联系航信处理 |
| 9247 | 平台处理异常 | 联系航信处理 |
| 9248 | 平台处理异常 | 联系航信处理 |
| 9249 | 平台处理异常 | 联系航信处理 |
| 9250 | 平台处理异常 | 联系航信处理 |
| 9251 | 平台处理异常 | 联系航信处理 |
| 9252 | 平台处理异常 | 联系航信处理 |
| 9253 | 商品名称含有特殊字符 | 企业处理 |
| 9301 | 再次扫码获取发票时输入的发票抬头不正确 | 受票方确认抬头，可联系企业获取正确的发票抬头 |
| 9401 | 平台处理异常 | 联系航信处理 |
| 9402 | 平台处理异常 | 联系航信处理 |
| 9501 | 平台处理异常 | 联系航信处理 |
| 9502 | 平台处理异常 | 联系航信处理 |
| 9601 | 发票被重复添加到支付宝发票管家 | 无须重复添加，受票方可在支付宝中查看发票 |
| 9602 | 平台处理异常 | 联系航信处理 |
| 9701 | 发票被重复添加至微信卡包 | 1、无须重复添加，受票方可在支付宝中查看发票；2、受票方在将发票加入微信卡包时未按照流程全部操作，此时联系航信处理 |
| 9702 | 平台处理异常 | 联系航信处理 |
| 9703 | 平台处理异常 | 联系航信处理 |
| 9990 | 平台处理异常 | 联系航信处理 |
| 9991 | 平台处理异常 | 联系航信处理 |
| 9992 | 平台处理异常 | 联系航信处理 |
| 9993 | 平台处理异常 | 联系航信处理 |
| 9994 | 平台处理异常 | 联系航信处理 |
| 9995 | 平台处理异常 | 联系航信处理 |
| 9996 | 平台处理异常 | 联系航信处理 |
| 9997 | 平台处理异常 | 联系航信处理 |
| 9998 | 平台处理异常 | 联系航信处理 |
3.1 进项服务API列表
| 代码 | 说明 |
|---|---|
| jx.invoiceCheck | 发票查验 |
| jx.rz.invoicesQuery | 发票信息下载 |
| jx.rz.invoicesStateQuery | 发票状态下载 |
| jx.rz.select.request | 发票勾选申请 |
| jx.rz.select.query | 发票勾选结果查询 |
| jx.rz.cert.statRequest | 发票申请统计 |
| jx.rz.cert.statQuery | 发票统计结果查询 |
| jx.rz.cert.certRequest | 企业认证请求 |
| jx.rz.cert.certQuery | 企业认证结果查询 |
| jx.rz.info.invoiceQuery | 单张发票查询 |
| jx.rz.invoices.mainQuery | 发票主体信息下载 |
| jx.rz.info.timeQuery | 同步税款所属期 |
| jx.rz.corp.query | 税收黑名单数据查询 |
| jx.rz.invoices.mainQuery.new | 发票主体信息下载（新） |
| jx.rz.corp.unnormal | 企业经营异常 |
| jx.rz.corp.unnormal | 企业税收违法 |
| jx.rz.info.downPdfOrXml | 发票版式文件下载 |
| jx.rz.info.stateQuery | 进项业务状态查询 |
| jx.taxdigital.tpass.login | 电子税局企业账号登录 |
| jx.taxdigital.phone.login | 电子税局企业手机登录 |
| jx.taxdigital.invoice.makeup | 进项发票弥补 |
| jx.entry.query | 发票入账信息查询 |
| jx.entry.operate | 发票入账信息提交 |
| jx.entry.batchApply | 批量上传发票入账信息 |
| jx.entry.batchResult | 查询批量上传发票入账处理结果 |
4.1 票据服务API列表
| 代码 | 说明 |
|---|---|
| 51.pdf.ofd.recognition | 单张票据文件信息提取 |
| pdf.ofd.ocr.sync.request | 票据识别 |
| ofd.convert.image | OFD文件转图片 |
5.1 加密方式
为保证交互数据的安全性，需要对业务报文进行加密。诺e票针对不同服务，提供不同的加密方式。
加密密钥均由诺e票平台提供。
5.1.1 SM4加密
加密模式：ECB
填充模式：PKCS5Padding
该加密方式适用于平台进项服务。
5.1.2 3DES加密
加密模式：ECB
填充模式：PKCS5Padding
该加密方式适用于平台销项服务、平台进项服务、扫码开票服务、扫码取票服务、票据服务。
5.1.3 AES加密
加密模式：ECB
填充模式：PKCS5Padding
该加密方式适用于扫码开票服务、扫码取票服务。