AvaTax-integration

Avalaras AvaTax är ett molnbaserat skatteprogram. Integrering av AvaTax med Odoo ger realtids- och regionspecifika skatteberäkningar när användare säljer, köper och fakturerar artiklar i Odoo. AvaTax skatteberäkning stöds med alla länder som är kartlagda av FN, inklusive gränsöverskridande transaktioner.

Viktigt

AvaTax is only available for integration with databases/companies that have locations in the United States and Canada. This means the fiscal position/country of a database can only be set to the United States or Canada. For more information, reference this documentation: Skattepliktigt land.

AvaTax tar hänsyn till platsbaserade skattesatser för varje stat, län och stad. Det förbättrar remitteringsnoggrannheten genom att noga uppmärksamma lagar, regler, jurisdiktionsgränser och särskilda omständigheter (som skattehelger och produktundantag). Företag som integrerar med AvaTax kan behålla kontrollen över skatteberäkningar internt med denna enkla API-integration.

Viktigt

Some limitations exist in Odoo while using AvaTax for tax calculation:

• AvaTax is not supported in Odoo’s Point of Sale app, because a dynamic tax calculation model is excessive for transactions within a single delivery address, such as stores or restaurants.

• AvaTax and Odoo use the company address and not the warehouse address.

• Exercise tax is not supported. This includes tobacco/vape taxes, fuel taxes, and other specific industries.

Se även

Avalaras stöddokument: Om AvaTax

Installera på AvaTax

För att använda AvaTax krävs ett konto hos Avalara för installationen. Om ett sådant inte har skapats ännu, kontakta Avalara för att köpa en licens: Avalara: Let’s Talk.

Tips

Vid kontoinställning, notera AvaTax Account ID. Detta kommer att behövas i Odoo setup. I Odoo är detta nummer API ID.

Then, create a basic company profile.

Skapa en grundläggande företagsprofil

Samla in viktiga företagsuppgifter för nästa steg: platser där skatt tas ut, sålda produkter/tjänster (och deras försäljningsställen) och skattebefrielse för kunder, om tillämpligt. Följ Avalara-dokumentationen för att skapa en grundläggande företagsprofil:

1. Add company information.

2. Tell us where the company collects and pays tax.

3. Verify jurisdictions and activate the company.

4. Add other company locations for location-based filing.

5. Add a marketplace to the company profile.

Anslut till AvaTax

Efter att ha skapat den grundläggande företagsprofilen i Avalara, anslut till AvaTax. Detta steg länkar Odoo och AvaTax dubbelriktat.

Navigera till antingen Avalaras sandbox eller production miljö. Detta beror på vilken typ av Avalara-konto som företaget vill integrera.

Se även

Sandbox vs produktionsmiljöer i Avalara <https://knowledge.avalara.com/bundle/fzc1692293626742/page/sandbox-vs-production.html>`_.

Logga in för att skapa Licensnyckel. Gå till Inställningar ‣ Licens och API-nycklar. Klicka på Generate License Key.

Observera

En varning visas där det står: ”Om din företagsapp är ansluten till Avalara Solutions kommer anslutningen att brytas tills du uppdaterar appen med den nya licensnyckeln. Denna åtgärd kan inte ångras.”

När du genererar en ny licensnyckel bryts kopplingen till befintliga affärsappar som använder AvaTax-integrationen. Se till att uppdatera dessa appar med den nya licensnyckeln.

Om detta är den första API-integrationen som görs med AvaTax och Odoo, klicka då på Generera licensnyckel.

Om detta är en extra licensnyckel, se till att den tidigare anslutningen kan brytas. Det finns endast en licensnyckel associerad med var och en av Avalara sandbox- och produktionskonton.

Viktigt

Copy this key to a safe place. It is strongly encouraged to backup the license key for future reference. This key cannot be retrieved after leaving this screen.

Odoo-konfiguration

Innan du använder AvaTax finns det några ytterligare konfigurationer i Odoo för att säkerställa att skatteberäkningarna görs korrekt.

Kontrollera att Odoo-databasen innehåller nödvändiga data. Det land som ursprungligen ställdes in i databasen bestämmer den skattemässiga positionen och hjälper AvaTax att beräkna korrekta skattesatser.

Skattepliktigt land

För att ställa in Fiscal Country, navigera till Accounting app ‣ Configuration ‣ Settings.

Se även

../../fiskala_lokaliseringar

Under the Taxes section, set the Fiscal Country feature to United States or Canada. Then, click Save.

Företagets inställningar

Alla företag som är verksamma under Odoo-databasen bör ha en fullständig och fullständig adress listad i inställningarna. Navigera till Settings app, och under Companies sektionen, se till att det bara finns ett företag som driver Odoo-databasen. Klicka på Update Info för att öppna en separat sida för att uppdatera företagsuppgifterna.

Om det finns flera företag i databasen kan du klicka på Manage Companies för att ladda en lista med företag att välja från. Uppdatera företagsinformationen genom att klicka på det specifika företaget.

Databasadministratörer bör se till att Street…, Street2…, City, State, ZIP och Country alla är uppdaterade för företagen.

Detta säkerställer korrekta skatteberäkningar och smidig bokföring i slutet av året.

Se även

• ../../../allmänt/företag

• Kom igång

Installation av modul

Se sedan till att Odoo AvaTax-modulen är installerad. För att göra det, navigera till Apps application. I fältet Search… skriver du in avatax och trycker på Enter. Följande resultat visas:

Namn	Tekniskt namn	Beskrivning
Avatax	konto_avatax	Standardmodul för AvaTax. Denna modul lägger till basfunktionerna i AvaTax för skatteberäkning.
Avatax för SO	konto_avatax_försäljning	Innehåller den information som behövs för skatteberäkning på försäljningsorder i Odoo.
Avatax for Subscriptions	account_avatax_sale_subscription	This module includes the features required for tax calculation on subscriptions in Odoo.
Account Avatax - Ecommerce	website_sale_account_avatax	Includes tax calculation features for the checkout process on Odoo eCommerce.
Account AvaTax - Ecommerce - Delivery	website_sale_delivery_avatax	Includes tax calculation features for the delivery process on Odoo eCommerce.

Click the Install button on the module labeled Avatax: account_avatax. Doing so installs the following modules:

• Avatax: konto_avatax

• Avatax för SO: konto_avatax_sale

• Account Avatax - Ecommerce: website_sale_account_avatax

Should AvaTax be needed for Odoo Subscriptions, or for delivery tax in Odoo eCommerce, then install those modules individually by clicking on Install.

Odoo AvaTax inställningar

To integrate the AvaTax API with Odoo, go to Accounting app ‣ Configuration ‣ Settings section. The AvaTax fields in the Taxes section is where the AvaTax configurations are made and the credentials are entered in.

Förkunskapskrav

Välj först den Miljö som företaget vill använda AvaTax i. Det kan antingen vara Sandbox eller Production.

Se även

För hjälp med att bestämma vilken AvaTax-miljö som ska användas (antingen Production eller Sandbox), besök: Sandbox vs Production-miljöer <https://knowledge.avalara.com/bundle/fzc1692293626742/page/sandbox-vs-production.html>`_.

Legitimationshandlingar

Nu kan inloggningsuppgifterna matas in. AvaTax Account ID ska skrivas in i fältet API ID och License Key ska skrivas in i fältet API Key.

Viktigt

Du hittar Account ID genom att logga in på AvaTax-portalen (sandbox eller production). I det övre högra hörnet klickar du på användarens initialer och Account. Account ID listas först.

För att komma åt Licensnyckel se denna dokumentation: Anslut till AvaTax.

I fältet Company Code anger du Avalaras företagskod för det företag som ska konfigureras. Avalara tolkar detta som DEFAULT, om det inte är inställt. Company Code kan nås i Avalara management portal.

Logga först in på AvaTax-portalen (sandbox eller produktion). Navigera sedan till Inställningar ‣ Hantera företag. Värdet för Company Code finns i raden för Company i kolumnen Company Code.

Transaktionsalternativ

Det finns två transaktionsinställningar i Odoo AvaTax-inställningarna som kan konfigureras: Use UPC och Commit Transactions.

Om kryssrutan bredvid Use UPC är markerad kommer transaktionerna att använda Universal Product Codes (UPC), istället för anpassade koder i Avalara. Rådfråga en auktoriserad revisor (CPA) för specifik vägledning.

Om kryssrutan Commit Transactions är markerad kommer transaktionerna i Odoo-databasen att överföras för rapportering i AvaTax.

Validering av adress

Funktionen Address Validation säkerställer att den mest aktuella adressen enligt postala standarder anges på en kontakt i Odoo. Detta är viktigt för att tillhandahålla korrekta skatteberäkningar för kunder.

Viktigt

Funktionen Address Validation fungerar bara med partners/kunder i Nordamerika.

Markera dessutom kryssrutan bredvid fältet Address validation.

Viktigt

För att skatteberäkningarna ska bli korrekta är det bäst att ange en fullständig adress för de kontakter som sparas i databasen. AvaTax kan dock fortfarande fungera genom att göra ett försök med endast Country, State och Zip code. Dessa är de tre fält som minst måste fyllas i.

Spara inställningarna för att implementera konfigurationen.

Tips

Manuellt Validera adressen genom att navigera till Kontakter-appen och välja en kontakt. Nu när AvaTax-modulen har konfigurerats i databasen visas en Validate-knapp direkt under Address.

Klicka på Validate, och ett popup-fönster visas med Validated Address och Original Address listade. Om Validated Address är den korrekta postadressen för skatteändamål klickar du på Save Validated.

Varning

Alla tidigare inmatade adresser för kontakter i Odoo-databasen måste bekräftas med hjälp av den manuella valideringsprocessen som beskrivs ovan. Adresser bekräftas inte automatiskt om de har angetts tidigare. Detta sker endast vid skatteberäkning.

Testanslutning

När du har angett all ovanstående information i AvaTax-installationen i Odoo klickar du på Test connection. Detta säkerställer att API ID och API KEY är korrekta och att en anslutning görs mellan Odoo och AvaTax API (Application Programming Interface).

Synkroniseringsparametrar

När du är klar med konfigurationen och inställningarna för avsnittet AvaTax klickar du på knappen Sync Parameters. Denna åtgärd synkroniserar undantagskoderna från AvaTax.

Finanspolitisk ställning

Navigera sedan till Redovisningsapp ‣ Konfiguration ‣ Redovisning: Skattepositioner. En Fiscal Position listas med namnet Automatic Tax Mapping (AvaTax). Klicka på den för att öppna AvaTaxs konfigurationssida för skattepositioner.

Kontrollera här att kryssrutan Use AvaTax API är markerad.

Om du vill kan du markera kryssrutan bredvid fältet märkt: Detect Automatically. Om detta alternativ är markerat kommer Odoo automatiskt att tillämpa denna Fiscal Position för transaktioner i Odoo.

Om du aktiverar Detect Automatically visas också specifika parametrar, till exempel VAT required, Foreign Tax ID, Country Group, Country, Federal States eller Zip Range. Om dessa parametrar fylls i filtreras användningen av Fiscal Position. Om du lämnar dem tomma görs alla beräkningar med hjälp av denna Fiscal Position.

Varning

Om kryssrutan Detect Automatically inte är markerad måste varje kund ha Fiscal Position inställd på fliken Sales and Purchase i kontaktposten. För att göra detta, navigera till Sales app ‣ Order ‣ Customers, eller Contacts app ‣ Contacts. Välj sedan en kund eller kontakt som du vill ställa in skattepositionen på.

Navigera till fliken Sales and Purchase och gå ner till avsnittet Fiscal Position. Ställ in fältet Fiscal Position till den skattemässiga positionen för kunden.

Se även

fiskala_positioner

AvaTax-konton

När du markerar kryssrutan för Use AvaTax API visas en ny flik AvaTax. Klicka på den här fliken för att visa två olika inställningar.

Den första inställningen är AvaTax Fakturakonto, medan den andra är AvaTax Återbetalningskonto. Se till att båda kontona är inställda för smidig bokföring i slutet av året. Kontakta en auktoriserad revisor (CPA) för specifik vägledning om hur du ställer in båda kontona.

Klicka på Save för att genomföra ändringarna.

Kartläggning av skatter

AvaTax-integrationen är tillgänglig på försäljningsorder och fakturor med den medföljande AvaTax-skattesatsen.

Kartläggning av produktkategorier

Innan du använder integrationen ska du ange en Avatax Category på produktkategorierna. Navigera till Inventory app ‣ Configuration ‣ Product Categories. Välj den produktkategori som du vill lägga till AvaTax Category till. I fältet AvaTax Category väljer du en kategori från rullgardinsmenyn eller Sök mer… för att öppna hela listan med alternativ.

Kartläggning av produkter

AvaTax Kategorier kan också ställas in på enskilda produkter. För att ställa in Avatax Category navigera till Inventory app ‣ Products ‣ Products. Välj den produkt som du vill lägga till Avatax Category för. Under fliken Generell information, längst till höger, finns ett väljarfält märkt: Avatax Category. Klicka slutligen på rullgardinsmenyn och välj en kategori, eller Sök mer… för att hitta en som inte finns med i listan.

Observera

Om både produkten och dess kategori har en AvaTax Category inställd, har produktens AvaTax Category företräde.

Viktigt

Mapping an AvaTax Category on either the Product or Product Category should be completed for every Product or Product Category, depending the route that is chosen.

Se även

• fiskala_positioner

• AvaTax användning

• Avalara (Avatax) portal

• Efterlevnad av skatteregler i USA: Avatax elearning video <https://www.odoo.com/slides/slide/us-tax-compliance-avatax-2858?fullscreen=1>`_

• AvaTax användning
• Avalara (Avatax) portal