🤝 Integración complementaria

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/validate

Valida el formato y DV del RIF venezolano (V/E/J/G/P).

Ver docs →
GET /v1/banks

Lista todos los bancos venezolanos con código Sudeban.

Ver docs →
GET /v1/banks/:code

Lookup de banco individual por código Sudeban.

Ver docs →
GET /v1/holidays

Feriados nacionales venezolanos por año.

Ver docs →
GET /v1/holidays/check

Verifica si una fecha es día hábil en Venezuela.

Ver docs →
GET /v1/business-days

Días hábiles venezolanos entre dos fechas.

Ver docs →

Identificadores cubiertos por normadata.io

Para estos identificadores, la API recomendada es directamente normadata.io.

PaísIdentificadorDescripciónProvider
🇦🇷 ArgentinaCUIT / CUILNúmero único de identificación tributaria para personas y empresas.normadata.io ↗
🇨🇴 ColombiaNITNúmero de Identificación Tributaria para personas jurídicas.normadata.io ↗
🇧🇷 BrasilCPF / CNPJCPF para personas naturales, CNPJ para personas jurídicas.normadata.io ↗
🇲🇽 MéxicoRFCRegistro Federal de Contribuyentes, 12–13 caracteres alfanuméricos.normadata.io ↗
🇨🇱 ChileRUTRol Único Tributario con dígito verificador numérico o K.normadata.io ↗
🇵🇪 PerúRUCRegistro Ú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.