Módulo que añade un botón para rellenar automáticamente los campos de un partner a partir de su CNPJ. A continuación se muestran los campos que se pueden consultar de ambas APIs utilizadas para obtener información a partir del CNPJ:
ReceitaWS
SERPRO
CPF.CNPJ (cpfcnpj.com.br)
Proveedor comercial con datos en tiempo real, procedentes de la Receita Federal en el momento de la consulta (D+0). El paquete 5 (CNPJ B) es la opción más ligera (registro y dirección, sin socios y sin PDF), mientras que el paquete 6 (CNPJ D) trae el registro completo.
Del paquete 6, el módulo rellena en el partner: razón social, nombre de fantasía, dirección completa, teléfonos, correo electrónico, naturaleza jurídica, capital social, CNAE principal y secundarios, tamaño de la empresa, situación registral (con fecha y motivo), fecha de apertura, matriz o filial, fecha de opción por el Simples Nacional y responsable ante la Receita (nombre y cualificación). A partir del Simples Nacional, SIMEI y tamaño, el módulo también alimenta el tax_framework (régimen tributario) del partner, campo que los demás proveedores no rellenan hoy.
Cada socio del Quadro de Sócios e Administradores se convierte en un contacto hijo y el Cartão CNPJ en PDF de la Receita Federal queda adjunto al partner; las opciones "CPF.CNPJ: do not import partners (QSA)" y "CPF.CNPJ: do not attach the CNPJ card PDF" desactivan cada uno de esos pasos. La opción "CPF.CNPJ: fetch state registration (package 16)" (desactivada por defecto) realiza una consulta al paquete 16 (CNPJ H) para traer la Inscrição Estadual de la UF de la dirección.
El proveedor mantiene las certificaciones ISO/IEC 27001, ISO/IEC 27701 e ISO
- La documentación de la API está disponible en
https://www.cpfcnpj.com.br/dev/.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Añade un botón de búsqueda en contactos y empresas que consulta un CNPJ brasileño en un servicio externo (ReceitaWS, SERPRO o CPF.CNPJ) y rellena automáticamente los datos de registro, dirección, teléfono, correo electrónico, fiscales y de socios de la empresa.
Este módulo permite a los usuarios rellenar un contacto o una empresa a partir de su CNPJ brasileño en lugar de escribir todo a mano. Junto al campo CNPJ de los formularios de contacto y empresa aparece un pequeño botón de búsqueda; al pulsarlo se abre un asistente que consulta un servicio externo de CNPJ y muestra los datos encontrados antes de guardar nada.
- El asistente rellena la razón social, el nombre comercial, la dirección completa, el teléfono, el correo electrónico, la naturaleza jurídica, el capital social, las actividades económicas principal y secundarias (CNAE), el tamaño de la empresa, la situación del registro con fecha y motivo, la fecha de apertura, la sede o sucursal, la fecha de opción por el Simples Nacional y el responsable legal.
- Con el proveedor CPF.CNPJ también puede establecer el régimen fiscal (MEI, Simples Nacional o Normal), crear los socios de la empresa (QSA) como contactos hijos y adjuntar el PDF de la tarjeta CNPJ al contacto.
- Al pulsar el botón de actualización se escriben los valores en el contacto y se cierra el asistente; los valores vacíos no se escriben.
En Ajustes, una nueva sección permite a los administradores elegir el proveedor (ReceitaWS, SERPRO o CPF.CNPJ) e introducir el token de SERPRO, el modo de prueba y el esquema, o el token de CPF.CNPJ, el paquete y las opciones para omitir los socios, omitir la tarjeta PDF u obtener la inscripción estatal.
El botón se niega a ejecutarse si el contacto no tiene CNPJ o si la validación de CNPJ está desactivada en los ajustes de la base brasileña. Afecta a los contactos (res.partner), las empresas (res.company) y los modelos de datos fiscales para CNAE y naturaleza jurídica.
Depende de
Lo necesitan otros módulos
Modelos y campos (5)
- res.company · amplía un modelo existentecompany_type, equity_capital, company_currency_id (Company Currency)
- res.config.settings · amplía un modelo existenteserpro_token (SERPRO Token), serpro_trial (Use SERPRO Trial), cnpj_provider (CNPJ Search Provider), cpfcnpj_token (CPF.CNPJ Token), serpro_schema (SERPRO Schema), cpfcnpj_package (CPF.CNPJ Package), cpfcnpj_fetch_ie (CPF.CNPJ: fetch state registration (package 16)), cpfcnpj_skip_card (CPF.CNPJ: do not attach the CNPJ card PDF), cpfcnpj_skip_partners (CPF.CNPJ: do not import partners (QSA))
- partner.search.wizard · modelo nuevovat (CNPJ), zip, name, email, phone, city_id, street2, district, state_id, child_ids, country_id, legal_name, partner_id, cnpj_status, currency_id, street_name, cnae_main_id, company_size, opening_date, cnpj_card_pdf, provider_name, street_number, tax_framework, equity_capital, l10n_br_ie_code, legal_nature_id, cnpj_branch_type, cnpj_status_date, cnae_secondary_ids, cnpj_status_reason
- l10n_br_base.party.mixin · amplía un modelo existentecnpj_status (CNPJ Status), cnae_main_id, company_size, opening_date, br_currency_id (BR Company Currency), equity_capital, legal_nature_id (Legal Nature), cnpj_branch_type (Head Office / Branch), cnpj_status_date (CNPJ Status Date), cnpj_status_reason (CNPJ Status Reason), simples_option_date (Simples Nacional Option Date), legal_responsible_name (Legal Responsible), legal_responsible_function
- l10n_br_cnpj_search.webservice.abstract · modelo nuevo
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
Fuente · Odoo 19.0Esta búsqueda de informaciones a partir del cnpj se realiza con base en el proveedor configurado en la pestaña de configuraciones, cabe resaltar que el proveedor receitaws permite la realización de tres consultas por minuto, mientras que el SERPRO es de pago y permite consultas ilimitadas en sus planes.
El proveedor cpfcnpj.com.br es comercial, con datos en tiempo real (D+0), sin el límite de tres consultas por minuto del receitaws. Los datos vienen directamente de la Receita Federal en el momento de la consulta. Para utilizarlo, seleccione "CPF.CNPJ" en el campo proveedor e informe el token de acceso y el paquete deseado. El paquete 5 (CNPJ B) es la opción más ligera (registro y dirección, sin socios y sin PDF), mientras que el paquete 6 (CNPJ D) es el registro completo (porte, situación registral, Simples Nacional, Cuadro de Socios y Administradores y Tarjeta CNPJ en PDF). El token se graba en ir.config_parameter y nunca queda en el código. Con el paquete 6, el módulo también rellena el régimen tributario (tax_framework) del partner.
Al seleccionar el proveedor CPF.CNPJ, quedan visibles en Configuraciones > Contactos las siguientes opciones:
- "CPF.CNPJ: do not import partners (QSA)" (predeterminado desactivado): por defecto cada socio del Cuadro de Socios y Administradores se convierte en un contacto hijo, con nombre, calificación y CPF/CNPJ. Marque esta opción para omitir este paso.
- "CPF.CNPJ: do not attach the CNPJ card PDF" (predeterminado desactivado): por defecto la Tarjeta CNPJ en PDF emitida por la Receita Federal, devuelta por la API en el mismo request, se adjunta al partner. Marque esta opción para no adjuntar.
- "CPF.CNPJ: fetch state registration (package 16)" (predeterminado desactivado): realiza una segunda consulta al paquete 16 (CNPJ H) para rellenar la Inscripción Estadual de la UF de la dirección. El paquete 16 tiene costo propio por consulta, por eso la opción viene desactivada.
El proveedor es auditado bajo las normas ISO/IEC 27001, ISO/IEC 27701 e ISO
- Consulte la documentación de la API, los paquetes disponibles y las
credenciales en https://www.cpfcnpj.com.br/dev/.
- Acceda a Configurações
- Elija un proveedor para la búsqueda
- Acceda a Configurações \> Usuários e Empresas \> Empresas \> Criar o acceda a Contatos \> Criar
- Complete los campos obligatorios, introduzca en el campo de CNPJ el CNPJ que desea buscar y haga clic en la lupa junto al campo para buscar
- El mismo procedimiento puede realizarse editando alguna empresa.
Con el proveedor CPF.CNPJ, el botón de búsqueda en el partner (la lupa junto al campo de CNPJ) abre un asistente que muestra los campos devueltos. Al confirmar, el módulo graba los datos en el partner, crea un contacto hijo por socio del Quadro de Sócios e Administradores (opción QSA) y adjunta el Cartão CNPJ en PDF en la pestaña "Anexos".
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.