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.

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

Corporate Financial Reimbursement: When employees submit expense reports, the system automatically calls the API to verify invoice information, preventing duplicate claims or fraudulent invoices.
Supply Chain Settlement Review: Before settling accounts with suppliers, batch verify invoice elements to ensure tax compliance.
Financial and Tax Agency Software: Integrate into accounting software to improve the efficiency of accountants processing invoice vouchers.

Usage Notes and Limitations

The verification results from this API are for information reconciliation reference only and do not constitute final tax or legal conclusions.
Only supports verification of VAT invoices within the specified scope; some special bills or local bills may not be verifiable.
There may be a time delay in verification; invoices issued on the current day might only be verifiable the next day.

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

Documentation

API Capabilities

Request and Response

Use Cases

Usage Notes and Limitations

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online