通用电子发票验真
使用说明
统一接口版本号 v2
八戒财税提供通用电子发票验真接口，以下区划的通用电子发票：
| 地区 |
|---|
| 浙江 、 广东 |
接口列表和资费
接口通常分为 3 步：
- 预处理：参数校验等
- 发票查验：同步查询官方平台信息
- 格式化数据：返回格式化数据结果
TIP
接口响应结果返回success: true才计费
不同接口单次请求成功消耗的资源点数不同，具体如下
| 接口路径 | 消耗资源点 | 功能 | 描述 |
|---|---|---|---|
| /v2/tyInvoice/query | 1 | 基础查验 | 基础查验结果 |
浙江-基础查验
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fpdm | String | 是 | 发票代码(8位、10位、12位纯数字的字符串) |
| fphm | String | 是 | 发票号码(8位、10位纯数字的字符串) |
| xfsbh | String | 是 | 销方识别号 |
| kprq | String | 是 | 开票日期,建议格式YYYYMMDD |
| jshj | String | 是 | 价税合计 |
| dq | String | 是 | 地区代码，默认值3300 |
广东-基础查验
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| fpdm | String | 是 | 发票代码(10位、12位纯数字的字符串) |
| fphm | String | 是 | 发票号码(8位纯数字的字符串) |
| xfsbh | String | 否 | 销方识别号 |
| jshj | String | 否 | 价税合计 |
| dq | String | 是 | 地区代码，默认值4400 |
响应结果
浙江-基础信息
{
"dq": "浙江",
"fpdm": "发票代码",
"fphm": "发票号码",
"fplbmc": "电子发票", // 发票类别名称
"fpzt": "0", // (String 0 未作废|2 已作废|3 红冲发票|7 部分冲红|8 全额冲红)
"gfmc": "购方名称",
"gfsbh": "购方识别号",
"jshj": "价税合计",
"kprq": "开票日期",
"xfmc": "销方名称",
"xfsbh": "销方识别号"
}
广东-基础信息
{
"fpxx": [
{
"xfsbh": "销方识别号",
"xfmc": "销方名称",
"fpzlDm": "发票种类代码",
"fpzlmc": "发票种类名称",
"fpdm": "发票代码",
"fpqshm": "号码批次起始号",
"fpzzhm": "号码批次截止号",
"fphm": "发票号码",
"lyrq": "录入日期"
}
]
}
错误码定义
参考错误码定义