¿Qué son el CPF y el CNPJ?

El CPF (Cadastro de Pessoa Física) es el documento de identificación fiscal para ciudadanos brasileños, equivalente al SSN estadounidense o al NIF europeo. Todo brasileño recibe un CPF único de 11 dígitos usado para todas las transacciones financieras, apertura de cuentas, compras y contratación de servicios. El CNPJ (Cadastro Nacional da Pessoa Jurídica) es el registro fiscal para empresas brasileñas, similar al EIN en EE. UU. o al Company Number en el Reino Unido, con 14 dígitos. Ambos son emitidos por la Receita Federal y obligatorios para operaciones comerciales legales en Brasil.

¿Para qué sirve una API de validación de CPF y CNPJ?

Una API de validación permite que las empresas verifiquen automáticamente si los CPF y CNPJ son válidos, existen oficialmente y están activos en la Receita Federal. Esto previene fraudes, garantiza el cumplimiento regulatorio y automatiza procesos de registro (KYC). Los casos de uso incluyen: validación de clientes en e-commerce durante el checkout, apertura de cuentas digitales en fintechs, onboarding de conductores en apps de movilidad, contratación de empleados remotos y emisión de facturas. La API devuelve no solo si el documento es válido, sino también datos oficiales como nombre completo, razón social, dirección y situación registral, permitiendo cross-validation y detección de inconsistencias.

¿Cuál es la diferencia entre la validación de dígitos verificadores y la consulta en la Receita Federal?

La validación de dígitos verificadores es un cálculo matemático (algoritmo mod-11) que verifica si los dos últimos dígitos del CPF/CNPJ son correctos matemáticamente. Esta validación es instantánea y puede hacerse sin conexión, pero solo confirma que el formato es válido: no garantiza que el documento exista o esté activo. La consulta en la Receita Federal va más allá: accede a la base de datos oficial del gobierno brasileño para confirmar si el documento fue realmente emitido, está activo (no cancelado ni suspendido) y devuelve datos completos del titular. Nuestra API combina ambas: primero valida los dígitos verificadores localmente (si son inválidos, los rechaza de inmediato sin costo), luego consulta la Receita Federal solo para documentos con formato válido, optimizando rendimiento y costo.

¿Cómo funciona la autenticación en la API?

La autenticación utiliza un sistema de tokens generados en tu panel de control tras el registro. Cada solicitud HTTP GET incluye tu token único directamente en la URL: api.cpfcnpj.com.br/{tu_token}/{package_id}/{cpf_o_cnpj}. El token identifica tu cuenta automáticamente y controla el consumo de créditos en tiempo real. Puedes generar múltiples tokens para diferentes aplicaciones o entornos (producción, staging, desarrollo) y revocarlos al instante desde el panel si hay un compromiso de seguridad. No utilizamos autenticación mediante headers para simplificar la integración, permitiendo pruebas desde el navegador o curl sin configuraciones complejas.

¿Cuál es el tiempo medio de respuesta de la API?

El tiempo medio de respuesta es de 0,4 a 2 segundos para consultas de CPF y CNPJ. La variación depende de la carga en los servidores de la Receita Federal, que puede fluctuar especialmente en horarios pico comercial (14h-17h hora de Brasilia). Recomendamos configurar un timeout de 60 segundos en tus solicitudes HTTP para acomodar lentitudes ocasionales en los sistemas gubernamentales. Importante: los datos son siempre en tiempo real D+0 (actualizados el mismo día). Nunca utilizamos caché ni bases de datos intermedias para "acelerar artificialmente" las respuestas, garantizando que siempre recibas la información más reciente disponible en la Receita Federal.

¿Qué datos devuelve la API además de la validación?

Para el CPF, la API devuelve: (1) Nombre completo del titular según el registro oficial, (2) Fecha de nacimiento, (3) Nombre completo de la madre (campo importante para verificación adicional antifraude), (4) Situación registral (activo, suspendido, cancelado, nulo, pendiente de regularización), (5) Fecha de inscripción en la Receita Federal. Para el CNPJ, devuelve: (1) Razón social (nombre legal de la empresa), (2) Nombre fantasía si difiere de la razón social, (3) CNAE principal (código de actividad económica), (4) Dirección completa (calle, número, complemento, barrio, ciudad, estado, código postal), (5) Situación registral, (6) Fecha de apertura, (7) Capital social, (8) Actividades económicas secundarias, (9) Naturaleza jurídica (MEI, LTDA, S.A., etc.). Todos los datos provienen directamente de la Receita Federal sin modificaciones ni enriquecimiento.

¿Cómo integrar la API en 5 minutos?

Proceso simplificado en 4 pasos: (1) Regístrate en 30 segundos sin necesidad de tarjeta de crédito para la prueba, (2) Copia tu token que aparece de inmediato en el panel tras iniciar sesión, (3) Haz una solicitud GET a api.cpfcnpj.com.br/{token}/{package}/{cpf_o_cnpj} (puedes probarlo directamente en el navegador), (4) Recibe un JSON con datos completos. Nuestra documentación técnica (/dev/) tiene ejemplos copy-paste listos en PHP, Python, Node.js, Java, Ruby, Go y cURL. El soporte técnico responde dudas en menos de 2 horas hábiles por correo electrónico o chat en vivo.

¿La API está certificada LGPD? ¿Cómo funciona el cumplimiento?

Sí, mantenemos un cumplimiento riguroso con la LGPD (Ley General de Protección de Datos brasileña, artículos 7.º, 11.º y 46.º) y el GDPR (Reglamento General de Protección de Datos europeo), validado por nuestras certificaciones ISO/IEC 27001:2022 (Gestión de Seguridad de la Información), ISO/IEC 27701:2025 (Gestión de Privacidad de la Información) e ISO/IEC 37301:2021 (Sistema de Gestión de Cumplimiento). Todos los datos se transmiten vía HTTPS con TLS 1.3, implementamos cifrado de extremo a extremo (E2EE), no almacenamos datos personales consultados (solo logs técnicos de solicitud sin PII), mantenemos un Data Protection Officer (DPO) dedicado (dpo@alas.technology), operamos con DPA (Data Processing Agreement) personalizado para clientes enterprise y realizamos auditorías anuales independientes. Proporcionamos documentación completa de cumplimiento para due diligence corporativa, informes trimestrales de conformidad y certificados ISO verificables para clientes regulados.

¿Poseen certificaciones ISO/IEC? ¿Qué controles de seguridad están implementados?

Sí, poseemos tres certificaciones ISO/IEC reconocidas internacionalmente, todas auditadas anualmente por organismos independientes acreditados: (1) ISO/IEC 27001:2022 - Sistema de Gestión de Seguridad de la Información (Certificado Q7LUQTCU20251113BRAIS1Z1): implementamos controles integrales que incluyen autenticación multifactor, RBAC (control de acceso basado en roles), cifrado AES-256 para datos en reposo, E2EE para datos en tránsito, centros de datos certificados con monitoreo 24/7, SOC (Security Operations Center) dedicado, planes de respuesta a incidentes y continuidad del negocio. (2) ISO/IEC 27701:2025 - Gestión de Privacidad de la Información (Certificado Q7LUQTCU20251113BRAPI15R): alineación total con LGPD/GDPR, Privacy by Design y by Default en todos los sistemas, procedimientos documentados para los derechos de los titulares (acceso, rectificación, eliminación, portabilidad), DPIA (Evaluaciones de Impacto a la Privacidad) para nuevas actividades de tratamiento, registros completos de actividades de tratamiento conforme al art. 37 de la LGPD. (3) ISO/IEC 37301:2021 - Sistema de Gestión de Cumplimiento (Certificado Q7LUQTCC20251113BRACM1X7): cultura de cumplimiento organizacional, DPO designado, registro de todas las obligaciones legales aplicables, capacitación continua del equipo, auditorías regulares y mecanismos de denuncia confidenciales. Todas las certificaciones pasan por auditorías de vigilancia anuales que garantizan el cumplimiento continuo con estándares en evolución.

¿Los datos consultados quedan almacenados en los servidores de la API?

No. Por cumplimiento con LGPD/GDPR, no almacenamos datos personales devueltos por las consultas. Mantenemos solo logs técnicos de solicitudes (timestamp, token usado, tipo de consulta, código de estado HTTP) sin incluir PII (Personally Identifiable Information). Estos logs son necesarios para depuración, soporte técnico y facturación, pero no contienen los CPF/CNPJ consultados ni los datos personales devueltos. Los logs se conservan durante 90 días y luego se eliminan automáticamente. Los clientes enterprise pueden solicitar una copia de sus propios logs para auditoría interna. Nunca compartimos, vendemos ni utilizamos datos de consultas con fines secundarios.

¿Cómo prevenir fraudes usando la API?

Estrategias antifraude recomendadas: (1) Haz cross-validation del nombre devuelto por la API con el nombre en el documento de identidad enviado (DNI/licencia de conducir): las divergencias indican un posible fraude, (2) Compara el nombre de la tarjeta de crédito con el nombre del CPF durante el checkout, (3) Usa la fecha de nacimiento como segundo factor de validación cuando esté disponible, (4) Verifica la consistencia del nombre de la madre si tu sistema recopila esa información, (5) Implementa velocity checks que detecten el mismo CPF usado varias veces en un período corto, (6) Monitorea patrones sospechosos como CPF secuenciales, una misma IP haciendo múltiples intentos o grandes volúmenes de CPF cancelados/suspendidos. Combinando la validación registral vía API con reglas de negocio específicas de tu sector, los clientes reportan una reducción de fraudes del 60-80%.

¿Por qué no usar bases de datos filtradas o scraping?

Las bases de datos filtradas (muchas veces vendidas ilegalmente) tienen problemas críticos: (1) Cobertura parcial de solo el 70-85% de los documentos existentes con vacíos aleatorios, (2) Datos desactualizados de meses o años: no reflejan cambios registrales (cambios de dirección, cancelaciones, regularizaciones), (3) Ilegalidad: su uso viola LGPD/GDPR exponiendo a tu empresa a multas de hasta el 2% de la facturación anual, (4) Riesgo reputacional e imposibilidad de comprobar cumplimiento en auditorías. El screen-scraping del sitio de la Receita Federal también es problemático: (1) Se rompe con frecuencia cuando el sitio cambia de diseño, (2) Exige resolver un captcha para cada solicitud, (3) Viola los términos de servicio, (4) La IP puede ser bloqueada permanentemente. Nuestra API ofrece acceso legal, confiable y auditable a la misma fuente oficial.

¿Cómo funciona el pricing? ¿Cuánto cuesta por consulta?

El paquete más económico, NFe Unificada, cuesta R$ 0,04 por consulta. Los paquetes de validación de CPF comienzan en R$ 0,17 (CPF A, solo Nombre Completo) y llegan a R$ 1,57 (CPF K con dirección y situación registral). Los paquetes de CNPJ van de R$ 0,15 (CNPJ A) a R$ 2,25 (QsA Detallado con porcentaje societario). Los más vendidos: CPF C a R$ 0,29 (Nombre + Fecha de Nacimiento + Madre + Género) y CNPJ D a R$ 0,51 (registro completo en tiempo real en la Receita Federal con PDF de la Tarjeta CNPJ). Las consultas no expiran, el saldo es acumulativo entre paquetes y se acredita proporcionalmente en upgrades. Pago vía tarjeta de crédito, Boleto y Pix; NF-e automática para clientes con CNPJ. Tabla completa en /precos.

¿Existe plan gratuito o período de prueba?

Sí, todo registro nuevo recibe consultas gratuitas para probar la API en un entorno real sin limitaciones de funcionalidad y sin compromiso. No pedimos tarjeta de crédito durante la prueba: solo correo electrónico y contraseña para crear la cuenta. Tras consumir las consultas gratuitas, puedes contratar planes de pago. No hay contrato de permanencia: puedes cancelar cuando quieras, hacer upgrade o downgrade instantáneo de planes, y los créditos nunca expiran.

¿Necesito tener CNPJ para contratar la API?

No, puedes contratar como persona física (CPF) o jurídica (CNPJ). La factura se emite según tu tipo de registro. Para clientes persona jurídica, emitimos NF-e (Factura Electrónica) automáticamente tras el pago. Para persona física, el cobro se realiza vía tarjeta de crédito o Boleto bancario sin emisión de NF-e (por limitación legal brasileña: la persona física no puede recibir factura de servicio). Pago aceptado: tarjeta de crédito, Boleto y Pix.

¿La API ya está lista para el CNPJ Alfanumérico que entra en vigor en julio de 2026?

Sí. Nuestra API ya acepta y valida el nuevo CNPJ Alfanumérico definido por la Instrucción Normativa RFB n.º 2.229/2024, que entra en vigor en julio de 2026. El nuevo formato mantiene 14 caracteres, pero los 12 primeros pueden contener letras mayúsculas y dígitos (0-9, A-Z), mientras que los 2 últimos permanecen como dígitos verificadores numéricos calculados por adaptación del algoritmo mod-11 (cada letra contribuye con su valor ASCII menos 48). Tanto los CNPJ numéricos antiguos como los nuevos alfanuméricos se consultan por el mismo endpoint, sin cambios en la integración. Las empresas existentes mantienen su CNPJ numérico actual: el formato alfanumérico vale solo para nuevos registros posteriores a julio de 2026. Recomendamos actualizar la regex de validación en el front-end a ^[A-Z\d]{12}\d{2}$ y ampliar el tamaño de las columnas en la base de datos si hoy solo aceptan dígitos.

¿La consulta de CNPJ ya contempla IBS, CBS y la Reforma Tributaria de 2026?

A partir de 2026, la Reforma Tributaria (EC 132/2023 y LCs 214/2025 y 215/2025) implementa el IBS (Impuesto sobre Bienes y Servicios) estatal/municipal y la CBS (Contribución sobre Bienes y Servicios) federal, en sustitución gradual de ICMS, ISS, PIS y Cofins. Nuestra API expone —cuando está disponible en la Receita Federal— los nuevos campos correspondientes (régimen de tributación, situación en el IBS/CBS, alícuota efectiva por CNAE cuando se publica) sin costo adicional para los paquetes que ya entregan datos registrales completos de CNPJ. Durante la fase de transición (alícuota de prueba del 0,9% CBS + 0,1% IBS en 2026), los campos pueden aparecer como null para empresas aún no encuadradas. La documentación se actualiza conforme la Receita libera los nuevos endpoints oficiales.

¿Los datos son realmente en tiempo real o provienen de caché?

Los datos son D+0 en tiempo real, consultados directamente en los sistemas oficiales de la Receita Federal en cada solicitud en los paquetes CPF D, CPF E y CNPJ D. No usamos caché intermedia, base propia, datos raspados ni bancos de terceros en esos paquetes. Si un CNPJ fue reactivado hace un momento, tu próxima consulta ya devuelve situacao_cadastral=ATIVA, sin ventana de desfase. Trade-off: el tiempo de respuesta acompaña la latencia del servidor de la Receita (media de 400 ms a 2 s, con picos en horario comercial). Configura un timeout HTTP de 60 segundos y retry con backoff exponencial para 3 intentos. Los paquetes simplificados (CPF A, B, C, F, etc.) usan fuentes asociadas con menor latencia (media de 1 segundo).

¿Cuál es la base legal LGPD para la consulta de CPF de terceros vía API?

La consulta de CPF de terceros vía nuestra API está permitida por la LGPD (Ley 13.709/2018) en diversas hipótesis del art. 7.º: cumplimiento de obligación legal (II), ejecución de contrato (V), protección al crédito (X) e interés legítimo (IX). Casos típicos cubiertos: validación registral en e-commerce, onboarding de fintechs (Resolución BCB 5/2020 — KYC), contratación de empleados CLT, emisión de NF-e (obligatoria por SPED), prevención de fraudes financieros y cumplimiento contra el lavado de dinero (Ley 9.613/1998 y Circular BCB 3.978/2020). Lo que NO es base legal: marketing directo sin consentimiento, enriquecimiento para venta de leads o investigación no relacionada con la finalidad contractual. Recomendamos mantener un registro de operaciones de tratamiento (LGPD art. 37) documentando la finalidad de cada consulta. DPA disponible bajo solicitud para clientes corporativos.

¿La consulta genera un comprobante PDF oficial para auditorías o procesos judiciales?

Sí. Cada consulta devuelve en el JSON un protocolo único (consultaID), timestamp UTC con precisión de milisegundos y una cadena de auditoría criptográfica. Estos tres elementos juntos tienen un valor probatorio equivalente a una captura de la consulta pública de la Receita. Para los paquetes CPF D, CPF E (tiempo real RF) y CNPJ D, generamos un PDF del comprobante oficial codificado en Base64 (campo situacaoComprovantePdf) con un diseño idéntico al emitido por la Receita Federal, aceptado por bancos, notarías y procesos judiciales como evidencia de due diligence. El paquete CPF CAC/SINIC (R$ 0,27) devuelve además el PDF del Certificado de Antecedentes Penales de la Policía Federal con número de protocolo SINIC e indicador de "nada consta".

¿Qué son el CPF y el CNPJ?

El CPF (Cadastro de Pessoa Física) es el documento de identificación fiscal para ciudadanos brasileños, equivalente al SSN estadounidense o al NIF europeo. Todo brasileño recibe un CPF único de 11 dígitos usado para todas las transacciones financieras, apertura de cuentas, compras y contratación de servicios. El CNPJ (Cadastro Nacional da Pessoa Jurídica) es el registro fiscal para empresas brasileñas, similar al EIN en EE. UU. o al Company Number en el Reino Unido, con 14 dígitos. Ambos son emitidos por la Receita Federal y obligatorios para operaciones comerciales legales en Brasil.

¿Para qué sirve una API de validación de CPF y CNPJ?

Una API de validación permite que las empresas verifiquen automáticamente si los CPF y CNPJ son válidos, existen oficialmente y están activos en la Receita Federal. Esto previene fraudes, garantiza el cumplimiento regulatorio y automatiza procesos de registro (KYC). Los casos de uso incluyen: validación de clientes en e-commerce durante el checkout, apertura de cuentas digitales en fintechs, onboarding de conductores en apps de movilidad, contratación de empleados remotos y emisión de facturas. La API devuelve no solo si el documento es válido, sino también datos oficiales como nombre completo, razón social, dirección y situación registral, permitiendo cross-validation y detección de inconsistencias.

¿Cuál es la diferencia entre la validación de dígitos verificadores y la consulta en la Receita Federal?

La validación de dígitos verificadores es un cálculo matemático (algoritmo mod-11) que verifica si los dos últimos dígitos del CPF/CNPJ son correctos matemáticamente. Esta validación es instantánea y puede hacerse sin conexión, pero solo confirma que el formato es válido: no garantiza que el documento exista o esté activo. La consulta en la Receita Federal va más allá: accede a la base de datos oficial del gobierno brasileño para confirmar si el documento fue realmente emitido, está activo (no cancelado ni suspendido) y devuelve datos completos del titular. Nuestra API combina ambas: primero valida los dígitos verificadores localmente (si son inválidos, los rechaza de inmediato sin costo), luego consulta la Receita Federal solo para documentos con formato válido, optimizando rendimiento y costo.

¿Cómo funciona la autenticación en la API?

La autenticación utiliza un sistema de tokens generados en tu panel de control tras el registro. Cada solicitud HTTP GET incluye tu token único directamente en la URL: api.cpfcnpj.com.br/{tu_token}/{package_id}/{cpf_o_cnpj}. El token identifica tu cuenta automáticamente y controla el consumo de créditos en tiempo real. Puedes generar múltiples tokens para diferentes aplicaciones o entornos (producción, staging, desarrollo) y revocarlos al instante desde el panel si hay un compromiso de seguridad. No utilizamos autenticación mediante headers para simplificar la integración, permitiendo pruebas desde el navegador o curl sin configuraciones complejas.

¿Cuál es el tiempo medio de respuesta de la API?

El tiempo medio de respuesta es de 0,4 a 2 segundos para consultas de CPF y CNPJ. La variación depende de la carga en los servidores de la Receita Federal, que puede fluctuar especialmente en horarios pico comercial (14h-17h hora de Brasilia). Recomendamos configurar un timeout de 60 segundos en tus solicitudes HTTP para acomodar lentitudes ocasionales en los sistemas gubernamentales. Importante: los datos son siempre en tiempo real D+0 (actualizados el mismo día). Nunca utilizamos caché ni bases de datos intermedias para "acelerar artificialmente" las respuestas, garantizando que siempre recibas la información más reciente disponible en la Receita Federal.

¿Qué datos devuelve la API además de la validación?

Para el CPF, la API devuelve: (1) Nombre completo del titular según el registro oficial, (2) Fecha de nacimiento, (3) Nombre completo de la madre (campo importante para verificación adicional antifraude), (4) Situación registral (activo, suspendido, cancelado, nulo, pendiente de regularización), (5) Fecha de inscripción en la Receita Federal. Para el CNPJ, devuelve: (1) Razón social (nombre legal de la empresa), (2) Nombre fantasía si difiere de la razón social, (3) CNAE principal (código de actividad económica), (4) Dirección completa (calle, número, complemento, barrio, ciudad, estado, código postal), (5) Situación registral, (6) Fecha de apertura, (7) Capital social, (8) Actividades económicas secundarias, (9) Naturaleza jurídica (MEI, LTDA, S.A., etc.). Todos los datos provienen directamente de la Receita Federal sin modificaciones ni enriquecimiento.

¿Cómo integrar la API en 5 minutos?

Proceso simplificado en 4 pasos: (1) Regístrate en 30 segundos sin necesidad de tarjeta de crédito para la prueba, (2) Copia tu token que aparece de inmediato en el panel tras iniciar sesión, (3) Haz una solicitud GET a api.cpfcnpj.com.br/{token}/{package}/{cpf_o_cnpj} (puedes probarlo directamente en el navegador), (4) Recibe un JSON con datos completos. Nuestra documentación técnica (/dev/) tiene ejemplos copy-paste listos en PHP, Python, Node.js, Java, Ruby, Go y cURL. El soporte técnico responde dudas en menos de 2 horas hábiles por correo electrónico o chat en vivo.

¿La API está certificada LGPD? ¿Cómo funciona el cumplimiento?

Sí, mantenemos un cumplimiento riguroso con la LGPD (Ley General de Protección de Datos brasileña, artículos 7.º, 11.º y 46.º) y el GDPR (Reglamento General de Protección de Datos europeo), validado por nuestras certificaciones ISO/IEC 27001:2022 (Gestión de Seguridad de la Información), ISO/IEC 27701:2025 (Gestión de Privacidad de la Información) e ISO/IEC 37301:2021 (Sistema de Gestión de Cumplimiento). Todos los datos se transmiten vía HTTPS con TLS 1.3, implementamos cifrado de extremo a extremo (E2EE), no almacenamos datos personales consultados (solo logs técnicos de solicitud sin PII), mantenemos un Data Protection Officer (DPO) dedicado (dpo@alas.technology), operamos con DPA (Data Processing Agreement) personalizado para clientes enterprise y realizamos auditorías anuales independientes. Proporcionamos documentación completa de cumplimiento para due diligence corporativa, informes trimestrales de conformidad y certificados ISO verificables para clientes regulados.

¿Poseen certificaciones ISO/IEC? ¿Qué controles de seguridad están implementados?

Sí, poseemos tres certificaciones ISO/IEC reconocidas internacionalmente, todas auditadas anualmente por organismos independientes acreditados: (1) ISO/IEC 27001:2022 - Sistema de Gestión de Seguridad de la Información (Certificado Q7LUQTCU20251113BRAIS1Z1): implementamos controles integrales que incluyen autenticación multifactor, RBAC (control de acceso basado en roles), cifrado AES-256 para datos en reposo, E2EE para datos en tránsito, centros de datos certificados con monitoreo 24/7, SOC (Security Operations Center) dedicado, planes de respuesta a incidentes y continuidad del negocio. (2) ISO/IEC 27701:2025 - Gestión de Privacidad de la Información (Certificado Q7LUQTCU20251113BRAPI15R): alineación total con LGPD/GDPR, Privacy by Design y by Default en todos los sistemas, procedimientos documentados para los derechos de los titulares (acceso, rectificación, eliminación, portabilidad), DPIA (Evaluaciones de Impacto a la Privacidad) para nuevas actividades de tratamiento, registros completos de actividades de tratamiento conforme al art. 37 de la LGPD. (3) ISO/IEC 37301:2021 - Sistema de Gestión de Cumplimiento (Certificado Q7LUQTCC20251113BRACM1X7): cultura de cumplimiento organizacional, DPO designado, registro de todas las obligaciones legales aplicables, capacitación continua del equipo, auditorías regulares y mecanismos de denuncia confidenciales. Todas las certificaciones pasan por auditorías de vigilancia anuales que garantizan el cumplimiento continuo con estándares en evolución.

¿Los datos consultados quedan almacenados en los servidores de la API?

No. Por cumplimiento con LGPD/GDPR, no almacenamos datos personales devueltos por las consultas. Mantenemos solo logs técnicos de solicitudes (timestamp, token usado, tipo de consulta, código de estado HTTP) sin incluir PII (Personally Identifiable Information). Estos logs son necesarios para depuración, soporte técnico y facturación, pero no contienen los CPF/CNPJ consultados ni los datos personales devueltos. Los logs se conservan durante 90 días y luego se eliminan automáticamente. Los clientes enterprise pueden solicitar una copia de sus propios logs para auditoría interna. Nunca compartimos, vendemos ni utilizamos datos de consultas con fines secundarios.

¿Cómo prevenir fraudes usando la API?

Estrategias antifraude recomendadas: (1) Haz cross-validation del nombre devuelto por la API con el nombre en el documento de identidad enviado (DNI/licencia de conducir): las divergencias indican un posible fraude, (2) Compara el nombre de la tarjeta de crédito con el nombre del CPF durante el checkout, (3) Usa la fecha de nacimiento como segundo factor de validación cuando esté disponible, (4) Verifica la consistencia del nombre de la madre si tu sistema recopila esa información, (5) Implementa velocity checks que detecten el mismo CPF usado varias veces en un período corto, (6) Monitorea patrones sospechosos como CPF secuenciales, una misma IP haciendo múltiples intentos o grandes volúmenes de CPF cancelados/suspendidos. Combinando la validación registral vía API con reglas de negocio específicas de tu sector, los clientes reportan una reducción de fraudes del 60-80%.

¿Por qué no usar bases de datos filtradas o scraping?

Las bases de datos filtradas (muchas veces vendidas ilegalmente) tienen problemas críticos: (1) Cobertura parcial de solo el 70-85% de los documentos existentes con vacíos aleatorios, (2) Datos desactualizados de meses o años: no reflejan cambios registrales (cambios de dirección, cancelaciones, regularizaciones), (3) Ilegalidad: su uso viola LGPD/GDPR exponiendo a tu empresa a multas de hasta el 2% de la facturación anual, (4) Riesgo reputacional e imposibilidad de comprobar cumplimiento en auditorías. El screen-scraping del sitio de la Receita Federal también es problemático: (1) Se rompe con frecuencia cuando el sitio cambia de diseño, (2) Exige resolver un captcha para cada solicitud, (3) Viola los términos de servicio, (4) La IP puede ser bloqueada permanentemente. Nuestra API ofrece acceso legal, confiable y auditable a la misma fuente oficial.

¿Cómo funciona el pricing? ¿Cuánto cuesta por consulta?

El paquete más económico, NFe Unificada, cuesta R$ 0,04 por consulta. Los paquetes de validación de CPF comienzan en R$ 0,17 (CPF A, solo Nombre Completo) y llegan a R$ 1,57 (CPF K con dirección y situación registral). Los paquetes de CNPJ van de R$ 0,15 (CNPJ A) a R$ 2,25 (QsA Detallado con porcentaje societario). Los más vendidos: CPF C a R$ 0,29 (Nombre + Fecha de Nacimiento + Madre + Género) y CNPJ D a R$ 0,51 (registro completo en tiempo real en la Receita Federal con PDF de la Tarjeta CNPJ). Las consultas no expiran, el saldo es acumulativo entre paquetes y se acredita proporcionalmente en upgrades. Pago vía tarjeta de crédito, Boleto y Pix; NF-e automática para clientes con CNPJ. Tabla completa en /precos.

¿Existe plan gratuito o período de prueba?

Sí, todo registro nuevo recibe consultas gratuitas para probar la API en un entorno real sin limitaciones de funcionalidad y sin compromiso. No pedimos tarjeta de crédito durante la prueba: solo correo electrónico y contraseña para crear la cuenta. Tras consumir las consultas gratuitas, puedes contratar planes de pago. No hay contrato de permanencia: puedes cancelar cuando quieras, hacer upgrade o downgrade instantáneo de planes, y los créditos nunca expiran.

¿Necesito tener CNPJ para contratar la API?

No, puedes contratar como persona física (CPF) o jurídica (CNPJ). La factura se emite según tu tipo de registro. Para clientes persona jurídica, emitimos NF-e (Factura Electrónica) automáticamente tras el pago. Para persona física, el cobro se realiza vía tarjeta de crédito o Boleto bancario sin emisión de NF-e (por limitación legal brasileña: la persona física no puede recibir factura de servicio). Pago aceptado: tarjeta de crédito, Boleto y Pix.

¿La API ya está lista para el CNPJ Alfanumérico que entra en vigor en julio de 2026?

Sí. Nuestra API ya acepta y valida el nuevo CNPJ Alfanumérico definido por la Instrucción Normativa RFB n.º 2.229/2024, que entra en vigor en julio de 2026. El nuevo formato mantiene 14 caracteres, pero los 12 primeros pueden contener letras mayúsculas y dígitos (0-9, A-Z), mientras que los 2 últimos permanecen como dígitos verificadores numéricos calculados por adaptación del algoritmo mod-11 (cada letra contribuye con su valor ASCII menos 48). Tanto los CNPJ numéricos antiguos como los nuevos alfanuméricos se consultan por el mismo endpoint, sin cambios en la integración. Las empresas existentes mantienen su CNPJ numérico actual: el formato alfanumérico vale solo para nuevos registros posteriores a julio de 2026. Recomendamos actualizar la regex de validación en el front-end a ^[A-Z\d]{12}\d{2}$ y ampliar el tamaño de las columnas en la base de datos si hoy solo aceptan dígitos.

¿La consulta de CNPJ ya contempla IBS, CBS y la Reforma Tributaria de 2026?

A partir de 2026, la Reforma Tributaria (EC 132/2023 y LCs 214/2025 y 215/2025) implementa el IBS (Impuesto sobre Bienes y Servicios) estatal/municipal y la CBS (Contribución sobre Bienes y Servicios) federal, en sustitución gradual de ICMS, ISS, PIS y Cofins. Nuestra API expone —cuando está disponible en la Receita Federal— los nuevos campos correspondientes (régimen de tributación, situación en el IBS/CBS, alícuota efectiva por CNAE cuando se publica) sin costo adicional para los paquetes que ya entregan datos registrales completos de CNPJ. Durante la fase de transición (alícuota de prueba del 0,9% CBS + 0,1% IBS en 2026), los campos pueden aparecer como null para empresas aún no encuadradas. La documentación se actualiza conforme la Receita libera los nuevos endpoints oficiales.

¿Los datos son realmente en tiempo real o provienen de caché?

Los datos son D+0 en tiempo real, consultados directamente en los sistemas oficiales de la Receita Federal en cada solicitud en los paquetes CPF D, CPF E y CNPJ D. No usamos caché intermedia, base propia, datos raspados ni bancos de terceros en esos paquetes. Si un CNPJ fue reactivado hace un momento, tu próxima consulta ya devuelve situacao_cadastral=ATIVA, sin ventana de desfase. Trade-off: el tiempo de respuesta acompaña la latencia del servidor de la Receita (media de 400 ms a 2 s, con picos en horario comercial). Configura un timeout HTTP de 60 segundos y retry con backoff exponencial para 3 intentos. Los paquetes simplificados (CPF A, B, C, F, etc.) usan fuentes asociadas con menor latencia (media de 1 segundo).

¿Cuál es la base legal LGPD para la consulta de CPF de terceros vía API?

La consulta de CPF de terceros vía nuestra API está permitida por la LGPD (Ley 13.709/2018) en diversas hipótesis del art. 7.º: cumplimiento de obligación legal (II), ejecución de contrato (V), protección al crédito (X) e interés legítimo (IX). Casos típicos cubiertos: validación registral en e-commerce, onboarding de fintechs (Resolución BCB 5/2020 — KYC), contratación de empleados CLT, emisión de NF-e (obligatoria por SPED), prevención de fraudes financieros y cumplimiento contra el lavado de dinero (Ley 9.613/1998 y Circular BCB 3.978/2020). Lo que NO es base legal: marketing directo sin consentimiento, enriquecimiento para venta de leads o investigación no relacionada con la finalidad contractual. Recomendamos mantener un registro de operaciones de tratamiento (LGPD art. 37) documentando la finalidad de cada consulta. DPA disponible bajo solicitud para clientes corporativos.

¿La consulta genera un comprobante PDF oficial para auditorías o procesos judiciales?

Sí. Cada consulta devuelve en el JSON un protocolo único (consultaID), timestamp UTC con precisión de milisegundos y una cadena de auditoría criptográfica. Estos tres elementos juntos tienen un valor probatorio equivalente a una captura de la consulta pública de la Receita. Para los paquetes CPF D, CPF E (tiempo real RF) y CNPJ D, generamos un PDF del comprobante oficial codificado en Base64 (campo situacaoComprovantePdf) con un diseño idéntico al emitido por la Receita Federal, aceptado por bancos, notarías y procesos judiciales como evidencia de due diligence. El paquete CPF CAC/SINIC (R$ 0,27) devuelve además el PDF del Certificado de Antecedentes Penales de la Policía Federal con número de protocolo SINIC e indicador de "nada consta".