GETPublicinvoice-check

Invoice Verification

Submit invoice code, number, date, amount, and verification code to validate the authenticity of VAT invoices, returning invoice type and seller information to assist financial compliance review.

Usage Cost

40 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

The Invoice Information Verification API supports the verification of basic information for VAT invoices. By inputting key elements from the invoice face, the API can provide the verification result (e.g., verification passed) and return information such as the invoice type and seller name. This API aims to assist corporate finance personnel or automated systems in preliminary invoice information reconciliation, reducing financial compliance risks.

Request and Response

Request Parameters: Core elements from the invoice face must be provided, including invoiceCode (invoice code), invoiceNo (invoice number), invoiceDate (invoice date, format YYYY-MM-DD), invoiceAmt (invoice amount, excluding tax), and verCode (last six digits of the verification code).
Return Results: In the returned data, the result field indicates the verification status (e.g., "Verification Passed"), while also providing invoiceType (invoice type, such as VAT ordinary invoice) and seller (seller name).
Troubleshooting Failures: If verification fails, please carefully check if all input parameters exactly match those on the invoice, especially the date format and amount (whether it includes tax).

Use Cases

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

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

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
invoiceCode	string	044001900111
invoiceNo	string	00012345
invoiceDate	string	2024-01-01
invoiceAmt	string	100.00
verCode	string	123456

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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;

Invoice Verification

Try it online

Documentation

API Capabilities

Request and Response

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Usage Notes and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example