TaxCloud-Integration¶
Warnung
Die Odoo-TaxCloud-Integration wird ab Odoo 17 entfernt. Neuinstallationen sind in Odoo 17 verboten. In Odoo 18 wird es das/die TaxCloud-Modul(e) nicht mehr geben. Odoo empfiehlt stattdessen die Verwendung der Avatax-Plattform.
Siehe auch
TaxCloud berechnet den Umsatzsteuersatz in Echtzeit für jeden Bundesstaat, jede Stadt und jede besondere Gerichtsbarkeit in den Vereinigten Staaten. Es verfolgt, welche Produkte von der Umsatzsteuer befreit sind und in welchen Staaten die jeweilige Befreiung gilt.
TaxCloud-Registrierung¶
Legen Sie ein Konto auf TaxCloud.com an und richten Sie es ein. Sobald es verwenden, erhalten Sie die TaxCloud-API-Schlüssel, indem Sie auf Stores (Shops) und dann auf Get Details (Details erhalten) klicken.
TaxCloud aktivieren¶
Gehen Sie zum und aktivieren Sie die Steuern im Abschnitt TaxCloud.
Fügen Sie unter API-ID die Anmelde-ID und unter API-Schlüssel den Schlüssel des Shops hinzu. Klicken Sie auf Speichern.
Klicken Sie auf die Schaltfläche Aktualisieren (🗘) neben Standardkategorie, um die Produktkategorien der TIC Taxability Information Codes aus TaxCloud zu importieren. Einige Kategorien können bestimmte Steuersätze oder Steuerbefreiungen beinhalten.
Wählen Sie eine Standardkategorie und Speichern Sie. Die Standardkategorie wird angewendet, wenn für Ihre Produkte oder Produktkategorien keine TaxCloud-Kategorie eingestellt ist oder wenn kein Produkt in einem Auftrag oder einer Rechnung gefunden wird.
TaxCloud-Kategorien für Produkte einstellen¶
Wenn Sie mehr als eine TIC-Kategorie (d. h. die Standardkategorie) verwenden möchten, gehen Sie zu den Reiter Allgemeine Informationen des Produkts und wählen Sie eine TaxCloud-Kategorie.
Wenn Sie mehrere Produkte gleichzeitig konfigurieren möchten, vergewissern Sie sich, dass sie dieselbe Produktkategorie teilen und klicken Sie auf die Schaltfläche für den externen Link (🡕), um stattdessen eine TaxCloud-Kategorie für die Produktkategorie festzulegen.
Bemerkung
Wenn Sie für ein Produkt eine TaxCloud-Kategorie und eine weitere für dessen Produktkategorie setzen, berücksichtigt Odoo nur die TaxCloud-Kategorie auf dem Produkt selbst.
Eine TaxCloud-Kategorie, die auf eine übergeordnete Produktkategorie gesetzt wurde, gilt nicht für ihre untergeordneten Produktkategorien. Wenn Sie zum Beispiel TaxCloud-Kategorie auf die Produktkategorie Alle setzen, wird es nicht auf die Produktkategorie Alle/Verkäufe angewendet.
Wichtig
Vergewissern Sie sich, dass Ihre Unternehmensadresse vollständig ist, einschließlich des Bundeslandes und der Postleitzahl. Gehen Sie zu , um Ihre Unternehmensadresse zu öffnen und zu bearbeiten.
Steuern automatisch im richtigen Steuerschuldkonto buchen¶
Um sicherzustellen, dass die von der TaxCloud-Integration generierten neuen Steuern mit dem richtigen Steuerschuldkonto erstellt werden, erstellen Sie eine benutzerdefinierten Vorgabe. Dieser Vorgang sollte für jedes Ihrer Unternehmen, das TaxCloud verwendet, wiederholt werden.
Warnung
Eine benutzerdefinierte Vorgabe wirkt sich bei der Erstellung auf alle Datensätze aus. Das bedeutet, dass jede neue Steuer so eingerichtet wird, dass das Einkommen auf dem angegebenen Steuerschuldkonto erfasst wird, es sei denn, die Steuer wird manuell bearbeitet, um ein anderes Ertragskonto anzugeben (oder wenn eine andere benutzerdefinierte Vorgabe Vorrang hat).
Gehen Sie dazu zum , suchen Sie das Steuerschuldkonto des Unternehmens, und klicken Sie auf Einrichten. Achten Sie auf die Zahl nach id= in der URL-Zeichenfolge; dies ist die ID des Steuerschuldkontos und wird später verwendet.
Aktivieren Sie den Entwicklermodus, gehen Sie dann zu und klicken Sie auf Neu.
Klicken Sie auf das Drop-down-Menü in Feld und dann auf Mehr suchen ….
Verwenden Sie die Suchleiste, um nach dem Modell Steuerverteilungszeile zu filtern, und verwenden Sie sie ein zweites Mal, um nach dem Feld Konto zu filtern. Wählen Sie die Zeile mit Steuerverteilungszeile unter der Spalte Modell.
Sobald Sie zur Erstellung von Benutzerdefinierten Standards zurückkehren, geben Sie die ID des Steuerschuldkontos, die Sie sich zuvor notiert haben, in das Feld Standardwert (JSON-Format) ein.
Wählen Sie im Feld Unternehmen das Unternehmen aus, für das diese Konfiguration gelten soll, und klicken Sie auf Speichern.
Die Steuerposition automatisch ermitteln¶
Die Umsatzsteuer wird in Odoo auf der Grundlage von Steuerpositionen berechnet. Eine Steuerposition für die Vereinigten Staaten wird erstellt, wenn Sie TaxCloud aktivieren.
Sie können Odoo so konfigurieren, dass es automatisch erkennt, auf welche Kunden die Steuerposition angewendet werden soll. Gehen Sie dazu zum und wählen Sie Automatische Steuerzuordnung (TaxCloud). Aktivieren Sie Automatisch erkennen und dann Speichern Sie.
Jetzt wird diese Steuerposition automatisch in jedem Auftrag oder Rechnung festgelegt, wenn das Land des Kunden Vereinigte Staaten ist. Dadurch wird die automatische Steuerberechnung ausgelöst.
Bemerkung
Um die Umsatzsteuer für einen Verkaufsauftrag zu erhalten, bestätigen Sie ihn oder klicken Sie auf die Schaltfläche Steuern aktualisieren neben Versand hinzufügen.
Interaktion mit Gutscheinen und Werbeaktionen¶
Wenn Sie Gutscheine oder Werbeaktionen verwenden, kann sich die Integration mit TaxCloud unerwartet verhalten. Da TaxCloud bei der Steuerberechnung keine Zeilen mit negativen Beträgen akzeptiert, muss der Betrag der durch die Werbeaktion hinzugefügten Zeilen von der Summe der Zeilen, auf die es sich auswirkt, abgezogen werden.
Wichtig
Das bedeutet unter anderem, dass Aufträge mit Gutscheinen oder Aktionen mit einer TaxCloud-Steuerposition vollständig abgerechnet werden müssen – Sie können keine Rechnungen für Teillieferungen usw. erstellen.
Ein anderes unerwartetes Verhalten ist möglich. Sie verkaufen z. B. ein Produkt, für das Sie eine Werbeaktion haben, die einen Rabatt von 50 % gewährt. Wenn der Steuersatz des Produkts 7 % beträgt, zeigt der von der TaxCloud-Integration berechnete Steuersatz 3,5 % an. Das liegt daran, dass der Rabatt in dem an TaxCloud gesendeten Preis enthalten ist. In Odoo steht der Rabatt jedoch in einer ganz anderen Zeile. Dennoch ist die Steuerberechnung korrekt. Eine Steuer von 3,5 % auf den vollen Preis entspricht einer Steuer von 7 % auf die Hälfte des Preises, was für den Benutzer jedoch unerwartet sein könnte.