Fiskaly Validar NIF

Descripción

Este modulo permite validar un número de identificación fiscal (TIN - Tax Identification Number) utilizando la API de Fiskaly. Acepta formatos NIF, CIF y NIE espanoles, así como números fiscales de otros paises configurando el country_code.

La validación se realiza mediante un POST a la API de Fiskaly que verifica la estructura y validez del número fiscal proporcionado. El resultado indica si el número es valido o no, junto con detalles adicionales.

El modulo es de tipo hidden (oculto en la interfaz principal).

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Fiskaly
tin	text	Si	Número de identificación fiscal a validar (NIF/CIF/NIE)
country_code	text	No	Código ISO del pais (default: ES)

Credenciales

Requiere credenciales de tipo Fiskaly con:

• api_key: API Key de Fiskaly
• api_secret: API Secret de Fiskaly

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "valid": true,
    "tin": "B12345678",
    "details": { "...detalles de la validacion..." },
    "message": "NIF/CIF B12345678 es valido"
  }
}

Si no es valido:

{
  "nextModule": "siguiente_modulo",
  "data": {
    "success": true,
    "valid": false,
    "tin": "XINVALIDO",
    "details": { "...detalles del error..." },
    "message": "NIF/CIF XINVALIDO no es valido"
  }
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi-fiskaly",
  "tin": "B12345678",
  "country_code": "ES"
}

API Utilizada

• Fiskaly SIGN ES API - POST /validation/tin

Notas

• El código de pais por defecto es ES (Espana)
• Soporta NIF (personas fisicas), CIF (personas juridicas) y NIE (extranjeros)
• Útil como paso previo antes de crear un contribuyente o cliente para asegurar datos correctos
• Un resultado valid: true no garantiza que el NIF este activo en la AEAT, solo valida el formato

Nodos Relacionados

• FiskalyUpsertTaxpayer - Crear/actualizar contribuyente
• FiskalyUpsertClient - Crear/actualizar dispositivo