1. 错误码定义
| 错误类型 | 错误代码 | 描述 | 原因 | 解决方案 |
|---|---|---|---|---|
| 内部服务错误 | 10000 | Internal error | 服务器内部错误 | 请联系管理员 |
| 认证错误 | 10002 | Authenticate failed | 授权错误 | 请确认已使用有效的appkey以及appsecret获取token，获取方法上文已述 |
| 参数错误 | 10003 | Invalid parameter | 无效参数 | 补充相关必要参数 |
| 文件解析错误 | 10006 | Invalid image | 无效图片 | 请检查以下几点: 1, 是否是损坏的图片 2, 是否是不支持的图片格式 3, 是否图片大小超过限制 |
| 账号错误 | 10007 | No available packet | 账号余额不足 | 请检查账户余额。如果正常联系管理员确认 |
| 账号错误 | 10007 | No available docs | 此账号没有任何模型 | 联系管理员确认 |
| appkey 错误 | 10025 | Invalid appKey | 请求参数app key错误 | 请确认appkey是否有效 |
| 文件处理错误 | 10300 | pdf/ofd convert failed | pdf/ofd文件处理异常 | 请联系管理员并反馈相关文件 |
| 图片处理错误 | 10400 | Download image file failed | 使用image_url参数时图片下载失败 | 1.检查图片url是否正确 2.检查图片能否正常下载,图片下载timeout为50秒 |
| 请求过于频繁 | 10500 | Request too frequently, please try later. | 调用接口次数太频繁 | 对现有请求进行排队 |
| 接口访问错误 | 10700 | No access to API | 接口没访问权限 | 请联系管理员 |
2. 发票类型
| 名称 | 描述 | 名称 | 描述 | 名称 | 描述 |
|---|---|---|---|---|---|
| 10100 | 增值税专用发票 | 10200 | 定额发票 | 10507 | 过路费发票 |
| 10101 | 增值税普通发票 | 10400 | 机打发票 | 10900 | 可报销其他发票 |
| 10102 | 增值税电子普通发票 | 10500 | 出租车发票 | ||
| 10103 | 增值税普通发票(卷票) | 10503 | 火车票 | 20100 | 小票 |
| 10104 | 机动车销售统一发票 | 10505 | 客运汽车票 | 20105 | 出行行程单 |
| 10105 | 二手车销售统一发票 | 10506 | 航空运输电子客票行程单 | 10902 | 完税证明 |
| 10505a | 船票 | 10107 | 数电票(增值税专用发票) | 10108 | 数电票(普通发票) |
| 102015 | 非税收入类票据 | 102020 | 海关专用缴款书 | 102021 | 电子医疗票据 |
| 102018 | 海关进口货物报关单 | 102017 | 海关出口货物报关单 | 10110 | 增值税发票清单 |
| 103015 | 医疗票明细 | 102085 | 货物运输电子收款凭证 |
| 名称 | 分类依据 |
|---|---|
| 区块链电子发票 | 识别类型为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时，视为一次有效查验，计算验真费用，其他值不计费