Forma, dígito de control, ejemplos aceptados y rechazados y la llamada a la API para NIF / CIF en España. Cada ejemplo de esta página pasa por los mismos validadores que el validador gratuito de identificadores, así que un valor aceptado aquí es un valor que el validador acepta.
| Campo | Valor |
|---|---|
| Registro | Registro Mercantil (BORME) |
| Forma | L N{7} C |
| Dígito de control | Obligatorio. Las posiciones impares de los 7 dígitos se duplican (un producto mayor que 9 pierde 9) y el resto se suma; control = (10 - suma mod 10) mod 10, escrito como ese dígito o como su letra (J A B C D E F G H I). |
| Ejemplo resuelto (aceptado) | A28015865 |
| Forma normalizada | A28015865 |
| También se acepta como entrada | A-28015865 |
| Un error de un carácter | A28015866 se rechaza |
| Regex (forma normalizada) | ^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$ |
| Llamada a la API | GET /companies/search?country=ES&company_number=A28015865 · lo recibe también nif= |
| Número de IVA | ES + NIF — construido a partir del identificador por regla; el alta no está confirmada |
La primera letra es la forma jurídica (A sociedad anónima, B sociedad limitada). Un DNI o NIE personal tiene otro control (una letra mod 23) y no es un identificador de empresa: la API lo rechaza.
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&company_number=A28015865" \ -H "Authorization: Bearer YOUR_API_KEY"
Notación de la forma: N dígito · L letra · X dígito o letra · C dígito o carácter de control · {n} se repite n veces.
Una forma y un dígito de control válidos demuestran que el número está bien formado, no que una empresa lo tenga. Eso solo lo responde una consulta al registro.
Los datos del registro que la API sirve para España llevan esta atribución:
Based on data from the Agencia Estatal Boletín Oficial del Estado (BORME)
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.