Installation et configuration de l'interface d'intégration des taxes

Pour installer et configurer l'interface d'intégration des taxes, appliquez la procédure suivante :

  1. Enregistrement de nouvelles instructions fournies par le kit d'intégration des taxes dans la base de données
  2. Configuration de codes de calcul de taxe
  3. Configuration de codes de pays et d'Etats (facultatif)
  4. Mappage des codes de calcul de taxe de WebSphere Commerce
  5. Mappage des codes de calcul de taxe de WebSphere Commerce à l'aide de codes externes définis par l'utilisateur
  6. (facultatif)
  7. Association d'un code de calcul de taxe à des articles
  8. Création d'une fonction d'intégration des taxes

A. Enregistrement de nouvelles instructions fournies par le kit d'intégration des taxes dans la base de données

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 :

  1. Insérez une entrée dans la table CALMETHOD.
    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
  2. Mettez à jour la table STENCALUSG en insérant le nouvel identificateur CALMETHOD ID (obtenu ci-avant) du magasin : 

    update STENCALUSG set CALMETHOD_ID_APP = <CALMETHOD ID> où 
        CALUSAGE_ID = -3 et STOREENT_ID = <ID_magasin>
  3. Si CMDREG contient une entrée portant ce nom d'interface, supprimez l'entrée : com.ibm.commerce.taxation.commands.ApplyOrderTaxesCmd
Le fournisseur du logiciel de calcul des taxes vous demandera également d'enregistrer les instructions, TaxOrderCmd et TaxOrderItemCmd, dans CMDREG.  Pour plus de détails, reportez-vous à la documentation du fournisseur de logiciels de taxes.

B. Configuration des codes de calcul de taxe

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 :

  1. Pour chaque groupe de catalogue dans la table CATGROUP ou entrée de catalogue dans la table CATENTRY nécessitant l'application de modalités de taxation, choisissez le code produit tierce partie approprié.
  2. Alimentez la table CALCODE avec les codes produit tierce partie. Pour chaque code produit, créez une entrée dans la table CALCODE où la valeur de la zone CODE est le code produit. Voici une description du contenu d'une nouvelle entrée dans la table CALCODE :
    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)

     
  3. Affectation du code de calcul aux groupes de catalogue ou aux entrées de catalogue. Pour chaque groupe de catalogue requérant l'application de modalités de taxation, créez un ligne dans la table CATGPCALCD qui mappe l'identificateur CATGROUPS_ID (dans la table CATGROUP) à l'identificateur CALCODE_ID (dans la table CALCODE). 
  4. Pour chaque entrée de catalogue requérant l'application de modalités de taxation, créez une ligne dans CATENCALCD qui mappe l'identificateur CATENTRY_ID (dans la table CATENTRY) à l'identificateur CALCODE_ID (dans la table CALCODE).

Pour plus de détails sur le mappage et l'affectation de codes de calcul (CALCODE), reportez-vous à la section ci-après

C. Configuration de codes de pays et d'Etats

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 : 

  1. Mappez le nom de pays au code de pays tierce partie. Identifiez l'abréviation de chaque nom de pays dans la table COUNTRY, puis créez une ligne dans la table COUNTCODE pour mapper l'entrée COUNTRYABBR (dans la table COUNTRY) au code de pays tierce partie. Voici un exemple :
     
    COLONNE VALEURS
    COUNTRYABBR CA
    COUNTRYCODE CA
    PRODUCTVENDOR Taxware

     

  2. Mappez le nom d'Etat au code d'Etat tierce partie. Identifiez l'abréviation de chaque nom d'Etat dans la table STATEPROV, puis créez une ligne dans la table STATECODE qui mappe l'entrée STATEPROVABBR (dans la table STATEPROV) sur le code d'Etat tierce partie.

D. Mappage des codes de calcul de taxe de WebSphere Commerce 

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.

Procédure de mappage de groupes de produit sur des codes externes

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. 

  1. Pour chaque groupe de catalogue de la table CATGROUP, choisissez un code de taxation de produit de l'application tierce partie approprié au groupe.
  2. Alimentez la table CALCODE. Pour chaque code de taxation de produit de l'application tierce partie devant correspondre à un groupe de catalogue, créez une ligne dans la table CALCODE où CALCODE.CODE représente le code externe de taxation du produit et CALCODE.CALCODE_ID une clé unique.
  3. Alimentez la table CATGPCALCD. Pour chaque groupe de catalogue de la table CATGROUP, créez une ligne dans la table CATGPCALCD qui mappe l'identificateur CATGPCALCD.CATGROUP_ID sur l'identificateur CALCODE.CALCODE_ID associé au code externe de taxation de produit.
Procédure de mappage de SKU de produit sur des codes externes

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.

  1. Pour chaque entrée de catalogue dans la table CATENTRY, choisissez le code de taxation de produit de l'application tierce partie approprié à l'entrée de catalogue.
  2. Alimentez la table CALCODE. Pour chaque code de taxation de produit de l'application tierce partie devant correspondre à une entrée de catalogue, créez une ligne dans la table CALCODE où CALCODE.CODE représente le code externe de taxation du produit et CALCODE.CALCODE_ID une clé unique.
  3. Alimentez la table CATENCALCD comme suit :

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.

E. Mappage des codes de calcul de taxe de WebSphere Commerce à l'aide de codes externes définis par l'utilisateur

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.

Procédure de mappage de groupes de produits sur des codes externes définis par l'utilisateur

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.

  1. Définissez un ensemble de codes et/ou séries de codes externes de produit définis par l'utilisateur qui pourraient être mappés aux codes de taxe de produit de l'application tierce partie.
  2. Pour chaque groupe de catalogue de la table CATGROUP, choisissez le code externe de taxe de produit défini par l'utilisateur approprié au groupe.
  3. Alimentez la table CALCODE. Pour chaque code externe de taxe de produit défini par l'utilisateur choisi pour être mappé sur un groupe de catalogue WebSphere Commerce, créez une ligne dans la table CALCODE où l'identificateur CALCODE.CODE représente le code externe de taxe de produit défini par l'utilisateur et CALCODE.CALCODE_ID une clé unique.
  4. Alimentez la table CATGPCALCD. Pour chaque groupe de catalogue de la table CATGROUP, créez une ligne dans la table CATGPCALCD qui mappe l'identificateur CATGROUP.CATGROUP_ID sur l'identificateur CALCODE.CALCODE_ID associé au code externe de taxe de produit défini par l'utilisateur.
  5. Dans l'application tierce partie, définissez un ensemble de codes et/ou séries de codes externes de produit définis par l'utilisateur et mappez-les sur les codes de taxe de produit.
Procédure de mappage de SKU de produit sur des codes externes définis par l'utilisateur

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.

  1. Définissez un ensemble de codes et/ou séries de codes externes de produit définis par l'utilisateur qui pourraient être mappés aux codes de taxe de produit de l'application tierce partie.
  2. Pour chaque entrée de catalogue dans la table CATENTRY, choisissez le code externe de taxe de produit défini par l'utilisateur, approprié à l'entrée de catalogue.
  3. Alimentez la table CALCODE. Pour chaque code externe de taxe de produit défini par l'utilisateur, créez une ligne dans la table CALCODE où l'identificateur CALCODE.CODE représente le code externe de taxe de produit défini par l'utilisateur et CALCODE.CALCODE_ID une clé unique.
  4. Alimentez la table CATENCALCD. 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 taxe de produit défini par l'utilisateur.
  5. A l'aide de l'application tierce partie, définissez un ensemble de codes et/ou séries de codes externes de produit définis par l'utilisateur et mappez-les sur les codes de taxe de produit de l'application tierce partie.
Remarque sur les mappages CALCODE

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.   

F. Association d'un code de calcul de taxe à des articles

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 : 

  1. Pour associer les tables CALCODE à des entrées de produit ou de groupes de catalogue, alimentez les tables CATGPCALCD et CATENCALCD.
  2. Pour associer des codes de taxe à la totalité d'un magasin, utilisez la fonction Store Services de WebSphere Commerce.
  3. Pour associer des codes de taxe à des articles, utilisez l'éditeur de produits Commerce Accelerator de WebSphere Commerce. 

G. Création d'une fonction d'intégration des taxes

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.

  1. Ecrivez une implémentation d'instruction pour chacune des interfaces suivantes :
  2. TaxOrderCmd et TaxOrderItemCmd sont de nouvelles interfaces de WebSphere Commerce.  Vous trouverez des informations générales relatives à l'écriture d'implémentation d'instructions dans WebSphere Commerce, dans le manuel WebSphere Commerce Programmer's Guide (disponible dans la bibliothèque technique de WebSphere Commerce à l'adresse http://www.ibm.com/software/webservers/commerce/wc_be/lit-tech-general.html ou http://www.ibm.com/software/webservers/commerce/wc_pe/lit-tech-general.html).  
  3. Mettez à jour la table CMDREG dans WebSphere Commerce.
    Mettez à jour le paramètre <ID_magasin> et insérez les nouvelles implémentations d'instructions dans la table CMDREG à l'aide du fichier cmdregInsert.db2 situé dans le répertoire suivant :
        <chemin_accès>:\WebSphere\CommerceServer\samples\TaxIntegrationInterfaceKit
  4. Publiez votre magasin à l'aide de Store Services.
  5. Lancez le magasin à partir de Store Services pour visualiser et tester les fonctionnalités de taxe.

Rubrique connexe (454 octets)

IBM copyright