Exemple : Calculs des surtaxes
Exemple de description
Votre magasin perçoit un supplément pour la commande dans une zone géographique donnée. La surtaxe doit être calculée en fonction des secteurs d'activité locaux.
Les tableaux suivants décrivent la taxe à percevoir :
| Zone géographique | Taux de la taxe |
|---|---|
| H | 5 % |
Example de mise en œuvre du calcul de surtaxe
Pour utiliser la structure de calcul pour calculer les taxes pour cet exemple, procédez comme suit :
- Définissez des juridictions et des groupes de juridictions.
- Définissez des catégories de taxe.
- Définissez les codes de calcul.
- Définissez des règles de calcul.
- Définissez les échelles de calcul.
- Définissez des fourchettes de calcul.
- Définissez les résultats de recherche pour les fourchettes de calcul.
- Associez les fourchettes de calcul aux règles de calcul.
- Rattachez les codes de calcul à toutes les entrées du catalogue.
- Rattachez les règles de calcul au centre de distribution.
- Permettez aux utilisations de calcul de ne pas calculer une valeur pour un OrderItem.
- Facultatif : Définissez les codes de calcul de surtaxe par défaut pour le magasin. Vous ne terminez cette étape que si votre magasin ne dispose pas déjà de codes de calcul par défaut pour la surtaxe.
Les identificateurs de texte ne sont souvent pas valides dans la base de données HCL Commerce. Vous devez convertir les identificateurs de texte en entiers ou autoriser HCL Commerce à générer les identificateurs pour vous. Vérifiez le schéma de base de données dans les informations en ligne pour le type de valeur valide pour les identificateurs d'une table de base de données particulière.
Définition des groupes de juridictions fiscales et des juridictions fiscales
Les renseignements relatifs aux juridictions, aux groupes de juridictions et aux relations entre elles sont définis dans les tables de base de données suivantes :
- JURSTGROUP
- Cette table définit les groupes de juridictions.
- JURST
- Cette table définit les juridictions.
- JURSTGPREL
- Cette tableadéfinit les juridictions qui appartiennent à quels groupes de compétence.
Sur base de la description de l'exemple de description de calcul de la surtaxe, la juridiction, le groupe de juridiction et la relation entre eux peuvent être définis sur le tableau suivant :
| Zone géographique | Jurisdiction | Groupe de juridictions |
|---|---|---|
| H | H | GroupeA |
Définition des catégories de taxes
La valeur par défaut du type de surtaxe est définie dans le fichier bootstrap indépendant de la langue. Une catégorie de taxe est requise pour chaque combinaison de type taxe et de groupe de jurdictions.
Le tableau suivant montre la catégorie de taxe qui peut être définie en fonction de la description de l'exemple :
| Catégorie de taxe | Type de taxe | Description |
|---|---|---|
| GroupA_SurchargeTax | -9 (surtaxe) | Zone géographique A, surtaxe (5 %) |
Chaque catégorie de taxe est affectée d'un identificateur unique. L'identificateur unique est utilisé pour associer une règle de calcul à une catégorie de taxe.
Définition du code de calcul de taxe
Le code de calcul doit être défini dans cet exemple, car la taxe s'applique à tous les éléments d'une commande. Le code de calcul doit être associé à une méthode de calcul CalculationCodeQualify.
Voici les propriétés clés que vous devez définir pour le code de calcul :
| Propriété | Valeur | Description de la valeur |
|---|---|---|
| Méthode de regroupement | 0 | Aucun regroupement de produits n'est requis |
| Indicateur de qualification | 0 | La méthode de calcul CalculationCodeQualify spécifiée pour ce code de calcul ne sera pas invoquée |
| Identification de chaîne | Code d'exemple de surtaxe | Il s'agit d'une chaîne de caractères qui identifie uniquement ce code de calcul, compte tenu d'une utilisation de calcul particulière et du magasin ou groupe de magasins |
| Published | 1 | Le code de calcul est actif |
| Utilisation du calcul | -9 | Il s'agit de l'ID pour l'utilisation de calcul de la surtaxe |
| Méthode de calcul CalculationCodeQualify | -92 | Il s'agit de l'ID pour CalculationCodeQualifyCmd |
| Méthode de calcul CalculationCodeApply | -94 | Il s'agit de l'ID pour SalesTaxCalculationCodeApplyCmd |
| Méthode de calcul CalculationCodeCalculate | -93 | Il s'agit de l'ID pour CalculationCodeCalculateCmd |
Définition de la règle de calcul de taxe
En règle générale, le calcul de taxe en pourcentage exige une règle de calcul pour chaque code de calcul et chaque catégorie de taxe.
Voici les propriétés clés que vous devez définir pour la règle de calcul :
| Propriété | Valeur | Description de la valeur |
|---|---|---|
| Code de calcul | SurchargeTaxCalcCode | Il s'agit du code de calcul de la surtaxe défini précédemment |
| Numéro d'identification | 1 | Il s'agit d'un nombre qui, avec son code de calcul, identifie de façon unique cette règle de calcul |
| Indicateur de qualification | 1 | Invocation de la méthode de calcul de qualification définie pour cette règle de calcul pour vérifier que cette règle de calcul s'applique à chaque article de la commande |
| Combinaison | 2 | Les résultats de cette règle de calcul peuvent être combinés avec d'autres règles de calcul qui ont une propriété de combinaison 0 ou 2 |
| Catégorie de taxe | GroupA_SurchargeTax | Il s'agit de l'ID pour l'utilisation de calcul pour la surtaxe |
| Méthode de calcul CalculRuleQualifier | -96 | Il s'agit de l'ID pour TaxCalculationRuleQualifyCmd |
| Méthode de calcul CalculationRuleCalculate | -97 | Il s'agit de l'ID pour CalculationRuleCalculateCmd |
Définition de l'échelle de calcul de taxe
Une échelle de calcul est requise pour chaque combinaison d'utilisation de calcul et de groupe de juridictions. Il s'agit d'une échelle de calcul en pourcentage et toutes ses fourchettes de calcul commencent par zéro, qui est convertible en toutes les devises. L'échelle de calcul est utilisée pour trouver le taux de taxe en pourcentage.
Voici les propriétés clés que vous devez définir pour l'échelle de calcul :
| Propriété | Valeur | Description de la valeur |
|---|---|---|
| Utilisation du calcul | -9 | Il s'agit de l'utilisation du calcul pour la surtaxe |
| Identification de chaîne | Exemple de taxe | Il s'agit d'une chaîne de caractères qui identifie de manière unique cette échelle de calcul, compte tenu d'une utilisation de calcul particulière et d'un magasin ou groupe de magasins |
| Méthode de calcul CalculationScaleLookup | -99 | TaxableSurchargeCalculationScaleLookupCmd |
Définition de la fourchette de calcul de taxe
Étant donné que le taux de taxe s'applique à tous les articles d'une commande, quel que soit le prix de l'article, le poids ou la quantité d'articles, une seule fourchette de calcul est requise pour l'échelle de calcul.
Voici les propriétés clés que vous devez définir pour la fourchette de calcul :
| Propriété | Valeur | Description de la valeur |
|---|---|---|
| ID de l'échelle de calcul | GroupASurchargeScale | Il s'agit de l'échelle de calcul qui a été définie précédemment |
| Valeur de départ de la fourchette de calcul | 0 | Tout montant total de surtaxe pour une commande supérieure ou égale à zéro est soumis à cette fourchette |
| Indicateur de fourchette de calcul cumulative | 0 | Cette fourchette de calcul n'est pas cumulative |
| Méthode de calcule CalculationRange | -59 | PercentageCalculationRangeCmd |
Définition des résultats de recherche pour la fourchette de calcul de taxe
Chaque fourchette de calcul nécessite un ensemble de résultats de recherche. Pour cet exemple, le résultat de recherche est le taux de taxe en pourcentage. Le résultat de recherche est une valeur en pourcentage, de sorte que vous n'avez pas besoin d'associer de devises ou d'unités de quantité aux résultats de recherche.
Voici les propriétés clés que vous devez définir pour chaque résultat de recherche de fourchette de calcul :
| Propriété | Valeur | Description de la valeur |
|---|---|---|
| Résultat de recherche | 5.0 | Il s'agit du taux de surtaxe de 5 % pour le groupe A |
| ID de la fourchette de calcul | GroupASurchargeRange | Il s'agit de l'identificateur de la fourchette de calcul à laquelle appartient ce résultat de recherche |
Associer les échelles de calcul de taxe à la règle de calcul des taxes
Chacune des échelles de calcul que vous avez définies doit être associée aux règles de calcul définies dans la table CRULESCALE de la base de données. La relation entre les échelles de calcul définies et les règles de calcul définies est illustrée dans le tableau suivant :
| Echelle de calcul | Règle de calcul |
|---|---|
| GroupASurchargeScale | GroupASurchargeRule |
Rattachement des codes de calcul des taxes
Pour utiliser le code de calcul de la surtaxe nouvellement défini, vous devez joindre le code de calcul aux articles de commande. Joignez-les indirectement, car le code de calcul s'applique à tous les articles de commande résultant de l'achat d'un produit par un client dans le catalogue du magasin, et pas seulement à un seul article.
Pour associer le code de calcul à tous les éléments du catalogue de magasin, utilisez un ID d'entrée de catalogue de valeur NULL. L'identificateur du magasin s'appelle Store.
Renseignez la table de base de données CATENCALCD avec les informations suivantes :
| ID d'entrepôt | ID d'entrée de catalogue | Code de calcul |
|---|---|---|
| Royaume-Uni | null | SurchargeTaxCalcCode |
Associer la règle de calcul de taxe au centre de distribution
Pour associer un centre de distribution à une règle de calcul de taxes dans la table de base de données TAXJCRULE. Cela garantit que la méthode de calcul TaxCalculationRuleQualify choisit une règle de calcul qui correspond à l'une des juridictions fiscales lors de l'expédition depuis un centre de distribution à une adresse de livraison.
| Centre de distribution | Juridiction fiscale | Priorité | Règle de calcul des taxes |
|---|---|---|---|
| DistributionA | GroupeA | 1 | GroupASurchargeRule |
Autoriser l'utilisation du calcul de la surtaxe à ne pas calculer une valeur pour un OrderItem
Par défaut, HCL Commerce lance une exception lorsqu'une utilisation de calcul ne renvoie pas une valeur pour un article de la commande. Vous pouvez empêcher cela en réglant l'indicateur d'utilisation du calcul (STENCALUSG.USAGEFLAG) sur 1. Lorsque l'indicateur est réglé sur 1 et que l'utilisation du calcul ne renvoie pas de valeur, HCL Commerce suppose que la valeur calculée est 0.
Le tableau suivant contient les informations requises pour permettre à l'utilisation du calcul des surtaxes de ne pas calculer une valeur pour un OrderItem :
| ID d'entrepôt | Utilisation du calcul | Code de calcul | Indicateur d'utilisation |
|---|---|---|---|
| Royaume-Uni | -9 (surtaxe) | SurchargeTaxCalcCode | 1 |
Définition des codes de calcul de taxes par défaut pour un magasin (facultatif)
La table de base de données STENCALUSG est également utilisée pour définir les codes de calcul par défaut d'un magasin. Les informations sur les codes de calcul par défaut doivent apparaître dans la même ligne de base de données où la colonne USAGEFLAG sera définie.
Le tableau suivant contient les informations requises pour définir le code de calcul des surtaxes par défaut pour le magasin :
| ID d'entrepôt | Utilisation de calcul | Code de calcul |
|---|---|---|
| Royaume-Uni | -9 (surtaxe) | SurchargeTaxCalcCode |