Exemple : Frais de port

Exemple de description

Votre magasin expédie des produits dans le monde entier à partir d'un centre de distribution, appelé DistributionA.

Vous utilisez un transporteur pour expédier toutes les livraisons à partir du centre de distribution. Le transporteur offre deux méthodes de livraison : livraison standard et livraison express.

Les frais de port sont basés sur le poids total de l'expédition en grammes. Le montant des frais dépend de la zone géographique vers laquelle l'expédition sera livrée. Les trois zones sont la zone A, la zone B et le reste du monde. La zone géographique A et la zone géographique B consistent en un seul pays ou région.

Les frais de port sont déterminés à l'aide du tableau suivant :

La devise des frais de port est la devise locale du pays ou de la région où se trouve votre magasin.

Exemple de mise en œuvre des frais de port

Pour utiliser la structure de calcul pour calculer les frais de port pour cet exemple, procédez comme suit :

1. Définissez des juridictions et des groupes de juridictions.
2. Définissez les modes d'expédition.
3. Définissez les codes de calcul.
4. Définissez des règles de calcul.
5. Définissez les échelles de calcul.
6. Définissez des fourchettes de calcul.
7. Définissez les résultats de recherche pour les fourchettes de calcul.
8. Associez les fourchettes de calcul aux règles de calcul.
9. Rattachez le code de calcul à toutes les entrées de catalogue.
10. Rattachez les règles de calcul au centre de distribution.
11. Facultatif : Définissez le mode de livraison par défaut pour le magasin.
12. Facultatif : Définissez le code de calcul de frais de port par défaut pour le magasin. Vous ne passerez cette étape que si votre magasin ne possède pas déjà un code de calcul par défaut défini pour les frais de port.

Important : les identificateurs de texte sont utilisés dans les sections suivantes pour faciliter l'affichage des relations entre les composants.

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 WebSphere Commerce à générer les identificateurs pour vous.

Définition des groupes de juridictions d'expédition et des juridictions d'expédition

La première étape de l'utilisation de la structure de calcul pour le calcul des frais de port consiste à définir les groupes de juridictions d'expédition vers lesquels les livraisons sont expédiées. Vous devez également définir les relations qui définissent quelles juridictions appartiennent à quels groupes de juridictions.

Les juridictions et les groupes de juridictions sont utilisés par la méthode de calcul ShippingCalculationRuleQualify pour déterminer quelle règle de calcul utiliser, en fonction de l'adresse de livraison de la commande.

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 table définit quelles juridictions appartiennent à quels groupes de juridictions.

D'après la description de l'exemple des frais de port, les juridictions, les groupes de juridictions et les relations entre elles peuvent être définis conformément au tableau ci-dessous :

Plus tard, nous bénéficions de la propriété de priorité lorsque nous associons les règles de calcul des frais de port aux trois groupes de juridictions dans les règles de calcul des frais de port associées aux centres de distribution.

Définition de modes d'expédition

Le mode d'expédition correspond à la combinaison d'un transporteur et du service d'expédition qu'il propose. Les informations sur le mode d'expédition sont stockées dans les tables de base de données SHIPMODE et SHPMODEDSC.

Le magasin donné en exemple n'utilise qu'un seul transporteur qui fournit deux méthodes de livraison différentes, de sorte que le magasin donné en exemple aura deux modes d'expédition comme suit :

Définition du code de calcul des frais de port

Vous devez définir un code de calcul dans cet exemple, car les frais de port s'appliquent à tous les articles d'une commande. Le code de calcul doit être associé à une méthode de calcul CalculationCodeQualify afin que la règle de calcul correcte puisse être choisie en fonction de l'adresse de la commande.

Voici les propriétés clés que vous devez définir pour le code de calcul :

Définition des règles de calcul des frais de port

Une règle de calcul est requise pour chaque mode d'expédition pour chaque groupe de juridictions. Cet exemple nécessite six règles de calcul :

• Calculer les frais de port standard pour le groupe de juridictions du GroupeA.
• Calculer les frais de port express pour le groupe de juridictions du GroupeA.
• Calculer les frais de port standard pour le groupe de juridictions du GroupeB.
• Calculer les frais de port express pour le groupe de juridictions du GroupeB.
• Calculer les frais de port standard pour le groupe de juridictions Monde.
• Calculer les frais de port express pour le groupe de juridictions Monde.

Ces règles sont toutes des règles de calcul des frais de port, vous devez donc spécifier que la méthode de calcul ShippingCalculationRuleQualify doit être utilisée avec ces règles de calcul.

Pour cet exemple, toutes les règles de calcul auront les mêmes propriétés comme illustré dans le tableau suivant :

Pour le reste de l'exemple, ces règles de calcul seront référencées comme suit :

• GroupARegularRule (Règle de calcul des frais de port standard du GroupeA)
• GroupAExpressRule (Règle de calcul des frais de port express du GroupeA)
• GroupBRegularRule (Règle de calcul des frais de port standard du GroupeeB)
• GroupBExpressRule (Règle de calcul des frais de port express du GroupeeB)
• WorldRegularRule (Règle de calcul des frais de port standard du Monde)
• WorldExpressRule (Règle de calcul des frais de port express du Monde)

Définition des échelles de calcul des frais de port

Une échelle de calcul est requise pour chaque mode d'expédition pour chaque groupe de juridictions. Les échelles de calcul pour cet exemple sont basées sur le poids de la commande en kilogrammes, c'est pourquoi les échelles de calcul doivent être associées à une unité de mesure.

Les frais de port sont basés sur le poids total des OrderItems dans une commande, c'est pourquoi la méthode de calcul WeightCalculationScaleLookupCmd est utilisée dans la méthode de calcul CalculationScaleLookup pour cette échelle de calcul.

Cet exemple nécessite six échelles de calcul comme suit :

• Échelle des frais de port standard du GroupeA
• Échelle des frais de port express du GroupeA
• Échelle des frais de port standard du GroupeB
• Échelle des frais de port express du GroupeB
• Échelle des frais de port standard du Monde
• Échelle des frais de port express du Monde

Pour cet exemple, toutes les échelles de calcul auront les mêmes propriétés, comme illustré dans le tableau suivant :

Pour le reste de l'exemple, ces échelles de calcul seront référencées comme suit :

• GroupARegularScale (Échelle de calcul des frais de port standard du GroupeA)
• GroupAExpressScale (Échelle de calcul des frais de port express du GroupeA)
• GroupBRegularScale (Échelle de calcul des frais de port standard du GroupeB)
• GroupBExpressScale (Échelle de calcul des frais de port express du GroupeB)
• WorldRegularScale (Échelle de calcul des frais de port standard du Monde)
• WorldExpressScale (Échelle de calcul des frais de port express du Monde)

Définition des fourchettes de calcul des frais de port

Chaque échelle de calcul que nous avons définie dans l'étape précédente nécessite un ensemble de quatre fourchettes de calcul. Il en résulte un total de 24 fourchettes de calcul qui doivent être définies pour cet exemple. Voici les quatre fourchettes de calcul pour chaque échelle de calcul :

• 0-2 kg (frais de port de base pour les packages de moins de 2 kg)
• 2-10 kg (frais supplémentaires pour chaque kg au-delà de 2 kg, mais inférieur à 10 kg)
• 10-20 kg (frais supplémentaires pour chaque kg au-delà de 10 kg, mais inférieur à 20 kg)
• 20 kg ou plus (frais supplémentaires pour chaque kg au-delà de 20 kg)

Les fourchettes de calcul sont toutes cumulatives. Les résultats d'une ou de plusieurs de ces fourchettes de calcul sont ajoutés pour déterminer les frais de port finaux associés à chaque OrderItem dans une commande.

Voici les propriétés clés que vous devez définir pour chaque fourchette de calcul :

Pour le reste de l'exemple, ces fourchettes de calcul seront référencées comme suit :

• GroupARegular0to2Range
• GroupARegular2to10Range
• GroupARegular10to20Range
• GroupARegular20+Range
• GroupAExpress0to2Range
• GroupAExpress2to10Range
• GroupAExpress10to20Range
• GroupAExpress20+Range
• GroupBRegular0to2Range
• GroupBRegular2to10Range
• GroupBRegular10to20Range
• GroupBRegular20+Range
• GroupBExpress0to2Range
• GroupBExpress2to10Range
• GroupBExpress10to20Range
• GroupBExpress20+Range
• WorldRegular0to2Range
• WorldRegular2to10Range
• WorldRegular10to20Range
• WorldRegular20+Range
• WorldExpress0to2Range
• WorldExpress2to10Range
• WorldExpress10to20Range
• WorldExpress20+Range

Vous devez spécifier l'ID d'échelle de calcul de l'échelle de calcul à laquelle appartient la fourchette de calcul lors de la définition d'une fourchette de calcul. Les relations entre les échelles de calcul définies et les fourchettes de calcul que nous définissons sont indiquées dans le tableau suivant :

Définition des résultats de recherche pour les fourchettes de calcul des frais de port

Chaque fourchette de calcul nécessite un ensemble de résultats de recherche. Chaque fourchette de calcul n'a qu'une seule valeur associée à celle-ci, de sorte qu'un seul résultat de recherche est nécessaire pour chaque fourchette. Chaque résultat de recherche doit être associé à la devise locale du pays ou de la région pour le magasin parce que c'est la devise des frais de port.

Les tableaux suivants définissent les propriétés clés que vous devez définir pour chaque résultat de recherche de fourchette de calcul. La devise a été omise ici, mais elle doit être incluse dans une mise en oeuvre réelle.

Rappel :

Ces propriétés ne disposent pas de la devise pour les résultats de recherche. La devise des résultats de recherche doit être définie. Pour cet exemple, elle doit correspondre à la devise de l'échelle de calcul.

Association de l'échelle de calcul des frais de port aux règles de calcul des frais de port

Chacune des échelles de calcul qui ont été définies doit être associée aux règles de calcul définies dans la table de base de données CRULESCALE. La relation entre les échelles de calcul définies et les règles de calcul définies est illustrée dans le tableau suivant :

Rattachement des codes de calcul des frais de port

Pour utiliser le nouveau code de calcul que vous avez défini précédemment, vous devez le rattacher aux articles de la commande. Rattachez-le indirectement, car il s'applique à tous les articles résultant de l'achat d'un produit par un client dans le catalogue du magasin, et pas seulement à un seul article.

Nous rattacherons indirectement le code de calcul en créant une entrée dans la table de base de données CATENCALCD. Pour associer le code de calcul à tous les articles du catalogue de magasin, utilisez un ID d'entrée de catalogue de valeur null. L'identificateur du magasin sera appelé Store.

Renseignez la table de base de données CATENCALCD avec les informations suivantes :

Association des règles de calcul des frais de port aux centres de distribution

Vous devez entrer des informations qui associent un centre de distribution à un calcul des frais de port dans la table de base de données SHIPJCRULE. Pour ce faire, la méthode ShippingCalculationRuleQualify choisit une règle de calcul lors de l'expédition depuis un centre de distribution à une adresse de livraison qui correspond à l'un des groupes de juridictions d'expédition.

Nous bénéficions de la propriété de priorité de la relation entre les règles de calcul et les centres de distribution. Nous avons défini les valeurs de propriété de priorité suivantes :

• Pour les relations impliquant le groupe de juridictions d'expédition GroupeA ou GroupeB, nous fixons la valeur de propriété de priorité à 1.
• Pour les relations impliquant le groupe de juridictions d'expédition Monde, nous fixons la valeur de propriété de priorité à 0.

Cela garantit que si une adresse de livraison entre dans tous les groupes de juridictions d'expédition, la règle de calcul applicable au GroupeA ou au GroupeB prime sur la règle de calcul applicable au groupe de juridictions Monde.

Dans cet exemple, nous avons un centre de distribution, trois groupes de juridictions d'expédition, et six règles de calcul. Les relations entre ces éléments sont définies dans le tableau suivant :

Définition du mode d'expédition par défaut (facultatif)

Vous pourriez vouloir définir un mode d'expédition par défaut pour un magasin ou un contrat. Les modes d'expédition sont associés à un magasin et à un contrat dans la table de base de données STOREDEF.

Pour déterminer quelles valeurs sont requises pour définir un mode d'expédition comme mode d'expédition par défaut, reportez-vous à la documentation du schéma de base de données.

Définition des codes de calcul des frais de port par défaut pour un magasin (facultatif)

Si votre magasin ne dispose pas déjà d'un code de calcul par défaut pour les frais de port, vous pouvez effectuer le code de calcul que vous avez défini précédemment comme votre valeur par défaut.

Les codes de calcul par défaut d'un magasin sont définis dans la table de base de données STENCALUSG. Le tableau suivant contient les informations requises pour définir le code de calcul des frais de port par défaut du magasin :

En règle générale, un code de calcul des frais de port ne peut être à la fois rattaché à toutes les entrées de catalogue dans un magasin et défini an tant que code de calcul des frais de port par défaut. Lorsqu'un code de calcul des frais de port est rattaché à toutes les entrées de catalogue d'un magasin, des codes supplémentaires qui sont définis et rattachés ultérieurement donneront un total des frais de port qui équivaut à la somme des frais de port résultant de chaque code. Si un code de calcul d'expédition par défaut est défini et qu'aucun code n'est rattaché aux entrées de catalogue ou aux groupes de catalogues, vous pouvez avoir un taux de frais de port différent pour les entrées de catalogue individuelles ou les groupes de catalogues. Le rattachement d'un code de calcul des frais de port à une entrée de catalogue ou à un groupe de catalogues écrase la valeur par défaut.