Brasil

Introducción

Con la localización brasileña es posible calcular los impuestos de venta de manera automática y enviar las facturas electrónicas de bienes (NF-e) y servicios (NFS-e) con AvaTax (Avalara) mediante llamadas API. También puede configurar los impuestos para servicios.

Para calcular impuestos sobre bienes y servicios y poder realizar el proceso de facturación electrónica es necesario que configure los contactos, la empresa, los productos y que cree una cuenta en AvaTax que deberá configurar en los ajustes generales.

Puede crear y configurar impuestos de servicios directamente desde Odoo sin calcularlos con AvaTax.

La localización también incluye impuestos y una plantilla del plan de cuentas que se puede modificar si es necesario.

Configuración

Instalación de módulos

Instale los siguientes módulos para obtener todas las funciones de la localización de Brasil:

Nombre

Nombre técnico

Descripción

Brasil - Contabilidad

l10n_br

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

l10n_br_reports

Reportes contables para Brasil.

AvaTax Brasil y AvaTax Brasil para sevicios

l10n_br_avatax y l10n_br_avatax_services

Cálculo de impuestos para bienes y servicios a través de Avalara.

EDI para contabilidad brasileña y EDI para contabilidad brasileña para servicios

l10n_br_edi y l10n_br_edi_services

Proporciona facturación electrónica de bienes y servicios para Brasil mediante AvaTax.

Códigos QR Pix para Brasil

l10n_br_pix

Implementa códigos QR Pix para Brasil.

Configure su empresa

Para configurar la información de su empresa, vaya a la aplicación Contactos y busque el nombre de su empresa.

  1. Seleccione la opción Empresa en la parte superior de la página y configure los siguientes campos:

    • 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

    Configuración de la empresa.
  2. Configure la información fiscal en la pestaña Ventas y compras:

    • Agregue 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

    Configuración fiscal de la empresa.
  3. Configure la siguiente información fiscal adicional en caso de que deba emitir NFS-e:

    • Agregue 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.

    Configuración fiscal de la empresa para NFSe.
  4. Por último, suba el logo de la empresa y guarde el contacto.

Nota

Si se encuentra bajo un régimen simplificado, debe configurar la tasa de ICMS en Contabilidad ‣ Configuración ‣ Ajustes ‣ Impuestos ‣ AvaTax Brasil.

Configurar la integración con AvaTax

Avalara AvaTax es un proveedor de cálculo de impuestos y facturación electrónica que se puede integrar a Odoo para calcular automáticamente los impuestos teniendo en cuenta la información de la empresa, el contacto (cliente), el producto y la transacción, para obtener el impuesto correcto a utilizar y procesar la factura electrónica posteriormente con el gobierno.

El uso de esta integración necesita de compras dentro de la aplicación (IAP) para calcular los impuestos y para enviar las facturas electrónicas. Cada que calcula impuestos, envía un documento electrónico (NF-e, NFS-e, etc) o lleva a cabo cualquier otro flujo electrónico (cancelar un NF-e, enviar una carta de rectificación, invalidar un número de factura), realiza una llamada a la API que usa los créditos de su cuenta de compras dentro de la aplicación.

Nota

Configuración de credenciales

Para activar AvaTax en Odoo es necesario que cree una cuenta. Para ello, vaya a Contabilidad ‣ Configuración ‣ Ajustes ‣ Impuestos y en la sección AvaTax Brasil agregue la dirección de correo electrónico de administración que utilizará para el portal de AvaTax en el campo Correo electrónico del portal de AvaTax. Después, haga clic en Crear cuenta.

Advertencia

Use 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 iniciar sesión en el portal de Avalara y configurar los certificados.

Hay dos portales de Avalara distintos, uno para pruebas y otro para producción:

Asegúrese de seleccionar el entorno adecuado cuando cree la cuenta desde Odoo. Además, el correo electrónico que use para abrir la cuenta no podrá usarlo para abrir otra. Guarde el ID de la API y su clave API cuando cree la cuenta desde Odoo.

Transferir credenciales API.

Después de crear la cuenta desde Odoo, debe ir al portal de Avalara para configurar su contraseña:

  1. Ingrese al portal de Avalara.

  2. Haga clic en Meu primeiro acesso (acceder por primera vez).

  3. Escriba la dirección de correo electrónico que utilizó en Odoo para crear la cuenta de Avalara/AvaTax y luego haga clic en Solicitar Senha (solicitar contraseña).

  4. Recibirá un correo electrónico con un token y un enlace para crear su contraseña, haga clic en este último y copie y pegue el token para continuar.

Truco

Puede comenzar a utilizar AvaTax en Odoo para el cálculo de impuestos solo sin crear una contraseña y acceder al portal de Avalara en la base de datos de Odoo. Sin embargo, para utilizar el servicio de factura electrónica, debe acceder al portal de AvaTax y subir su certificado allí.

Configuración de la cuenta de AvaTax.

Nota

Puede transferir credenciales API. Hágalo solo cuando ya haya creado una cuenta en otra instancia de Odoo y desee volver a utilizarla.

Subir certificado A1

Si desea emitir facturas electrónicas, debe subir un certificado en el 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 que vincule el certificado dentro del sistema del portal de la ciudad antes de que pueda emitir NFS-e con Odoo.

Si la ciudad le envía un mensaje de error con el texto Su certificado no está vinculado al usuario, entonces debe realizar el proceso en el portal correspondiente.

Configurar los datos maestros

Plan contable

El plan de cuentas se instala de forma predeterminada como parte del conjunto de datos incluido en el módulo de localización. Las cuentas se asignan de forma automática a los impuestos correspondientes y a los campos predeterminados de cuentas por pagar y cuentas por cobrar.

Nota

El plan de cuentas del Brasil toma como referencia el plan de cuentas SPED, que proporciona un punto de partida para las cuentas necesarias en Brasil.

Puede agregar o eliminar cuentas según lo necesite la empresa.

Diarios contables

En Brasil, un número de serie está vinculado a un rango de números de secuencia para facturas electrónicas. El número de serie se puede configurar en Odoo en un diario de ventas desde el campo series. Si se necesita más de una serie, entonces se deberá crear un nuevo diario de ventas y asignarle un nuevo número de serie para cada serie necesaria.

Debe seleccionar el campo usar documentos. Al emitir facturas electrónicas y no electrónicas, el campo tipo selecciona el tipo de documento utilizado al crear la factura. El campo tipo solo se mostrará si el campo usar documentos está seleccionado en el diario.

Configuración del diario con el campo "usar documento" marcado.

Nota

Al crear el diario, asegúrese de que el campo secuencia de notas de crédito dedicada 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 serie, es decir, por diario.

Impuestos

Los impuestos se crean en automático cuando instala la localización brasileña. Estos ya están configurados y Avalara utiliza algunos de ellos al calcular los impuestos sobre la orden de venta o la factura.

Puede editar o agregar más impuestos. Por ejemplo, algunos impuestos que se utilizan en los servicios se deben agregar y configurar manualmente, ya que la tasa puede cambiar según la ciudad donde se ofrezca el servicio.

Importante

No podrá emitir NFS-e si decide realizar sus impuestos de servicio manualmente. Para enviar NFS-e de forma electrónica deberá calcular los impuestos con Avalara.

Advertencia

No elimine ningún impuesto, AvaTax los necesita para realizar los cálculos. Si los elimina, Odoo los creará de nuevo cuando se utilicen en una orden de venta o factura y al calcular impuestos con AvaTax, pero debe configurar otra vez la cuenta que se utiliza para registrar el impuesto. Vaya a la pestaña Definición en las secciones de Distribución para facturas y Distribución para reembolsos.

Productos

Para utilizar la integración de AvaTax en las órdenes de venta y facturas, primero especifique la siguiente información en el producto según su uso previsto:

Factura electrónica para bienes (NF-e)
  • Código CEST: código para los productos sujetos a la sustitución de impuestos ICMS.

  • Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.

  • Fuente de origen: especifica el origen del producto. 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: especifique el propósito de uso previsto de este producto.

Configuración de un producto.

Nota

De forma automática, Odoo crea tres productos que ya están configurados (flete, seguro y otros costos) y se utilizan para los costos de transporte asociados a las ventas. Si necesita crear más, duplique los existentes y utilice la misma configuración. Seleccione servicio como tipo de producto, en tipo de costos de transporte seleccione entre flete, seguro y otros costos.

Factura electrónica para servicios (NFS-e)
  • Código NCM Mercosur: código de producto de la Nomenclatura común del Mercosur.

  • Propósito de uso: especifique 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.

  • Códigos de servicio: el código de servicio de la ciudad en la que proporcionará el servicio. Usará el código de la ciudad de origen si no proporciona ninguno.

  • Asignación de mano de obra: define si sus servicios incluyen mano de obra.

Contactos

Antes de utilizar la integración, especifique la siguiente información del contacto:

  1. Información general sobre el contacto:

    • 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).

    • 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: número de identificación fiscal estatal.

    • IM: número de identificación fiscal municipal.

    • Código SUFRAMA: número de registro SUFRAMA.

    • Teléfono

    • Correo electrónico

    Configuración de contacto.

    Nota

    Los campos CPF, IE, IM y Código SUFRAMA están ocultos hasta que seleccione Brasil como país.

  2. Información fiscal sobre el contacto en la pestaña ventas y compra:

    • Posición fiscal: agregue la posición fiscal de AvaTax para calcular de forma automática los impuestos en las órdenes de venta y las facturas.

    • Régimen fiscal: régimen fiscal federal.

    • Tipo de contribuyente ICMS: el tipo de contribuyente determina si el contacto pertenece al régimen ICMS, su estado de exención o si no es contribuyente.

    • Sector de actividad principal: una lista de los sectores de actividad principal del contacto.

    Configuración fiscal del contacto.
  3. Configure la siguiente información fiscal adicional en caso de que deba emitir NFS-e:

    • Agregue 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.

    Configuración fiscal del contacto para NFSe.

Posiciones fiscales

Si desea calcular impuestos y enviar facturas electrónicas en órdenes de venta y facturas, debe habilitar tanto las opciones detectar automáticamente como usar API de AvaTax deben estar habilitadas en la posición fiscal.

Es posible configurar la posición fiscal desde el contacto o puede seleccionarla al crear una orden de venta o una factura.

Configuración de la posición fiscal

Flujos de trabajo

Esta sección proporciona un resumen de las acciones que ejecutan llamadas a la API para calcular impuestos. También incluye instrucciones sobre cómo enviar facturas electrónicas de bienes (NF-e) y servicios (NFS-e) para su validación gubernamental.

Advertencia

Tenga en cuenta que las llamada a la API no son gratis. Sea cuidadoso con las acciones que activan las llamadas para tener mejor control sobre los gastos que realiza.

Cálculo de impuestos

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 el botón Vista 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 el botón 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.

Documentos electrónicos

Facturas de cliente

Para procesar una factura electrónica de bienes (NF-e) o servicios (NFS-e) primero debe confirmar la factura, después Avalara debe calcular los impuestos. Una vez que haya completado ese paso, haga clic en el botón Enviar e imprimir ubicado en la esquina superior izquierda. Aparecerá una ventana emergente, allí haga clic en Procesar factura electrónica y después haga clic en alguna de las otras opciones, estas son Descargar y Enviar por correo electrónico. Por último, haga clic en Enviar e imprimir para procesar la factura al gobierno.

Antes de enviar la factura electrónica para bienes (NF-e) o servicios (NFS-e) debe completar algunos campos en ella:

  • Cliente, con toda la información del cliente.

  • Método de pago: Brasil: cómo se planea pagar la factura.

  • Posición fiscal establecida como mapeo automático de impuestos (Avalara Brasil)

  • Tipo de documento establecido como (55) Factura electrónica (NF-e) o (SE) Factura de servicio electrónico (NFS-e).

Hay algunos otros campos opcionales que dependen de la naturaleza de la transacción. En la mayoría de los casos estos campos no son obligatorios, por lo que no aparecerán errores en la parte del gobierno si estos campos opcionales no están completos.

  • El modelo de flete determina cómo se planean transportar los bienes - doméstico.

  • El transportista de Brasil determina quién se encargará del transporte

Información de facturación obligatoria para procesar una factura electrónica. Ventana emergente para procesar una factura electrónica en Odoo.

Nota

Todos los campos disponibles en la factura que uso 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 necesita registrar una orden de devolución, entonces tiene que crear una nota de crédito en Odoo para enviarla al gobierno para que la validen.

Nota

Las notas de crédito solo están disponibles para las facturas electrónicas de bienes (NF-e).

Notas de débito

Es posible emitir una nota de débito si necesita incluir información adicional o debe corregir valores erróneos en la factura original.

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

Es posible cancelar una factura electrónica que ya validó el gobierno.

Nota

Revise si la factura electrónica todavía se encuentra dentro de la fecha límite de cancelación, la cual puede variar de acuerdo con la legislación de cada estado.

Factura electrónica para bienes (NFS-e)

Es posible cancelar una factura electrónica para bienes (NF-e) en Odoo al hacer clic en Solicitar cancelación y agregar el motivo correspondiente en la ventana emergente que aparece. Seleccione la casilla Correo electrónico si desea enviar este motivo al cliente mediante un correo electrónico.

Motivo de cancelación de la factura en Odoo.

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 consumirá uno de sus créditos IAP.

Facturas electrónicas para servicios (NFS-e)

En Odoo puede cancelar una factura electrónica de servicios (NFS-e) al hacer clic en Solicitar cancelación. En este caso 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. Puede solicitar la cancelación en Odoo luego de completar ese paso y esta acción 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 ya haya sido validada por el gobierno.

Esto se puede hacer en Odoo si hace 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 a un cliente mediante un correo electrónico, active la casilla Correo electrónico.

Motivo de la carta de corrección en Odoo.

Nota

Las cartas de rectificación solo están disponibles para las facturas electrónicas de bienes (NF-e).

Invalidar el rango de números de factura

A range of sequences that are assigned to sales journals can be invalidated with the government if they are not currently used, and will not be used in the future. To do so, navigate to the journal, and click the ⚙️ (gear) icon ‣ Invalidate Number Range (BR). On the Invalidate Number Range (BR) wizard, add the Initial Number and End Number of the range that should be cancelled, and enter an invalidation Reason.

Selección del rango de números a invalidar en Odoo. Asistente para invalidar un rango de números en Odoo.

Nota

Solo es posible invalidar documentos de números de facturas si de trata de facturas electrónicas de bienes (NF-e).

Nota

The log of the cancelled numbers along with the XML file are recorded in the chatter of the journal.

Facturas de proveedor

En cuanto a las facturas de proveedor, al recibir una, puede ingresarla en Odoo al agregar 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: cómo se planea pagar la factura.

  • Tipo de documento: el que usa su proveedor.

  • Número de documento: el número de factura de su distribuidor.

  • 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.