Brasil¶
Ver también
Recursos útiles para la localización brasileña, incluidos materiales de incorporación y videos:
Módulos¶
The following modules are installed automatically with the Brazilian localization:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Brasil - Contabilidad |
|
El paquete de localización fiscal predeterminado. Representa el plan de cuentas e impuestos brasileño genérico e incluye los tipos de documentos e identificación. |
Brasil - Reportes contables |
|
Reportes contables para Brasil. |
Códigos QR Pix para Brasil |
|
Implementa códigos QR Pix para Brasil. |
Brasil - Suscripción de venta |
|
Subscriptions modifications for Brazil. |
Brasil - Venta |
|
Sales modifications for Brazil. |
Brasil - Venta en sitio web |
|
Allows tax calculation and EDI for eCommerce. |
Además, los siguientes módulos deben instalarse manualmente:
Nombre |
Nombre técnico |
Descripción |
|---|---|---|
Avatax Brazil & Avatax Brazil for Services & Test SOs for the Brazilian Avatax |
|
Goods and services tax computation through Avalara. |
Avatax Brazil eCommerce Fiscal Reform |
|
eCommerce modifications for the 2026 tax reform. |
Avatax Brazil Fiscal Reform |
|
Avatax modifications for the 2026 tax reform. |
Avatax Brazil Sale Fiscal Reform |
|
Sales Avatax modifications for the 2026 tax reform |
AvaTax Brasil para ventas y servicios |
|
Sales modifications for Brazil for services |
EDI para contabilidad brasileña y EDI para contabilidad brasileña para servicios |
|
Proporciona facturación electrónica de bienes y servicios para Brasil mediante AvaTax. |
EDI de Contabilidad Brasileña para Ventas |
|
Adds fields to sales orders that will be carried over to the invoice. |
Nota
En algunos casos, como al actualizar a una versión con módulos adicionales, es posible que los módulos no se instalen automáticamente. Cualquier módulo faltante puede instalarse manualmente.
Descripción general de la localización¶
El paquete de localización brasileña garantiza el cumplimiento de las regulaciones fiscales y contables de Brasil. Incluye herramientas para gestionar impuestos, posiciones fiscales, informes y un plan de cuentas predefinido adaptado a los estándares de Brasil.
El paquete de localización brasileña proporciona las siguientes características clave para garantizar el cumplimiento de las regulaciones fiscales y contables locales:
Plan de cuentas: una estructura predefinida adaptada a los estándares contables brasileños
Impuestos: tasas impositivas preconfiguradas, incluyendo IVA estándar, opciones de tasa cero y exentas.
Plan contable¶
En el plan de cuentas, las cuentas se asignan automáticamente a sus impuestos correspondientes, y a los campos predeterminados de cuenta por pagar y cuenta por cobrar.
Nota
El plan de cuentas de Brasil se basa en el CoA SPED, que proporciona una base de las cuentas necesarias.
Impuestos¶
Los impuestos se crean y configuran automáticamente al instalar la localización brasileña. Avalara utiliza algunos para calcular impuestos en pedidos de venta o facturas.
Los impuestos utilizados para servicios deben agregarse y configurarse manualmente, ya que la tasa puede variar según la ciudad donde se ofrezca el servicio.
Importante
No se puede emitir NFS-e para impuestos de servicios creados manualmente. Para enviar electrónicamente un NFS-e, calcula los impuestos usando Avalara.
Advertencia
No elimines impuestos, ya que se utilizan para el cálculo de impuestos de AvaTax. Si se eliminan, Odoo los crea nuevamente cuando se usan en un SO o factura, calculando impuestos con AvaTax. Sin embargo, la cuenta utilizada para registrar el impuesto debe reconfigurarse en la pestaña Definición del impuesto, en las secciones Distribución para facturas y Distribución para notas de crédito.
Empresa y contactos¶
Para usar todas las funciones de esta localización fiscal, los siguientes campos son obligatorios en el registro de la empresa:
Nombre
Dirección: proporcione la ciudad, estado, código postal y país
En el campo calle, ingrese el nombre de la calle, el número y cualquier información adicional de dirección.
En el campo calle 2, ingrese la zona.
Número de identificación: CNPJ o CPF.
Número de identificación fiscal: asociado al tipo de identificación.
IE: inscrição estadual, registro estatal.
IM: inscrição municipal, registro municipal.
Código SUFRAMA: Superintendencia de la Zona Franca de Manaos, agréguelo si es necesario.
Teléfono
Correo electrónico
Truco
Select the Company option for a contact with a tax ID (CNPJ), or the Individual option for a contact with a CPF.
To update your company’s complete record, open the Contacts app and access the relevant record.
Configure the Fiscal Information within the Sales & Purchase tab:
Añade la posición fiscal para AvaTax Brasil.
Tax Regime: Federal tax regime.
ICMS Taxpayer Type: Select ICMS regime, Exempt status, or Non-Taxpayer.
Sector de actividad principal
The following fields are specific to the 2026 tax reform:
Tax Regime: For the simplified tax regime (Simples Nacional), set up the additional fields:
CBS/IBS Normal: Enable the option for Regime Normal (Regime Regular) regime or disable for Hybrid Simples Nacional (Regime Hibrido) regime. For the Hybrid Simples Nacional (Regime Hibrido) tax regime, configure the following additional fields:
CBS Presumed Credit (%): Specify the percentage of presumed CBS credit available for entities under the Hybrid Simples Nacional tax regime.
IBS Presumed Credit (%): Specify the percentage of presumed IBS credit available for entities under the Hybrid Simples Nacional tax regime.
ISS Simplified Rate: Indicate the specific municipal service tax rate applicable to the simplified tax regime.
Entity Type: Select the legal classification.
CBS/IBS Taxpayer: Enable the option if the entity is subject to CBS or IBS. Disable it for exempt entities or those operating under special non-taxable regimes.
Configura la siguiente información fiscal adicional para emitir NFS-e:
Añade la posición fiscal para AvaTax Brasil.
COFINS Details: Select the option that matches the correct COFINS tax status.
PIS Details: Select the option that matches the correct PIS tax status.
CSLL Taxable: Enable the option if the company is subject to CSLL.
Truco
Si es un régimen simplificado, debe configurarse la tasa ICMS. Para hacerlo, ve a , desplázate hacia abajo hasta la sección Impuestos y establece los campos Impuesto de venta e Impuesto de compra en la sección Impuestos predeterminados.
La misma configuración se aplica al formulario de contacto relevante cuando uses la integración de AvaTax.
Integración con AvaTax¶
Nota
Asegúrate de instalar el módulo AvaTax Brasil (
l10n_br_avatax).Odoo es un socio certificado de Avalara Brasil.
La integración de Avalara AvaTax utiliza compras dentro de la aplicación (IAP) para calcular impuestos y gestionar documentos electrónicos (por ejemplo, NF-e, NFS-e). Cada acción consume créditos del saldo de créditos IAP. Al crearla, las nuevas bases de datos reciben 500 créditos gratuitos.
Para calcular el impuesto sobre bienes y servicios y procesar facturas electrónicas, se necesitan las siguientes configuraciones:
Configuración¶
Credenciales¶
Connect AvaTax in the AvaTax Brazil section, add the administrator’s email address for the AvaTax portal in the AvaTax Portal Email field, then click Create account.
Advertencia
When testing or creating a production AvaTax Portal Email integration in a sandbox or production database, use a real email address, as it is needed to connect to Avalara and set up the certificates, whether to test or use it on production.
Hay dos portales diferentes de Avalara Brasil:
Uno para pruebas: https://portal.sandbox.avalarabrasil.com.br/
Uno para producción: https://portal.avalarabrasil.com.br/
Cuando la cuenta se crea desde Odoo, selecciona el entorno correcto. Además, el correo electrónico utilizado para abrir la cuenta no puede usarse para abrir otra cuenta. Guarda el ID de API y la clave de API cuando se crea la cuenta desde Odoo.
Después de crear la cuenta desde Odoo, ve al portal de Avalara para configurar la contraseña:
Ingrese al portal de Avalara.
Haz clic en Meu primeiro acesso.
Agrega la dirección de correo electrónico utilizada en Odoo para crear la cuenta de Avalara/AvaTax y haz clic en Solicitar Senha.
An email will then be received with a token and a link to create a password. Click this link and copy-paste the token to set the desired password.
Truco
Si usas AvaTax en Odoo solo para el cálculo de impuestos, no es necesario establecer una contraseña ni acceder al portal de Avalara. Sin embargo, para usar el servicio de factura electrónica, se necesita acceso a AvaTax y el certificado debe cargarse.
Nota
Las credenciales de API se pueden transferir. Esta opción solo debe usarse cuando ya se ha creado una cuenta en otra instancia de Odoo y debe reutilizarse.
2026 tax reform¶
To enable the sending of the new attributes of the 2026 tax reform, go to , scroll to the Taxes section, and enable Enable Brazilian fiscal reform under AvaTax Brazil.
Truco
If inconsistencies occur when submitting invoices under the 2026 tax reform rules, disable the Enable Brazilian fiscal reform option to revert invoice transmission to the previous communication model.
Subir certificado A1¶
Para emitir facturas electrónicas, debe cargarse un certificado en el portal de AvaTax.
El certificado se sincronizará con Odoo siempre que el número de identificador externo en el portal de AvaTax coincida, sin caracteres especiales, con el número CNPJ, y el número de identificación (CNPJ) en Odoo coincida con el CNPJ en AvaTax.
Importante
Algunas ciudades requieren que el certificado esté vinculado dentro del sistema del Portal de la Ciudad antes de emitir NFS-e desde Odoo.
Si se recibe un mensaje de error de la ciudad que dice Tu certificado no está vinculado al usuario, este proceso debe realizarse en el portal de la ciudad.
Posiciones fiscales¶
To set up the Automatic Tax Mapping (Avalara Brazil) fiscal position, enable the Detect Automatically and Use AvaTax Brazil API options.
Ver también
Productos¶
Accurate fiscal classification of goods and services is essential for tax calculation and electronic invoice issuance in compliance with the Brazilian regulations and the 2026 tax reform.
Nota
Brazil must be specified as the Country field of the company to display the required Brazilian fields.
Make sure the following fields are completed on the General Information tab of the products form:
Legal Unit of Measure: Select the conversion factor between the commercial unit and the taxable unit for taxes applied by quantity (ad rem).
IS taxable: Enable this option if the product is subject to Selective Tax (Imposto Seletivo or IS).
Special Customs Regime (optional): Select the applicable special customs regime if the transaction involving capital goods falls under such a regime.
L10N Br Transaction Usage (optional): Define the tax classification indicating how the good or service is used in the transaction, as this can affect tax calculation and invoice issuance.
If the selected Product Type is Service, select the NBS Code (Nomenclatura Brasileira de Serviços) necessary for tax classification.
To use the AvaTax integration on sales orders and invoices, enter the following information on the product form, based on how the product will be used:
Factura electrónica para bienes (NFS-e)¶
Importante
La integración de Avalara funciona con un sistema basado en créditos, donde cada interacción con Avalara consume un crédito. A continuación se encuentran las principales operaciones que consumen créditos:
Aplicación Ventas
Cálculo de impuestos en presupuestos y pedidos de venta.
Aplicación Contabilidad
Cálculo de impuestos en facturas.
Envío de factura electrónica (NF-e o NFS-e).
Operaciones ocasionales: (cada paso se factura por separado)
Nota
Si los impuestos se calculan en la aplicación Ventas y la factura se emite posteriormente en la aplicación Contabilidad, el cálculo ocurre dos veces, consumiendo dos créditos.
Example
CEST Code: tax classification code identifying goods and products subject to tax substitution under ICMS regulations, and helps determine the applicable tax treatment and procedures for specific items. The product’s applicability to this requirement can be verified on the Código CEST website.
Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.
Fuente de origen: origen del producto, que puede ser extranjero o nacional, entre otras opciones posibles, según el caso de uso específico
Tipo de producto fiscal SPED: tipo de producto fiscal según la tabla de lista SPED
Propósito de uso: propósito de uso previsto para este producto
Nota
Odoo crea automáticamente tres productos para usar en los costes de transporte asociados con las ventas. Se llaman Flete, Seguro y Otros costes y ya están configurados. Si es necesario crear más, duplica y usa la misma configuración:
Product Type: Service
Tipo de coste de transporte: Seguro, Flete u Otros costes
Facturas electrónicas para servicios (NFS-e)¶
Importante
La integración de Avalara funciona con un sistema basado en créditos, donde cada interacción con Avalara consume un crédito. A continuación se encuentran las principales operaciones que consumen créditos:
Aplicación Ventas
Cálculo de impuestos en presupuestos y pedidos de venta.
Aplicación Contabilidad
Cálculo de impuestos en facturas.
Envío de factura electrónica (NF-e o NFS-e).
Verificación del estado de la factura (se consume 1 crédito cada vez que se verifica el estado de la factura).
Operaciones ocasionales: (cada paso se factura por separado)
Nota
Si los impuestos se calculan en la aplicación Ventas y la factura se emite posteriormente en la aplicación Contabilidad, el cálculo ocurre dos veces, consumiendo dos créditos.
Example
Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.
Propósito de uso: propósito de uso previsto para este producto
Origen del código de servicio: código del servicio de la ciudad donde el proveedor está registrado.
Asignación de mano de obra: casilla para seleccionar si el servicio implica mano de obra
Tipo de coste de transporte: tipo de costes de transporte a seleccionar
Códigos de servicio: código de servicio de la ciudad donde se prestará el servicio; si no se añade ningún código, se utilizará el código de origen del servicio.
Cálculo de impuestos¶
Ver también
Cálculos de impuestos en cotizaciones y órdenes de venta¶
Activará una llamada a la API para calcular los impuestos de forma automática con AvaTax en una cotización u orden de ventas con cualquiera de las siguientes acciones:
- Al confirmar una cotización
Confirme la cotización de una orden de ventas.
- Al activarla manualmente
Haz clic en Calcular impuestos usando AvaTax.
- Al visualizar la vista previa
Haz clic en Vista previa.
- Enviar por correo electrónico una cotización/pedido de venta
Envíe una cotización u orden de venta mediante correo electrónico a un cliente.
- Al acceder a una cotización en línea
Cuando un cliente acceda a la cotización en línea (mediante la vista del portal), se activará una llamada a la API.
Cálculo de impuestos en facturas¶
Activará una llamada a la API para calcular los impuestos de forma automática con AvaTax en una factura para el cliente con cualquiera de las siguientes acciones:
- Al activarla manualmente
Haz clic en Calcular impuestos usando AvaTax.
- Al visualizar la vista previa
Haz clic en Vista previa.
- Al acceder a una cotización en línea
Cuando un cliente acceda a la factura en línea (mediante la vista del portal), se activará una llamada a la API.
Nota
Debe establecer la posición fiscal como Mapeo automático de impuestos (Avalara Brasil) en cualquiera de estas acciones para calcular los impuestos de forma automática.
Contabilidad¶
Documentos electrónicos¶
Configuración¶
A series number is linked to a sequence number range for electronic invoices. To configure the series number on a sales journal, follow these steps:
Go to and open the sales journal.
Enable Use Documents? to display the Series field.
Set the series number in the Series field.
Truco
If more than one series is needed, a new sales journal must be created, and a new series number must be assigned for each series. When creating the new sales journal, ensure the Dedicated Credit Note Sequence field in the Accounting Information section is disabled, as invoice, credit note, and debit note sequences are shared per series number, i.e., per journal.
When issuing electronic and non-electronic invoices, the document type is automatically selected based on the Type selected upon invoice creation.
Facturas de cliente¶
Para procesar una factura electrónica de bienes (NF-e) o servicios (NFS-e), la factura debe estar confirmada y los impuestos deben ser calculados por Avalara. Los siguientes campos deben completarse:
Cliente, con toda la información del cliente
Método de pago: Brasil: especifica el método de pago esperado.
Tipo de documento: selecciona (55) Factura electrónica (NF-e) o (SE) Factura electrónica de servicios (NFS-e).
In the Other Info tab:
Posición fiscal configurada como Mapeo automático de impuestos (Avalara Brasil).
Algunos campos opcionales dependen de la naturaleza de la transacción. Estos campos en la pestaña Otra información no son obligatorios, por lo que en la mayoría de los casos, dejarlos en blanco no generará errores del gobierno cuando se envíe la factura:
Freight Model defines the freight contracting and transport model for the shipment.
Transportista Brasil determina quién realiza el transporte.
Luego, haz clic en Enviar. En la ventana emergente, haz clic en Procesar factura electrónica y cualquier otra opción, como Descargar o Correo electrónico. Finalmente, haz clic en Enviar para procesar la factura con el gobierno.
Nota
Todos los campos disponibles en la factura utilizados para emitir una factura electrónica también están disponibles en el pedido de venta, si es necesario. Al crear la primera factura, se muestra el campo Número de documento y se asigna como el primer número que se utilizará secuencialmente para las facturas posteriores.
Notas de crédito¶
Si es necesario registrar una devolución de venta, se puede crear una nota de crédito en Odoo y enviarla al gobierno para su validación.
Nota
Las notas de crédito solo están disponibles para las facturas electrónicas de bienes (NF-e).
Notas de débito¶
Si se necesita incluir información adicional o corregir valores que no se proporcionaron con precisión en la factura original, se puede emitir una nota de débito.
Nota
Las notas de débito solo están disponibles para las facturas electrónicas de bienes (NF-e).
Solo los productos incluidos en la factura original pueden incluirse en la nota de débito. Si bien se pueden realizar cambios en el precio unitario o la cantidad del producto, no se pueden agregar productos a la nota de débito. El propósito de este documento es solo declarar el monto que se agregará a la factura original para los mismos productos o menos.
Cancelar facturas¶
Es posible cancelar una factura electrónica que el gobierno validó.
Nota
Verifica si la factura electrónica aún está dentro del plazo de cancelación, que puede variar según la legislación de cada estado.
Factura electrónica para bienes (NFS-e)¶
Para cancelar una factura electrónica de bienes (NF-e) en Odoo, haz clic en Solicitar cancelación y añade un Motivo de cancelación en la ventana emergente que aparece. Para enviar este motivo de cancelación al cliente por correo electrónico, activa la casilla Correo electrónico.
Nota
Esta es una cancelación electrónica, lo que significa que Odoo enviará una solicitud al gobierno para cancelar la NF-e. Consumirá un crédito IAP, ya que se realiza una llamada API.
Facturas electrónicas para servicios (NFS-e)¶
Para cancelar una factura electrónica de servicios (NFS-e) en Odoo, haz clic en Solicitar cancelación. En este caso no hay proceso de cancelación electrónica, ya que no todas las ciudades tienen este servicio disponible. El usuario necesita cancelar esta NFS-e en el portal de la ciudad manualmente. Una vez completado ese paso, puede solicitar la cancelación en Odoo, lo que cancelará la factura.
Carta de corrección¶
Se puede crear una carta de corrección y vincularla a una factura electrónica de bienes (NF-e) que el gobierno haya validado.
Para hacerlo en Odoo, haz clic en Carta de corrección y añade un Motivo de corrección en la ventana emergente. Para enviar el motivo de corrección a un cliente por correo electrónico, activa la casilla Correo electrónico.
Nota
Las cartas de rectificación solo están disponibles para las facturas electrónicas de bienes (NF-e).
Invalidación de rango de números de factura¶
Un rango de secuencias asignadas a diarios de ventas puede ser invalidado por el gobierno si no están siendo usadas actualmente y no serán usadas en el futuro. Para hacerlo, ve a , abre el diario, haz clic en el icono (engranaje) y selecciona Invalidar rango de números (BR). En el asistente Invalidar rango de números (BR), añade el Número inicial y el Número final del rango que debe cancelarse, e ingresa un Motivo de invalidación.
Nota
La invalidación de rango de números de factura solo está disponible para facturas electrónicas de bienes (NF-e).
El registro de conversación del diario registra el log de los números cancelados, junto con el archivo XML.
Facturas de proveedor¶
Al recibir una factura de un proveedor, codifica la factura en Odoo añadiendo toda la información comercial y la misma información específica de Brasil registrada en las facturas de cliente.
Estos campos específicos de Brasil son:
Método de pago: Brasil: especifica el método de pago esperado.
Tipo de documento: usado por el proveedor
Número de documento: el número de factura del proveedor
Freight Model (NF-e specific): Define the freight contracting and transport model for the shipment.
Transporter Brazil (NF-e specific): who is doing the transportation.