Escribe el NIF de una sociedad (por ejemplo A46103834) o su NIF-IVA con el prefijo ES: la página forma el número intracomunitario y lo consulta en VIES, el sistema de la Comisión Europea que dice si está dado de alta para operaciones intracomunitarias en el momento de la consulta.
NIF de la sociedad o NIF-IVA (ES…)
curl "https://api.prometiam.com/functions/v1/risk-api/vat/ESA46103834" \ -H "Authorization: Bearer YOUR_API_KEY"
El número de IVA intracomunitario de una sociedad española es su NIF precedido del prefijo ES: el NIF A46103834 da el NIF-IVA ESA46103834. No hay una clave añadida como en Francia, donde se calcula a partir del SIREN; aquí el prefijo basta. El NIF de una sociedad empieza por una letra que indica la forma jurídica (A sociedad anónima, B sociedad de responsabilidad limitada, F cooperativa…), sigue con siete dígitos y termina con un carácter de control, que puede ser un número o una letra.
Que el número esté bien formado no significa que sirva para una operación intracomunitaria. En España una empresa solo tiene un NIF-IVA válido en VIES si está dada de alta en el Registro de Operadores Intracomunitarios (ROI), que se solicita en la declaración censal (modelo 036). Muchas sociedades que solo venden en España no están en el ROI: su NIF es correcto, pero VIES responde que el número no es válido para operaciones intracomunitarias.
Para justificar la exención de una entrega intracomunitaria conviene conservar la consulta: el número comprobado, la fecha y el resultado. La herramienta muestra la fecha que devuelve VIES. Si necesitas un justificante con número de consulta, la web de VIES de la Comisión Europea lo emite cuando indicas tu propio NIF-IVA como solicitante.
Con una clave de API, GET /vat/ESA46103834 consulta VIES y devuelve JSON con is_valid, name, address y request_date. GET /companies/search?country=ES&nif=A46103834 devuelve la ficha de la empresa con su vat_number; para España vat_number_source es rule: el número se forma a partir del NIF y el registro no confirma el alta en el ROI, así que el alta se comprueba en VIES.
curl 'https://api.prometiam.com/functions/v1/risk-api/vat/ESA46103834' \ -H 'Authorization: Bearer rk_live_...' curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&nif=A46103834' \ -H 'Authorization: Bearer rk_live_...'
Cada consulta a VIES y cada búsqueda de empresa correcta cuesta 1 crédito; una consulta que falla no cuesta nada. Para revisar la cartera de clientes de una vez, POST /companies/lookup acepta lotes de NIF (1 crédito por empresa).
Empieza tu prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.