1. 错误码定义
| 名称 | 描述 | 原因 | 解决方案 |
|---|---|---|---|
| 10000 | Internal error | 服务器内部错误 | 请联系管理员 |
| 10002 | Authenticate failed | 授权错误 | 请确认已使用有效的appkey以及appsecret获取token，获取方法上文已述 |
| 10003 | Invalid parameter | 无效参数 | 补充相关必要参数 |
| 10004 | Not support type | 不支持的发票类型 | 该种类型发票尚不支持 |
| 10005 | Invalid type | 发票类型不对 | 1, 识别的发票类型 与 输入的“type”不一致, 检查输入的参数与要识别的图片. 2, 当前账号没有识别该类型发票的权限. 购买相应权限或者联系管理员. |
| 10006 | Invalid image | 无效图片 | 请检查以下几点: 1, 是否是损坏的图片 2, 是否是不支持的图片格式 3, 是否图片大小超过限制 |
| 10007 | No available packet | 无可用的流量包 | 购买新流量包或联系管理员 |
| 10008 | Image cache disabled | 图片缓存功能未开启 | 调用/feedback api时使用了id字段，但是图片缓存功能未开启，请联系管理员 |
| 10025 | Invalid app key | 无效App Key | 检查appkey，确保有效 |
| 10026 | Expired token | token过期 | 重新生成token |
| 10300 | pdf convert failed | pdf文件处理异常 | 请联系管理员 |
| 10400 | download image file failed | 使用image_url参数时图片下载失败 | 1.检查图片url是否正确 2.检查图片能否正常下载,图片下载timeout为20秒 |
| 10500 | request to frequently | 调用接口次数太频繁 | 限制每分钟请求次数 |
| 10600 | no support item type | 不支持的票据类型 | 检查type参数 |
| 10700 | No access to API | 接口没访问权限 | 请联系管理员 |
2. 发票类型
| 名称 | 描述 | 名称 | 描述 | 名称 | 描述 |
|---|---|---|---|---|---|
| 10100 | 增值税专用发票 | 10200 | 定额发票 | 10507 | 过路费发票 |
| 10101 | 增值税普通发票 | 10400 | 机打发票 | 10900 | 可报销其他发票 |
| 10102 | 增值税电子普通发票 | 10500 | 出租车发票 | ||
| 10103 | 增值税普通发票(卷票) | 10503 | 火车票 | 20100 | 国际小票 |
| 10104 | 机动车销售统一发票 | 10505 | 客运汽车 | 20105 | 滴滴出行行程单 |
| 10105 | 二手车销售统一发票 | 10506 | 航空运输电子客票行程单 | 10902 | 完税证明 |
| 10505a | 船票 |
| 名称 | 分类依据 |
|---|---|
| 区块链电子发票 | 识别类型为10102且block_chain为1 |
| 收费公路通行费增值税电子普通发票 | 识别类型为10102且transit_mark为1 |
| 增值税电子专用发票 | 识别类型为10100且electronic_mark为1 |
3. 消费类型type字段
| Food&Dining | Transport | Shopping | Bills | Other |
|---|---|---|---|---|
| Lodging | Travel | Car | Services | |
| Health_Fitness | Education | Shipping | Equipment |
4. 消费类型kind字段
| 餐饮 | 交通 | 住宿 | 房租装修 | 用车 |
|---|---|---|---|---|
| 通讯 | 邮寄 | 数码电器 | 水电 | 服务 |
| 服饰 | 教育 | 医疗 | 食品 | 办公 |
| 日用 | 其他 |
5. 验真结果代码定义
| 名称 | 描述 | 名称 | 描述 |
|---|---|---|---|
| 10000 | 查验成功 | 10001 | 查无此票 |
| 10002 | 查验信息不一致(一般是专票未税金额不正确) | 10003 | 验真次数超过限制，同一张票一天最多可以查验5次 |
| 10004 | 不支持验真发票类型 | 10005 | 无效参数（发票代码，号码，开票日期等为空或者格式错误，普票验证码为空，专票税前金额为空等不合法参数错误） |
| 10006 | 其它错误 |
说明： 其中验真结果代码为 10000,10001,10002,10003时，视为一次有效查验，计算验真费用，其他值不计费