Appearance
计费说明
计费方式
采用「预付费套餐包」模式,所有接口调用均从账户余额中按次扣除相应次数。
价格套餐
详情咨询客户经理
接口计费明细
发票查验类
接口名称 | 接口路径 | 单次扣费 | 功能描述 |
---|---|---|---|
增值税发票查验 | /v1/check_zzs/info | 1次 | 支持增值税发票全要素查验 |
发票查验-二维码字符串 | /v1/check_zzs/qrcodestr | 1次 | 传入二维码识别后的字符串,即可验证发票真伪,获取发票信息 |
PDF/OFD 发票查验 | /v1/check_fp/pdf | 1.5次 | 传入PDF/OFD文件,即可验证发票真伪,获取发票信息 |
OCR 发票查验 | /v1/check_fp/ocr | 2次 | 传入发票文件图片,即可验证发票真伪,获取发票信息 |
财政票据查验 | /v1/check_czpj/info | 1次 | 支持财政票据全要素查验 |
财政票据查验(明细版) | /v1/check_czpj/info | 1.5次 | 支持财政票据全要素查验,同时返回总局没有的明细 |
扣费规则
1. 计费情况
以下情况会扣费:
- 接口调用成功时扣费(返回值中的
code
为0
)。
OCR 计费规则
- OCR 识别阶段
- 调用接口成功:按标准计费1次。
- 识别失败:不计费。
- 结果查验阶段(需 OCR 识别成功)
- 查验通过:维持原计费标准。
- 查验未通过:系统自动降级为 0.5 次计费。
2. 不计费情况
以下情况不会扣费:
- 调用失败时不扣费(HTTP 状态码非 200)。
- 失败调用不扣费(如入参错误、必要参数未传入等)。
- 查验成功但查无此票,不扣费。
- 查验成功但票据信息与税务数据不一致,不扣费。
- 查验成功但已超过该张发票当日的查验次数(5 次),不扣费。
剩余次数
- 实时显示剩余可用次数(响应头包含
X-Balance: 剩余次数
)
如可用剩余次数为999时展示为: X-Balance: 999
注:当appCode认证通过后才会返回此请求头部
使用示例
假设账户剩余100次:
bash
# 调用普通发票查验(扣1次)
curl -X POST https://fpzwcx.com/v1/check_zzs/info
# 剩余次数:99
# 调用发票OCR接口(扣2次)
curl -X POST https://fpzwcx.com/v1/check_fp/ocr
# 剩余次数:97