EU VAT, Company Registry & Tenders MCP (W System)

npx add-mcp 'https://mcp.apify.com?tools=wsystem/eu-vat-checker,wsystem/european-company-registry,wsystem/eu-tenders-search'

Verificador de Número de IVA da UE (VIES) – Número de Comprovante e Lote (wsystem/eu-vat-checker) Actor

Valide números de IVA da UE para todos os 27 estados-membros + XI via VIES oficial. Obtenha nome da empresa, endereço e o número de consulta VIES (comprovante de auditoria). Verificações em lote, tentativas automáticas em indisponibilidades do VIES, pronto para MCP/agentes de IA. Pague apenas por verificações respondidas.

• URL: https://apify.com/wsystem/eu-vat-checker.md
• Desenvolvido por: W System (comunidade)
• Categorias: Ferramentas de desenvolvedor, Negócios, IA
• Estatísticas: 2 usuários no total, 1 usuário mensal, 100,0% de execuções bem-sucedidas, 0 favoritos
• Avaliação dos usuários: Sem avaliações ainda

Preços

Pague por evento

Este Actor é pago por evento. Você não é cobrado pelo uso da plataforma Apify, mas apenas por um preço fixo para eventos específicos.

Saiba mais: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

O que é um Actor da Apify?

Um Actor é um programa em nuvem serverless que roda na plataforma Apify. Ele tem dois modos de execução. No modo Lote, um Actor aceita uma entrada JSON bem definida, executa uma ação que pode levar de alguns segundos a algumas horas, e opcionalmente produz uma saída JSON bem definida, conjuntos de dados com resultados, ou arquivos em key-value store. No modo Standby, um Actor fornece um servidor web que pode ser usado como site, API ou servidor MCP.

O vocabulário da Apify e o modelo da plataforma são definidos uma vez, no quickstart para agentes em https://apify.com/agents.md.

Como integrar um Actor?

Se perguntado sobre integração, você ajuda desenvolvedores a integrar Actors em seus projetos. Você se adapta à stack deles e entrega integrações seguras, bem documentadas e prontas para produção.

Não adivinhe um caminho de integração. Cada um deles está no quickstart para agentes em https://apify.com/agents.md: o servidor MCP da Apify, Agent Skills com a CLI da Apify, os clientes JavaScript e Python, a API REST e o caminho sem conta para um agente sem humano para fazer login. Também contém a regra sobre informar o custo antes da primeira execução paga.

Para exemplos já conectados ao próprio esquema de entrada deste Actor, veja a seção API abaixo.

Cada biblioteca de cliente tem documentação de referência que o quickstart não repete: JavaScript/TypeScript (npm install apify-client) e Python (pip install apify-client).

README

Verificador de Número de IVA da UE (VIES) — Número de Comprovante, Lote, À Prova de Indisponibilidade, Pronto para MCP

Valide números de IVA da UE para todos os 27 estados-membros + Irlanda do Norte (XI) no serviço oficial VIES da Comissão Europeia — um por vez ou em lote. Cada verificação pode retornar o número de consulta VIES: o comprovante oficial e datado de verificação que as autoridades fiscais aceitam em auditorias (por exemplo, para faturas de reverse-charge / fornecimento intracomunitário).

Feito para equipes financeiras, e-commerce, marketplaces, pipelines de KYB/onboarding e agentes de IA (funciona como ferramenta através do servidor MCP da Apify).

Por que este Actor

• ✅ Todos os 28 países VIES: AT, BE, BG, CY, CZ, DE, DK, EE, EL/GR, ES, FI, FR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK, XI
• 🧾 Número de consulta (comprovante de auditoria): adicione seu próprio número de IVA como solicitante e mantenha o comprovante com cada verificação
• 🔁 Lida com indisponibilidades do VIES: tentativas automáticas com backoff exponencial em MS_UNAVAILABLE, timeouts e limites de taxa. Se um estado-membro ainda estiver fora do ar, o resultado indica claramente member_state_unavailable (nunca um "inválido" falso)
• 📦 Lote: verifique até 1.000 números de IVA por execução, 4 verificados por vez
• 🧹 Limpeza de entrada: espaços, pontos e hífens são removidos, GR é mapeado para EL, e formatos incorretos são rejeitados antes de chamar o VIES
• 🇭🇺 Enriquecimento extra para Hungria: forma jurídica (Kft., Zrt., Bt., Nyrt.…), validação de dígito verificador do törzsszám, código postal, links para registros oficiais
• 🤖 Pronto para agentes: JSON limpo, utilizável como ferramenta MCP a partir de Claude, Cursor, ChatGPT e outros agentes via mcp.apify.com
• 💶 Preço justo: você paga apenas por verificações que o VIES realmente respondeu (válido ou inválido). Indisponibilidades e erros de formato são gratuitos

Entrada

{ "vatNumbers": ["HU33119856", "IE6388047V", "DE811193231"], "requesterVatNumber": "HU33119856" }

requesterVatNumber é opcional. Defina-o com seu próprio número de IVA da UE para receber números de consulta.

Saída (um item por número de IVA)

{
  "vat": "IE6388047V", "country_code": "IE", "status": "valid", "valid": true,
  "name": "GOOGLE IRELAND LIMITED",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "request_date": "2026-10-15T12:25:47.434Z",
  "consultation_number": "WAPIAAAAaE_hpYRy",
  "source": "VIES (European Commission)"
}

status é um de valid, invalid, invalid_format, member_state_unavailable (tentar novamente mais tarde), error. Números húngaros também recebem um objeto hu (legal_form, checksum_valid, postal_code, …). Alguns países (por exemplo, Alemanha) não divulgam nome ou endereço através do VIES. Esses campos então ficam como null.

Preços

Pague por evento: $0,01 por número de IVA verificado + $0,005 por início de execução. 1.000 verificações ≈ $10.

Uso com agentes de IA (MCP)

Adicione o servidor MCP da Apify ao seu agente com este Actor como ferramenta: https://mcp.apify.com/?tools=wsystem/eu-vat-checker Exemplos de prompts:

• "Verifique estes IDs de IVA de clientes antes de eu emitir faturas reverse-charge e me dê os números de consulta VIES: DE811193231, FR40303265045."
• "FR40303265045 é um número de IVA válido? Dê-me o nome e endereço registrados."
• "Verifique os números de IVA da UE dos meus 300 fornecedores e liste quais são inválidos ou precisam de nova tentativa porque o VIES estava fora do ar."

Uso via API

curl -X POST "https://api.apify.com/v2/acts/wsystem~eu-vat-checker/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" -d '{"vatNumbers":["HU33119856"]}'

Casos de uso

API de validação de IVA da UE · verificação em lote VIES · conformidade reverse-charge · isenção de IVA no checkout B2B · KYB / onboarding de fornecedores · limpeza de dados mestre de clientes · validação de faturas.

Legal e fontes de dados

Os dados vêm ao vivo do serviço público VIES da Comissão Europeia. Este Actor é independente e não é afiliado à Comissão Europeia ou a qualquer autoridade fiscal. O enriquecimento húngaro é calculado localmente a partir da resposta do VIES, sem raspagem de registros. Os resultados confirmam a validade do registro de IVA no momento da verificação. Não são aconselhamento jurídico ou fiscal.

Editor: W System Hungary Kft. (IVA UE HU33119856).

Esquema de entrada do Actor

vatNumbers (tipo: array):

IDs de IVA completos da UE com prefixo do país, ex.: HU33119856, DE811193231.

requesterVatNumber (tipo: string):

Opcional. Se definido, o VIES retorna um número de consulta utilizável como comprovante de auditoria. Deixe vazio para pular.

Exemplo de objeto de entrada do Actor

{
  "vatNumbers": [
    "HU33119856"
  ]
}

Esquema de saída do Actor

results (tipo: string):

Sem descrição

resultsJson (tipo: string):

Sem descrição

API

Você pode executar este Actor programaticamente usando nossa API. Abaixo estão exemplos de código em JavaScript, Python e CLI, bem como a especificação OpenAPI e a configuração do servidor MCP.

Exemplo em JavaScript

import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "vatNumbers": [
        "HU33119856"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("wsystem/eu-vat-checker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

Exemplo em Python

from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "vatNumbers": ["HU33119856"] }

# Run the Actor and wait for it to finish
run = client.actor("wsystem/eu-vat-checker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

Exemplo em CLI

echo '{
  "vatNumbers": [
    "HU33119856"
  ]
}' |
apify call wsystem/eu-vat-checker --silent --output-dataset

Configuração do servidor MCP

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,wsystem/eu-vat-checker"
        }
    }
}

O servidor hospedado faz login com OAuth na primeira conexão, então nenhum token de API pertence a esta configuração. Clientes sem suporte a OAuth podem enviar um cabeçalho Authorization: Bearer <APIFY_API_TOKEN> em vez disso, usando um token de API e Integrações no Console da Apify (https://console.apify.com/settings/integrations).

Especificação OpenAPI

Baixe a definição OpenAPI: https://api.apify.com/v2/actors/VmPqXS6BIcigaSaBe/builds/6n9Y3OnK1LDhIe54n/openapi.json