AvaTax-Integration¶

Avalaras AvaTax ist eine cloudbasierte Steuersoftware. Die Integration von AvaTax in Odoo ermöglicht Echtzeit- und regionsspezifische Steuerberechnungen, wenn Benutzer Artikel in Odoo verkaufen, kaufen und fakturieren. Die AvaTax-Steuerberechnung wird für alle von den Vereinten Nationen aufgelisteten Länder unterstützt, einschließlich grenzüberschreitender Transaktionen.

AvaTax berücksichtigt die standortabhängigen Steuersätze für jeden Staat, jeden Landkreis und jede Stadt. Es verbessert die Überweisungsgenauigkeit, indem es Gesetze, Regeln, Zuständigkeitsgrenzen und besondere Umstände (wie z. B. Steuerferien und Produktbefreiungen) genau beachtet. Unternehmen, die AvaTax integrieren, können mit dieser einfachen API-Integration die Kontrolle über die internen Steuerberechnungen behalten.

Einrichtung in AvaTax¶

Um AvaTax zu verwenden, ist für die Einrichtung ein Konto bei Avalara erforderlich. Wenn Sie noch kein Konto eingerichtet haben, setzen Sie sich mit Avalara in Verbindung, um eine Lizenz zu erwerben: Avalara: Kontaktieren Sie uns.

Then, create a basic company profile.

Ein einfaches Unternehmensprofil erstellen¶

Erfassen Sie die wichtigsten Unternehmensdaten für den nächsten Schritt: Orte, an denen Steuern erhoben werden, verkaufte Produkte/Dienstleistungen (und deren Verkaufsorte) und ggf. Steuerbefreiungen für Kunden. Folgen Sie der Avalara-Dokumentation zur Erstellung eines einfachen Unternehmensprofils:

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.

Mit AvaTax verbinden¶

Verbinden Sie sich nach der Erstellung des einfachen Unternehmensprofils in Avalara mit AvaTax. Dieser Schritt verbindet Odoo und AvaTax bidirektional.

Navigieren Sie entweder zu Avalaras Sandbox oder Produktionsumgebung. Dies hängt davon ab, welche Art von Avalara-Konto das Unternehmen integrieren möchte.

Melden Sie sich an, um den License Key (Lizenzschlüssel) zu erhalten. Gehen Sie zu Settings ‣ License and API Keys (Einstellungen –> Lizenz- und API-Schlüssel). Klicken Sie auf Generate License Key (Lizenzschlüssel generieren).

Wenn dies die erste API-Integration mit AvaTax und Odoo ist, dann klicken Sie auf Generate license key (Lizenzschlüssel generieren).

Wenn es sich um einen zusätzlichen Lizenzschlüssel handelt, stellen Sie sicher, dass die vorherige Verbindung unterbrochen werden kann. Es gibt nur einen Lizenzschlüssel, der mit jedem der Sandbox- und Produktionskonten von Avalara verbunden ist.

Odoo-Konfiguration¶

Vo der Verwendung von AvaTax müssen Sie einige zusätzliche Konfigurationen in Odoo vornehmen, um sicherzustellen, dass die Steuerberechnungen korrekt durchgeführt werden.

Überprüfen Sie, ob die Odoo-Datenbank die erforderlichen Daten enthält. Das Land, das ursprünglich in der Datenbank eingerichtet wurde, bestimmt die Steuerposition und hilft AvaTax bei der Berechnung der genauen Steuersätze.

Steuerland¶

Navigieren Sie zu Buchhaltung ‣ Konfiguration ‣ Einstellungen, um das Steuerland einzurichten.

Richten Sie unter dem Abschnitt Steuern die Funktion Steuerland auf Vereinigte Staaten, Kanada oder Brasilien ein. Klicken Sie dann auf Speichern.

Unternehmenseinstellungen¶

Alle Unternehmen, die in der Odoo-Datenbank betrieben werden, sollten in den Einstellungen mit einer vollständigen Adresse aufgeführt sein. Navigieren Sie zur App Einstellungen und stellen Sie unter dem Abschnitt Unternehmen sicher, dass nur ein Unternehmen in der Odoo-Datenbank vorhanden ist. Klicken Sie auf Infos aktualisieren, um eine separate Seite zum Aktualisieren der Unternehmensdaten zu öffnen.

Wenn mehrere Unternehmen in der Datenbank vorhanden sind, klicken Sie auf Unternehmen verwalten, um eine Liste der Unternehmen zu laden, aus der Sie auswählen können. Aktualisieren Sie die Unternehmensinformationen, indem Sie auf das jeweilige Unternehmen klicken.

Datenbankadministratoren sollten sicherstellen, dass die Angaben Straße …, Straße2 …, Stadt, Bundesland, PLZ und Land für die Unternehmen aktualisiert werden.

Dies gewährleistet genaue Steuerberechnungen und einen reibungslosen Ablauf der Buchhaltung am Jahresende.

Modulinstallation¶

Stellen Sie als nächstes sicher, dass das Odoo-Modul AvaTax installiert ist. Navigieren Sie dazu zu Apps. Geben Sie in der Leiste Suchen … den Begriff avatax ein und drücken Sie Enter. Die folgenden Ergebnisse werden angezeigt:

Klicken Sie auf die Schaltfläche Installieren auf dem Modul mit der Bezeichnung Avatax: account_avatax. Dadurch werden die folgenden Module installiert:

• Avatax: account_avatax

• Avatax für Verkaufsaufträge: account_avatax_sale

• Avatax für Lager: account_avatax_stock

Sollte AvaTax für die Geolokalisierung oder mit dem Amazon-Konnektor benötigt werden, dann installieren Sie diese Module einzeln, indem Sie auf Installieren auf Avatax für Geolokalisierung bzw. Amazon/Avatax-Brücke klicken.

Odoos AvaTax-Einstellungen¶

Um die AvaTax-API in Odoo zu integrieren, gehen Sie zum Abschnitt Buchhaltung ‣ Konfiguration ‣ Einstellungen. In den AvaTax-Feldern im Abschnitt Steuern werden die AvaTax-Konfigurationen vorgenommen und die Anmeldeinformationen eingegeben.

Kreuzen Sie zunächst das Kontrollkästchen links neben den AvaTax-Einstellungen an, um AvaTax in der Datenbank zu aktivieren. Dies ist ein schneller und bequemer Weg, um die AvaTax-Steuerberechnung in der Odoo-Datenbank zu aktivieren und zu deaktivieren.

Voraussetzungen¶

Wählen Sie zunächst die Umgebung, in der das Unternehmen AvaTax verwenden möchte. Es kann entweder Sandbox oder Produktion sein.

Anmeldedaten¶

Jetzt können Sie die Anmeldeinformationen eingeben. Die Account ID (Konto-ID) von AvaTax sollte in das Feld API-ID und der License Key (Lizenzschlüssel) in das Feld API-Schlüssel eingetragen werden.

Für das Feld Unternehmenscode geben Sie den Avalara-Unternehmenscode für das zu konfigurierende Unternehmen ein. Avalara interpretiert dies als DEFAULT (STANDARD), wenn es nicht gesetzt ist. Den Unternehmenscode finden Sie im Avalara-Verwaltungsportal zugreifen.

Melden Sie sich zunächst beim AvaTax-Portal an (Sandbox oder Produktion). Navigieren Sie dann zu Settings ‣ Manage Companies (Einstellungen –> Unternehmen verwalten). Der Wert Company Code (Unternehmenscode) befindet sich in der Zeile des Company (Unternehmen) in der Spalte Company Code (Unternehmenscode).

Transaktionsoptionen¶

Es gibt zwei Transaktionseinstellungen in Odoos AvaTax-Einstellungen, die konfiguriert werden können: UPC verwenden und In Transaktionen einbinden.

Wenn das Kontrollkästchen neben UPC verwenden aktiviert ist, verwenden die Transaktionen Universal Product Codes (UPC) anstelle der benutzerdefinierten Codes in Avalara. Wenden Sie sich an einen Wirtschaftsprüfer (CPA) für weitere Informationen.

Wenn das Kontrollkästchen In Transaktionen einbinden aktiviert ist, werden die Transaktionen in der Odoo-Datenbank für die Berichterstattung in AvaTax festgeschrieben.

Adressvalidierung¶

Die Funktion Adressvalidierung stellt sicher, dass für einen Kontakt in Odoo die aktuellste Adresse nach postalischen Standards eingestellt ist. Dies ist wichtig, um genaue Steuerberechnungen für Kunden zu ermöglichen.

Aktivieren Sie außerdem das Kontrollkästchen neben dem Feld Adressvalidierung.

Speichern Sie die Einstellungen, um die Konfiguration zu implementieren.

Tipp

Manually Validate the address by navigating to the Contacts app, and selecting a contact. Now that the AvaTax module has been configured on the database, a Validate button appears directly below the Address.

Click Validate, and a pop-up window appears with a Validated Address and Original Address listed. If the Validated Address is the correct mailing address for tax purposes, click Save Validated.

Verbindung testen¶

After entering all the above information into the AvaTax setup on Odoo, click Test connection. This ensures the API ID and API KEY are correct, and a connection is made between Odoo and the AvaTax application programming interface (API).

Parameter synchronisieren¶

Nach Abschluss der Konfiguration und der Einstellungen im Abschnitt AvaTax klicken Sie auf die Schaltfläche Parameter synchronisieren. Diese Aktion synchronisiert die Befreiungscodes aus AvaTax.

Steuerposition¶

Next, navigate to Accounting app ‣ Configuration ‣ Accounting: Fiscal Positions. A Fiscal Position is listed named, Automatic Tax Mapping (AvaTax). Click it to open AvaTax’s fiscal position configuration page.

Here, ensure that the Use AvaTax API checkbox is ticked.

Optionally, tick the checkbox next to the field labeled: Detect Automatically. Should this option be ticked, then, Odoo will automatically apply this Fiscal Position for transactions in Odoo.

Enabling Detect Automatically also makes specific parameters, such as VAT required, Foreign Tax ID, Country Group, Country, Federal States, or Zip Range appear. Filling these parameters filters the Fiscal Position usage. Leaving them blank ensures all calculations are made using this Fiscal Position.

AvaTax-Konten¶

Wenn Sie das Kontrollkästchen für AvaTax-API verwenden aktivieren, erscheint ein neuer Reiter AvaTax. Klicken Sie auf diesen Reiter, um zwei verschiedene Einstellungen zu sehen.

The first setting is the AvaTax Invoice Account, while the second is, AvaTax Refund Account. Ensure both accounts are set for smooth end-of-year record keeping. Consult a certified public accountant (CPA) for specific guidance on setting both accounts.

Klicken Sie auf Speichern, um die Änderungen zu übernehmen.

Steuerzuordnung¶

Die Avatax-Integration ist bei Verkaufsaufträgen und Rechnungen mit der enthaltenen Avatax-Steuerposition verfügbar.

Zuordnung der Produktkategorie¶

Before using the integration, specify an Avatax Category on the product categories. Navigate to Inventory app ‣ Configuration ‣ Product Categories. Select the product category to add the AvaTax Category to. In the AvaTax Category field, select a category from the drop-down menu, or Search More… to open the complete list of options.

Product mapping¶

AvaTax Categories may be set on individual products, as well. To set the Avatax Category navigate to Inventory app ‣ Products ‣ Products. Select the product to add the Avatax Category to. Under the General Information tab, on the far-right, is a selector field labeled: Avatax Category. Finally, click the drop-down menu, and select a category, or Search More… to find one that is not listed.