通用电子发票验真
使用说明
统一接口版本号 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": "价税合计",
"kjlx": "1", // 开具类型标识：0委托代开 1自开 2代开 3代办退税
"kprq": "开票日期",
"xfmc": "销方名称",
"xfsbh": "销方识别号"
}
广东-基础信息
{
"cybz": "found", // 查验标志，found-成功
"nsrshxx": "Right", // 纳税人税号信息， Right-一致
"nsrmc": "纳税人名称",
"jshj": "Right" // 价税合计信息，Right-一致
}
错误码定义
参考错误码定义