API RIF Venezuela
Validación de RIF venezolano (V/E/J/G/P) con verificación del dígito verificador.
Valida identificadores fiscales venezolanos en tu app, ERP o formulario web. Verificación matemática del DV, soporte para todos los tipos de contribuyente, JSON estable.
Datos validados con normadata.io — el algoritmo de validación de RIF proviene de normadata.io, la base de utilities de validación fiscal para LATAM. Para validación de CUIT, NIT, CPF, RFC y otros identificadores de la región, visita normadata.io.
Endpoint
POST /v1/rif/validateValida el formato y el dígito verificador de un RIF venezolano. Devuelve el tipo de contribuyente, el DV esperado y si el identificador es matemáticamente válido.
Request y respuesta
Request body (JSON)
{
"rif": "J-30123456-7"
}Respuesta exitosa (200)
{
"rif": "J-30123456-7",
"valid": true,
"type": "J",
"type_label": "Persona jurídica",
"digits": "30123456",
"dv": "7",
"dv_expected": "7"
}Respuesta con DV incorrecto
{
"rif": "J-30123456-0",
"valid": false,
"type": "J",
"type_label": "Persona jurídica",
"digits": "30123456",
"dv": "0",
"dv_expected": "7",
"error": "invalid_dv"
}Tipos de RIF venezolano
| Prefijo | Tipo | Ejemplo | Descripción |
|---|---|---|---|
| V | Persona natural venezolana | V-12.345.678-9 | Venezolano mayor de edad con cédula de identidad. |
| E | Persona natural extranjera | E-87.654.321-3 | Extranjero residente con carnet de extranjería. |
| J | Persona jurídica / empresa | J-30.123.456-7 | Compañía anónima, SRL, asociación civil u otra persona jurídica. |
| G | Organismo gubernamental | G-20.000.001-2 | Entidades del Estado venezolano, ministerios, institutos autónomos. |
| P | Persona natural (pasaporte) | P-AB1234567-5 | Extranjero sin carnet de extranjería, identificado con pasaporte. |
La API acepta el RIF con o sin guiones y con el prefijo en mayúsculas o minúsculas.
Snippets de integración
cURL
curl -X POST https://api.cotizave.com/v1/rif/validate \
-H "X-API-Key: ctz_live_••••••" \
-H "Content-Type: application/json" \
-d '{"rif": "J-30123456-7"}'JavaScript / Node.js
const res = await fetch('https://api.cotizave.com/v1/rif/validate', {
method: 'POST',
headers: {
'X-API-Key': 'ctz_live_••••••',
'Content-Type': 'application/json',
},
body: JSON.stringify({ rif: 'J-30123456-7' }),
})
const data = await res.json()
console.log(data.valid, data.type_label) // true, "Persona jurídica"PHP
<?php
$ch = curl_init('https://api.cotizave.com/v1/rif/validate');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'X-API-Key: ctz_live_••••••',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['rif' => 'J-30123456-7']),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
var_dump($body['valid']); // bool(true)Python
import requests
r = requests.post(
'https://api.cotizave.com/v1/rif/validate',
headers={'X-API-Key': 'ctz_live_••••••'},
json={'rif': 'J-30123456-7'},
)
data = r.json()
print(data['valid'], data['type_label']) # True, Persona jurídicaValidación matemática
El DV se verifica con el algoritmo estándar antes de que el dato llegue a tu base de datos.
Todos los tipos
V, E, J, G y P — un solo endpoint cubre personas naturales, jurídicas y organismos.
Respuesta inmediata
Sin consultas externas al SENIAT. La validación es local, la respuesta llega en milisegundos.
Casos de uso
Formularios web
Valida el RIF en tiempo real antes del submit.
ERPs / CRMs
Garantiza la integridad de datos de clientes y proveedores.
Facturación
Rechaza facturas con RIF matemáticamente inválido.
KYC / Onboarding
Primer filtro antes de validaciones más costosas.
¿Necesitas validar CUIT, NIT, CPF u otros identificadores LATAM?
Cotizave cubre Venezuela. Para validación de identificadores fiscales del resto de América Latina (Argentina, Colombia, Brasil, México, Chile, Perú), el proveedor especializado es normadata.io, la base de utilities de validación fiscal para LATAM.
Ver normadata.io — validación LATAM completa ↗Preguntas frecuentes
¿Qué es el RIF en Venezuela?
El RIF (Registro de Información Fiscal) es el identificador tributario venezolano emitido por el SENIAT. Identifica a personas naturales, jurídicas, organismos gubernamentales y entidades del Estado ante la administración tributaria.
¿Qué tipos de RIF existen?
El RIF venezolano tiene cinco tipos según el prefijo: V (persona natural venezolana), E (persona natural extranjera), J (persona jurídica / empresa), G (organismo gubernamental) y P (pasaporte para personas naturales extranjeras).
¿Cómo funciona la validación matemática del RIF?
El dígito verificador (DV) se calcula a partir de los 8 dígitos numéricos usando una fórmula estándar que asigna pesos a cada posición y aplica aritmética modular. Si el DV calculado no coincide con el DV del RIF ingresado, el identificador es inválido.
¿La API valida contra el SENIAT?
No. La API realiza validación matemática del formato y el dígito verificador. No consulta la base de datos del SENIAT ni verifica si el RIF está activo o dado de baja.
¿Cuántas validaciones incluye el plan gratis?
El plan gratis incluye 1.500 llamadas por mes sin tarjeta de crédito. Suficiente para proyectos en etapa de desarrollo o uso esporádico.
¿Puedo validar un RIF sin API key?
No. El endpoint requiere un header X-API-Key. La key gratuita se genera en app.cotizave.com en menos de dos minutos.