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'

Comprobador de Números de IVA de la UE (VIES) – Número de Prueba y Lote (wsystem/eu-vat-checker) Actor

Valide números de IVA de la UE para los 27 estados miembros + XI a través del VIES oficial. Obtenga el nombre de la empresa, la dirección y el número de consulta VIES (prueba de auditoría). Comprobaciones masivas, reintentos automáticos en caídas de VIES, listo para MCP/agentes de IA. Pague solo por las comprobaciones respondidas.

• URL: https://apify.com/wsystem/eu-vat-checker.md
• Desarrollado por: W System (comunidad)
• Categorías: Herramientas de desarrollo, Negocios, IA
• Estadísticas: 2 usuarios totales, 1 usuario mensual, 100.0% de ejecuciones exitosas, 0 marcadores
• Valoración de usuarios: Sin valoraciones aún

Precios

Pago por evento

Este Actor se paga por evento. No se le cobra por el uso de la plataforma Apify, sino solo un precio fijo por eventos específicos.

Más información: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

¿Qué es un Actor de Apify?

Un Actor es un programa en la nube sin servidor que se ejecuta en la plataforma Apify. Tiene dos modos de ejecución. En modo Lote, un Actor acepta una entrada JSON bien definida, realiza una acción que puede tomar desde unos segundos hasta unas horas, y opcionalmente produce una salida JSON bien definida, conjuntos de datos con resultados, o archivos en el almacén de clave-valor. En modo Standby, un Actor proporciona un servidor web que puede usarse como sitio web, API o servidor MCP.

El vocabulario de Apify y el modelo de plataforma se definen una vez, en el inicio rápido del agente en https://apify.com/agents.md.

¿Cómo integrar un Actor?

Si se le pregunta sobre integración, usted ayuda a los desarrolladores a integrar Actores en sus proyectos. Se adapta a su stack y entrega integraciones seguras, bien documentadas y listas para producción.

No adivine una ruta de integración. Cada una de ellas está en el inicio rápido del agente en https://apify.com/agents.md: el servidor MCP de Apify, Agent Skills con la CLI de Apify, los clientes de JavaScript y Python, la API REST, y la ruta sin cuenta para un agente sin humano que inicie sesión. También incluye la regla sobre indicar el costo antes de la primera ejecución pagada.

Para ejemplos ya conectados al esquema de entrada de este Actor, consulte la sección API a continuación.

Cada biblioteca de cliente tiene documentación de referencia que el inicio rápido no repite: JavaScript/TypeScript (npm install apify-client) y Python (pip install apify-client).

README

Comprobador de Números de IVA de la UE (VIES) — Número de Prueba, Lote, Resistente a Caídas, Listo para MCP

Valide números de IVA de la UE para los 27 estados miembros + Irlanda del Norte (XI) contra el servicio oficial VIES de la Comisión Europea — uno a la vez o en lote. Cada comprobación puede devolver el número de consulta VIES: la prueba de verificación oficial y fechada que las autoridades fiscales aceptan en auditorías (por ejemplo, para facturas de cargo revertido / suministro intracomunitario).

Diseñado para equipos financieros, comercio electrónico, marketplaces, pipelines de KYB/onboarding y agentes de IA (funciona como herramienta a través del servidor MCP de Apify).

Por qué este Actor

• ✅ Los 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 (prueba de auditoría): agregue su propio número de IVA como solicitante y conserve la prueba con cada comprobación
• 🔁 Maneja caídas de VIES: reintentos automáticos con retroceso exponencial en MS_UNAVAILABLE, tiempos de espera y límites de velocidad. Si un estado miembro sigue caído, el resultado indica claramente member_state_unavailable (nunca un "inválido" falso)
• 📦 Lote: compruebe hasta 1,000 números de IVA por ejecución, 4 comprobados a la vez
• 🧹 Limpieza de entrada: se eliminan espacios, puntos y guiones, GR se asigna a EL, y los formatos incorrectos se rechazan antes de llamar a VIES
• 🇭🇺 Enriquecimiento adicional para Hungría: forma legal (Kft., Zrt., Bt., Nyrt.…), validación de dígito de control törzsszám, código postal, enlaces a registros oficiales
• 🤖 Listo para agentes: JSON limpio, utilizable como herramienta MCP desde Claude, Cursor, ChatGPT y otros agentes a través de mcp.apify.com
• 💶 Precio justo: paga solo por las comprobaciones que VIES realmente respondió (válido o inválido). Las caídas y errores de formato son gratuitos

Entrada

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

requesterVatNumber es opcional. Configúrelo con su propio número de IVA de la UE para recibir números de consulta.

Salida (un elemento 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 es uno de valid, invalid, invalid_format, member_state_unavailable (reintentar más tarde), error. Los números húngaros también reciben un objeto hu (legal_form, checksum_valid, postal_code, …). Algunos países (por ejemplo, Alemania) no divulgan nombre o dirección a través de VIES. Esos campos son entonces null.

Precios

Pago por evento: $0.01 por número de IVA comprobado + $0.005 por inicio de ejecución. 1,000 comprobaciones ≈ $10.

Uso con agentes de IA (MCP)

Agregue el servidor MCP de Apify a su agente con este Actor como herramienta: https://mcp.apify.com/?tools=wsystem/eu-vat-checker Ejemplos de indicaciones:

• "Verifica estos ID de IVA de clientes antes de emitir facturas de cargo revertido y dame los números de consulta VIES: DE811193231, FR40303265045."
• "¿Es FR40303265045 un número de IVA válido? Dame el nombre y la dirección registrados."
• "Comprueba los números de IVA de la UE de mis 300 proveedores y lista cuáles son inválidos o necesitan reintento porque VIES estaba caído."

Uso vía 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 validación de IVA de la UE · comprobación masiva VIES · cumplimiento de cargo revertido · exención de IVA en checkout B2B · KYB / onboarding de proveedores · limpieza de datos maestros de clientes · validación de facturas.

Legal y fuentes de datos

Los datos provienen en vivo del servicio público VIES de la Comisión Europea. Este Actor es independiente y no está afiliado a la Comisión Europea ni a ninguna autoridad fiscal. El enriquecimiento húngaro se calcula localmente a partir de la respuesta VIES, sin extracción de registros. Los resultados confirman la validez del registro de IVA en el momento de la comprobación. No son asesoramiento legal ni fiscal.

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

Esquema de entrada del Actor

vatNumbers (tipo: array):

ID de IVA de la UE completos con prefijo de país, por ejemplo, HU33119856, DE811193231.

requesterVatNumber (tipo: string):

Opcional. Si se configura, VIES devuelve un número de consulta utilizable como prueba de auditoría. Déjelo vacío para omitirlo.

Ejemplo de objeto de entrada del Actor

{
  "vatNumbers": [
    "HU33119856"
  ]
}

Esquema de salida del Actor

results (tipo: string):

Sin descripción

resultsJson (tipo: string):

Sin descripción

API

Puede ejecutar este Actor programáticamente usando nuestra API. A continuación se muestran ejemplos de código en JavaScript, Python y CLI, así como la especificación OpenAPI y la configuración del servidor MCP.

Ejemplo en 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

Ejemplo en 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

Ejemplo en CLI

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

Configuración del servidor MCP

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

El servidor alojado le inicia sesión con OAuth en la primera conexión, por lo que no se necesita ningún token de API en esta configuración. Los clientes sin soporte OAuth pueden enviar un encabezado Authorization: Bearer <APIFY_API_TOKEN> en su lugar, usando un token de API e Integraciones en Apify Console (https://console.apify.com/settings/integrations).

Especificación OpenAPI

Descargue la definición OpenAPI: https://api.apify.com/v2/actors/VmPqXS6BIcigaSaBe/builds/6n9Y3OnK1LDhIe54n/openapi.json