Skip to main content

はじめに

VAT検証エンドポイント

VAT番号の真正性を検証し、国、企業名、住所、登録詳細を含む包括的な企業情報を取得します。

VAT計算エンドポイント

国別の規制、購入タイプ、取引金額に基づいてVAT準拠の価格を計算し、正確な財務計算を実現します。

VATカテゴリエンドポイント

特定の国における現在のVAT税率と税カテゴリにアクセスし、現地の税規制へのコンプライアンスを確保します。

RESTアーキテクチャ

VAT検証APIはRESTの原則に従い、予測可能なリソース指向のURLと標準的なHTTPステータスコードを使用して、シームレスな統合とエラーハンドリングを実現します。すべてのAPIエンドポイントは末尾スラッシュ(/)で終わる必要があり、GETリクエストのみをサポートします。

HTTPSセキュリティ

すべてのAPI通信はTLS 1.2以上の暗号化プロトコルで保護され、データの完全性とプライバシーが確保されます。

APIバージョン管理

VAT検証APIはバージョン管理により後方互換性を維持しており、現在はバージョン1で稼働し、将来の機能強化が計画されています。

認証

APIキーはVAT検証APIにアクセスするための唯一の認証情報です。Cleariflowの各サービスには固有のキーが必要であり、異なるAPI間で安全かつ分離されたアクセスが保証されます。APIはすべてのユーザーに公平な利用を確保するため、レート制限を実装しています。

レスポンスおよびエラーコード

リクエストが失敗した場合、APIは効果的なトラブルシューティングのために、特定のコードと説明を含む構造化されたJSONエラーレスポンスを返します。

国コード

以下はVATエンドポイントがサポートする国のリストです。