Validador de NIF español drop-in

curl -X POST https://app.beel.es/api/v1/nif/validate \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{ "nif": "B12345678" }'

Los ejemplos usan el prefijo beel_sk_test_ — puedes probarlos tal cual en sandbox.

1. 1

   Crea una API key de test

   Regístrate en app.beel.es, abre 'Developer settings' y genera una key con prefijo beel_sk_test_.

   .env

   BEEL_API_KEY=beel_sk_test_a1b2c3d4e5f6g7h8

2. 2

   Haz tu primera llamada con cURL

   Lanza un POST /nif/validate con un NIF de ejemplo para comprobar que todo responde antes de tocar tu código.

   cURL

   curl -X POST https://app.beel.es/api/v1/nif/validate \
     -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
     -H "Content-Type: application/json" \
     -d '{ "nif": "B12345678" }'

3. 3

   Conéctalo a tu formulario o checkout

   En el handler de submit, llama al endpoint y bloquea el formulario si el status no es VALID.

   Node.js / TypeScript

   // Plain fetch — no SDK required for a single endpoint
   const res = await fetch(
     'https://app.beel.es/api/v1/nif/validate',
     {
       method: 'POST',
       headers: {
         'Authorization': 'Bearer beel_sk_test_a1b2c3d4e5f6g7h8',
         'Content-Type': 'application/json',
       },
       body: JSON.stringify({ nif: 'B12345678' }),
     },
   );
   
   const { data } = await res.json();
   // data.status: 'VALID' | 'INVALID' | 'PENDING'
   if (data.status === 'VALID') {
     console.log('NIF válido — se puede facturar a este cliente');
   }

4. 4

   Pasa a producción

   Sustituye tu key por una con prefijo beel_sk_live_ y despliega. El mismo código, la misma URL base.