Brazilia¶

Introducere¶

With the Brazilian localization you can automatically compute sales taxes for goods using AvaTax (Avalara) through API calls, also configure taxes for services.

For the goods tax computation part, you need to configure the contacts, company, products, and create an account in Avatax from the Odoo general settings.

Pentru taxele de servicii, le puteți crea și configura direct din Odoo, fără a le calcula cu AvaTax.

Localizarea include, de asemenea, taxe și un șablon de plan de conturi care poate fi modificat dacă este necesar.

Configurare¶

Module instalate¶

Instalați următoarele module pentru a obține toate caracteristicile localizării braziliene:

Configurați compania dvs.¶

Pentru a configura informațiile despre companie, accesați aplicația Contacts și căutați numele dat companiei dvs.

1. Selectați opțiunea Company din partea de sus a paginii. Apoi, configurați următoarele câmpuri:

   • Nume

   • Address (add City, State, Zip Code, Country)

   • Tax ID (CNPJ)

   • IE (State Registration)

   • IM (Municipal Registration)

   • SUFRAMA code (Superintendence of the Manaus Free Trade Zone - add if applicable)

   • Telefon

   • E-mail

   

2. Configurați Informații fiscale în fila Vânzări și achiziții:

   • Add the Fiscal Position for Avatax Brazil.

   • Tax Regime (Federal Tax Regime)

   • ICMS Taxpayer Type (indicates ICMS regime, Exempt status, or Non-Taxpayer.)

   • Sector de activitate principal

   

3. În cele din urmă, încărcați un logo al companiei și salvați contactul.

Configurați integrarea AvaTax¶

Avalara AvaTax is a tax calculation provider that can be integrated in Odoo to automatically compute taxes by taking into account the company, contact (customer), product, and transaction information to retrieve the correct tax to be used.

Odoo is a certified partner of Avalara Brazil, which means that Avalara experts reviewed workflows covered within the scope of the integration.

Using this integration requires In-App-Purchases (IAPs) to compute taxes. Every time you compute taxes, an API call is made, using credits from your IAP credits balance.

Configurarea acreditărilor¶

To activate AvaTax in Odoo, you need to create an account. To do so, go to Accounting ‣ Configuration ‣ Settings ‣ Taxes, and, in the AvaTax Brazil section, add the email address you want to use to log in to the AvaTax portal, and click on Create account. This email is used as the administrator email address in AvaTax.

După ce creați contul din Odoo, trebuie să accesați Portalul Avalara pentru a vă configura parola:

1. Access the Avalara portal

2. Click on Meu primeiro acesso

3. Add the email address you used in Odoo to create the Avalara/Avatax account, and then click Solicitar Senha

4. Veți primi un e-mail cu un simbol și un link pentru a vă crea parola. Faceți clic pe acest link și copiați și lipiți simbolul pentru a aloca parola dorită.

Configurați datele principale¶

Planul de conturi¶

The chart of accounts is installed by default as part of the data set included in the localization module. The accounts are mapped automatically in their corresponding taxes, and the default account payable and account receivable fields.

Taxe¶

Taxele sunt create automat la instalarea localizării braziliene. Taxele sunt deja configurate, iar unele dintre ele sunt folosite de Avalara la calculul taxelor pe comanda de vânzare sau pe factură.

Taxele pot fi editate sau pot fi adăugate mai multe taxe. De exemplu, unele taxe utilizate pentru servicii trebuie adăugate și configurate manual, deoarece tariful poate diferi în funcție de orașul în care oferiți serviciul.

When configuring a tax used for a service that is included in the final price (when the tax is not added or subtracted on top of the product price), set the Tax Computation to Percentage of Price Tax Included, and, on the Advanced Options tab, check the Included in Price option.

For more information on configuring taxes to fit your needs better, please go to the taxes functional documentation.

Produse¶

To use the AvaTax integration on sale orders and invoices, first specify the following information on the product:

• CEST Code (Code for products subject to ICMS tax substitution)

• Mercosul NCM Code (Mercosur Common Nomenclature Product Code)

• Source of Origin (Indicates the origin of the product, which can be foreign or domestic, among other possible options depending on the specific use case)

• SPED Fiscal Product Type (Fiscal product type according to SPED list table)

• Purpose of Use (Specify the intended purpose of use for this product)

Contacte¶

Înainte de a utiliza integrarea, specificați următoarele informații pe contact:

1. Informații generale despre contact:

   • Selectați opțiunea Company pentru un contact cu un cod fiscal (CNPJ) sau bifați Persoană fizică pentru un contact cu un CPF.

   • Nume

   • Address: Zip Code is a required field to compute taxes properly.

   • Tax ID or CPF: Use CPF for individuals and Tax ID (CNPJ) for companies

   • IE: numărul de identificare fiscală de stat

   • IM: municipa tax identification number

   • Cod SUFRAMA: Număr de înregistrare SUFRAMA

   • Telefon

   • E-mail

   

   Notă

   Câmpurile CPF, IE, IM și Cod SUFRAMA sunt ascunse până când Țara este setată la Brazilia.

2. Fiscal information about the contact under the Sales & Purchase tab:

   • Fiscal Position: add the AvaTax fiscal position to automatically compute taxes on sale orders and invoices automatically.

   • Tax Regime: regim fiscal federal

   • ICMS Taxpayer Type: taxpayer type determines if the contact is within the ICMS regime, if it is exempt, or if it is a non-taxpayer.

   • Sector de activitate principal: lista principalelor sectoare de activitate ale contactului

   

Poziții fiscale¶

To compute taxes on sale orders and invoices, it is necessary to have a Fiscal Position with the Detect Automatically and the Use AvaTax API options enabled.

The Fiscal Position can be configured on the contact or selected when creating a sales order or an invoice.

Fluxuri de lucru¶

This section provides an overview of the actions that trigger API calls for tax computation.

Tax calculations on quotation / sales orders¶

Trigger an API call to calculate taxes on a quotation or sales order automatically with AvaTax in any of the following ways:

• Confirmare ofertă

  Confirmați o ofertă într-o comandă de vânzare.

• Declanșare manuală

  Click on Compute Taxes Using Avatax.

• Previzualizare

  Faceți clic pe butonul Previzualizare.

• Trimiteți o ofertă prin e-mail/comandă de vânzare

  Trimiteți o ofertă sau o comandă de vânzare unui client prin e-mail.

• Acces la cotație online

  When a customer accesses the quotation online (via the portal view), the API call is triggered.

Calcule fiscale pe facturi¶

Trigger an API call to calculate taxes on a customer invoice automatically with AvaTax any of the following ways:

• Declanșare manuală

  Faceți clic pe Calculează taxe folosind AvaTax.

• Previzualizare

  Faceți clic pe butonul Previzualizare.

• Acces la factura online

  When a customer accesses the invoice online (via the portal view), the API call is triggered.