Führen Sie die folgenden Schritte aus, um die Schnittstelle zur Integration von Steuern zu installieren und zu konfigurieren:
Damit ein Geschäft den neuen Befehl verwenden kann, der vom Steuerintegrationskit zur Steuerberechnung bereitgestellt wird, müssen Sie diesen neuen Befehl (ApplyCalculationUsageCmd) in der WebSphere Commerce-Datenbank registrieren, indem Sie die Tabellen CALMETHOD und STENCALUSG aktualisieren. Dazu müssen Sie wie folgt vorgehen:
Spalte | Werte |
CALMETHOD_ID | Der Schlüssel: eine eindeutige ID, die dem Eintrag zugewiesen wird |
STOREENT_ID | -1 oder die <geschäfts_id> |
CALUSAGE_ID | -3 |
TASKNAME | com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd |
DESCRIPTION | Eine Beschreibung der Umsatzsteuermethode des unabhängigen Softwareanbieters |
SUBCLASS | 12 |
NAME | ApplyCalculationUsageTIK |
WebSphere Commerce stellt Mechanismen dafür bereit, wie der Steuerberechnungscode (CALCODE) ermittelt werden kann, der für die Berechnung der Steuern für einen Bestellartikel verwendet werden muss. Bei der Zuordnung zu einem Produkt oder einer Produktgruppe wird jeder Berechnungscode an die Steueranwendung des Drittherstellers übergeben. Er ist für die Berechnung einer Liste mit Steuerbeträgen für das Produkt oder die Produktgruppe verantwortlich, wobei je ein Betrag pro Steuerkategorie (z. B. verschiedene Arten von Umsatzsteuern) verwendet wird.
Die Zuordnungen zwischen Produkten und Steuercodes sowie zwischen Produktkategorien und Steuercodes werden in einigen Datenbanktabellen angezeigt. WebSphere Commerce verwendet diese Tabellen dazu, die Berechnungscodes für jedes Produkt in einem Bestellartikel abzurufen. Die für das WebSphere Commerce-Steuerintegrationskit wichtigen Datenbanktabellen sind im Folgenden aufgeführt:
Der WebSphere Commerce-Produkteditor und die WebSphere Commerce-Geschäftsservices stellen die grafische Benutzerschnittstelle (GUI) zur Verfügung, mit der diese Tabellen gefüllt werden können. Steueranwendungen von Drittherstellern können jedoch über eigene Dienstprogramme für denselben Zweck verfügen. Diese werden verwendet, wenn sie verfügbar sind.
Die Steueranwendungen von Drittherstellern stellen u. U. eine Liste mit den integrierten Produktcodes bereit, um die Steuerbehandlung für ein bestimmtes Produkt anzuzeigen. Diese Produktcodes können in WebSphere Commerce importiert werden, um als WebSphere Commerce-Steuerberechnungscodes verwendet und zu den Artikeln zugeordnet zu werden. Wenn also Steuern für einen Artikel berechnet werden, wird der Produktcode des Drittherstellers aus den WebSphere Commerce-Tabellen extrahiert und an das Steuerprogramm des Drittherstellers zurück übergeben. Weitere Informationen hierzu enthält die Dokumentation des betreffenden Anbieters.
Gehen Sie wie folgt vor, um die Steuerproduktcodes von Drittherstellern zu den Artikeln zuzuordnen:
Spalte | Werte |
CALCODE_ID | Eine eindeutige CALCODE_ID |
STOREENT_ID | -1 oder <geschäfts_ID> |
CALUSAGE_ID | -3 |
CODE | Der Name des Produktcodes, der von der Drittherstelleranwendung bereitgestellt wird |
CALMETHOD_ID | -43 (verbindlicher Wert) |
CALMETHOD_ID_APP | -44 (verbindlicher Wert) |
CALMETHOD_ID_QFY | -42 (verbindlicher Wert) |
Weitere Einzelheiten zur Zuordnung von CALCODE sind nachfolgend verfügbar.
Dieser Schritt ist optional.
Die Steueranwendung eines Drittherstellers kann über spezifische Codeformate verfügen, die ein Land oder ein Bundesland darstellen, das zur Berechnung der Steuern verwendet werden muss. Dies macht es für WebSphere Commerce u. U. erforderlich, die Codes in diesem spezifischen Format zu übergeben, nicht im standardmäßigen Namen des betreffenden Landes oder Bundeslands. Daher stellt WebSphere Commerce die Tabellen COUNTCODE und STATECODE bereit, in die die spezifischen Codes eingetragen werden können, die von der Steueranwendung des Drittherstellers verfügbar gemacht werden. Einzelheiten hierzu können Sie der Dokumentation des betreffenden Anbieters entnehmen.
Führen Sie die folgenden Schritte aus, um die Namen von Ländern und Bundesländern den Codes zuzuordnen, die vom Drittherstellerprodukt zugewiesen werden:
SPALTE | WERTE |
COUNTRYABBR | CA |
COUNTRYCODE | CA |
PRODUCTVENDOR | Taxware |
Wenn sich Ihre Steuerberechnungscodes von denen unterscheiden, die von Ihrer Steueranwendung des Drittherstellers verwendet werden, müssen Sie u. U. einen der folgenden Schritte ausführen:
Steuerpakete, die für WebSphere Commerce extern sind, verfügen normalerweise über eine Liste integrierter Produktbesteuerbarkeitscodes oder Produktbesteuerbarkeitscodes, die die Steuerbehandlung für ein bestimmtes Produkt angeben. Darüber hinaus kann der Steueradministrator mit diesen Paketen Bereiche für benutzerdefinierte externe Produktbesteuerbarkeitscodes definieren und diese auf geeignete Weise zu den integrierten Produktbesteuerbarkeitscodes zuordnen.
Der Schlüssel zur Integration von WebSphere Commerce mit einem externen Steuerpaket liegt in der Zuordnung von WebSphere Commerce-CALCODEs zu den Produktbesteuerbarkeitscodes des externen Steuerpakets. Es gibt grundsätzlich zwei Arten, wie diese Zuordnung erfolgen kann: unter Verwendung der Produktbesteuerbarkeitscodes des externen Steuerpakets direkt in WebSphere Commerce oder durch Zuordnen von CALCODEs als benutzerdefinierte externe Produktbesteuerbarkeitscodes im externen Steuerpaket. Diese beiden Methoden bieten zwei Arten zum Einrichten der CALCODEs für WebSphere Commerce-Produkte: nach Artikelnummer oder nach Produktgruppe.
Verwendung externer Produktsteuercodes direkt in WebSphere Commerce. Eine Methode dazu, sicherzustellen, dass CALCODEs fehlerfrei zu den Produktcodes eines externen Steuerpakets zugeordnet werden, besteht darin, die WebSphere Commerce-Tabellen mit den Produktbesteuerbarkeitscodes des externen Steuerpakets zu füllen. Wenn für einen Artikel Steuern berechnet werden, wird dieser Produktbesteuerbarkeitscode aus den Tabellen extrahiert und an das externe Steuerpaket übergeben. Das externe Steuerpaket verwendet dann einen eigenen Produktbesteuerbarkeitscode ohne zusätzliche Konvertierung, um die Steuerbehandlung für den Bestellartikel zu ermitteln.
Der Vorteil dieser Herangehensweise liegt darin, dass innerhalb des externen Steuerpakets keine Zuordnung erforderlich ist. Diese Verfahrensweise kann für Kunden nützlich sein, die bereits die Produktbesteuerbarkeitscodes des externen Steuerpakets verwenden. Ihr Nachteil liegt darin, dass die WebSphere Commerce-CALCODE-Tabellen immer dann aktualisiert werden müssen, wenn die Produktbesteuerbarkeitscodes des externen Steuerpakets geändert werden. Diese Pflegemaßnahmen sind aber normalerweise auf eine Prüfung neuer und geänderter Produktcodes beschränkt und sollten in einem gewissen Rahmen bleiben, wobei sie allerdings fortlaufend durchgeführt werden müssen.
Bei dieser Herangehensweise gibt es zwei Arten zur Definition der Produktbesteuerbarkeitscodes: nach Gruppe oder nach Artikelnummer (Produkt). Nachfolgend wird die Verfahrensweise zur Zuordnung für beide Verfahren beschrieben.
Diese Vorgehensweise beschreibt, wie die Produktbesteuerbarkeitscodes eines externen Steuerpakets direkt in WebSphere Commerce verwendet werden können, indem jeder Kataloggruppe ein Produktbesteuerbarkeitscode zugewiesen wird.
Diese Vorgehensweise beschreibt, wie die Produktbesteuerbarkeitscodes eines externen Steuerpakets direkt in WebSphere Commerce verwendet werden können, indem jedem Katalogeintrag ein externer Produktsteuercode zugewiesen wird.
Erstellen Sie für jeden Katalogeintrag in der Tabelle CATENTRY eine Zeile in der Tabelle CATENCALCD, wobei die Kennung CATENTRY.CATENTRY_ID zu der Kennung CALCODE.CALCODE_ID zugeordnet wird, die dem externen Produktbesteuerbarkeitscode zugewiesen ist.
Eine weitere Methode dazu, sicherzustellen, dass CALCODEs fehlerfrei zu den Produktbesteuerbarkeitscodes eines externen Steuerpakets zugeordnet werden, besteht darin, die WebSphere Commerce-Tabellen mit benutzerdefinierten externen Produktsteuercodes zu füllen. Wenn Steuern für einen Artikel berechnet werden, wird der benutzerdefinierte externe Produktsteuercode aus den WebSphere Commerce-Tabellen extrahiert und an das externe Steuerpaket übergeben. Das externe Steuerpaket verwendet dann einen eigenen Zuordnungsmechanismus, um einen gültigen Produktbesteuerbarkeitscode zu erhalten und die Steuerbehandlung für den betreffenden Bestellartikel zu ermitteln.
Der Vorteil dieser Herangehensweise liegt darin, dass WebSphere Commerce nicht direkt an die Produktbesteuerbarkeitscodes des externen Steuerpakets gebunden ist. Diese Vorgehensweise kann für Kunden nützlich sein, die bereits eigene CALCODEs verwenden und diese zu den externen Produktbesteuerbarkeitscodes zuordnen möchten, wozu sie den Zuordnungsmechanismus des externen Steuerpakets verwenden möchten.
Der Nachteil dieser Vorgehensweise liegt darin, dass im Vorfeld zusätzliche Arbeit erforderlich wird, um die benutzerdefinierten externen Produktsteuercodes im externen Steuerpaket zuzuordnen. Diese zusätzliche Arbeit, die nur einmal anfällt, führt zu einer Trennung von Produktcodes und WebSphere Commerce und ermöglicht, dass ein größerer Anteil der Produktcodepflege auf den Teil der Integration beschränkt bleibt, den das externe Steuerpaket bildet.
Bei dieser Herangehensweise gibt es zwei Methoden, mit denen diese Zuordnung erreicht werden kann: nach Gruppe oder nach Artikelnummer (Produkt). Nachfolgend werden beide Methoden beschrieben.
Diese Vorgehensweise beschreibt, wie die Produktbesteuerbarkeitscodes eines externen Steuerpakets indirekt in WebSphere Commerce verwendet werden können, indem zu jeder Kataloggruppe in WebSphere Commerce CALCODEs zugewiesen und diese CALCODEs dann zu einem benutzerdefinierten externen Produktsteuercode im externen Steuerpaket zugeordnet werden.
Diese Vorgehensweise beschreibt, wie die Produktbesteuerbarkeitscodes eines externen Steuerpakets indirekt in WebSphere Commerce verwendet werden können, indem zu jedem Katalogeintrag in WebSphere Commerce CALCODEs zugewiesen und diese CALCODEs dann zu einem benutzerdefinierten externen Produktbesteuerungscode im externen Steuerpaket zugeordnet werden.
Wenn ein Produkt über einen zugeordneten CALCODE verfügt und es zu einer Produktgruppe gehört, die ebenfalls über einen zugeordneten CALCODE verfügt, legt das Feld SEQUENCE in der Tabelle CALCODE fest, welcher Code tatsächlich ausgewählt wird. Bei der Zuordnung von Produkten und auch Gruppen zu Produktsteuercodes über CALCODEs sollte vorsichtig vorgegangen werden. In einer solchen Situation wird der CALCODE mit dem höheren Wert für SEQUENCE ausgewählt. Daher sollten im Allgemeinen CALCODEs für Produkte höhere Werte für SEQUENCE zugeordnet werden als CALCODEs für Produktgruppen.
Im Zusammenhang mit der Erstellung Ihres Onlinegeschäfts müssen Sie Artikeln, die in Ihrem Katalog enthalten sind, einen Steuerberechnungscode zuweisen. Es gibt drei verschiedene Arten, dies zu tun:
Um Ihre Integration abzuschließen, müssen Sie eine bestehende Funktion zu Steuerintegration beschaffen, die für Ihre Steueranwendung verwendet werden kann, oder eine neue erstellen. Nachfolgend ist eine Liste der allgemeinen Schritte aufgeführt, die Sie ausführen müssen, um eine Funktion zur Steuerintegration für Ihr WebSphere Commerce-Geschäft zu erstellen.
![]() |