Brasilien¶
Inledning¶
With the Brazilian localization, sales taxes can be automatically computed and electronic invoices for goods (NF-e) and services (NFS-e) can be sent using AvaTax (Avalara) through API calls. Moreover, taxes for services can be configured.
For the goods and services tax computation and electronic invoicing process, you need to configure the contacts, company, products, and create an account in AvaTax which needs to be configured in the general settings.
För tjänsteskatterna kan du skapa och konfigurera dem direkt från Odoo utan att beräkna dem med AvaTax.
Lokaliseringen inkluderar även skatter och en mall för kontoplan som kan modifieras vid behov.
Konfiguration¶
Installation av moduler¶
Installera följande moduler för att få alla funktioner i den brasilianska lokaliseringen:
Namn |
Tekniskt namn |
Beskrivning |
|---|---|---|
Brasilianska - Redovisning |
|
Default fiscal localization package, which represents having the Generic Brazilian chart of accounts and Taxes, together with document types and identification types. |
Brasilien - Redovisningsrapporter |
|
Accounting reports for Brazil. |
AvaTax Brazil & AvaTax Brazil for Services |
|
Goods and Services tax computation through Avalara. |
Brazilian Accounting EDI & Brazilian Accounting EDI for services |
|
Provides electronic invoicing for goods and services for Brazil through AvaTax. |
Brazil Pix QR codes |
|
Implements Pix QR codes for Brazil. |
Konfigurera ditt företag¶
För att konfigurera din företagsinformation, gå till appen och sök på det namn som ditt företag har fått.
Välj alternativet Company högst upp på sidan. Konfigurera sedan följande fält:
Namn
Address: add City, State, Zip Code, Country
I fältet Street anger du gatans namn, nummer och eventuell ytterligare adressinformation.
I fältet Street 2 anger du stadsdelen.
Identification Number: CNPJ or CPF
Tax ID: associated with the identification type
IE: State registration
IM: Municipal registration
SUFRAMA code: Superintendence of the Manaus Free Trade Zone - add if applicable
Telefon
E-postadress
Konfigurera Fiskal information på fliken Sales and Purchase:
Add the Fiscal Position for AvaTax Brazil.
Tax Regime: Federal Tax Regime
ICMS Taxpayer Type: indicates ICMS regime, Exempt status, or Non-Taxpayer
Huvudsaklig verksamhetssektor
Configure the following extra Fiscal Information if you are going to issue NFS-e:
Add the Fiscal Position for AvaTax Brazil.
COFINS Details: Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
PIS Details Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
CSLL Taxable If the company is subject to CSLL or not
Slutligen laddar du upp en företagslogotyp och sparar kontakten.
Observera
If you are a simplified regime, you need to configure the ICMS rate under .
Konfigurera AvaTax-integrering¶
Avalara AvaTax är en leverantör av skatteberäkning och elektronisk fakturering som kan integreras i Odoo för att automatiskt beräkna skatter genom att ta hänsyn till företags-, kontakt- (kund), produkt- och transaktionsinformation för att hämta rätt skatt som ska användas och behandla e-fakturan efteråt med regeringen.
Using this integration requires In-App-Purchases (IAPs) to compute the taxes and to send the electronic invoices. Whenever you compute taxes, send an electronic document (NF-e, NFS-e, etc), or perform any electronic flow (NF-e Cancellation, Correction letter, Invalidate invoice number range), an API call is made using credits from your IAP credits balance.
Observera
Odoo är en certifierad partner till Avalara Brazil.
You can buy IAP credit on odoo.com.
Konfiguration av autentiseringsuppgifter¶
To activate AvaTax in Odoo, you need to create an account. To do so, go to , and in the AvaTax Brazil section, add the administration email address to be used for the AvaTax portal in the AvaTax Portal Email, and then click on Create account.
Varning
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 log in to the Avalara Portal and set up the certificates, whether you want to test or use it on production.
There are two different Avalara Portals, one for testing and one for production:
Production: https://portal.avalarabrasil.com.br/
When you create the account from Odoo, be sure to select the right environment. Moreover, the email used to open the account cannot be used to open another account. Save your API ID and API Key when you create the account from Odoo.
När du har skapat kontot från Odoo måste du gå till Avalara Portal för att ställa in ditt lösenord:
Gå till Avalara-portalen.
Klicka på My first access.
Add the email address you used in Odoo to create the Avalara/AvaTax account, and then click Solicitar Senha.
Du kommer att få ett e-postmeddelande med en token och en länk för att skapa ditt lösenord. Klicka på denna länk och kopiera och klistra in token för att tilldela ditt önskade lösenord.
Tips
Du kan börja använda AvaTax i Odoo för skatteberäkning endast utan att skapa ett lösenord och få tillgång till Avalara-portalen i Odoo-databasen. För att kunna använda tjänsten för elektroniska fakturor måste du dock gå in på AvaTax-portalen och ladda upp ditt certifikat där.
Observera
Du kan överföra API-autentiseringsuppgifter. Använd detta endast om du redan har skapat ett konto i en annan Odoo-instans och vill återanvända det.
Uppladdning av A1-intyg¶
För att kunna utfärda elektroniska fakturor måste ett certifikat laddas upp till AvaTax-portalen.
Certifikatet kommer att synkroniseras med Odoo, så länge det externa identifieringsnumret i AvaTax-portalen matchar - utan specialtecken - med CNPJ-numret, och identifieringsnumret (CNPJ) i Odoo matchar med CNPJ i AvaTax.
Viktigt
To issue NFS-e, some cities require that you link the certificate within the City Portal system before issuing NFS-e from Odoo.
If you receive an error message from the city that says Your certificate is not linked to the user, that means this process needs to be done in the city portal.
Konfigurera masterdata¶
Kontoplan¶
kontoplan installeras som standard som en del av den datauppsättning som ingår i lokaliseringsmodulen. Kontona mappas automatiskt i motsvarande skatter och standardfälten för leverantörsskulder och kundfordringar.
Observera
Kontoplanen för Brasilien baseras på SPED CoA, som ger en baslinje för de konton som behövs i Brasilien.
Du kan lägga till eller ta bort konton efter företagets behov.
Tidskrifter¶
I Brasilien är ett series-nummer kopplat till ett sekvensnummerintervall för elektroniska fakturor. Serienumret kan konfigureras i Odoo på en försäljningsjournal från fältet Series. Om mer än en serie behövs måste en ny försäljningsjournal skapas och ett nytt serienummer tilldelas den för varje serie som behövs.
Fältet Use Documents måste vara markerat. Vid utfärdande av elektroniska och icke-elektroniska fakturor väljer fältet Type den dokumenttyp som används när fakturan skapas. Fältet Type visas endast om fältet Use Documents är markerat i journalen.
Observera
När du skapar journalen, se till att fältet Dedicated Credit Note Sequence är avmarkerat, eftersom i Brasilien delas sekvenser mellan fakturor, kreditnotor och debetnotor per serienummer, vilket innebär per journal.
Skatter¶
Skatter skapas automatiskt när den brasilianska lokaliseringen installeras. Skatter är redan konfigurerade, och vissa av dem används av Avalara när skatter beräknas på försäljningsordern eller fakturan.
Skatter kan redigeras eller fler skatter kan läggas till. Vissa skatter som används för tjänster måste till exempel läggas till och konfigureras manuellt, eftersom skattesatsen kan variera beroende på vilken stad du erbjuder tjänsten i.
Viktigt
If you decide to do service taxes manually, you won’t be able to issue an NFS-e. To electronically send an NFS-e, you need to compute taxes using Avalara.
Varning
Ta inte bort skatter, eftersom de används för AvaTax skatteberäkning. Om de raderas skapar Odoo dem igen när de används i en SO eller faktura och beräknar skatter med AvaTax, men kontot som används för att registrera skatten måste konfigureras om i skattens Definition flik, under Distribution for invoices och Distribution for refunds sektioner.
Se även
Skatter funktionell dokumentation
Produkter¶
To use the AvaTax integration on sale orders and invoices, first specify the following information on the product depending on its intended use:
E-Invoice for goods (NF-e)¶
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
Observera
Odoo skapar automatiskt tre produkter som ska användas för transportkostnader i samband med försäljning. Dessa heter Frakt, Försäkring och Övriga kostnader. De är redan konfigurerade, om fler behöver skapas, duplicera och använd samma konfiguration (konfiguration behövs: Product Type Service, Transportation Cost Type Insurance, Freight, eller Other Costs).
E-Invoice for services (NFS-e)¶
Mercosul NCM Code: Mercosur Common Nomenclature Product Code
Purpose of Use: Specify the intended purpose of use for this product
Service Code Origin: City Service Code where the provider is registered
Service Codes: City Service Code where the service will be provided, if no code is added, the Origin City Code will be used
Labor Assignment: Defines if your services includes labor
Kontakter¶
Innan du använder integrationen, ange följande information om kontakten:
Allmän information om kontakten:
Välj alternativet Company för en kontakt med ett skatte-ID (CNPJ), eller markera Individual för en kontakt med ett CPF.
Namn
Address: add City, State, Zip Code, Country
I fältet Street anger du gata, nummer och eventuell extra adressinformation.
I fältet Street 2 anger du stadsdelen.
Identification Number: CNPJ or CPF
Tax ID: associated with the identification type
IE: statligt skatteregistreringsnummer
IM: municipal tax identification number
SUFRAMA-kod: SUFRAMA registreringsnummer
Telefon
E-postadress
Observera
Fälten CPF, IE, IM, och SUFRAMA code är dolda tills Country är satt till
Brazil.Skatteinformation om kontakten under fliken Sales & Purchase:
Fiscal Position: lägg till AvaTax skatteposition för att automatiskt beräkna skatter på försäljningsorder och fakturor automatiskt
Tax Regime: federalt skattesystem
ICMS Taxpayer Type: taxpayer type determines if the contact is within the ICMS regime, Exempt status, or Non-taxpayer
Main Activity Sector: Förteckning över kontaktens huvudsakliga verksamhetsområden
Configure the following extra Fiscal Information if you are going to issue NFS-e:
Add the Fiscal Position for AvaTax Brazil
COFINS Details: Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
PIS Details: Taxable, Not Taxable, Taxable with rate 0%, Exempt, Suspended
CSLL Taxable: If the company is subject to CSLL or not
Finanspolitiska ställningstaganden¶
För att beräkna skatter och skicka elektroniska fakturor på försäljningsorder och fakturor måste både Detektera automatiskt och Använd AvaTax API vara aktiverade i Fiskal position.
The Fiscal Position can be configured on the contact or selected when creating a sales order or an invoice.
Arbetsflöden¶
This section provides an overview of the actions that trigger API calls for tax computation, along with instructions on how to send electronic invoices for goods (NF-e) and services (NFS-e) for government validation.
Varning
Observera att varje API-anrop medför en kostnad. Var uppmärksam på de åtgärder som utlöser dessa anrop för att hantera kostnaderna effektivt.
Skatteberäkning¶
Skatteberäkningar på offerter och försäljningsorder¶
Utlös ett API-anrop för att beräkna skatter på en offert eller försäljningsorder automatiskt med AvaTax på något av följande sätt:
- Bekräftelse av offert
Bekräfta en offert till en försäljningsorder.
- Manuellt utlösningsdon
Klicka på Beräkna skatter med AvaTax.
- Förhandsgranskning
Klicka på knappen Förhandsgranskning.
- Skicka en offert/försäljningsorder till
Skicka en offert eller försäljningsorder till en kund via e-post.
- Online tillgång till offerter
När en kund öppnar offerten online (via portalvyn) utlöses anropet API.
Skatteberäkningar på fakturor¶
Trigger an API call to calculate taxes on a customer invoice automatically with AvaTax in any of the following ways:
- Manuellt utlösningsdon
Klicka på Beräkna skatter med AvaTax.
- Förhandsgranskning
Klicka på knappen Förhandsgranskning.
- Online tillgång till fakturor
När en kund öppnar fakturan online (via portalvyn) utlöses anropet API.
Observera
Fiskal position måste vara inställd på Automatisk skatteberäkning (Avalara Brasilien) för att någon av dessa åtgärder ska beräkna skatter automatiskt.
Elektroniska dokument¶
Kundfakturor¶
To process an electronic invoice for goods (NF-e) or services (NFS-e), the invoice needs to be confirmed and taxes need to be computed by Avalara. Once that step is done, click on the Send & Print button in the upper left corner. In the pop-up that appears, click on Process e-invoice and any of the other options - Download or Email. Finally, click on Send & Print to process the invoice with the government.
Before sending the electronic invoice for goods (NF-e) or services (NFS-e), some fields need to be filled out on the invoice:
Customer, with all the customer information
Payment Method: Brazil: how the invoice is planned to be paid
Fiskal position satt som Automatisk skattemappning (Avalara Brasilien)
Document Type set as (55) Electronic Invoice (NF-e) or (SE) Electronic Service Invoice (NFS-e)
Det finns några andra valfria fält som beror på transaktionens natur. Dessa fält är inte obligatoriska, så inga fel kommer att visas från regeringen om dessa valfria fält inte fylls i för de flesta fall:
Freight Model bestämmer hur varorna är planerade att transporteras - inrikes
Transporter Brazil avgör vem som utför transporten
Observera
Alla fält som är tillgängliga på fakturan som används för att utfärda en elektronisk faktura är också tillgängliga på försäljningsordern, om det behövs. När den första fakturan skapas visas fältet Dokumentnummer, som tilldelas som det första numret som ska användas sekventiellt för efterföljande fakturor.
Kreditnotor¶
Om en försäljningsdeklaration behöver registreras kan en kreditnota skapas i Odoo som skickas till regeringen för validering.
Observera
Credit notes are only available for electronic invoices for goods (NF-e).
Se även
Debetnoter¶
Om ytterligare information behöver inkluderas, eller värden behöver korrigeras som inte angavs korrekt i den ursprungliga fakturan, kan en debetnota utfärdas.
Observera
Debit notes are only available for electronic invoices for goods (NF-e).
Endast de produkter som ingår i den ursprungliga fakturan kan vara en del av debetnotan. Även om ändringar kan göras i produktens enhetspris eller kvantitet, kan produkter inte läggas till i debetnotan. Syftet med detta dokument är endast att ange det belopp som du vill lägga till den ursprungliga fakturan för samma eller färre produkter.
Se även
Annullering av faktura¶
Det är möjligt att makulera en elektronisk faktura som har godkänts av regeringen.
Observera
Kontrollera om den elektroniska fakturan fortfarande ligger inom ångerfristen, som kan variera beroende på lagstiftningen i varje stat.
E-invoices for goods (NF-e)¶
Cancel an e-invoice for goods (NF-e) in Odoo by clicking Request Cancel and adding a cancellation Reason on the pop-up that appears. If you want to send this cancellation reason to the customer via email, activate the E-mail checkbox.
Observera
This is an electronic cancellation, which means that Odoo will send a request to the government to cancel the NF-e, and it will then consume one IAP credit, as an API call occurs.
E-invoices for services (NFS-e)¶
Cancel an e-invoice for services (NFS-e) in Odoo by clicking Request Cancel. In this case, there is no electronic cancellation process, as not every city has this service available. The user needs to manually cancel this NFS-e on the city portal. Once that step is completed, they can request the cancellation in Odoo, which will cancel the invoice.
Korrigeringsbrev¶
A correction letter can be created and linked to an electronic invoice for goods (NF-e) that was validated by the government.
Detta kan göras i Odoo genom att klicka på Korrigeringsbrev och lägga till en korrigering Anledning i popup-fönstret som visas. Om du vill skicka denna rättelseorsak till en kund via e-post aktiverar du kryssrutan E-post.
Observera
Correction letters are only available for electronic invoices for goods (NF-e).
Invalidera intervall för fakturanummer¶
Ett antal sekvenser som tilldelats försäljningsjournaler kan ogiltigförklaras med regeringen om de inte används för närvarande, och inte kommer att användas i framtiden. Navigera till journalen och klicka på . I guiden Invalidate Number Range (BR) lägger du till Initial Number och End Number för det intervall som ska annulleras, och anger en ogiltighetsgrund Reason.
Observera
Invalidate invoice number range documents are only available for electronic invoices for goods (NF-e).
Observera
Loggen över de avbrutna numren tillsammans med XML-filen registreras i journalens chatter.
Vendor bills¶
När du tar emot en faktura från en leverantör kan du koda fakturan i Odoo genom att lägga till all kommersiell information tillsammans med samma brasilianska specifika information som registreras på kundfakturor.
Dessa brasilianska specifika områden är:
Payment Method: Brazil: how the invoice is planned to be paid
Document Type: used by your vendor
Document Number: the invoice number from your supplier
Freight Model: NF-e specific how goods are planned to be transported - domestic
Transporter Brazil: NF-e specific who is doing the transportation.