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 consulta de CNPJ en empresas y contactos que obtiene datos de empresas brasileñas desde ReceitaWS, SERPRO o CPF.CNPJ y rellena el registro del partner automáticamente.
Este módulo permite a los usuarios rellenar un registro de empresa o contacto en Odoo a partir de su CNPJ brasileño (número de identificación fiscal de la empresa) en lugar de escribir todo a mano.
Dónde aparece: - Un botón de búsqueda junto al campo CNPJ en el formulario de empresa y en el formulario de contacto/partner. - Una pantalla de ajustes donde un administrador elige el proveedor de datos (ReceitaWS, SERPRO o CPF.CNPJ) e introduce los tokens, el modo de prueba, el esquema de SERPRO y el paquete de CPF.CNPJ.
Qué ocurre al pulsar el botón: - Odoo comprueba que hay un CNPJ rellenado y que la validación de CNPJ está activada, y después abre un asistente que muestra los datos devueltos por el proveedor. - El usuario revisa los valores y confirma; a continuación, el partner se actualiza con 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, los códigos de actividad CNAE principal y secundaria, el tamaño de la empresa, el estado de registro con fecha y motivo, la fecha de apertura, la sede o sucursal, la fecha de opción de Simples Nacional y el responsable legal. - Con el proveedor CPF.CNPJ, también se deduce el marco fiscal (MEI, Simples Nacional o Normal), los socios de la empresa (QSA) se pueden crear como contactos hijos y el PDF de la ficha CNPJ se puede adjuntar al contacto. - Los valores vacíos no se escriben, por lo que los datos existentes no se borran.
Las opciones de ajustes permiten omitir la importación de socios, omitir el PDF de la ficha o también obtener la inscripción estatal. El módulo afecta a res.partner, res.company y a los campos fiscales del partner.
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.