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.
Wichtig
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: Steuerland.
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.
Wichtig
Bei der Nutzung von AvaTax zur Steuerberechnung gibt es in Odoo einige Einschränkungen:
AvaTax wird nicht für Odoo Kassensystem unterstützt, da ein dynamisches Steuerberechnungsmodell für Transaktionen innerhalb einer einzigen Lieferadresse, wie z. B. Geschäfte oder Restaurants, überzogen ist.
AvaTax und Odoo verwenden die Unternehmensadresse und nicht die Lagerhausadresse.
Verbrauchssteuern werden nicht unterstützt. Dies gilt auch für die Tabak-/Vape-Steuer, die Kraftstoffsteuer und andere spezifische Branchen.
Siehe auch
Avalaras Support-Dokumente: About AvaTax
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.
Tipp
Notieren Sie sich bei der Einrichtung des Kontos die Account ID (Konto-ID) von Avatar*. Diese wird in der Odoo-Einrichtung benötigt. In Odoo ist diese Nummer die API-ID.
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:
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 (Einstellungen –> Lizenz- und API-Schlüssel). Klicken Sie auf Generate License Key (Lizenzschlüssel generieren).
Bemerkung
Es erscheint eine Warnung: If your business app is connected to Avalara solutions, the connection will be broken until you update the app with the new license key. This action cannot be undone.
(Wenn Ihre Business-App mit Avalara-Lösungen verbunden ist, wird die Verbindung unterbrochen, bis Sie die App mit dem neuen Lizenz-Schlüssel aktualisieren. Diese Aktion kann nicht rückgängig gemacht werden.)
Die Generierung eines neuen Lizenzschlüssels unterbricht die Verbindung mit bestehenden Geschäftspps, die die AvaTax-Integration verwenden. Stellen Sie sicher, dass Sie diese Apps mit dem neuen Lizenzschlüssel aktualisieren.
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.
Wichtig
Kopieren Sie diesen Schlüssel an einen sicheren Ort. Es wird stark empfohlen, den Lizenzschlüssel für spätere Zwecke zu sichern. Dieser Schlüssel kann nach Verlassen dieses Bildschirms nicht mehr abgerufen werden.
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 Steuerland einzurichten.
, um dasSiehe auch
Under the Taxes section, set the Fiscal Country feature to United States or Canada. Then, click Save.
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 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.
und stellen Sie unter dem AbschnittWenn 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.
Siehe auch
Modulinstallation¶
Stellen Sie als nächstes sicher, dass das Odoo-Modul AvaTax installiert ist. Navigieren Sie dazu zu Suchen … den Begriff avatax
ein und drücken Sie Enter. Die folgenden Ergebnisse werden angezeigt:
Name |
Technische Bezeichnung |
Beschreibung |
---|---|---|
Avatax |
|
AvaTax-Standardmodul. Dieses Modul fügt die AvaTax-Grundfunktionen zur Steuerberechnung hinzu. |
Avatax für Verkaufsaufträge |
|
Enthält die Informationen, die für die Steuerberechnung in Verkaufsaufträgen in Odoo benötigt werden. |
Avatax for Subscriptions |
|
This module includes the features required for tax calculation on subscriptions in Odoo. |
Account Avatax - Ecommerce |
|
Includes tax calculation features for the checkout process on Odoo eCommerce. |
Account AvaTax - Ecommerce - Delivery |
|
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:
account_avatax
Avatax für Verkaufsaufträge:
account_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.
Odoos AvaTax-Einstellungen¶
To integrate the AvaTax API with Odoo, go to AvaTax fields in the Taxes section is where the AvaTax configurations are made and the credentials are entered in.
section. TheVoraussetzungen¶
Wählen Sie zunächst die Umgebung, in der das Unternehmen AvaTax verwenden möchte. Es kann entweder Sandbox oder Produktion sein.
Siehe auch
Hilfe bei der Entscheidung, welche AvaTax-Umgebung Sie verwenden sollten (entweder Produktion oder Sandbox), finden Sie unter: Sandbox- vs. Produktionsumgebung.
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.
Wichtig
Die Account ID (Konto-ID) finden Sie, indem Sie sich beim AvaTax-Portal anmelden (Sandbox oder Produktion). Klicken Sie in der oberen rechten Ecke auf die Initialen des Benutzers und Account (Konto). Die Account ID (Konto-ID) wird zuerst aufgeführt.
Um auf den License Key (Lizenzschlüssel) zuzugreifen, lesen Sie diese Dokumentation: Mit AvaTax verbinden.
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 (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.
Wichtig
Die Funktion Adressvalidierung funktioniert nur mit Partnern/Kunden in Nordamerika.
Aktivieren Sie außerdem das Kontrollkästchen neben dem Feld Adressvalidierung.
Wichtig
Für genaue Steuerberechnungen ist es am besten, wenn Sie eine vollständige Adresse für die in der Datenbank gespeicherten Kontakte eingeben. Allerdings kann AvaTax auch funktionieren, wenn Sie versuchen, nur die Felder Land, Bundesland und Postleitzahl zu verwenden. Dies sind die drei minimal erforderlichen Felder.
Speichern Sie die Einstellungen, um die Konfiguration zu implementieren.
Tipp
Manually Validate the address by navigating to the , 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.
Warnung
All previously-entered addresses for contacts in the Odoo database will need to be validated using the manually validate process outlined above. Addresses are not automatically validated if they were entered previously. This only occurs upon tax calculation.
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 synchronisierne. Diese Aktion synchronisiert die Befreiungscodes aus AvaTax.
Steuerposition¶
Next, navigate to Fiscal Position is listed named, Automatic Tax Mapping (AvaTax). Click it to open AvaTax’s fiscal position configuration page.
. AHere, 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.
Warnung
Should the Detect Automatically checkbox not be ticked, each customer will need to have the Fiscal Position set on their Sales and Purchase tab of the contact record. To do so, navigate to , or . Then, select a customer or contact to set the fiscal position on.
Navigate to the Sales and Purchase tab, and down to the section labeled, Fiscal Position. Set the Fiscal Position field to the fiscal position for the customer.
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 . 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 . 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.
Bemerkung
If both the product, and its category, have an AvaTax Category set, the product’s AvaTax Category takes precedence.
Wichtig
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.
Siehe auch