Brasile¶
Vedi anche
Risorse utili per la localizzazione brasiliana, inclusi materiali di onboarding e video:
Moduli¶
The following modules are installed automatically with the Brazilian localization:
Nome |
Nome tecnico |
Descrizione |
|---|---|---|
Brasile - Contabilità |
|
Default fiscal localization package, which represents having the Generic Brazilian chart of accounts and Taxes, together with document types and identification types. |
Brasile - Report contabili |
|
Report contabili per il Brasile. |
Brazil Pix QR codes |
|
Implements Pix QR codes for Brazil. |
Brazil - Sale Subscription |
|
Subscriptions modifications for Brazil. |
Brazil - Sale |
|
Sales modifications for Brazil. |
Brazil - Website Sale |
|
Consente il calcolo delle imposte e l’EDI per gli utenti e-commerce. |
Inoltre, i seguenti moduli devono essere installati manualmente:
Nome |
Nome tecnico |
Descrizione |
|---|---|---|
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 fiscal reform. |
Avatax Brazil Fiscal Reform |
|
Avatax modifications for fiscal reform. |
Avatax Brazil Sale Fiscal Reform |
|
Sales Avatax modifications for fiscal reform |
Avatax Brasile Vendite per servizi |
|
Sales modifications for Brazil for services |
Brazilian Accounting EDI & Brazilian Accounting EDI for services |
|
Provides electronic invoicing for goods and services for Brazil through AvaTax. |
EDI contabile brasiliano per vendite |
|
Adds fields to sales orders that will be carried over to the invoice. |
Nota
In alcuni casi, come durante l’aggiornamento a una versione con moduli aggiuntivi, è possibile che i moduli non vengano installati automaticamente. Eventuali moduli mancanti possono essere installati manualmente.
Panoramica della localizzazione¶
Il pacchetto di localizzazione brasiliano garantisce la conformità alle normative fiscali e contabili brasiliane. Include strumenti per la gestione delle imposte, delle posizioni di bilancio, della reportistica e un piano dei conti predefinito su misura per gli standard brasiliani.
Il pacchetto di localizzazione brasiliano fornisce le seguenti funzionalità chiave per garantire la conformità alle normative fiscali e contabili locali:
Piano dei conti: una struttura predefinita su misura per gli standard contabili brasiliani
Imposte: aliquote fiscali preconfigurate, comprese opzioni standard IVA, aliquota zero ed esenzioni.
Piano dei conti¶
Nel piano dei conti, i conti vengono mappati automaticamente alle imposte corrispondenti e ai campi predefiniti conto fornitori e conto clienti.
Nota
Il piano dei conti brasiliano si basa sul CoA SPED, che fornisce una base dei conti necessari.
Imposte¶
Le imposte vengono create e configurate automaticamente durante l’installazione della localizzazione brasiliana. Avalara ne utilizza alcune per calcolare le imposte sugli ordini di vendita o sulle fatture.
Le imposte utilizzate per i servizi devono essere aggiunte e configurate manualmente, poiché l’aliquota può variare a seconda della città in cui viene offerto il servizio.
Importante
L’NFS-e non può essere emessa per imposte sui servizi create manualmente. Per inviare elettronicamente un’NFS-e, calcolare le imposte utilizzando Avalara.
Avvertimento
Non eliminare le imposte, poiché vengono utilizzate per il calcolo delle imposte AvaTax. Se eliminate, Odoo le crea nuovamente quando utilizzate in un SO o fattura, calcolando le imposte con AvaTax. Tuttavia, il conto utilizzato per registrare l’imposta deve essere riconfigurato nella scheda Definizione dell’imposta, nelle sezioni Distribuzione per fatture e Distribuzione per note di credito.
Prodotti¶
Accurate fiscal classification of goods and services is essential for tax calculation and electronic invoice issuance in compliance with Brazilian regulations and the 2026 Tax Reform.
Nota
Brazil must be specified in the Country field of the company form to display the required fields for the fiscal reform.
The following information, specific to the fiscal reform, is required 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.
Azienda e contatti¶
Per utilizzare tutte le funzionalità di questa localizzazione fiscale, i seguenti campi sono obbligatori sulla scheda azienda:
Nome
Indirizzo: aggiungere Città, Stato, CAP, Paese
Nel campo Via, inserire il nome della via, il numero civico e qualsiasi informazione aggiuntiva sull’indirizzo.
Nel campo Via 2, inserire il quartiere.
Numero di identificazione: CNPJ o CPF
Partita IVA: associata al tipo di identificazione
IE: Registrazione statale
IM: Registrazione municipale
Codice SUFRAMA: Sovrintendenza della zona franca di Manaus - aggiungere se applicabile
Telefono
E-mail
Suggerimento
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:
aggiungi la posizione di bilancio per AvaTax Brasile
Tax Regime: Federal tax regime.
ICMS Taxpayer Type: Select ICMS regime, Exempt status, or Non-Taxpayer.
Settore di attività principale
2026 tax reform fields:
Tax Regime: For the simplified tax regime (Simples Nacional), set up the additional fields specific to the fiscal reform:
CBS/IBS Normal: Enable the option for Regime Normal (Regime Regular) regime or disable for Hybrid Simples Nacional (Regime Hibrido) regime. For 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 model.
IBS Presumed Credit (%): Specify the percentage of presumed IBS credit available for entities under the Hybrid Simples Nacional tax model.
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.
Configurare le seguenti Informazioni fiscali aggiuntive per emettere NFS-e:
aggiungi la posizione di bilancio per AvaTax Brasile
COFINS Details: When a transaction is exempt from COFINS even though all parties and items are taxable, this attribute identifies the exemption scenario and applies the override accordingly. Select the appropriate option.
PIS Details: When a transaction is exempt from PIS even though all parties and items are taxable, this attribute identifies the exemption scenario and applies the override accordingly. Select the appropriate option.
CSLL Taxable: Enable the option if the company is subject to CSLL.
Suggerimento
Se si tratta di un regime semplificato, è necessario configurare l’aliquota ICMS. Per farlo, andare su , scorrere fino alla sezione Imposte e impostare i campi Imposta di vendita e Imposta d’acquisto nella sezione Imposte predefinite.
La stessa configurazione si applica al modulo contatto pertinente quando si utilizza l’integrazione AvaTax.
Nota
Selezionare l’opzione Azienda per un contatto con partita IVA (CNPJ) oppure selezionare Privato per un contatto con codice fiscale (CPF).
Integrazione AvaTax¶
Nota
Assicurarsi di installare il modulo AvaTax Brasile (
l10n_br_avatax).Odoo è un partner certificato di Avalara Brasile.
L”integrazione Avalara AvaTax utilizza acquisti in-app (IAP) per calcolare le imposte e gestire i documenti elettronici (ad es. NF-e, NFS-e). Ogni azione consuma crediti dal saldo crediti IAP. Al momento della creazione, i nuovi database ricevono 500 crediti gratuiti.
Per calcolare l’imposta su beni e servizi e processare le fatture elettroniche, sono necessarie le seguenti configurazioni:
Configurazione¶
Credenziali¶
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.
Avvertimento
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.
Esistono due diversi portali Avalara brasiliani:
Uno per i test: https://portal.sandbox.avalarabrasil.com.br/
Uno per la produzione: https://portal.avalarabrasil.com.br/
Quando l’account viene creato da Odoo, selezionare l’ambiente corretto. Inoltre, l’email utilizzata per aprire l’account non può essere utilizzata per aprirne un altro. Salvare API ID e API Key quando l’account viene creato da Odoo.
Dopo aver creato l’account da Odoo, accedere al portale Avalara per impostare la password:
Accedere al portale Avalara.
Fare clic su Meu primeiro acesso.
Aggiungere l’indirizzo email utilizzato in Odoo per creare l’account Avalara/AvaTax e fare clic su 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.
Suggerimento
Se si utilizza AvaTax in Odoo solo per il calcolo delle imposte, impostare una password o accedere al portale Avalara non è necessario. Tuttavia, per utilizzare il servizio di fatturazione elettronica, è necessario l’accesso ad AvaTax e il certificato deve essere caricato.
Nota
Le credenziali API possono essere trasferite. Questa opzione dovrebbe essere utilizzata solo quando un account è già stato creato in un’altra istanza Odoo e deve essere riutilizzato.
Fiscal reform¶
To enable the sending of the new attributes of the 2026 tax reform, follow these steps:
Go to and scroll to the Taxes section.
Under AvaTax Brazil, enable the Enable Brazilian fiscal reform option.
Suggerimento
If inconsistencies occur when submitting fiscal reform information, disable the Enable Brazilian fiscal reform option to revert to the previous communication model.
Caricamento certificato A1¶
Per emettere fatture elettroniche, è necessario caricare un certificato nel portale AvaTax.
Il certificato verrà sincronizzato con Odoo purché il numero identificativo esterno nel portale AvaTax corrisponda, senza caratteri speciali, al numero CNPJ e il numero di identificazione (CNPJ) in Odoo corrisponda al CNPJ in AvaTax.
Importante
Alcune città richiedono che il certificato sia collegato all’interno del sistema del portale comunale prima di emettere NFS-e da Odoo.
Se si riceve un messaggio di errore dalla città che dice Il tuo certificato non è collegato all’utente, questo processo deve essere eseguito nel portale comunale.
Posizioni di bilancio¶
To set up the Automatic Tax Mapping (Avalara Brazil) fiscal position, enable the Detect Automatically and Use AvaTax Brazil API options.
Vedi anche
Prodotti¶
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.
Fatture elettroniche per beni (NF-e)¶
Importante
L”integrazione Avalara funziona su un sistema basato su crediti, in cui ogni interazione con Avalara consuma un credito. Di seguito sono riportate le principali operazioni che consumano crediti:
Applicazione Vendite
Calcolo delle imposte su preventivi e ordini di vendita.
Applicazione Contabilità
Calcolo delle imposte sulle fatture.
Invio della fattura elettronica (NF-e o NFS-e).
Operazioni occasionali: (ogni passaggio viene fatturato separatamente)
Nota
Se le imposte vengono calcolate nell’app Vendite e la fattura viene successivamente emessa nell’app Contabilità, il calcolo avviene due volte, consumando due crediti.
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.
Codice Mercosul NCM: codice prodotto della Nomenclatura Comune del Mercosur
Fonte di origine: origine del prodotto, che può essere estera o nazionale, tra altre possibili opzioni, a seconda del caso d’uso specifico
Tipo di prodotto fiscale SPED: tipo di prodotto fiscale secondo la tabella elenco SPED
Scopo d’uso: scopo d’uso previsto per questo prodotto
Nota
Odoo crea automaticamente tre prodotti da utilizzare per i costi di trasporto associati alle vendite. Questi sono denominati Trasporto, Assicurazione e Altri costi e sono già configurati. Se è necessario crearne altri, duplicare e utilizzare la stessa configurazione:
Product Type: Service
Tipo di costo di trasporto: Assicurazione, Trasporto o Altri costi
Fatture elettroniche per servizi (NFS-e)¶
Importante
L”integrazione Avalara funziona su un sistema basato su crediti, in cui ogni interazione con Avalara consuma un credito. Di seguito sono riportate le principali operazioni che consumano crediti:
Applicazione Vendite
Calcolo delle imposte su preventivi e ordini di vendita.
Applicazione Contabilità
Calcolo delle imposte sulle fatture.
Invio della fattura elettronica (NF-e o NFS-e).
Controllo dello stato della fattura (1 carta di credito viene consumato ogni volta che lo stato della fattura viene controllato).
Operazioni occasionali: (ogni passaggio viene fatturato separatamente)
Nota
Se le imposte vengono calcolate nell’app Vendite e la fattura viene successivamente emessa nell’app Contabilità, il calcolo avviene due volte, consumando due carte di credito.
Example
Codice Mercosul NCM: codice prodotto della Nomenclatura Comune del Mercosur
Scopo d’uso: scopo d’uso previsto per questo prodotto
Origine codice servizio: Codice servizio città in cui il fornitore è registrato
Assegnazione lavoro: casella di controllo per selezionare se il servizio comporta lavoro
Tipo di costo di trasporto: tipo di costi di trasporto da selezionare
Codici servizio: Codice servizio città in cui verrà fornito il servizio; se non viene aggiunto alcun codice, verrà utilizzato Origine codice servizio.
Calcolare le imposte¶
Vedi anche
Calcoli fiscali su preventivi e ordini di vendita¶
Attivare una chiamata API per calcolare automaticamente le imposte su un preventivo o un Ordine di vendita con AvaTax in uno dei seguenti modi:
- Conferma del preventivo
Confermare un preventivo in un Ordine di vendita.
- Attivazione manuale
Fare clic su Calcola imposte usando AvaTax.
- Anteprima
Fare clic su Anteprima.
- Inviare via email un preventivo/ordine di vendita
Inviare un preventivo o un ordine di vendita a un cliente via email.
- Accesso online al preventivo
Quando un cliente accede al preventivo online (tramite la vista portale), viene attivata la chiamata API.
Calcolo delle imposte sulle fatture¶
Attivare una chiamata API per calcolare automaticamente le imposte su una fattura cliente con AvaTax in uno dei seguenti modi:
- Attivazione manuale
Fare clic su Calcola imposte usando AvaTax.
- Anteprima
Fare clic su Anteprima.
- Accesso online alla fattura
Quando un cliente accede alla fattura online (tramite la vista portale), viene attivata la chiamata API.
Nota
La Posizione fiscale deve essere impostata su Automatic Tax Mapping (Avalara Brazil) affinché una di queste azioni calcoli automaticamente le imposte.
Contabilità¶
Documenti elettronici¶
Configurazione¶
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 the Use Documents? option to display the Series field.
Set the series number in the Series field.
Suggerimento
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 unchecked, as in Brazil, sequences between invoices, credit notes, and debit notes are shared per series number, which means per journal.
Quando si emettono fatture elettroniche e non elettroniche, il campo Tipo seleziona il tipo di documento utilizzato durante la creazione della fattura.
Fatture cliente¶
Per elaborare una fattura elettronica per beni (NF-e) o servizi (NFS-e), la fattura deve essere confermata e le imposte devono essere calcolate da Avalara. I seguenti campi devono essere compilati:
Cliente, con tutte le informazioni sul cliente
Metodo di pagamento: Brasile: specificare il metodo di pagamento previsto.
Tipo di documento: selezionare (55) Fattura elettronica (NF-e) o (SE) Fattura elettronica di servizio (NFS-e).
Scheda Altre info:
Posizione fiscale impostata come Mappatura fiscale automatica (Avalara Brazil).
Alcuni campi facoltativi dipendono dalla natura della transazione. Questi campi nella scheda Altre info non sono obbligatori, quindi nella maggior parte dei casi lasciarli vuoti non comporterà errori da parte del governo quando la fattura viene inviata:
Modello di trasporto determina come si prevede di trasportare le merci - nazionale.
Trasportatore Brasile determina chi si occupa del trasporto.
Quindi, fare clic su Invia. Nella finestra pop-up, fare clic su Elabora fattura elettronica e qualsiasi altra opzione, come Scarica o Email. Infine, fare clic su Invia per elaborare la fattura con il governo.
Nota
Tutti i campi disponibili sulla fattura utilizzata per emettere una fattura elettronica sono disponibili anche sull’ordine di vendita, se necessario. Quando si crea la prima fattura, viene visualizzato il campo Numero documento e assegnato come primo numero da utilizzare in sequenza per le fatture successive.
Note di credito¶
Se è necessario registrare un reso di vendita, è possibile creare una nota di credito in Odoo e inviarla al governo per la convalida.
Nota
Le note di credito sono disponibili solo per le fatture elettroniche di beni (NF-e).
Note di debito¶
Se è necessario includere informazioni aggiuntive o correggere valori non forniti con precisione nella fattura originale, è possibile emettere una nota di debito.
Nota
Le note di debito sono disponibili solo per le fatture elettroniche di beni (NF-e).
Solo i prodotti inclusi nella fattura originale possono essere inclusi nella nota di debito. Sebbene sia possibile modificare il prezzo unitario o la quantità del prodotto, i prodotti non possono essere aggiunti alla nota di debito. Lo scopo di questo documento è solo dichiarare l’importo da aggiungere alla fattura originale per gli stessi prodotti o un numero inferiore.
Annullamento fattura¶
È possibile annullare una fattura elettronica che il governo ha convalidato.
Nota
Verificare se la fattura elettronica rientra ancora nel termine di annullamento, che può variare in base alla legislazione di ciascuno stato.
Fatture elettroniche per beni (NF-e)¶
Per annullare una fattura elettronica di beni (NF-e) in Odoo, fare clic su Richiedi annullamento e aggiungere un Motivo di annullamento nella finestra che appare. Per inviare questo motivo di annullamento al cliente via email, abilitare la casella E-mail.
Nota
Si tratta di un annullamento elettronico, il che significa che Odoo invierà una richiesta al governo per annullare la NF-e. Ciò consumerà un credito IAP, poiché si verifica una chiamata API.
Fatture elettroniche per servizi (NFS-e)¶
Per annullare una fattura elettronica per servizi (NFS-e) in Odoo, fare clic su Richiedi annullamento. In questo caso non esiste un processo di annullamento elettronico, poiché non tutte le città hanno questo servizio disponibile. L’utente deve annullare questa NFS-e sul portale della città manualmente. Una volta completato questo passaggio, può richiedere l’annullamento in Odoo, che annullerà la fattura.
Lettera di correzione¶
È possibile creare e collegare una lettera di correzione a una fattura elettronica di beni (NF-e) che il governo ha convalidato.
Per farlo in Odoo, clicca su Lettera di correzione e aggiungi un Motivo di correzione al pop-up. Per inviare il motivo della correzione a un cliente via email, abilita la casella E-mail.
Nota
Le lettere di correzione sono disponibili solo per le fatture elettroniche per beni (NF-e).
Invalidazione della gamma di numeri di fattura¶
Una gamma di sequenze assegnate ai registri vendite può essere invalidata dal governo se non sono attualmente utilizzate e non saranno utilizzate in futuro. Per farlo, vai su , apri il registro, clicca sull’icona , e seleziona Invalida gamma di numeri (BR). Nella procedura guidata Invalida gamma di numeri (BR), aggiungi il Numero iniziale e il Numero finale della gamma che dovrebbe essere annullata, e inserisci un Motivo di invalidazione.
Nota
L’invalidazione della gamma di numeri di fattura è disponibile solo per le fatture elettroniche per beni (NF-e).
Il chatter del registro registra il log dei numeri annullati, insieme al file XML.
Fatture fornitore¶
Quando ricevi una fattura da un fornitore, codifica la fattura in Odoo aggiungendo tutte le informazioni commerciali e le stesse informazioni specifiche brasiliane registrate sulle fatture cliente.
Questi campi specifici brasiliani sono:
Metodo di pagamento: Brasile: specificare il metodo di pagamento previsto.
Tipo di documento: utilizzato dal fornitore
Numero di documento: il numero di fattura del fornitore
Freight Model (NF-e specific): how goods are planned to be transported - domestic
Transporter Brazil (NF-e specific): who is doing the transportation.