addio-admin-sdk 1.7.102 → 1.7.104

package/dist/rules/GR/utils/g2.js

@@ -24,13 +24,16 @@ const toNumber_1 = __importDefault(require("lodash/toNumber"));
 const minBy_1 = __importDefault(require("lodash/minBy"));
 const uniqBy_1 = __importDefault(require("lodash/uniqBy"));
 const chunk_1 = __importDefault(require("lodash/chunk"));
+// Interfaces générales
 const Customer_1 = require("../../../Interfaces/Customer");
 const G2_1 = require("../../../Interfaces/G2");
 const Cart_1 = require("../../../Interfaces/Cart");
+// Utils généraux
 const data_1 = require("../../../utils/data");
 const object_1 = require("../../../utils/object");
 const context_1 = require("../../../utils/context");
 const locale_1 = require("../../../utils/locale");
+// Interfaces spécifiques
 const data_2 = require("../interfaces/data");
 const flatten_1 = __importDefault(require("lodash/flatten"));
 const groupBy_1 = __importDefault(require("lodash/groupBy"));
@@ -43,6 +46,8 @@ const cart_1 = require("../../../utils/cart");
 const round_1 = __importDefault(require("lodash/round"));
 const products_2 = require("../constants/products");
 const products_3 = require("./products");
+// ---------------------------------------------------------------------------------------------
+// #region PRODUCTS
 const getG2ProductExternalValues = async (sku, g2Service, space, org) => {
     var _a, _b, _c;
     const g2Auth = g2Service.external_service_infos.api;
@@ -50,6 +55,7 @@ const getG2ProductExternalValues = async (sku, g2Service, space, org) => {
         return;
     let externalValues = undefined;
     try {
+        // Fetch item from G2
         const productG2 = await (0, exports.fetchProductFromG2WithSku)(sku, space, org);
         if (!!productG2) {
             const noArticle = (_a = productG2.article.noArticle) !== null && _a !== void 0 ? _a : undefined;
@@ -95,12 +101,16 @@ const fetchProductFromG2WithSku = async (sku, space, org, logError) => {
         }
     };
     let g2Prod = await callG2(sku);
+    // If no result was returned, and sku does not already include -1, call G2 again with added suffix
     if (!!!g2Prod && !sku.includes('-1')) {
         g2Prod = await callG2(`${sku}-1`);
     }
     return g2Prod;
 };
 exports.fetchProductFromG2WithSku = fetchProductFromG2WithSku;
+// #endregion
+// ---------------------------------------------------------------------------------------------
+// #region CUSTOMERS
 const getG2Customer = async (spaceToken, customerId) => {
     let allG2Customers = [];
     try {
@@ -224,6 +234,9 @@ const transformG2CustomerToCustomer = (g2Customer, prevCustomer, allGroups) => {
         const sameGroup = allGroups.find((g) => g.external_slug === type);
         return !!sameGroup ? sameGroup.slug : defaultProGroup;
     };
+    // Mapping langue G2 -> Addio
+    // G2: 1=Français, 2=Anglais
+    // Addio: 'fr' | 'en' (default 'fr')
     const mapG2LangToAddioPreferredLang = (g2Lang) => {
         return g2Lang === 2 ? 'en' : 'fr';
     };
@@ -237,6 +250,7 @@ const transformG2CustomerToCustomer = (g2Customer, prevCustomer, allGroups) => {
         ? {
             has_credit_line: true,
             credit_line_max: client.limiteDeCrédit
+            // credit_line_used: ',
         }
         : {})), (!!client.noReprésentant ? { represented_by: client.noReprésentant } : {})), { basic_info: Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (0, Customer_1.getDefaultBasicCustomer)()), (!!prevCustomer ? prevCustomer.basic_info : { customer_type: Customer_1.BasicCustomerTypeEnum.PRO })), (!!client.email ? { customer_email: client.email.split(';')[0].toLowerCase() } : {})), (!!client.fax ? { customer_photocopier: client.fax } : {})), (!!client.personneRessourceVentes ? getCustomerNameInfo(client.personneRessourceVentes) : {})), (preferredLang ? { customer_prefered_lang: preferredLang } : {})), { customer_professionnal_info: Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (!!prevCustomer ? prevCustomer.basic_info.customer_professionnal_info : {})), { professionnal_title: !!client.groupeDeClient && !!(0, exports.getG2CustomerTypeFromCode)(client.groupeDeClient)
                     ? getCustomerGroupFromTypeCode((0, exports.getG2CustomerTypeFromCode)(client.groupeDeClient))
@@ -281,6 +295,7 @@ const transformG2CustomerToCustomer = (g2Customer, prevCustomer, allGroups) => {
                     expedition_recipient_phone: !!client.téléphone ? (0, data_1.formatPhoneNumberDB)(client.téléphone) : ''
                 }
             ] });
+    // If is test env, and anonymisation process was already done for customer, keep prev customer info for specific props
     if (!!__1.isTestEnv &&
         !!prevCustomer &&
         !!prevCustomer.basic_info.customer_email &&
@@ -297,6 +312,12 @@ const transformG2CustomerToCustomer = (g2Customer, prevCustomer, allGroups) => {
     return customerWithNewInfo;
 };
 exports.transformG2CustomerToCustomer = transformG2CustomerToCustomer;
+/**
+ * Verifies if customer exists in G2.
+ * @param customerID - Customer ID for G2 fetch
+ * @param space - Space Object
+ * @param org - Org Object
+ */
 const checkIfCustomerExistsInG2 = async (customerID, space, org) => {
     try {
         const token = (0, context_1.getSpaceToken)(space, org);
@@ -321,6 +342,14 @@ const checkIfCustomerExistsInG2 = async (customerID, space, org) => {
     }
 };
 exports.checkIfCustomerExistsInG2 = checkIfCustomerExistsInG2;
+/**
+ * Updates customer in database with new info found in G2.
+ * @param customerID - Customer ID for G2 fetch
+ * @param space - Space Object
+ * @param org - Org Object
+ * @param addToDB - if updated customer should be saved to database (defaults to true)
+ * @param skipEmailCheck - if check for unique email should be skiped or not (defaults to false)
+ */
 const updateCustomerWithG2Info = async (customerID, space, org, addToDB = true, skipEmailCheck = false) => {
     console.log('===============');
     console.log('in v2 sdk updateCustomerWithG2Info');
@@ -360,6 +389,9 @@ const updateCustomerWithG2Info = async (customerID, space, org, addToDB = true,
     }
 };
 exports.updateCustomerWithG2Info = updateCustomerWithG2Info;
+// #endregion
+// ---------------------------------------------------------------------------------------------
+// #region ESCOMPTES
 const getG2DiscountFromCode = (code) => {
     const onlyNb = code.replace(/[^0-9]/gi, '');
     return !!!onlyNb || !!isNaN(Number(onlyNb)) ? undefined : (0, toNumber_1.default)(onlyNb);
@@ -367,11 +399,14 @@ const getG2DiscountFromCode = (code) => {
 exports.getG2DiscountFromCode = getG2DiscountFromCode;
 const getG2CustomerTypeFromCode = (code) => {
     let parsedCode = code;
+    // 1. Remove prefix
     const possiblePrefixes = ['BASE', 'PAYS', 'RENC'];
     for (let prefix of possiblePrefixes) {
         parsedCode = parsedCode.replace(prefix, '');
     }
+    // 2. Remove numbers
     parsedCode = parsedCode.replace(/[0-9]/gi, '');
+    // 3. Remove all non-wanted characters
     const possibleTypes = ['AM', 'AL', 'AS', 'AMN'];
     const checkWithPossibleTypes = (codeToCheck, removeFrom) => {
         if (!!!possibleTypes.includes(codeToCheck)) {
@@ -419,10 +454,18 @@ const fetchCustomPriceList = async (spaceToken, customerId, ignoreDashPriceList,
     return prices;
 };
 exports.fetchCustomPriceList = fetchCustomPriceList;
+/**
+ * Constructs a custom price list for a PRO Groupe Richer customer, based on data from G2 and AddioCommerce.
+ * @param space - The space Object for appointed customer
+ * @param idClient - The customer's G2 ID
+ * @param ignoreDashPriceList - Optionnal. If customer group prices found in Addio should be ignored, and only G2 prices be considered.
+ * @param onlyForProductSlugs - Optionnal. Array of skus for which the list should be generated (used to not go through all products in database if only certain products are needed)
+ */
 const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForProductSlugs) => {
     let priceList = [];
     let escomptesClient = [];
     let ententesClient = [];
+    // Fetch api info from space
     let G2Auth = '';
     let G2Url = '';
     const G2Service = space.services({ field: 'external_service_name', value: 'G2' });
@@ -432,6 +475,8 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
     }
     if (!!!G2Auth || !!!G2Url)
         throw `Error on fetching G2 API info from space`;
+    // -------------------------------------------------------------------
+    // 0. Fetch customer from G2
     try {
         const customerReq = await fetch(`${G2Url}/clients?noClient=${idClient}`, {
             method: 'GET',
@@ -447,6 +492,8 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
         const g2Customer = allG2Customers[0];
         if (!!!g2Customer)
             return priceList;
+        // -------------------------------------------------------------------
+        // #region 1. Fetch ententesClient from G2
         const today = (0, moment_1.default)();
         const allCurrentEntentes = g2Customer.soumissions.filter((s) => !!s.soumission.actif &&
             !!s.soumission.dateDébut &&
@@ -456,9 +503,14 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
         if (!!mostRecent) {
             ententesClient = mostRecent;
         }
+        // #endregion ---------------------------------------------------------
+        // -------------------------------------------------------------------
+        // #region 2. Fetch escomptesClient from G2
         const { noClient, groupeDeClient, classePrix } = g2Customer.client;
         const customerType = !!!groupeDeClient ? undefined : (0, exports.getG2CustomerTypeFromCode)(groupeDeClient);
+        // const normalCustomerEscompte = !!!groupeDeClient ? undefined : getG2DiscountFromCode(groupeDeClient)
         try {
+            // 2.a fetch escomptes with noClient
             const escomptesNumClient = await fetch(`${G2Url}/escompteclient?code=${noClient}`, {
                 method: 'GET',
                 headers: {
@@ -477,6 +529,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
             console.log('error on fetching escomptesClient from G2: ', e.toString());
         }
         try {
+            // 2.b fetch escomptes with groupeDeClient
+            //     + added logic if groupeClient is same as noClient to no check twice same value
+            //       (happens with test G2 customers)
             if (!!groupeDeClient && groupeDeClient !== noClient) {
                 const escomptesGroupeClient = await fetch(`${G2Url}/escompteclient?code=${groupeDeClient}`, {
                     method: 'GET',
@@ -490,6 +545,7 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                 }
                 else {
                     const groupeClientEscomptes = groupeClientResults.map((r) => r.escompteClient);
+                    // Specific user promos always have priority over "group" promos, so we filter out escomptes where code2 is found in numClientEscomptes
                     const noDuplicates = groupeClientEscomptes.filter((es) => !!!es.code2 || !!!escomptesClient.some((e) => !!e.code2 && e.code2 === es.code2));
                     escomptesClient = [...escomptesClient, ...noDuplicates];
                 }
@@ -501,6 +557,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
         catch (e) {
             console.log('error on fetching escomptesClient from G2: ', e.toString());
         }
+        // #endregion ---------------------------------------------------------
+        // -------------------------------------------------------------------
+        // #region 3. Fetch products (except drafts) from DB
         let allProducts = [];
         try {
             if (!!onlyForProductSlugs && !!onlyForProductSlugs.length) {
@@ -531,6 +590,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
         }
         if (!!!allProducts.length)
             return priceList;
+        // #endregion ---------------------------------------------------------
+        // -------------------------------------------------------------------
+        // #region 4. Check each product for custom price to push
         const allCustomerGroups = space.preferences.customers.groups() || [];
         const customerGroupByPriceClass = !!classePrix
             ? allCustomerGroups.find((g) => g.external_price_list_slug == classePrix.toString())
@@ -542,20 +604,27 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                 continue;
             const type = !!data.attributes && data.attributes[data_2.AttributesIdEnumGR.TYPE];
             for (let decli of data.declinations.filter((d) => !!!d.is_sample)) {
+                // const isSpecificBetonProd =
+                // 	!!decli.external_values && ['BOLDUC', 'RINOX', 'RICHER', 'OAKS'].includes(decli.external_values['catégorie2'])
+                // let shouldApplyNormalEscompte = !!!data.is_service && !!isSpecificBetonProd
                 let isNetPrice = !!decli.external_values && decli.external_values['catégorie2'] === 'NET';
                 const sku = decli.sku;
                 if (!!decli.external_values && decli.external_values['catégorie1'] === products_2.allInclusiveCategory) {
                     allIncSkus.push(sku);
                 }
+                // Establish base price for sku ...
                 let basePrice = (0, toNumber_1.default)(decli.regular_price.amount);
+                // ... if groupeDeClient is set, check dashboard pricelist for pro price if !!!ignoreDashPriceList
                 if (!!decli.prices_list && !!decli.prices_list.length && !!!ignoreDashPriceList) {
                     let priceListItemToUse = undefined;
+                    // ... a. Check group with classe de prix
                     const samePriceClassInPriceList = !!customerGroupByPriceClass
                         ? decli.prices_list.find((pl) => pl.group_id == customerGroupByPriceClass.slug)
                         : undefined;
                     if (!!samePriceClassInPriceList && !isNaN((0, toNumber_1.default)(samePriceClassInPriceList.amount))) {
                         priceListItemToUse = samePriceClassInPriceList;
                     }
+                    // ... a. Check group with groupeDeClient
                     else if (!!groupeDeClient) {
                         const samePriceInPriceList = !!customerType
                             ? decli.prices_list.find((p) => !!p.external_slug && p.external_slug === customerType)
@@ -571,10 +640,13 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                     if (!!priceListItemToUse) {
                         basePrice = (0, toNumber_1.default)(priceListItemToUse.amount);
                         if (!!!isNetPrice) {
+                            // shouldApplyNormalEscompte = !!priceListItemToUse.custom_promo_applies && !!isSpecificBetonProd
                             isNetPrice = !!priceListItemToUse.is_net_price;
                         }
                     }
                 }
+                // Array to stock all promos that could be applied for customer and declination
+                // By default, contains regular price + regular escompted price
                 let comparePrices = [
                     Object.assign(Object.assign({ price: basePrice, type: G2_1.CustomPriceItemTypeEnum.REG }, (!!(0, object_1.recursiveCheckObject)(decli, 'external_values.catégorie1')
                         ? { code1: (0, object_1.recursiveCheckObject)(decli, 'external_values.catégorie1') }
@@ -582,6 +654,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                         ? { code2: (0, object_1.recursiveCheckObject)(decli, 'external_values.catégorie2') }
                         : {}))
                 ];
+                // Other promo checks, if found, are added to comparePrices array
+                // -------------------------------------------------------------------
+                // #region 4.1 Check ententeClient for same sku
                 let foundEntenteForProduct = false;
                 if (!!ententesClient.length) {
                     for (let entente of ententesClient) {
@@ -607,6 +682,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                         }
                     }
                 }
+                // #endregion ---------------------------------------------------------
+                // -------------------------------------------------------------------
+                // #region 4.2 Check escompteClient array
                 if (!!escomptesClient.length) {
                     const findBestDeal = (escomptesToCheck) => {
                         const bestDeal = (0, maxBy_1.default)(escomptesToCheck, (escompte) => (0, toNumber_1.default)(escompte.pourcEscompte));
@@ -614,7 +692,11 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                             comparePrices.push(Object.assign({ price: basePrice * ((100 - (0, toNumber_1.default)(bestDeal.pourcEscompte)) / 100), type: G2_1.CustomPriceItemTypeEnum.ESCOMPTE, percent: (0, toNumber_1.default)(bestDeal.pourcEscompte), code1: bestDeal.code1 }, (!!bestDeal.code2 ? { code2: bestDeal.code2 } : {})));
                         }
                     };
+                    // Check only if :
+                    //   - foundEntenteForProduct = false (entente always has priority over escompte)
                     if (!!!foundEntenteForProduct) {
+                        // If isNetPrice, check if escompte for cat1 DALLE is found for user. If so, apply escompte even if NET
+                        // ** WORKAROUND pour nouvelle logique GR où certains produits à prix NET dans G2 doivent pouvoir être escomptés dans certaines régions (ici à QC) **
                         if (!!isNetPrice) {
                             const sameCat1Escompte = escomptesClient.filter((e) => {
                                 if (!!!e.code2)
@@ -626,10 +708,12 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                             }
                         }
                         else {
+                            // a. No 2nd code is found (applies to client or client group directly)
                             const no2ndCode = escomptesClient.filter((e) => !!!e.code2);
                             if (!!no2ndCode.length) {
                                 findBestDeal(no2ndCode);
                             }
+                            // b. 2nd code is current sku && no entente was found for sku
                             let sameSkuEscompte = escomptesClient.filter((e) => e.code2 && e.code2 === sku);
                             if (!!!sameSkuEscompte.length) {
                                 sameSkuEscompte = escomptesClient.filter((e) => e.code2 && e.code2.includes(sku));
@@ -637,6 +721,8 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                             if (!!sameSkuEscompte.length) {
                                 findBestDeal(sameSkuEscompte);
                             }
+                            // c. 2nd code is prod brand or type
+                            //    Only check if no sameSkuEscompte found (precise promo always has precedence over "group" promo)
                             if (!!!sameSkuEscompte.length) {
                                 const sameBrandEscompte = escomptesClient.filter((e) => {
                                     if (!!!e.code2)
@@ -651,6 +737,9 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                         }
                     }
                 }
+                // #endregion ---------------------------------------------------------
+                // -------------------------------------------------------------------
+                // #region 4.3 Set price to apply to variable, ready to be pushed
                 comparePrices = (0, uniqBy_1.default)(comparePrices, (p) => p.price);
                 const lowestPrice = (0, minBy_1.default)(comparePrices, (p) => p.price);
                 let appliedPrice;
@@ -660,8 +749,10 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                 }
                 else {
                     appliedPrice = lowestPrice;
+                    // If lowestPrice is regular price and entente is found in product, override with entente price, even if amount is higher
                     if (!!lowestPrice && lowestPrice.type == G2_1.CustomPriceItemTypeEnum.REG) {
                         const ententeFound = comparePrices.find((p) => p.type == G2_1.CustomPriceItemTypeEnum.ENTENTE);
+                        // set reg props to entente price so both prices have same value, but keep all other props as entente
                         if (!!ententeFound)
                             appliedPrice = Object.assign(Object.assign({}, ententeFound), { reg: ententeFound.price });
                     }
@@ -677,14 +768,21 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
                         }
                         : {})), appliedPrice);
                 }
+                // #endregion ---------------------------------------------------------
+                // ----------------------------------------------------------------
+                // 6. Push lowest price from comparePrice to priceList
                 if (!!customPriceItemToPush) {
                     priceList.push(customPriceItemToPush);
                 }
             }
         }
+        // #endregion ---------------------------------------------------------
+        // -------------------------------------------------------------------
+        // #region 5. Use ALLINC decli when all-inclusive installation is active
         if (!!allIncSkus.length && !!(0, products_3.getInstallationAllInclusiveFromPriceList)(priceList)) {
             priceList = priceList.map((item) => (allIncSkus.includes(item.sku) ? Object.assign(Object.assign({}, item), { price: 0 }) : item));
         }
+        // #endregion ---------------------------------------------------------
         return priceList;
     }
     catch (e) {
@@ -693,13 +791,21 @@ const getCustomPriceList = async (space, idClient, ignoreDashPriceList, onlyForP
     }
 };
 exports.getCustomPriceList = getCustomPriceList;
+/**
+ * Get promise to purchase additionnal escompte equivalent from customPriceList for specific cart item
+ * @param customPriceList - The pro customers custom price list
+ * @param item - The cart item to check
+ */
 const getItemEscompteSupp = (customPriceList, item) => {
+    // Get catégorie 2 from item
     const code2InItem = (0, object_1.recursiveCheckObject)(item, `external_values.catégorie2`);
+    // Get code2 from customPriceList item
     let code2InPriceList = undefined;
     const customPriceItem = customPriceList.find((priceItem) => priceItem.sku === item.sku);
     if (!!customPriceItem && !!customPriceItem.code2) {
         code2InPriceList = customPriceItem.code2;
     }
+    // Use customPriceList item code2 if defined, else item's catégorie 2
     const code2ToCheck = code2InPriceList !== null && code2InPriceList !== void 0 ? code2InPriceList : code2InItem;
     if (!!!code2ToCheck)
         return;
@@ -721,6 +827,7 @@ const buildEscompteSuppCartItem = (escompteItems, customPriceList, escompteSuppI
     const escompteDecli = escompteItems[0].data().declinations.find((decli) => decli.sku === escompteSuppItem.sku);
     if (!!!escompteDecli)
         return;
+    // If esc supp found in price list has type reg price and has price of 0.00, it means the escompte does not apply to the customer
     const sameInCustomPriceList = customPriceList.find((c) => c.sku === escompteDecli.sku);
     if (!!sameInCustomPriceList &&
         sameInCustomPriceList.type === G2_1.CustomPriceItemTypeEnum.REG &&
@@ -734,11 +841,22 @@ const isEscompteSuppItem = (itemSku) => {
     return Object.values(G2_1.EscomptesDeclinationSkusEnum).some((subString) => itemSku.includes(subString));
 };
 exports.isEscompteSuppItem = isEscompteSuppItem;
+// #endregion
+// ---------------------------------------------------------------------------------------------
+// #region FORMAT CART ITEMS
+/**
+ * Adjusts prices in item provided with corresponding custom price list item, if it exists.
+ * @param item - The cart item or indexed declination
+ * @param customPriceList - The customers custom price list
+ * @param options.removeTierPricing - Optionnal. If tier-pricing should be removed from item returned
+ * @param options.setNetPriceAsRegular - Optionnal. If true and custom price found is NET (entente), sets the NET price as regular price (normaly set to discount_price)
+ */
 const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
     var _a;
     const sameInCustomPriceList = customPriceList.find((i) => i.sku === item.sku);
     if (!!!sameInCustomPriceList)
         return item;
+    // If price was already overridden and price found in customPriceList is of type regular, return
     const hasOverriddenPrice = item.price_override;
     if (!!hasOverriddenPrice && sameInCustomPriceList.type === G2_1.CustomPriceItemTypeEnum.REG)
         return item;
@@ -749,6 +867,8 @@ const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
     const isEntente = sameInCustomPriceList.type === G2_1.CustomPriceItemTypeEnum.ENTENTE;
     const isPA = !!sameInCustomPriceList.PA_percent;
     const shouldUseCustomPriceForRegPrice = (!!isReg && !!!sameInCustomPriceList.percent) || (!!options.setNetPriceAsRegular && !!isEntente);
+    // MODIF. FRAIS 2024 - Si le prix de la liste de prix est 0, et que le type du priceItem est REG ou ENTENTE, on pousse 0 comme valeur pour le prix régulier
+    // Le code se chargera alors de retirer le frais de ceux ajoutés au panier si c'est le cas
     const currentDiscountPrice = item.discount_price || { currency: 'CAD' };
     const currentPromoPrice = item.promo_price || { currency: 'CAD' };
     const calculatedRegPrice = !!item.price_override
@@ -758,7 +878,10 @@ const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
             : !!shouldUseCustomPriceForRegPrice
                 ? sameInCustomPriceList.price
                 : sameInCustomPriceList.reg;
-    let updatedCartItem = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), { regular_price: Object.assign(Object.assign(Object.assign({}, regular_price), { amount: calculatedRegPrice }), (sameInCustomPriceList.type !== G2_1.CustomPriceItemTypeEnum.REG && !!!regular_price.price_type
+    // #region RECREATE CART ITEM WITH UPDATED PRICES
+    let updatedCartItem = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), { 
+        // a. Set regular price for product with price_type if not already defined
+        regular_price: Object.assign(Object.assign(Object.assign({}, regular_price), { amount: calculatedRegPrice }), (sameInCustomPriceList.type !== G2_1.CustomPriceItemTypeEnum.REG && !!!regular_price.price_type
             ? { price_type: sameInCustomPriceList.type }
             : {})) }), (!!!hasOverriddenPrice
         ? Object.assign(Object.assign({}, (sameInCustomPriceList.percent || !!!isReg
@@ -772,14 +895,15 @@ const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
                         }
                         : {}))
                 }
-                :
+                : // c2. Add discount price data if custom price list item has no Net Price as regular price indicator.
+                    //     ONLY if current discount price for item is not already overriden!
                     !!!options.setNetPriceAsRegular
                         ? Object.assign({ discount_price: Object.assign(Object.assign({}, currentDiscountPrice), (!currentDiscountPrice.overridden
                                 ? {
                                     amount: sameInCustomPriceList.price,
                                     price_type: sameInCustomPriceList.type
                                 }
-                                : {})) }, (!!currentPromoPrice.overridden ? { promo_price: currentPromoPrice } : {})) : {})) :
+                                : {})) }, (!!currentPromoPrice.overridden ? { promo_price: currentPromoPrice } : {})) : {})) : // d. Add discount price data if price is tier pricing price and tier pricing should be kept for product
             currentDiscountPrice.price_type === 'tierpricing' && !!!options.removeTierPricing
                 ? {
                     discount_price: Object.assign(Object.assign({}, item.discount_price), { original_amount: !!isReg || !!!options.setNetPriceAsRegular ? null : sameInCustomPriceList.price })
@@ -794,6 +918,7 @@ const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
             tier_pricing
         }
         : {}));
+    // g. If promo price was overriden in POS, and discount_price or reg_price changed, recalculate promo price applied from percentage
     const priceUsedForPromoCalculations = !!updatedCartItem.discount_price
         ? updatedCartItem.discount_price.amount
         : updatedCartItem.regular_price.amount;
@@ -803,15 +928,20 @@ const checkForCustomPriceEquivalent = (item, customPriceList, options = {}) => {
         priceUsedForPromoCalculations != initialPriceToCompare) {
         updatedCartItem = Object.assign(Object.assign({}, updatedCartItem), { promo_price: Object.assign(Object.assign({}, (updatedCartItem.promo_price || { currency: 'CAD' })), { amount: (0, round_1.default)((0, cart_1.calculateAmountForCustomPromo)(updatedCartItem, Cart_1.CustomPromoType.EXTRA_PROMO, currentPromoPrice.percent_applied), priceUsedForPromoCalculations.toString().split('.').length) }) });
     }
+    // #endregion
     return updatedCartItem;
 };
 exports.checkForCustomPriceEquivalent = checkForCustomPriceEquivalent;
+// #endregion
+// ---------------------------------------------------------------------------------------------
+// #region CUSTOM INCENTIVE
 const getCustomIncentiveAmount = (customPriceList) => {
     if (!!!customPriceList)
         return;
     const ententeSku = 'INCITATIF';
     let amount = 0;
     const entente = customPriceList.find((priceItem) => priceItem.sku === ententeSku);
+    // Si l'incitatif n'est pas trouvé dans l'entente, ou correspond au prix "régulier", ne pas le retourner
     if (!!!entente || !!!entente.price || entente.type == G2_1.CustomPriceItemTypeEnum.REG)
         return;
     amount = entente.price * -100;
@@ -843,6 +973,7 @@ const getCustomIncentiveInfo = (customPriceList, discountRules, defaultIncentive
     let customIncentiveAmount = (0, exports.getCustomIncentiveAmount)(customPriceList);
     const incentiveDiscountRule = (0, discount_1.getPaymentIncentiveDiscount)(discountRules);
     if (!!!customIncentiveAmount) {
+        // If already overridden, reset incentive discount if no custom incentive found for customer
         if (!!incentiveDiscountRule && !!incentiveDiscountRule.overridden) {
             return {
                 amount: defaultIncentiveAmount || 0,
@@ -865,4 +996,5 @@ const getCustomIncentiveInfo = (customPriceList, discountRules, defaultIncentive
     };
 };
 exports.getCustomIncentiveInfo = getCustomIncentiveInfo;
+// #endregion
 //# sourceMappingURL=g2.js.map