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, paralelo, P2P) y catálogo de bancos Sudeban. 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ú.

Para validar el RIF venezolano y otros identificadores fiscales de la región (CUIT, NIT, RFC, CPF, RUT, RUC), normadata.io ofrece un estándar de validación consistente a lo largo de toda LATAM.

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.

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 →

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.