Brazilia¶
Vedeți și
Resurse utile pentru localizarea braziliană, incluzând materiale de orientare și videoclipuri:
Module¶
The following modules are installed automatically with the Brazilian localization:
Nume |
Nume tehnic |
Descriere |
|---|---|---|
Brazilian - Contabilitate |
|
Implicit pachetul de localizare fiscală, care reprezintă deținerea planului de conturi și impozite brazilian generic, împreună cu tipurile de documente și tipurile de identificare. |
Brazilia - Rapoarte contabile |
|
Rapoarte contabile pentru Brazilia. |
Brazil Pix QR codes |
|
Implementează coduri QR Pix pentru Brazilia. |
Brazilia - Abonament Vânzare |
|
Subscriptions modifications for Brazil. |
Brazilia - Vânzare |
|
Sales modifications for Brazil. |
Brazilia - Vânzare Site Web |
|
Permite calcularea taxelor și EDI pentru utilizatorii eCommerce. |
În plus, următoarele module trebuie instalate manual:
Nume |
Nume tehnic |
Descriere |
|---|---|---|
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 |
Vânzare pentru servicii Avatax Brazilia |
|
Sales modifications for Brazil for services |
Brazilian Accounting EDI & Brazilian Accounting EDI for services |
|
Oferă facturare electronică pentru bunuri și servicii pentru Brazilia prin AvaTax. |
EDI Contabilitate Braziliană Pentru Vânzări |
|
Adds fields to sales orders that will be carried over to the invoice. |
Notă
În unele cazuri, cum ar fi atunci când se actualizează la o versiune cu module suplimentare, este posibil ca modulele să nu fie instalate automat. Orice module lipsă pot fi instalate manual.
Prezentarea generală a localizării¶
Pachetul de localizare pentru Brazilia asigură conformitatea cu reglementările fiscale și contabile braziliene. Include instrumente pentru gestionarea taxelor, pozițiilor fiscale, raportării și un plan de conturi predefinit adaptat standardelor din Brazilia.
Pachetul de localizare braziliană oferă următoarele caracteristici cheie pentru a asigura conformitatea cu reglementările fiscale și contabile locale:
Planul de conturi: o structură predefinită adaptată standardelor contabile braziliene
Taxe: rate de taxare preconfigurate, inclusiv TVA standard, cu taxă zero și opțiuni de scutire.
Planul de conturi¶
În planul de conturi, conturile sunt mapate automat la taxele corespunzătoare și câmpurile implicite pentru conturile de plătit și de încasat.
Notă
Planul de conturi din Brazilia se bazează pe SPED CoA, care oferă o bază de pornire pentru conturile necesare.
Taxe¶
Taxele sunt create și configurate automat la instalarea localizării braziliene. Avalara folosește unele pentru a calcula taxele pe comenzile de vânzare sau facturi.
Taxele folosite pentru servicii trebuie adăugate și configurate manual, deoarece rata poate diferi în funcție de orașul în care este oferit serviciul.
Important
NFS-e nu poate fi emisă pentru taxele de servicii create manual. Pentru a trimite electronic o NFS-e, calculați taxele folosind Avalara.
Atenționare
Nu ștergeți taxele, deoarece sunt folosite pentru calculul de taxe AvaTax. Dacă sunt șterse, Odoo le creează din nou când sunt folosite într-o SO sau factură, calculând taxele cu AvaTax. Cu toate acestea, contul folosit pentru înregistrarea taxei trebuie reconfigurat în fila Definiție a taxei, sub secțiunile Distribuție pentru facturi și Distribuție pentru rambursări.
Produse¶
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.
Notă
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.
Companie și contacte¶
Pentru a folosi toate caracteristicile acestei localizări fiscale, următoarele câmpuri sunt necesare în înregistrarea companiei:
Nume
Adresă: add Oraș, Stat, Cod poștal, Țara
În câmpul Street, introduceți numele străzii, numărul și orice informații suplimentare despre adresă.
În câmpul Street 2, introduceți cartierul.
Număr de identificare: CNPJ sau CPF
Cod fiscal: asociat cu tipul de identificare
IE: Înregistrare de stat
IM: Înmatriculare municipală
Cod SUFRAMA: Supraintendența Zonei Libere Manaus - adăugați dacă este cazul
Telefon
E-mail
Sfat
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:
Adăugați Poziția Fiscală pentru AvaTax Brazil.
Tax Regime: Federal tax regime.
ICMS Taxpayer Type: Select ICMS regime, Exempt status, or Non-Taxpayer.
Sector de activitate principal
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.
Configurați următoarele Informații Fiscale suplimentare pentru a emite NFS-e:
Adăugați Poziția Fiscală pentru AvaTax Brazil.
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.
Sfat
Dacă este un regim simplificat, rata ICMS trebuie configurată. Pentru a face acest lucru, mergeți la , derulați în jos la secțiunea Taxe și setați câmpurile Taxa de Vânzare și Taxa de Cumpărare din secțiunea Taxe Implicite.
Aceeași configurație se aplică formularului relevant de contact când se folosește integrarea AvaTax.
Notă
Selectați opțiunea Company pentru un contact cu un cod fiscal (CNPJ) sau bifați Persoană fizică pentru un contact cu un CPF.
Integrarea AvaTax¶
Notă
Asigurați-vă că instalați modulul AvaTax Brazil (
l10n_br_avatax).Odoo este un partener certificat al Avalara Brazilia.
Integrarea Avalara AvaTax folosește Cumpărături în Aplicație (IAPs) pentru a calcula taxele și a gestiona documentele electronice (de ex., NF-e, NFS-e). Fiecare acțiune consumă credite din soldul de credite IAP. La creare, bazele de date noi primesc 500 de credite gratuite.
Pentru a calcula taxa pe bunuri și servicii și a procesa facturile electronice, sunt necesare următoarele configurații:
Configurare¶
Credențiale¶
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.
Atenționare
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.
Există două portaluri Avalara braziliene diferite:
Unul pentru testare: https://portal.sandbox.avalarabrasil.com.br/
Unul pentru producție: https://portal.avalarabrasil.com.br/
Când contul este creat din Odoo, selectați mediul corect. În plus, emailul folosit pentru a deschide contul nu poate fi folosit pentru a deschide un alt cont. Salvați API ID și API Key când contul este creat din Odoo.
După ce contul este creat din Odoo, mergeți la Portalul Avalara pentru a configura parola:
Accesați portalul Avalara.
Apăsați Meu primeiro acesso.
Adăugați adresa de email folosită în Odoo pentru a crea contul Avalara/AvaTax și apăsați 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.
Sfat
Dacă folosiți AvaTax în Odoo doar pentru calculul taxelor, setarea unei parole sau accesarea portalului Avalara nu este necesară. Cu toate acestea, pentru a folosi serviciul de facturi electronice, este necesar accesul la AvaTax și certificatul trebuie încărcat.
Notă
Credentialele API pot fi transferate. Această opțiune ar trebui folosită doar când un cont a fost deja creat într-o altă instanță Odoo și trebuie reutilizat.
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.
Sfat
If inconsistencies occur when submitting fiscal reform information, disable the Enable Brazilian fiscal reform option to revert to the previous communication model.
Încărcarea certificatului A1¶
Pentru a emite facturi electronice, un certificat trebuie încărcat în portalul AvaTax.
Certificatul va fi sincronizat cu Odoo atâta timp cât numărul identificatorului extern din portalul AvaTax se potrivește, fără caractere speciale, cu numărul CNPJ, și numărul de identificare (CNPJ) din Odoo se potrivește cu CNPJ din AvaTax.
Important
Unele orașe cer ca certificatul să fie legat în sistemul Portalului Orașului înainte de a emite NFS-e din Odoo.
Dacă se primește un mesaj de eroare de la oraș care spune Certificatul dvs. nu este legat de utilizator, acest proces trebuie făcut în portalul orașului.
Poziții fiscale¶
To set up the Automatic Tax Mapping (Avalara Brazil) fiscal position, enable the Detect Automatically and Use AvaTax Brazil API options.
Vedeți și
Produse¶
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.
Facturi electronice pentru mărfuri (NF-e)¶
Important
Integrarea Avalara funcționează pe un sistem bazat pe credite, unde fiecare interacțiune cu Avalara consumă un credit. Mai jos sunt principalele operațiuni care consumă credite:
Aplicația Vânzări
Calculul taxelor pe oferte și comenzi de vânzare.
Aplicația Contabilitate
Calculul taxelor pe facturi.
Transmiterea facturilor electronice (NF-e sau NFS-e).
Operațiuni ocazionale: (fiecare pas este facturat separat)
Notă
Dacă taxele sunt calculate în aplicația Vânzări și factura este emisă ulterior în aplicația Contabilitate, calculul se întâmplă de două ori, consumând două credite.
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.
Codul NCM Mercosur: Codul Produsului Nomenclatorului Comun Mercosur
Sursa de Origine: originea produsului, care poate fi străină sau domestică, printre alte opțiuni posibile, în funcție de cazul specific de utilizare
Tipul Produsului Fiscal SPED: tipul de produs fiscal conform tabelului de listă SPED
Scopul de Utilizare: scopul intenționat de utilizare pentru acest produs
Notă
Odoo creează automat trei produse care vor fi folosite pentru costurile de transport asociate cu vânzările. Acestea sunt denumite Transport, Asigurare și Alte Costuri și sunt deja configurate. Dacă mai multe trebuie create, duplicați și folosiți aceeași configurație:
Product Type: Service
Tipul Costului de Transport: Asigurare, Transport, sau Alte Costuri
Facturi electronice pentru servicii (NFS-e)¶
Important
Integrarea Avalara funcționează pe un sistem bazat pe credite, unde fiecare interacțiune cu Avalara consumă un credit. Mai jos sunt principalele operațiuni care consumă credite:
Aplicația Vânzări
Calculul taxelor pe oferte și comenzi de vânzare.
Aplicația Contabilitate
Calculul taxelor pe facturi.
Transmiterea facturilor electronice (NF-e sau NFS-e).
Verificarea stării facturii (1 credit este consumat de fiecare dată când starea facturii este verificată).
Operațiuni ocazionale: (fiecare pas este facturat separat)
Notă
Dacă taxele sunt calculate în aplicația Vânzări și factura este emisă ulterior în aplicația Contabilitate, calculul se întâmplă de două ori, consumând două credite.
Example
Codul NCM Mercosur: Codul Produsului Nomenclatorului Comun Mercosur
Scopul de Utilizare: scopul intenționat de utilizare pentru acest produs
Cod de serviciu Origin: Codul de serviciu al orașului în care este înregistrat furnizorul
Atribuirea Muncii: casetă de selectare pentru a alege dacă serviciul implică muncă
Tipul Costului de Transport: tipul de costuri de transport de selectat
Coduri de Servicii: Codul de Serviciu al Orașului unde va fi furnizat serviciul; dacă nu se adaugă niciun cod, va fi folosit Originea Codului de Serviciu.
Calculul impozitelor¶
Vedeți și
Calcule de taxe pe cotații și comenzi de vânzare¶
Declanșează un API sunați pentru a calcula automat taxele pentru o cotație sau o comandă de vânzare cu AvaTax în oricare dintre următoarele moduri:
- Confirmare ofertă
Confirmați o ofertă într-o comandă de vânzare.
- Declanșare manuală
Apăsați Calculează Taxele Folosind AvaTax.
- Previzualizare
Apăsați Previzualizare.
- Trimiteți prin email o ofertă/comandă de vânzare
Trimiteți o ofertă sau o comandă de vânzare unui client prin e-mail.
- Acces la cotație online
Când un client accesează oferta online (prin vizualizarea portalului), API apelul este declanșat.
Calcule fiscale pe facturi¶
Declanșează un API sunați pentru a calcula automat taxele pe o factură de client cu AvaTax în oricare dintre următoarele moduri:
- Declanșare manuală
Apăsați Calculează Taxele Folosind AvaTax.
- Previzualizare
Apăsați Previzualizare.
- Acces la factura online
Când un client accesează factura online (prin vizualizarea portalului), API apelul este declanșat.
Notă
Poziția fiscală trebuie setată la Cartografiere automată a taxelor (Avalara Brazilia) pentru oricare dintre aceste acțiuni de calculare automată a taxelor.
Contabilitate¶
Documente electronice¶
Configurare¶
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.
Sfat
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.
Când emiți facturi electronice și neelectronice, câmpul Tip selectează tipul de document folosit la crearea facturii.
Facturi client¶
Pentru a procesa o factură electronică pentru bunuri (NF-e) sau servicii (NFS-e), factura trebuie confirmată și taxele trebuie calculate de Avalara. Următoarele câmpuri trebuie completate:
Client, cu toate informațiile clientului
Metoda de Plată: Brazil: Specificați metoda de plată așteptată.
Tipul Documentului: Selectați (55) Factură Electronică (NF-e) sau (SE) Factură Electronică de Servicii (NFS-e).
Fila Alte Informații:
Poziția Fiscală setată ca Maparea Automată a Taxelor (Avalara Brazil).
Unele câmpuri opționale depind de natura tranzacției. Aceste câmpuri din fila Alte Informații nu sunt necesare, așa că în majoritatea cazurilor, lăsarea lor goale nu va rezulta în erori de la guvern când factura este trimisă:
Modelul de Transport determină cum sunt planificate bunurile să fie transportate - domestic.
Transportator Brazil determină cine face transportul.
Apoi, faceți clic pe Trimite. În fereastra pop-up, faceți clic pe Procesează factura electronică și orice alte opțiuni, cum ar fi Descarcă sau E-mail. În final, faceți clic pe Trimite pentru a procesa factura cu guvernul.
Notă
Toate câmpurile disponibile pe factură folosite pentru a emite o factură electronică sunt de asemenea disponibile pe comanda de vânzare, dacă este necesar. Când creați prima factură, câmpul Numărul Documentului este afișat și alocat ca primul număr care va fi folosit secvențial pentru facturile ulterioare.
Note de credit¶
Dacă o returnare de vânzări trebuie înregistrată, o notă de credit poate fi creată în Odoo și trimisă guvernului pentru validare.
Notă
Notele de credit sunt disponibile numai pentru facturile electronice pentru mărfuri (NF-e).
Note de debit¶
Dacă informații suplimentare trebuie incluse sau valori care nu au fost furnizate cu acuratețe în factura originală trebuie corectate, o notă de debit poate fi emisă.
Notă
Notele de debit sunt disponibile numai pentru facturile electronice pentru mărfuri (NF-e).
Doar produsele incluse în factura originală pot fi incluse în nota de debit. Deși se pot face modificări la prețul unitar sau cantitatea produsului, produsele nu pot fi adăugate la nota de debit. Scopul acestui document este doar să declare suma care urmează să fie adăugată la factura originală pentru aceleași produse sau mai puține.
Anularea facturii¶
Este posibilă anularea unei facturi electronice pe care guvernul a validat-o.
Notă
Verificați dacă factura electronică este încă în termenul de anulare, care poate varia în funcție de legislația fiecărui stat.
Facturi electronice pentru mărfuri (NF-e)¶
Pentru a anula o factură electronică pentru bunuri (NF-e) în Odoo, faceți clic pe Solicitare Anulare și adăugați un Motiv de anulare în fereastra pop-up care apare. Pentru a trimite acest motiv de anulare clientului prin email, activați caseta de selectare E-mail.
Notă
Aceasta este o anulare electronică, ceea ce înseamnă că Odoo va trimite o solicitare către guvern pentru a anula NF-e. Apoi va consuma un credit IAP, deoarece are loc un apel API.
Facturi electronice pentru servicii (NFS-e)¶
Pentru a anula o factură electronică pentru servicii (NFS-e) în Odoo, faceți clic pe Solicitare Anulare. Nu există un proces de anulare electronică în acest caz, deoarece nu toate orașele au acest serviciu disponibil. Utilizatorul trebuie să anuleze manual această NFS-e pe portalul orașului. Odată ce acest pas este finalizat, poate solicita anularea în Odoo, care va anula factura.
Scrisoare de corectare¶
O scrisoare de corecție poate fi creată și legată de o factură electronică pentru bunuri (NF-e) pe care guvernul a validat-o.
Pentru a face acest lucru în Odoo, faceți clic pe Scrisoare de Corecție și adăugați un Motiv de corecție în fereastra pop-up. Pentru a trimite motivul corecției unui client prin email, activați caseta de selectare E-mail.
Notă
Scrisorile de corectare sunt disponibile numai pentru facturile electronice pentru mărfuri (NF-e).
Invalidarea intervalului de numere de facturi¶
Un interval de secvențe care sunt atribuite jurnalelor de vânzări poate fi invalidat de către guvern dacă nu sunt utilizate în prezent și nu vor fi utilizate în viitor. Pentru a face acest lucru, mergeți la , deschideți jurnalul, faceți clic pe iconița (roată dințată) și selectați Invalidare Interval Numere (BR). În asistentul Invalidare Interval Numere (BR), adăugați Numărul Inițial și Numărul Final al intervalului care ar trebui anulat și introduceți un Motiv de invalidare.
Notă
Invalidarea intervalului de numere de factură este disponibilă doar pentru facturile electronice pentru bunuri (NF-e).
Conversația jurnalului înregistrează jurnal numerelor anulate, împreună cu fișierul XML.
Facturi vânzător¶
Când primiți o factură de la un furnizor, codificați factura în Odoo adăugând toate informațiile comerciale și aceleași informații specifice braziliene înregistrate pe facturile clienților.
Aceste câmpuri specifice braziliene sunt:
Metoda de Plată: Brazil: Specificați metoda de plată așteptată.
Tipul Documentului: utilizat de furnizor
Numărul Documentului: numărul facturii de la furnizor
Freight Model (NF-e specific): how goods are planned to be transported - domestic
Transporter Brazil (NF-e specific): who is doing the transportation.