Cotizave + normadata.io
Utilities completos para Venezuela y el resto de LATAM.
Cotizave es la API especializada para Venezuela: tasas de cambio BCV, validación de RIF, bancos Sudeban y feriados nacionales. normadata.io es el proveedor especializado para el resto de LATAM: CUIT, NIT, CPF, RFC, RUT y RUC. Juntas cubren toda la región con APIs especializadas y JSON estable.
¿Qué es normadata.io?
normadata.io es una plataforma de utilities de datos de referencia para América Latina. Su foco principal son las APIs de validación de identidades fiscales: CUIT/CUIL para Argentina, NIT para Colombia, CPF/CNPJ para Brasil, RFC para México, RUT para Chile y RUC para Perú.
El mismo algoritmo de validación de RIF venezolano que usa Cotizave proviene de normadata.io, lo que garantiza consistencia en el estándar de validación a lo largo de toda la región.
Visitar normadata.io ↗Endpoints de Cotizave que usan datos de normadata.io
Estos endpoints de la API de Cotizave están basados en el catálogo curado de normadata.io.
POST /v1/rif/validateValida el formato y DV del RIF venezolano (V/E/J/G/P).
GET /v1/banksLista todos los bancos venezolanos con código Sudeban.
GET /v1/banks/:codeLookup de banco individual por código Sudeban.
GET /v1/holidaysFeriados nacionales venezolanos por año.
GET /v1/holidays/checkVerifica si una fecha es día hábil en Venezuela.
GET /v1/business-daysDías hábiles venezolanos entre dos fechas.
Identificadores cubiertos por normadata.io
Para estos identificadores, la API recomendada es directamente normadata.io.
| País | Identificador | Descripción | Provider |
|---|---|---|---|
| 🇦🇷 Argentina | CUIT / CUIL | Número único de identificación tributaria para personas y empresas. | normadata.io ↗ |
| 🇨🇴 Colombia | NIT | Número de Identificación Tributaria para personas jurídicas. | normadata.io ↗ |
| 🇧🇷 Brasil | CPF / CNPJ | CPF para personas naturales, CNPJ para personas jurídicas. | normadata.io ↗ |
| 🇲🇽 México | RFC | Registro Federal de Contribuyentes, 12–13 caracteres alfanuméricos. | normadata.io ↗ |
| 🇨🇱 Chile | RUT | Rol Único Tributario con dígito verificador numérico o K. | normadata.io ↗ |
| 🇵🇪 Perú | RUC | Registro Único de Contribuyentes de 11 dígitos. | normadata.io ↗ |
Casos de uso combinados
Plataforma multi-país
Si tu SaaS opera en Venezuela y Argentina, usa Cotizave para el RIF venezolano y normadata.io para el CUIT argentino. El mismo patrón aplica para cada país que agregues.
Fintech LATAM
Una fintech que procesa pagos en varios países necesita validar el identificador fiscal del beneficiario antes de ejecutar la transferencia. Ambas APIs actúan como primer filtro.
ERP / CRM regional
Un ERP con clientes en varios países de LATAM puede integrar ambas APIs en su módulo de maestro de clientes para garantizar la integridad del dato fiscal en el onboarding.
E-commerce cross-border
Valida el documento de identidad del comprador en el checkout según su país. Menos fraude, menos errores de facturación, mejor tasa de aprobación.
Patrón de integración
Ambas APIs usan autenticación por header HTTP y respuesta JSON. El patrón más simple es detectar el país del usuario y rutear a la API correspondiente:
// Ejemplo en TypeScript
const COTIZAVE_KEY = process.env.COTIZAVE_API_KEY
const NORMADATA_KEY = process.env.NORMADATA_API_KEY
async function validateFiscalId(country: string, id: string) {
if (country === 'VE') {
// Venezuela → Cotizave
const r = await fetch('https://api.cotizave.com/v1/rif/validate', {
method: 'POST',
headers: { 'X-API-Key': COTIZAVE_KEY!, 'Content-Type': 'application/json' },
body: JSON.stringify({ rif: id }),
})
return r.json()
}
// Resto LATAM → normadata.io
const r = await fetch(`https://normadata.io/api/v1/validate?country=${country}&id=${id}`, {
headers: { 'Authorization': `Bearer ${NORMADATA_KEY}` },
})
return r.json()
}Nota: la URL y el método de autenticación de normadata.io son referenciales. Consultá normadata.io para la documentación actualizada.
Cubre toda LATAM
Venezuela con Cotizave. El resto de la región con normadata.io.