GET公開中invoice-check

請求書情報検証

請求書コード、番号、日付、金額、小切手コード、その他の情報を送信して VAT 請求書の信頼性を確認し、請求書の種類と販売者情報を返して財務コンプライアンスのレビューに役立てます。

導入ドキュメント

インターフェース機能

請求書情報検証 API は、VAT 請求書の基本情報の検証をサポートします。請求書の主要な要素を入力すると、インターフェースは請求書の検証結果 (検証に合格したなど) をフィードバックし、請求書の種類や販売者の名前などの情報を返すことができます。このインターフェイスは、企業の財務担当者や自動システムによる請求書情報の事前検証を支援し、財務コンプライアンスのリスクを軽減するように設計されています。

リクエストと返却

リクエストパラメータ: invoiceCode (請求書コード)、invoiceNo (請求書番号)、invoiceDate (請求日、形式 YYYY-MM-DD)、invoiceAmt (請求書金額、税抜き)、および verCode (チェックコードの最後の 6 桁) など、請求書のコア要素を指定する必要があります。
結果を返す: 返されたデータの result フィールドは検査ステータス (「検証合格」など) を示し、また invoiceType (一般的な VAT 請求書などの請求書タイプ) および seller (販売者名) も提供します。
失敗のトラブルシューティング: 検証に失敗した場合は、入力したパラメータがチケットの表面と完全に一致しているかどうか、特に日付形式と金額 (税額が含まれているかどうか) を注意深く確認してください。

使用シナリオ

企業の財務償還: 従業員が償還フォームを送信すると、システムは自動的にインターフェースを呼び出して請求書情報を確認し、繰り返しの償還や虚偽の請求書を防止します。
サプライチェーン決済レビュー: サプライヤーと決済する前に、請求書の要素をバッチチェックして税務コンプライアンスを確認します。
財務および税務代理ソフトウェア: 会計ソフトウェアに統合され、会計担当者の請求伝票処理の効率が向上します。

指示と制限事項

このインターフェースの検証結果は情報検証の参考のみを目的としており、最終的な税金や法的な結論としては機能しません。
指定された範囲内の VAT 請求書のみが検査対象となります。一部の特別紙幣や地方紙幣などは閲覧できない場合があります。
検証には一定の時間遅れが生じます。同日に発行された請求書は、翌日まで確認できない場合があります。

実装サンプルコード

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 例

オンライン試用