Brasil¶
Ver también
A continuación podrá encontrar recursos útiles para la localización contable de Brasil, incluyendo materiales y videos de capacitación:
Módulos¶
La localización brasileña cuenta con los siguientes módulos:
Nombre |
Nombre técnico |
Descripción |
---|---|---|
Brasil - Contabilidad |
|
El paquete de localización fiscal para Brasil. Incluye el plan de cuentas brasileño, impuestos, reporte fiscal, posiciones fiscales y tipos de documentos e identificación. |
Brasil - Reportes contables |
|
Reportes contables para Brasil. |
AvaTax Brasil, AvaTax Brasil Ventas y Probar órdenes de venta para AvaTax en Brasil |
|
Cálculo de impuestos para bienes y servicios a través de Avalara. |
EDI para contabilidad brasileña |
|
Permite realizar facturas electrónicas a través de AvaTax. |
EDI para contabilidad brasileña para Ventas |
|
Agrega más campos a las órdenes de venta que luego se transfieren a la factura. |
Contabilidad EDI de Brasil para el PdV |
|
Permite realizar facturas electrónicas a través de AvaTax en el PdV. |
EDI para contabilidad brasileña para comercio electrónico |
|
Habilita el cálculo de impuestos y el EDI para usuarios de Comercio electrónico. |
EDI para contabilidad brasileña para existencias |
|
Agrega información relacionada con el envío al NF-e. |
Brasil - Ventas en sitio web |
|
Habilita el cálculo de impuestos y el EDI para usuarios de Comercio electrónico. |
Brasil - Ventas |
|
Modificaciones de venta para Brasil |
Brasil - Venta de suscripciones |
|
Modificaciones para venta de suscripciones en Brasil |
Nota
Los módulos principales de la localización se instalan en automático y puede instalar los otros de forma manual.
Resumen de la localización¶
El paquete de localización de Brasil garantiza el cumplimiento de las regulaciones fiscales y contables del país. Incluye herramientas para gestionar impuestos, posiciones fiscales, reportes y un plan de cuentas predefinido que se adapta a las normas de Brasil.
El paquete de localización de Brasil ofrece las siguientes funciones clave para garantizar que se cumple con las regulaciones fiscales y contables locales:
Plan de cuentas: Una estructura predefina y adaptada a las normas de contabilidad d Brasil.
Impuestos: Tasas impositivas preconfiguradas, como el IVA estándar, tasa cero y otras opciones de exención.
Plan de cuentas¶
En el plan de cuentas las cuentas se mapean de forma automática a sus impuestos correspondientes, y a los campos de cuentas por pagar y por cobrar.
Nota
El plan de cuentas de Brasil toma como referencia el plan de cuentas SPED, que proporciona un punto de partida para las cuentas necesarias.
Impuestos¶
Los impuestos se crean de forma automática y se configuran al instalar la localización de Brasil. Avalara usa algunos para calcular los impuestos en órdenes de ventas o facturas.
Los impuestos que se usen para servicios deben agregarse y configurarse de forma manual, ya que la tasa puede cambiar dependiendo de la ciudad donde se ofrezca el servicio.
Importante
No se pueden emitir NFS-e para impuestos de servicios que se crearon de forma manual. Para emitir una NFS-e de forma electrónica calcula los impuestos con Avalara.
Advertencia
No elimines ningún impuesto, AvaTax los necesita para realizar los cálculos. Si los eliminas, Odoo los creará de nuevo cuando se utilicen en una orden de venta o factura y al calcular impuestos con AvaTax, pero deberás configurar otra vez la cuenta que se utiliza para registrar el impuesto. Ve a la pestaña Definición en las secciones de Distribución para facturas y Distribución para reembolsos.
Empresa y contactos¶
El registro de la empresa debe tener completos los siguientes campos para que pueda utilizar todas las funciones de la localización fiscal:
Nombre
Dirección: proporcione la ciudad, estado, código postal y país
Escriba el nombre de la calle, el número y la información adicional de la dirección en el campo Calle.
Ingrese la zona en el campo Calle 2.
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
Configure la información fiscal en la pestaña Ventas y compras:
Agrega la posición fiscal para AvaTax Brasil.
Régimen fiscal: régimen fiscal federal.
Tipo de contribuyente ICMS: indica el régimen de ICMS, el estado de exención o si no es contribuyente.
Sector de actividad principal
Configure la siguiente información fiscal adicional para emitir NFS-e:
Agrega la posición fiscal para AvaTax Brasil.
Detalles de COFINS: imponible, no imponible, imponible con tasa del 0%, exento o suspendido.
Detalles de PIS: imponible, no imponible, imponible con tasa del 0%, exento o suspendido.
Imponible al CSLL: Si la empresa está sujeta al impuesto de contribución social sobre las ganancias o no.
Truco
Si es un régimen simplificado, debes configurar la tasa ICMS. Para ello, ve a Impuestos y configura los campos de impuestos de venta e impuestos de compra en la sección Impuestos predeterminados.
, baja a la secciónLa misma configuración aplica al formulario de contacto relevante al usar la integración con AvaTax.
Nota
Seleccione la opción empresa si es un contacto con un número de identificación fiscal (CNPJ) o seleccione individuo si es un contacto con un registro de persona física (Cadastro de Pessoas Físicas).
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 con Avalara AvaTax usa 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 balance de créditos IAP. Al crear una base de datos nueva, recibirás 500 créditos gratis.
Para calcular el impuesto sobre bienes y servicios y procesar facturas electrónicos, necesitas realizar las configuraciones a continuación:
Configuración¶
Credenciales¶
Activa AvaTax en Odoo y, en la sección AvaTax Brasil agrega la dirección de correo del administración del portal de AvaTaz en el campo Correo electrónico del portal de AvaTax, después haz clic en Crear cuenta.
Advertencia
Usa una dirección de correo electrónico real al probar o crear una integración de producción de correo electrónico del portal de AvaTax en una base de datos de entorno de prueba o de producción, pues es necesaria para conectarse a Avalara y configurar los certificados.
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/
Asegúrate de seleccionar el entorno adecuado cuando crees la cuenta desde Odoo. Además, el correo electrónico que uses para crear la cuenta no podrá usarse para crear otra. Guarda el ID de la API y tu clave API cuando la cuenta se cree desde Odoo.

Después de que la cuenta se cree desde Odoo, vaya al portal de Avalara para configurar la contraseña:
Ingrese al portal de Avalara.
Haga clic en Meu primeiro acesso (acceder por primera vez).
Escribe la dirección de correo electrónico que utilizaste en Odoo para crear la cuenta de Avalara/AvaTax y luego haz clic en Solicitar Senha (solicitar contraseña).
Recibirás un correo electrónico con un token y un enlace para crear una contraseña. Haz clic en este enlace y copia y pega el token para asignar la contraseña deseada.
Truco
Si usas AvaTax en Odoo solo para el cálculo de impuestos, no necesitas establecer una contraseña o acceder al portal de Avalara. Sin embargo, para utilizar el servicio de factura electrónica, debes acceder al portal de AvaTax y debes subir tu certifcado.
Nota
Las credenciales API se pueden transferir. Esta opción se debe usar solo cuando ya haya creado una cuenta en otra instancia de Odoo y quiera volver a utilizarla.
Subir certificado A1¶
Para emitir facturas electrónicas, debe subir un certificado al portal de AvaTax.
El certificado se sincronizará con Odoo siempre y cuando el número de identificación externo en el portal de AvaTax coincida (sin caracteres especiales) con el número de CNPJ, y el número de identificación (CNPJ) en Odoo coincida con el CNPJ en AvaTax.
Importante
En algunas ciudades es necesario vincular el certificado al sistema del portal de la ciudad antes de usar NFS-e desde Odoo.
Si recibe un mensaje de error de la ciudad con el texto Su certificado no está vinculado al usuario, tendrá que realizar este proceso en el portal de la ciudad.
Posiciones fiscales¶
Para configurar la posición fiscal del mapeo automático de impuestos (Avalara Brasil), activa las opciones Detectar de manera automática y Usar el API de AvaTax Brasil.
Ver también
Productos¶
Para utilizar la integración con AvaTax en órdenes de venta y facturas, ingrese la información a continuación en la pestaña Ventas del formulario del producto en la sección Contabilidad de Brasil, dependiendo de cómo se usará el producto.
Factura electrónica para bienes (NFS-e)¶
Importante
La integración con Avalara funciona en un sistema a base de créditos en el que cada interacción con Avalara consume un crédito. A continuación, podrás encontrar las operaciones principales que consumen créditos:
Aplicación Ventas
Cálculo de impuestos en cotizaciones y órdenes de venta
Aplicación Contabilidad
Cálculo de impuestos en facturas.
Emisión de facturas electrónicas (NF-e o NFS-e).
Operaciones ocasinales: (cada paso se factura por separado)
Nota
Si los impuestos se calculan en la aplicación Ventas y la factura se emite después en la aplicación Contabilidad, el cálculo ocurre dos veces, por lo que se consumen dos créditos.
Example
CEST Code (Código CEST): Un código de clasificación de impuestos para identificar bienes y productos sujetos a una sustitución tributaria según las normas ICMS. Nos ayuda a determinar el régimen fiscal aplicable y los procedimientos para apuntes específicos. Puede revisar si este requisito aplica a un producto en https://www.codigocest.com.br/.
Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.
Fuente de origen: El 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 lista del Sistema Público de Contabilidad Digital (SPED).
Propósito de uso: El propósito de uso previsto de este producto.
Nota
De forma automática, Odoo crea tres productos que se usarán para costos de transporte relacionados a la venta, llamados Flete, Seguro y Otros costos y ya están configurados. Si se necesita crear más, duplíquelos y use la misma configuración:
Tipo de producto Servicio
Costo del tipo de transporte: Seguro, flete, u otros costos
Facturas electrónicas para servicios (NFS-e)¶
Importante
La integración con Avalara funciona en un sistema a base de créditos en el que cada interacción con Avalara consume un crédito. A continuación, podrás encontrar las operaciones principales que consumen créditos:
Aplicación Ventas
Cálculo de impuestos en cotizaciones y órdenes de venta
Aplicación Contabilidad
Cálculo de impuestos en facturas.
Emisión de facturas electrónicas (NF-e o NFS-e).
Revisión del estado de la factura (se consume 1 crédito cada vez que se revisa el estado de la factura).
Operaciones ocasinales: (cada paso se factura por separado)
Nota
Si los impuestos se calculan en la aplicación Ventas y la factura se emite después en la aplicación Contabilidad, el cálculo ocurre dos veces, por lo que se consumen dos créditos.
Example
Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.
Propósito de uso: El propósito de uso previsto de 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 de verificación que debe seleccionar si el servicio incluye mano de obra.
Costo del tipo de transporte: El costo del tipo de transporte que debe seleccionar.
Códigos de servicio: El código de servicio de la ciudad en la que se proporcionará el registro. Si no se agrega un código, se usará el Código de servicio de origen.
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
Haga clic en Calcular impuestos con AvaTax.
- Al visualizar la vista previa
Haga clic en Vsita previa.
- Al enviar un correo con una cotización u orden 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
Haga clic en Calcular impuestos con AvaTax.
- Al visualizar la vista previa
Haga clic en Vsita 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¶
Un número de series está vinculado a un rango de números de secuencia para facturas electrónicas. Para configurar un número de series en un diario de ventas, vaya a Series. Si necesita más de una serie, deberá crear un diario de ventas nuevo y asignar un nuevo número de series para cada series.
y configúrelo en el campoEl campo Series solo se mostrará si se selecciona la opción ¿Usar documentos? en el diario, por lo que tendrá que habilitar esta opción.
Al emitir facturas electrónicas o no electrónicas, el campo Tipo selecciona el tipo de documento que se usará al crear una factura.
Nota
Al crear el diario, asegúrese de que el campo secuencia de notas de crédito dedicada en la sección Información contable no esté marcado, ya que en Brasil las secuencias entre facturas, notas de crédito y notas de débito se comparten por número de series, es decir, por diario.
Facturas de cliente¶
Para procesar una factura electrónica para bienes (NF-e) o servicios (NFS-e), la factura debe estar confirmada y los impuestos deben estar calculados con Avalara. Debe llenar los campos a continuación:
Cliente, con toda la información del cliente.
Método de pago: Brasil: Establece el método de pago esperado.
Tipo de documento: Selecciona (55) Factura electrónica (NF-e) o (SE) Factura de servicio electrónico (NFS-e).
Pestaña Otra información:
Posición fiscal establecida 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 necesarios, por lo que en la mayoría de los casos, si los deja en blanco no se generarán errores de parte del gobierno al enviar la factura:
El modelo de flete determina cómo se planean los bienes para transporte - doméstico.
El transportista de Brasil determina quién se encargará del transporte.
Después, haz clic en Enviar. En la ventana Imprimir y enviar, 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 usada para emitir una factura electrónica también están disponibles en la orden de ventas. Al crear la primera factura, aparecerá el campo Número de documento, asignado como el primer número que se utilizará de manera secuencial para las facturas subsecuentes.
Notas de crédito¶
Si necesitas registrar una devolución de ventas, puedes 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¶
Puede emitir una nota de débito si necesita incluir información adicional o valores que no eran correctos en la factura original y se deben corregir.
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 ser parte de la nota de débito. Además, puede realizar cambios en el precio unitario del producto o en las cantidades, pero no puede agregar productos a la nota de débito. El objetivo de este documento solo es declarar el importe que quiere agregar a la factura original por los mismos productos o menos.
Cancelar facturas¶
Sí se puede cancelar una factura electrónica que ya haya validado el gobierno.
Nota
Revise si la factura electrónica todavía está dentro de la fecha límite de cancelación, que puede variar de acuerdo con la legislación de cada estado.
Factura electrónica para bienes (NFS-e)¶
Para cancelar una factura electrónica para bienes (NF-e) en Odoo, haz clic en Solicitar cancelación y agrega un motivo para la cancelación en la ventana emergente que aparece. Para enviar este motivo de cancelación al cliente a través del correo electrónico, habilita Correo electrónico.
Nota
Esta es una cancelación electrónica, es decir, Odoo enviará una solicitud al gobierno para que cancele la NF-e, pero esta llamada API consumirá uno de sus créditos de compras dentro de la aplicación (IAP).
Facturas electrónicas para servicios (NFS-e)¶
Para cancelar una factura electrónica de servicios (NFS-e) en Odoo, debes hacer clic en Solicitar cancelación. No hay un proceso de cancelación electrónica, pues no todas las ciudades disponen de este servicio. El usuario debe cancelar esta NFS-e de forma manual en el portal de la ciudad. Después de completar este paso, puedes solicitar la cancelación en Odoo para cancelar la factura.
Carta de corrección¶
Es posible crear una carta de rectificación y vincularla a una factura electrónica para bienes (NF-e) que el gobierno haya validado.
Para hacer esto en Odoo, haz clic en Carta de corrección y agrega un motivo de corrección en la ventana emergente que aparece. Para enviar este motivo de corrección por correo electrónico a un cliente, selecciona la opción Correo electrónico.
Nota
Las cartas de rectificación solo están disponibles para las facturas electrónicas de bienes (NF-e).
Invalidación del rango del número de la factura¶
El gobierno puede invalidar una serie de secuencias asignadas a los diarios de ventas si no están en uso y no se usarán en el futuro. Para hacerlo, ve a Invalidar rango de números (BR). En el asistente para Invalidar rango de números (BR), agrega el número inicial y el número final del rango que se deba cancelar y escribe el motivo.
, abre el diario, haz clic en el icono (engranaje) y seleccionaNota
La invalidación de un rango de número de factura solo está disponible para facturas electrónicas de bienes (NF-e).
El chatter del diario lleva un registro de los números cancelados, junto con el archivo XML.
Facturas de proveedor¶
Al recibir las facturas del proveedor, ingrésalas a Odoo. Agrega toda la información comercial junto la misma información específica de Brasil registrada en las facturas de clientes.
Los campos específicos para Brasil son:
Método de pago: Brasil: Establece el método de pago esperado.
Tipo de documento: El que usa el proveedor.
Número de documento: El número de la factura del proveedor.
Modelo de flete: específico para NF-e. Determina cómo planea transportar los bienes de forma local.
Transportista de Brasil: específico para NF-e. Quién se encarga de la transportación.
NFC-e de Punto de venta¶
El NFC-e es un documento legal que se emite para la venta de bienes o mercancía al consumidor final. Como el NF-e, la factura electrónica del cliente también se emite en un archivo de formato XML e incluye un documento auxiliar (DANFC-e) conocido como el NFC-e de resumen. Este es un documento electrónico se puede emitir a través del Punto de venta de Odoo.
La validez legal se garantiza con la firma digital y por la SEFAZ (Secretaría de hacienda) de cada estado de Brasil.
Importante
La integración con Avalara funciona con un sistema a base de créditos. Cada operación que involucra comunicación con Avalara consume un crédito. Las siguientes operaciones dentro del Punto de venta (PdV) consumen créditos:
Cálculo de impuestos al momento de la venta
Emisión de factura electrónica (NFC-e)
Nota
Cada paso se cobra por separado. Por ejemplo, el cálculo de impuestos y la emisión de una factura para la misma transacción del PdV consume dos créditos.
Ver también
Configuración¶
Instala el módulo Contabilidad EDI de Brasil para el PdV (l10nbr_edi_pos
) y asegúrate de activar AvaTax.
Detalles CSC¶
Ve a Impuestos. En la sección configuración NFC-e, completa los campos de CSC (Código de seguridad del contribuyente) a continuación:
y deslízate a la secciónCSC ID: El CSC ID o token CSC es la identificación del código de seguridad del contribuyente. Puede tener de 1 a 6 dígitos y está disponible en el sitio web oficial de la Secretaría de hacienda (SEFAZ) de su estado.
CSC Number (Número CSC): El número CSC es un código de hasta 36 caracteres que solo usted y la Secretaría de hacienda conocen. Se usa para generar el código QR del NFC-e y asegura la autenticidad del DANFE.
Nota
La información necesaria para llenar estos campos la puede generar el contador de la empresa en el sitio web de la SEFAZ de cada estado de Brasil.
Configuración de productos¶
Accede al formulario del producto en el PdV y configura los campos de la contabilidad brasileña del producto.
Punto de venta¶
Ve a seleccionado en la parte superior de la pantalla sea el correcto. Después, ve a la sección Contabilidad y configura los campos para el EDI de Brasil:
y asegúrate de que el punto de ventaSeries
Número siguiente: El siguiente número NFC-e que se emitirá, por ejemplo, si el último número emitido es SEFAZ es
100
, el Número siguiente será101
.
Flujo¶
Generar una NFC-e¶
Para generar una NFC-e, sigue los pasos a continuación:
Abre la tienda de punto de venta relevante y realiza una venta.
Valida el pago para calcular los impuestos y emite una NFC-e. La NFC-e válida aparece en el lado derecho de la pantalla.

Nota
También es posible emitir una NFC-e en la que se identifique al cliente con su CPF/CNPJ. Para hacerlo, haz clic en Cliente y busque el cliente o cree uno nuevo.
Los campos a continuación son obligatorio para poder emitir una NFC-e identificada con CPF/CNPJ:
Nombre
Ciudad y Estado donde se emite la factura.
CPF/CNPJ
Haz clic en Validar. La NFC-e aparecerá y se resaltará el CPF del cliente en la impresión.
Haz clic en Imprimir o en Enviar por correo electrínico para entregarle la factura al cliente.
Imprimir ticket NFC-e¶
Después de generar y validar la NFC-e, haga clic en Imprimir para entregar la factura.
Nota
La función NFC-e de Odoo es compatibl con cualquier impresora térmica y no requiere una caja IoT de Odoo.
Volver a emitir una orden del PdV con error de NFC-e¶
Si la NFC-e regresa un error, sigue los pasos a continuación:
Corrige el error.
Haz clic en el icono (menú) y selecciona Órdenes para volver a emitir el NFC-e.
Usa un filtro en la lista para que se muestren solo las órdenes Pagadas y haga clic en Detalles. Se mostrará el error.
Haz clic en Enviar NFC-e.
Nota
Si corrigiste el error y se cerró la sesión de PdV, Odoo registra el ajuste de impuesto en el chatter del asiento contable relacionado. El asiento contable para la orden indica que los impuestos no se calcularon bien. En este caso, debes volver a procesar la NFC-e.

Reembolsos y cancelaciones de NFC-e¶
Puede procesar reembolsos directamente en Odoo, pero las cancelaciones se deben realizar a través del portal oficial del gobierno.
Al finalizar el proceso, se crea la devolución de NF-e aprobada, es decir que la NFC-e anterior se cancela.

Importante
SEFAZ solo permite la cancelación de una NFC-e hasta 30 minutos después de su emisión en el sitio web de SEFAZ. Si se agota este tiempo, se debe procesar un reembolso manual y se debe emitir una NF-e de reembolso de bienes.