유럽 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 - 두 자리 국가 코드
• company_name - 등록된 상호명
• company_address - 공식 등록 주소

5가지 활용 사례

1. 결제 흐름 - B2B 송장의 역청구 메커니즘을 적용하기 전에 실시간으로 VAT 번호를 검증합니다.
2. 송장 자동화 - API 응답에서 회사명과 주소를 자동으로 입력하여 수동 데이터 입력을 줄입니다.
3. 공급업체 온보딩 - 계약 서명 전에 새 공급업체의 VAT 번호가 활성 상태인지 확인합니다.
4. 세금 규정 준수 감사 - 기존 고객 데이터베이스를 일괄 검증하여 만료되거나 유효하지 않은 VAT 번호를 플래그 처리합니다.
5. 다국가 가격 책정 - country_code를 사용하여 EU 회원국 전체의 B2C 고객에 대한 올바른 VAT 세율을 결정합니다.

관련 글

• IBAN 검증: 체크섬 그 이상 - 완전한 B2B 온보딩을 위해 부가가치세 번호와 함께 은행 계좌 검증
• 사기 탐지 파이프라인 구축 - 포괄적인 사기 예방을 위한 결제, 이메일, IP 신호 결합
• Paperclip 자율 회사에서 Veille API 사용하기 - Paperclip 자율 청구 에이전트 내의 VAT 및 IBAN 검증