GET已开放invoice-check

发票信息查验

提交发票代码、号码、日期、金额及校验码等信息，验证增值税发票的真伪，并返回发票类型与销售方信息，辅助财务合规审核。

接入文档

接口能力

发票信息查验 API 支持对增值税发票的基础信息进行核验。通过输入发票票面上的关键要素，接口可反馈该发票的查验结果（如验证通过），并返回发票类型及销售方名称等信息。本接口旨在辅助企业财务人员或自动化系统进行发票信息的初步核对，降低财务合规风险。

请求与返回

请求参数：需提供发票票面上的核心要素，包括 invoiceCode（发票代码）、invoiceNo（发票号码）、invoiceDate（开票日期，格式 YYYY-MM-DD）、invoiceAmt（开票金额，不含税）以及 verCode（校验码后六位）。
返回结果：返回数据中 result 字段指示查验状态（如“验证通过”），同时提供 invoiceType（发票类型，如增值税普通发票）和 seller（销售方名称）。
失败排查：若验证失败，请仔细核对输入的各项参数是否与票面完全一致，特别是日期格式和金额（是否包含税额）。

使用场景

企业财务报销：员工提交报销单时，系统自动调用接口查验发票信息，防止重复报销或虚假发票。
供应链结算审核：在与供应商进行账务结算前，批量核对发票要素，确保税务合规。
财税代理软件：集成至代账软件中，提升会计人员处理发票凭证的效率。

使用说明与限制

本接口查验结果仅供信息核对参考，不作为最终的税务或法律结论。
仅支持查验规定范围内的增值税发票，部分特殊票据或地方性票据可能无法查验。
查验存在一定的时间延迟，当日开具的发票可能需要次日才能查验到结果。

接入示例代码

提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。

请求示例

{
  "invoiceCode": "044001900111",
  "invoiceNo": "00012345",
  "invoiceDate": "2024-01-01",
  "invoiceAmt": "100.00",
  "verCode": "123456"
}

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "验证通过",
    "invoiceType": "增值税普通发票",
    "seller": "阿里巴巴(中国)有限公司"
  }
}

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
invoiceCode	string	044001900111
invoiceNo	string	00012345
invoiceDate	string	2024-01-01
invoiceAmt	string	100.00
verCode	string	123456

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	验证通过
data.invoiceType	string	增值税普通发票
data.seller	string	阿里巴巴(中国)有限公司

curl --request GET \ --url 'https://openapi.toolkk.com/v1/invoice-check' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "invoiceCode": "044001900111",\n "invoiceNo": "00012345",\n "invoiceDate": "2024-01-01",\n "invoiceAmt": "100.00",\n "verCode": "123456"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/invoice-check" payload = { "invoiceCode": "044001900111", "invoiceNo": "00012345", "invoiceDate": "2024-01-01", "invoiceAmt": "100.00", "verCode": "123456" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.get(url, headers=headers, params=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/invoice-check" payload := []byte("{\n \"invoiceCode\": \"044001900111\",\n \"invoiceNo\": \"00012345\",\n \"invoiceDate\": \"2024-01-01\",\n \"invoiceAmt\": \"100.00\",\n \"verCode\": \"123456\"\n}") req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"invoiceCode\": \"044001900111\",\n \"invoiceNo\": \"00012345\",\n \"invoiceDate\": \"2024-01-01\",\n \"invoiceAmt\": \"100.00\",\n \"verCode\": \"123456\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/invoice-check")) .method("GET", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/invoice-check'; $payload = "{\n \"invoiceCode\": \"044001900111\",\n \"invoiceNo\": \"00012345\",\n \"invoiceDate\": \"2024-01-01\",\n \"invoiceAmt\": \"100.00\",\n \"verCode\": \"123456\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

发票信息查验

接入文档

接口能力

请求与返回

使用场景

使用说明与限制

接入示例代码

请求示例

响应示例

请求字段

响应字段

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例

在线调试