欧州SaaS企業のためのVAT検証

EU内の企業にソフトウェアを販売する場合、VAT番号を検証する必要があります。これを誤ると、課税すべきでない時にVATを請求する（競争力の喪失）か、課税すべき時に請求しない（税務上の責任）かのどちらかになります。Veille VAT検証API（GET /v1/vat）はVIESデータベースに直接接続し、結果をミリ秒単位で返します。

APIが返す内容

任意のEU VAT番号に対して、次のものが得られます：valid（ブール値）、正規化された vat_number、country_code、company_name、company_address。APIはフォーマットの正規化を自動的に処理します - 国プレフィックスあり・なし、スペースあり・なし。

クイック統合

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.veille.io/v1"

response = requests.get(
    f"{BASE_URL}/vat",
    params={"query": "FR40303265045"},
    headers={"x-api-key": API_KEY},
)
data = response.json()

if data["valid"]:
    print(f"{data['company_name']} - reverse charge applies")
else:
    print("Invalid VAT number - charge local VAT rate")

TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.veille.io/v1";
const headers = { "x-api-key": API_KEY };

const response = await fetch(
  `${BASE_URL}/vat?query=FR40303265045`,
  { headers }
);
const data = await response.json();

if (data.valid) {
  console.log(`${data.company_name} - reverse charge applies`);
} else {
  console.log("Invalid VAT number - charge local VAT rate");
}

主要なレスポンスフィールド

• valid - VAT番号がVIESで現在有効かどうか
• vat_number - 正規化されたフォーマット（例：FR40303265045）
• country_code - 2文字の国コード
• company_name - 登録された商号
• company_address - 公式登録住所

5つのユースケース

1. チェックアウトフロー - B2B請求書の逆請求メカニズムを適用する前に、リアルタイムでVAT番号を検証します。
2. 請求書自動化 - APIレスポンスから会社名と住所を自動入力して手動データ入力を削減します。
3. サプライヤーオンボーディング - 契約締結前に新規ベンダーのVAT番号が有効かどうかを確認します。
4. 税務コンプライアンス監査 - 既存の顧客データベースを一括検証して、期限切れまたは無効なVAT番号をフラグ付けします。
5. 多国籍価格設定 - country_code を使用してEU加盟国全体のB2C顧客に対する正しいVAT税率を決定します。

関連記事

• IBANバリデーション：単なるチェックサム以上のもの - 完全なB2BオンボーディングのためにVAT番号とともに銀行口座を検証
• 不正検出パイプラインの構築 - 包括的な不正防止のための支払い、メール、IPシグナルの組み合わせ

関連記事

• IBANバリデーション：単なるチェックサム以上のもの - 完全なB2BオンボーディングのためにVAT番号とともに銀行口座を検証
• 不正検出パイプラインの構築 - 包括的な不正防止のための支払い、メール、IPシグナルの組み合わせ
• PaperclipのAI自律企業でVeille APIを使う - Paperclipの自律的な請求エージェント内でのVATとIBAN検証