Pour installer et configurer l'interface d'intégration des taxes, appliquez la procédure suivante :
Pour qu'un magasin puisse utiliser la nouvelle instruction fournie par le kit d'intégration des taxes pour le calcul de taxe, vous devez enregistrer cette instruction, ApplyCalculationUsageCmd, dans la base de données WebSphere Commerce, en mettant à jour les tables CALMETHOD et STENCALUSG comme indiqué ci-après :
Colonne | Valeurs |
CALMETHOD_ID | La clé : ID unique affecté à une entrée |
STOREENT_ID | -1 ou l'<ID_magasin> |
CALUSAGE_ID | -3 |
TASKNAME | com.ibm.commerce.isv.kit.tax.ApplyCalculationUsageTIKCmd |
DESCRIPTION | Il s'agit de la description de la méthode de taxe de l'ISV |
SUBCLASS | 12 |
NAME | ApplyCalculationUsageTIK |
WebSphere Commerce propose des mécanismes permettant de déterminer le code de calcul de taxe (CALCODE), à utiliser lors du calcul de taxe pour un article de commande. Lorsqu'il est affecté à un produit ou un groupe de produits, chaque code de calcul de taxe est transmis à une application tierce partie de calcul de taxe et doit calculer une liste de montants de taxe, dont chaque montant correspond à une catégorie de taxe (par exemple, taxe provinciale sur les ventes, taxe générale sur les ventes), pour le produit ou le groupe de produits.
Les associations entre produits et codes de taxe, ainsi qu'entre les catégories de produits et les codes de taxe, apparaissent dans plusieurs tables de base de données. Ces tables permettent à WebSphere Commerce d'extraire les codes de calcul pour chaque produit d'un article de commande. Les tables de base de données importantes pour le kit d'intégration des taxes de WebSphere Commerce sont les suivantes :
L'éditeur de produits et les services de magasin de WebSphere Commerce fournissent l'interface graphique permettant d'alimenter ces tables. Toutefois, les applications de taxes tierces parties doivent disposer de leur propre utilitaire pour effectuer cette opération et cet utilitaire, s'il est disponible, doit être utilisé.
Les applications de taxes tierces parties peuvent fournir une liste de codes produit intégrés qui indiquent les modalités de taxation pour un produit donné. Vous pouvez importer ces codes produit peuvent être importés dans WebSphere Commerce, les utiliser comme codes de calcul de taxe de WebSphere Commerce et les affecter à des articles. Lorsque la taxe sur un article est calculée, le code produit tierce partie est extrait des tables WebSphere Commerce et renvoyé au programme de taxes tierce partie. Pour plus de détails, reportez-vous à la documentation du fournisseur.
Pour affecter des codes produit de taxe tierces parties à des articles, procédez comme suit :
Colonne | Valeurs |
CALCODE_ID | ID CALCODE unique |
STOREENT_ID | -1 ou <ID_magasin> |
CALUSAGE_ID | -3 |
CODE | Nom du code produit fourni par l'application tierce partie |
CALMETHOD_ID | -43 (valeur requise) |
CALMETHOD_ID_APP | -44 (valeur requise) |
CALMETHOD_ID_QFY | -42 (valeur requise) |
Pour plus de détails sur le mappage et l'affectation de codes de calcul (CALCODE), reportez-vous à la section ci-après.
Cette étape est facultative.
L'application de taxes tierce partie peut disposer de formats de code spécifiques associés à un pays ou un Etat pouvant être utilisés pour le calcul de taxe et devant être transmis par WebSphere Commerce dans ce format spécifique au lieu du format standard de nom de pays ou d'Etat. A cet effet, WebSphere Commerce fournit les tables COUNTCODE et STATECODE que vous pouvez alimenter avec les codes spécifiques de l'application de taxes tierce partie. Pour plus de détails, reportez-vous à la documentation du fournisseur.
Pour mapper les noms de pays et d'Etat aux codes affectés par l'application tierce partie, procédez comme suit :
COLONNE | VALEURS |
COUNTRYABBR | CA |
COUNTRYCODE | CA |
PRODUCTVENDOR | Taxware |
Si vos codes de calcul de taxe sont différents de ceux utilisés par votre application de taxes tierce partie, vous devrez peut-être appliquer la procédure suivante :
Les applications de taxes externes à WebSphere Commerce disposent généralement d'une liste de codes de taxation de produit intégrés ou de codes de taxation de produit, permettant d'indiquer les modalités de taxation d'un produit donné. En outre, ces applications permettent généralement à l'administrateur de taxes de déterminer des fourchettes de codes externes de taxation de produit définis par l'utilisateur et de les mapper sur les codes de taxation de produit intégrés, le cas échéant.
La clé de l'intégration de WebSphere Commerce à une application de taxes tierce partie réside dans le mappage des tables CALCODE de WebSphere Commerce sur les codes de taxation de produit de l'application tierce partie. Il existe deux méthodes pour effectuer ce mappage : utiliser les codes de taxation de produit de l'application tierce partie directement dans WebSphere Commerce ou mapper les tables CALCODE comme codes externes de taxation de produit définis par l'utilisateur dans l'application tierce partie. Ces deux méthodes acceptent deux modes de configuration des tables CALCODE pour les produits WebSphere Commerce : par SKU ou par groupe de produits.
Utilisation des codes externes de taxe de produit directement dans WebSphere Commerce. Pour vous assurer que les tables CALCODE sont correctement mappées sur les codes produit de l'application de taxes tierce partie, vous pouvez alimenter les tables WebSphere Commerce avec les codes de taxation de produit de l'application tierce partie. Lorsque la taxe est calculée sur un article, ce code de taxation de produit est extrait des tables et transmis à l'application tierce partie. Celle-ci utilise alors son propre code de taxation de produit sans autre conversion pour déterminer les modalités de taxation d'un article de commande.
L'avantage de cette approche est qu'aucun mappage n'est requis dans l'application tierce partie. Cette méthode peut être adaptée aux clients qui utilisent déjà les codes de taxation de produit d'une application tierce partie. L'inconvénient de cette méthode est que les tables CALCODE de WebSphere Commerce doivent être mises à jour après chaque modification des codes de taxation de produit de l'application tierce partie. Toutefois, cette maintenance est généralement limitée à une révision des codes produit nouveaux et modifiés et sa portée doit être restreinte à terme.
Cette méthode propose deux modes de définition des codes de taxation de produit, à savoir : par groupe ou par SKU (produit). La procédure ci-après décrit l'utilisation de ces deux modes de mappage.
Cette procédure décrit l'utilisation de codes de taxation de produit d'une application de taxes tierce partie directement dans WebSphere Commerce en attribuant un code de taxation de produit à chaque groupe de catalogue.
Cette procédure décrit l'utilisation de codes de taxation de produit d'une application de taxes tierce partie directement dans WebSphere Commerce par l'affectation d'un code externe de taxe de produit à chaque entrée de catalogue.
Pour chaque entrée de catalogue de la table CATENTRY, créez une ligne dans la table CATENCALCD qui mappe l'identificateur CATENTRY.CATENTRY_ID sur l'identificateur CALCODE.CALCODE_ID associé au code externe de taxation de produit.
Pour vous assurer que les tables CALCODE sont mappées correctement aux codes de taxation de produit d'une application de taxes tierce partie, vous pouvez également alimenter les tables WebSphere Commerce avec des codes externes de taxe de produit définis par l'utilisateur. Lorsque la taxe est calculée sur un article, le code externe de taxe de produit défini par l'utilisateur est extrait des tables WebSphere Commerce et transmis à l'application tierce partie. Celle-ci utilise alors son propre mécanisme de mappage pour obtenir un code de taxation de produit correct et détermine les modalités de taxation à appliquer à l'article de commande.
L'avantage de cette approche est que WebSphere Commerce n'est pas directement lié aux codes de taxation de produit de l'application tierce partie. Cette méthode est adaptée aux clients qui ont déjà défini leurs tables CALCODE et souhaitent les mapper sur des codes externes de taxation de produit à l'aide du mécanisme de mappage de l'application tierce partie.
L'inconvénient de cette technique réside dans le travail de préparation supplémentaire pour mapper les codes externes de taxe de produit définis par l'utilisateur sur l'application tierce partie. Toutefois, ce travail en amont qui n'est effectué qu'une fois décuple les codes produit de WebSphere Commerce et permet de limiter la majeure partie de la maintenance des codes produit à l'aspect tierce partie de cette intégration.
Cette méthode propose deux modes de mappage : par groupe ou par SKU (produit). La procédure ci-après décrit ces deux modes.
Cette procédure décrit l'utilisation de codes de taxation de produit d'une application de taxes tierce partie indirectement dans WebSphere Commerce par l'affectation de tables CALCODE à chaque groupe de catalogue dans WebSphere Commerce et par le mappage de CALCODE sur un code externe de taxe de produit défini par l'utilisateur dans l'application tierce partie.
Cette procédure décrit l'utilisation de codes de taxation de produit d'une application de taxes tierce partie indirectement dans WebSphere Commerce par l'affectation de tables CALCODE à chaque entrée de catalogue dans WebSphere Commerce et par le mappage de CALCODE sur un code externe de taxation de produit défini par l'utilisateur dans l'application tierce partie.
Si une table CALCODE est associée à un produit qui lui-même appartient à un groupe de catalogue auquel est également associée une table CALCODE, la zone SEQUENCE de la table CALCODE détermine le code effectivement sélectionné. Le mappage de produits et de groupes sur des codes de taxe de produit via les tables CALCODE doit être effectué avec précaution. En effet, la table CALCODE dont le nombre SEQUENCE est le plus élevé, est sélectionnée, il convient donc d'attribuer aux tables CALCODE de produits un nombre SEQUENCE plus élevé qu'aux tables CALCODE de groupe de catalogues.
Lors de la création de votre magasin en ligne, vous devrez associer un code de calcul de taxe aux articles répertoriés dans votre catalogue. Pour ce faire, trois méthodes sont possibles :
Pour compléter votre intégration, vous devez disposer d'une fonction d'intégration des taxes existantes adaptée à l'application de taxes que vous avez choisie ou en créer une. La liste ci-après répertorie les principales étapes de création d'une fonction d'intégration des taxes destinée à votre magasin WebSphere Commerce.
![]() |