addio-admin-sdk 1.7.103 → 1.7.104

package/dist/services/g2/utils.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.transformCreditNoteToG2Order = exports.transformAddioCartToG2Order = exports.getDefaultG2OrderItem = void 0;
 const G2OrderSlip_1 = __importDefault(require("./G2OrderSlip"));
 const logs_1 = require("../logs");
+// Utils
 const round_1 = __importDefault(require("lodash/round"));
 const products_1 = require("../../rules/GR/constants/products");
 const cart_1 = require("../../rules/GR/utils/cart");
@@ -21,9 +22,14 @@ const services_1 = require("../../utils/services");
 const context_1 = require("../../utils/context");
 const string_1 = require("../../utils/string");
 const __1 = require("../..");
+// Interfaces and Enums
 const Cart_1 = require("../../Interfaces/Cart");
 const cart_3 = require("../../rules/GR/interfaces/cart");
 const refunds_1 = require("../../utils/refunds");
+/**
+ * Creates a partial G2OrderItem with all non-nullable properties with default values
+ * @param noArticle Optionnal. If not provided, sets noArticle as an empty string.
+ */
 const getDefaultG2OrderItem = (noArticle) => ({
     noArticle: noArticle || '',
     libreNum1: 0,
@@ -37,19 +43,29 @@ const getDefaultG2OrderItem = (noArticle) => ({
     coutdeVenteUnitaire: 0
 });
 exports.getDefaultG2OrderItem = getDefaultG2OrderItem;
+/**
+ * Creates a G2OrderSlip object from provided Addio cart data. Only works if provided space has G2 set in external_services.
+ * @param addioCart
+ * @param space
+ * @param orgId
+ */
 const transformAddioCartToG2Order = async (addioCart, space, orgId, isTest, creditNote) => {
+    // Check if cart to transform is higher status than 5 (CartStatusEnum.CHECKOUT_PAYMENT_SUCCESS)
     if (addioCart.status < Cart_1.CartStatusEnum.CHECKOUT_PAYMENT_SUCCESS) {
         console.error("can't create an order slip for a non-paid cart. Returning!");
         return;
     }
+    // Check if space has G2 set
     const g2Service = space.services({ field: 'external_service_name', value: 'G2' });
     if (!!!g2Service.length ||
         !!!(0, object_1.recursiveCheckObject)(g2Service[0], 'external_service_infos.specific_actions.save_order_to_g2')) {
         console.error('space does not have G2 in external_services or does not save order property. Returning!');
         return;
     }
+    // Create base g2OrderSlip obj
     const g2OrderObj = new G2OrderSlip_1.default(space, orgId);
     const data = { addioCart, creditNote, g2OrderObj, space, orgId };
+    // Update with Addio cart values
     try {
         await _constructGeneralData(data, isTest);
         _constructBillingData(data);
@@ -65,6 +81,8 @@ const transformAddioCartToG2Order = async (addioCart, space, orgId, isTest, cred
     }
 };
 exports.transformAddioCartToG2Order = transformAddioCartToG2Order;
+// =================================================================
+// #region GENERAL FUNCTIONS FOR DATA
 const _getCustomerData = (addioCart, dataToReturn, space) => {
     switch (dataToReturn) {
         case 'id':
@@ -87,6 +105,7 @@ const _getCustomerData = (addioCart, dataToReturn, space) => {
                 : (0, object_1.recursiveCheckObject)(addioCart, 'customer_info.previous_terms_code') ||
                     (0, object_1.recursiveCheckObject)(addioCart, 'customer_info.terms_code') ||
                     'P.S.L.';
+        //TODO - Attendre confirmation de la facturation qu'on envoie P.S.L. pour tous les clients où la valeur n'est pas définie (même les clients au détail)
     }
 };
 const _getTransformCartProps = (addioCart) => {
@@ -98,9 +117,15 @@ const _getTransformCartProps = (addioCart) => {
         isPickup: !!(0, object_1.recursiveCheckObject)(addioCart, 'is_pickup')
     };
 };
+// #endregion
+// =================================================================
+// #region CONSTRUCT SPECIFIC G2 ORDER DATA SECTIONS
+// ----------------------
+// General data
 const _constructGeneralData = async (data, _isTest) => {
     const { addioCart, g2OrderObj, space, creditNote } = data;
     const isWebCart = addioCart.cart_type == Cart_1.CartTypeEnum.WEB;
+    // A. Tax province
     let taxProvince = 'QC';
     const cartShippingAddress = (0, object_1.recursiveCheckObject)(addioCart, 'shipping_address.address');
     if (!!cartShippingAddress && cartShippingAddress.state != taxProvince) {
@@ -108,21 +133,28 @@ const _constructGeneralData = async (data, _isTest) => {
         if (!!shortCartShippingState)
             taxProvince = shortCartShippingState;
     }
+    // B. Rep. number
     const repNumber = !!isWebCart ? 'WEB' : (0, object_1.recursiveCheckObject)(addioCart, 'created_by.user_external_id') || 'NOUVEAU';
+    // C. All default data for G2Order
     g2OrderObj.setNoClient(_getCustomerData(addioCart, 'id', space));
     g2OrderObj.setNoProvinceTaxation(taxProvince);
     g2OrderObj.setCondition(_getCustomerData(addioCart, 'termsCode', space));
     g2OrderObj.setNoRepresentant(repNumber);
     g2OrderObj.setDate(!!addioCart.paid_at ? (0, data_1.formatDate)(addioCart.paid_at) : null);
     const cartRef = addioCart.ref || '';
-    const cartInvoice = addioCart.invoice_ref || '';
+    const cartInvoice = addioCart.invoice_ref || ''; // Replace - in invoice_ref so it can be searched for in G2
     g2OrderObj.setNoCommDuClient(`${cartRef}${!!cartInvoice && !!cartRef ? '/' : ''}${cartInvoice.replace('-', '')}`);
+    // C. Description
+    // For description, always contains order number. If non-pro customer, add customer name too.
+    // NOTE - Check if full name + order ref is longer thant limit (25 characters). If so, use only lastname. If still too long, only use order ref.
     let customerName = !(0, cart_1.isPro)(addioCart) ? _getCustomerData(addioCart, 'fullname', space) : '';
+    // Check if higher than 24 caracters (which is the max of 25 - the space in between sections)
     if (customerName.length + cartRef.length > 24) {
         const customerLastName = _getCustomerData(addioCart, 'lastname', space);
         customerName = customerLastName.length + cartRef.length <= 24 ? customerLastName : '';
     }
     g2OrderObj.setDescription(`${!!customerName ? customerName + ' ' : ''}${addioCart.ref || ''}`);
+    // D. Commandé par
     let name = (0, object_1.recursiveCheckObject)(addioCart, 'billing_address.expedition_recipient_name') || '';
     name = name.replace('%', ' ').slice(0, 50);
     let tel = (0, object_1.recursiveCheckObject)(addioCart, 'billing_address.expedition_recipient_phone') || '';
@@ -130,12 +162,15 @@ const _constructGeneralData = async (data, _isTest) => {
     const fullLength = name.length + tel.length;
     let orderedByValue = `${name}${!!name && !!tel && fullLength <= 49 ? ' ' : ''}${fullLength <= 49 ? tel : ''}`;
     g2OrderObj.setCommandePar(orderedByValue || null);
+    // E. Refund data
     if (!!creditNote) {
         g2OrderObj.setNoteDeCredit(true);
         g2OrderObj.setNoCommDuClient(`${(0, refunds_1.formatRefundInvoiceRef)(creditNote.ref, space, creditNote.groupCode).replace('-', '')}${!!creditNote.ref && !!cartRef ? '/' : ''}${cartRef}`);
+        // Add #memo
         if (!!creditNote.secondaryRef) {
             g2OrderObj.setNotes(`# mémo de retour: ${creditNote.secondaryRef}` + '\r\n');
         }
+        // Add notes
         if (!!creditNote.notes) {
             g2OrderObj.setNotes(creditNote.notes.replace('\n\n', '\r\n') + '\r\n');
         }
@@ -149,9 +184,11 @@ const _constructGeneralData = async (data, _isTest) => {
         }
     }
     if ((0, cart_1.checkIfCartContainsType)(cart_3.CartGeneralTypeEnum.RETURN_PALLETS, addioCart)) {
+        // Add #memo
         if (!!addioCart.shipping_payload.pallet_return_memo_ref) {
             g2OrderObj.setNotes(`# mémo de retour: ${addioCart.shipping_payload.pallet_return_memo_ref}` + '\r\n');
         }
+        // Add notes
         if (!!addioCart.message) {
             g2OrderObj.setNotes(addioCart.message.replace('\n\n', '\r\n') + '\r\n');
         }
@@ -164,6 +201,7 @@ const _constructExtraData = (data) => {
         if (!!cancelledDate)
             g2OrderObj.setDateAnnulation((0, data_1.formatDate)(cancelledDate));
     }
+    // TODO - Vérifier si autres valeurs à pousser ici?
     if (!!addioCart.payment_reference && !creditNote) {
         g2OrderObj.setNotes(`#ref. paiement : ${addioCart.payment_reference}\r\n`);
     }
@@ -171,6 +209,8 @@ const _constructExtraData = (data) => {
         g2OrderObj.setNotes(`code postal de la carte de crédit : ${(0, object_1.recursiveCheckObject)(addioCart, 'shipping_payload.credit_card_postal_code')}\r\n`);
     }
 };
+// ----------------------
+// Expedition data
 const _constructBillingData = (data) => {
     const { addioCart, g2OrderObj, space } = data;
     const cartBillingInfo = addioCart.billing_address;
@@ -203,6 +243,7 @@ const _constructShippingData = (data) => {
     const { addioCart, g2OrderObj, space, creditNote } = data;
     const cartRef = addioCart.ref || '';
     const invoiceRef = addioCart.invoice_ref || '';
+    // A. Set address data
     if (!!creditNote) {
         const refundStore = space.preferences.stores.get().find((s) => s.id == creditNote.groupCode);
         g2OrderObj.setLivreaNom(`RETOUR${!!refundStore ? ' ' + refundStore.name : ''}`);
@@ -214,7 +255,7 @@ const _constructShippingData = (data) => {
         const sameStore = space.preferences.stores.get().find((s) => s.id == pickupStoreID);
         g2OrderObj.setLivreaNom(`PICK UP${!!sameStore ? ' ' + sameStore.name : ''}`);
         g2OrderObj.setLivreaDepartement(`${cartRef}${!!cartRef && !!invoiceRef ? '/' : ''}${invoiceRef.replace('-', '')}`);
-        g2OrderObj.setTransport('PICK-UP');
+        g2OrderObj.setTransport('PICK-UP'); // TODO - Vérifier avec G2 les valeurs, semble être un enum/select dans les captures de la facturation?
     }
     else {
         const cartShippingInfo = addioCart.shipping_address;
@@ -228,8 +269,9 @@ const _constructShippingData = (data) => {
             g2OrderObj.setLivreaCodePostal(cartShippingInfo.address.postal_code);
             g2OrderObj.setLivreaPays(cartShippingInfo.address.country);
         }
-        g2OrderObj.setTransport('LIVRAISON');
+        g2OrderObj.setTransport('LIVRAISON'); // TODO - Vérifier avec G2 les valeurs, semble être un enum/select dans les captures de la facturation?
     }
+    // B. Date expected for order
     if (!creditNote) {
         const cartForDate = (0, object_1.recursiveCheckObject)(addioCart, 'shipping_payload.delivery_or_pickup_date');
         const timeOfDay = (0, object_1.recursiveCheckObject)(addioCart, 'shipping_payload.delivery_period');
@@ -253,6 +295,8 @@ const _constructShippingData = (data) => {
         }
     }
 };
+// ----------------------
+// Customer data
 const _constructCustomerData = async (data) => {
     const { addioCart, g2OrderObj, space, orgId } = data;
     let joursEcheance = null;
@@ -271,6 +315,7 @@ const _constructCustomerData = async (data) => {
             joursEcheance = sameCustomer.conditionsReglements.conditionReglement.joursÉchéance;
             joursReglementAnticipe = sameCustomer.conditionsReglements.conditionReglement.joursRèglementAnticipé;
             pourcEscReglementAnticipe = sameCustomer.conditionsReglements.conditionReglement.pourcEscRèglementAnticipé;
+            // If commandePar props is still empty here, set with G2 value by default
             if (!!!g2OrderObj.data().commandePar && (0, cart_1.isPro)(addioCart)) {
                 let valueToUse = sameCustomer.client.personneRessourceVentes || '';
                 valueToUse = valueToUse.slice(0, 50);
@@ -285,18 +330,22 @@ const _constructCustomerData = async (data) => {
     g2OrderObj.setJoursReglementAnticipe(joursReglementAnticipe);
     g2OrderObj.setPourcEscReglementAnticipe(pourcEscReglementAnticipe);
 };
+// ----------------------
+// Items (including promos and extra items)
 const _constructAllItems = async (data) => {
     var _a;
     if (!!!data.addioCart)
         return;
     const allOptions = _getTransformCartProps(data.addioCart);
     let subtotalToUse = 0;
+    // 1. Add all cart items
     try {
         subtotalToUse = await _constructProductItems(allOptions, data);
     }
     catch (e) {
         console.error('error on transforming items for G2: ', e.toString());
     }
+    // 2. Add all cart promos applied as items
     if (!!subtotalToUse) {
         try {
             subtotalToUse = await _constructPromoItems(subtotalToUse, allOptions, data);
@@ -305,6 +354,7 @@ const _constructAllItems = async (data) => {
             console.error('error on transforming promos for G2: ', e.toString());
         }
     }
+    // 3. Add refund item if defined in credit note
     if (!!data.creditNote && !!data.creditNote.refundFeesAmount) {
         try {
             await _constructRefundFeeItem(data);
@@ -313,6 +363,7 @@ const _constructAllItems = async (data) => {
             console.error('error on adding refund fee item to G2 order: ', e.toString());
         }
     }
+    // 4. If cart is shipping to Ontario, add Ontario Tax product
     if (allOptions.shippingToOntario) {
         try {
             await _constructOntarioTaxItem(subtotalToUse, data);
@@ -321,10 +372,13 @@ const _constructAllItems = async (data) => {
             console.error('error on adding Ontario tax item to G2 order: ', e.toString());
         }
     }
+    // 4. Add specific line for cart type
     if (!data.creditNote) {
         _constructCartTypeItem(data);
+        // 5. Add specific line for person on site
         _constructPersonOnSiteItem(data);
     }
+    // Last check : if subtotal is not the same at the end, log error
     if (subtotalToUse.toFixed(2) !== data.addioCart.subtotal.toFixed(2)) {
         const logTxt = `Something went wrong! Subtotals don't match... calculated subtotal: ${subtotalToUse.toFixed(2)}, cart subtotal: ${data.addioCart.subtotal.toFixed(2)}`;
         if (!__1.isTestEnv) {
@@ -347,6 +401,7 @@ const _constructProductItems = async (allOptions, data) => {
         try {
             const { g2Item, internalMsgForItem } = await _transformCartItemToPartialG2Item(item, data.space, data.orgId, allOptions);
             data.g2OrderObj.addItemLineToOrder(g2Item, internalMsgForItem);
+            // Calculate new subtotal by adding item amount
             const escompteApplied = !!g2Item.pourcEscompte ? (100 - g2Item.pourcEscompte) / 100 : 1;
             calculatedSubtotal += (g2Item.prixUnitaire || 0) * escompteApplied * (g2Item.quantite || 0);
         }
@@ -361,6 +416,7 @@ const _constructPromoItems = async (subtotalToUse, allOptions, data) => {
     if (!!!data.addioCart)
         return 0;
     let allPromos = (0, discount_1.getCartPromo)(data.addioCart) || [];
+    // 1. Check for non incentive promos
     let allNonIncentivePromos = allPromos.filter((p) => p.applies_to !== Cart_1.CartPromoAppliesToEnum.TOTAL_AFTER_TAXES);
     let promoAmountData = (0, cart_2.getAllPromoAppliedPrices)(allNonIncentivePromos, subtotalToUse, data.addioCart.items, data.space, !!data.creditNote);
     let calculatedSubtotal = subtotalToUse;
@@ -372,15 +428,18 @@ const _constructPromoItems = async (subtotalToUse, allOptions, data) => {
                 console.error('could not find corresponding cart promo for id: ', promoAmounts.id);
                 continue;
             }
+            // A. Find same discount_rule for data
             const sameDiscountRule = data.addioCart.discount_rules.find((d) => d.id == promoToCheckID);
             const externalValueForG2 = !!sameDiscountRule
                 ? (0, object_1.recursiveCheckObject)(sameDiscountRule, 'external_values.noArticle')
                 : undefined;
+            // B. Find entry in calculated amounts and check which value to use for promo quantity in G2 order
             const amountToUseForQuantity = [Cart_1.CartPromoAppliesToEnum.PRODUCT, Cart_1.CartPromoAppliesToEnum.ITEMS].includes(promoAmounts.appliesTo)
                 ? promoAmounts.productTotalAmount
                 : samePromoInCartApplied.amount_unit && samePromoInCartApplied.amount_unit.includes('amount')
                     ? 1
                     : promoAmounts.subtotalBefore;
+            // C. Transform promo to g2 item
             const { g2Item, internalMsgForItem } = await _transformCartPromoToPartialG2Item(samePromoInCartApplied, externalValueForG2, amountToUseForQuantity, data.space, data.orgId, allOptions);
             data.g2OrderObj.addItemLineToOrder(g2Item, internalMsgForItem);
         }
@@ -388,15 +447,19 @@ const _constructPromoItems = async (subtotalToUse, allOptions, data) => {
             console.error('error on transforming item to G2 item: ', e.toString());
         }
     }
+    // update subtotal with all promos applied by using last promo applied subtotalAfter
     if (promoAmountData.length >= 1) {
         calculatedSubtotal = promoAmountData[promoAmountData.length - 1].subtotalAfter;
     }
+    // 2. Check for incentive promos
     let incentive = allPromos.find((p) => p.applies_to === Cart_1.CartPromoAppliesToEnum.TOTAL_AFTER_TAXES);
     if (!!incentive) {
+        // A. Find same discount_rule for data
         const sameDiscountRule = data.addioCart.discount_rules.find((d) => d.id == incentive.discount_id);
         const externalValueForG2 = !!sameDiscountRule
             ? (0, object_1.recursiveCheckObject)(sameDiscountRule, 'external_values.noArticle')
             : undefined;
+        // B. Transform promo to g2 item
         const { g2Item, internalMsgForItem } = await _transformCartPromoToPartialG2Item(incentive, externalValueForG2, calculatedSubtotal, data.space, data.orgId, allOptions);
         data.g2OrderObj.addItemLineToOrder(g2Item, internalMsgForItem);
     }
@@ -441,12 +504,14 @@ const _constructCartTypeItem = (data) => {
     let calculatedPalQty = (0, expedition_1.getPalletQty)(allItems, cartProps.cartType == cart_3.CartGeneralTypeEnum.BETON ? 'concrete' : 'grass');
     let itemMsgStr = '';
     if (cartProps.cartType == cart_3.CartGeneralTypeEnum.BETON) {
+        // NEW [12-11-2025] - Set concrete order pal quantity to pallet fee quantity (or calculated qty if not found)
         let concretePalQty = calculatedPalQty;
         const palletFeeProd = allItems.find((i) => i.parent_slug == 'frais-palette');
         if (!!palletFeeProd) {
             concretePalQty = palletFeeProd.qte;
         }
         itemMsgStr += `${concretePalQty} BETON`;
+        // Check for accessories in order, and add then to item message
         let allAccessories = allItems.filter((i) => {
             const cat2 = (0, object_1.recursiveCheckObject)(i, 'external_values.catégorie2') || '';
             return !!cat2.includes('ACC') && !!(0, object_1.recursiveCheckObject)(i, 'external_values.catégorie1') && !i.is_service;
@@ -455,10 +520,12 @@ const _constructCartTypeItem = (data) => {
             itemMsgStr += ` + ${(0, object_1.recursiveCheckObject)(acc, 'external_values.catégorie1')}`;
     }
     else {
+        // NEW [12-11-2025] - For grass order pal quantity always use calculated pal quantity
         itemMsgStr += `${calculatedPalQty % 1 != 0 ? Math.floor(calculatedPalQty) + '½' : calculatedPalQty} GAZON`;
         const principalGrassItem = allItems.find((i) => (0, products_2.checkIfProductIsOfType)(i, 'gazon', true) && !i.is_service && i.sku !== products_1.kentucky);
         if (!!principalGrassItem)
             itemMsgStr += ` ${(0, locale_1.getLocaleOfDictionnary)(principalGrassItem.name, addioCart.locale).toUpperCase()}`;
+        // Check for installation specifics
         if ((0, cart_1.checkIfCartContainsType)(cart_3.CartGeneralTypeEnum.INSTALLATION, addioCart)) {
             itemMsgStr += ' EN INSTALLATION';
             if (allItems.some((i) => i.parent_slug == 'installation-fertilisation'))
@@ -491,6 +558,7 @@ const _constructCartTypeItem = (data) => {
                 itemMsgStr += ` + ${installAddOnStr.join(' | ')}`;
         }
     }
+    // Create item with only message
     const constructedItem = Object.assign(Object.assign({}, (0, exports.getDefaultG2OrderItem)()), { message: itemMsgStr, quantite: null, prixUnitaire: null, pourcEscompte: 0, taxableTPS: true, taxableTVQ: true });
     g2OrderObj.addItemLineToOrder(constructedItem);
 };
@@ -503,12 +571,25 @@ const _constructPersonOnSiteItem = (data) => {
     const personOnSitePhone = (0, object_1.recursiveCheckObject)(addioCart, 'shipping_payload.personOnSitePhone');
     if (!!!personOnSiteName && !!!personOnSitePhone)
         return;
+    // Create item with only message + generic sku
     const constructedItem = Object.assign(Object.assign({}, (0, exports.getDefaultG2OrderItem)()), { noArticle: 'APPEL', message: `* APPELER 30 MIN AVANT ${personOnSiteName.trim()} ${(0, data_1.formatPhoneNumberPrint)(personOnSitePhone).trim()}`, quantite: 0, prixUnitaire: 0, pourcEscompte: 0, taxableTPS: true, taxableTVQ: true });
     g2OrderObj.addItemLineToOrder(constructedItem);
 };
+// #endregion
+// =================================================================
+// #region TRANSFORM EXISTING ADDIO DATA
+/**
+ * Creates a G2 compatible item from a dashboard item, excluding index properties. Also consults G2 prod for certain props if found with provided item.sku
+ * @param item
+ * @param space
+ * @param org
+ * @param options
+ */
 const _transformCartItemToPartialG2Item = async (item, space, orgId, options) => {
     var _a;
     let extraMsg = [];
+    // --------------------------------
+    //#region CONSTANTS
     const isCustomProd = !!item.is_temp_prod;
     const isEscSuppItem = (0, g2_1.isEscompteSuppItem)(item.sku);
     const updatedPriceMsg = !!(0, cart_2.priceWasOverridden)(item)
@@ -517,21 +598,40 @@ const _transformCartItemToPartialG2Item = async (item, space, orgId, options) =>
     const updatedEscompteMsg = !!(0, cart_2.priceWasOverridden)(item)
         ? (0, object_1.recursiveCheckObject)(item, 'promo_price.authorization.note')
         : '';
+    //#endregion
+    // --------------------------------
+    //#region MINIMAL INFOS
     let defaultSku = (0, object_1.recursiveCheckObject)(item, 'external_values.noArticle') || item.sku;
+    // If is PA supp item, split sku to keep only "real" sku for item
     if (isEscSuppItem)
         defaultSku = (0, string_1.splitFromFirstChar)('-', defaultSku)[0];
+    // If is custom prod item, set default sku to "empty"
+    // else if (isCustomProd) defaultSku = ''
     let transG2Item = (0, exports.getDefaultG2OrderItem)(defaultSku);
+    //#endregion
+    // --------------------------------
+    //#region DESC. INFOS
     transG2Item.description = (_a = (0, locale_1.getLocaleOfDictionnary)(item.name, options.cartLocale)) !== null && _a !== void 0 ? _a : null;
     transG2Item.quantite = isEscSuppItem ? (0, round_1.default)(item.qte, 2) : item.qte;
     transG2Item.prixUnitaire = (0, cart_1.getAppliedPrice)(item, {
         isBookingBeton: options.cartType == cart_3.CartGeneralTypeEnum.BOOKING_BETON
     });
+    // ** If esc does not exist, send 0 instead of null (causes errors on G2's end)
     transG2Item.pourcEscompte = (0, cart_1.getPercentFromReducedPrice)(item, !!options.isPro) || 0;
+    //#endregion
+    // --------------------------------
+    //#region CONDITIONAL INFOS
+    // A. Add props if product's price or escomptes were manually updated
     transG2Item.prixModifieUtilisateur = !!updatedPriceMsg || (isCustomProd && !isEscSuppItem);
     transG2Item.escompteModifieUtilisateur = !!updatedEscompteMsg || (isCustomProd && !isEscSuppItem);
+    // B. Add tax applicable props (check if product is tax exempt or shipping to ontario)
     const prodIsTaxExempt = !!item.tax_exemption || options.shippingToOntario;
     transG2Item.taxableTPS = !prodIsTaxExempt;
     transG2Item.taxableTVQ = !prodIsTaxExempt;
+    //#endregion
+    // --------------------------------
+    //#region G2 PROD DATA
+    // Fetch item from G2. If found, use to set certain variables.
     try {
         transG2Item = await _updateItemWithG2Prod(defaultSku, transG2Item, options, space, orgId, {
             noArticle: true,
@@ -542,6 +642,10 @@ const _transformCartItemToPartialG2Item = async (item, space, orgId, options) =>
     catch (e) {
         console.error(`error on fetching prod from G2 for sku ${defaultSku}: `, e.toString());
     }
+    //#endregion
+    // --------------------------------
+    // #region MESSAGES
+    // Add custom message to order if product is custom prod, or product price/escompte were manually updated
     if (!!isCustomProd && !isEscSuppItem)
         extraMsg.push(`Produit ajouté manuellement`);
     else {
@@ -553,17 +657,32 @@ const _transformCartItemToPartialG2Item = async (item, space, orgId, options) =>
         if (allMsgs.length)
             extraMsg.push(allMsgs.join(' | '));
     }
+    //#endregion
     return {
         g2Item: transG2Item,
         internalMsgForItem: !!extraMsg.length ? `${extraMsg.join(', ')}` : ''
     };
 };
+/**
+ * Creates a G2 compatible item from a promo applied to a cart (ICartPromoApplied), excluding index properties. Also consults G2 prod for certain props if found with constructed sku for promo.
+ * @param promo The Cart Promo to transform
+ * @param associatedNoArticle The noArticle associated to G2, used to generate sku
+ * @param quantityToUse For promos, corresponds to the amount on which the promo is applied. Ex. if promo applied to subtotal, should be subtotal, or if applied to specific product, specific product's price * qte
+ * @param space
+ * @param org
+ * @param options
+ */
 const _transformCartPromoToPartialG2Item = async (promo, associatedNoArticle, quantityToUse, space, orgId, options) => {
     let extraMsg = [];
+    // --------------------------------
+    //#region MINIMAL INFOS
     let defaultSku = associatedNoArticle || '';
     if (!!!defaultSku && !!promo.promo_code)
         defaultSku = promo.promo_code;
     let transG2Item = (0, exports.getDefaultG2OrderItem)(defaultSku);
+    //#endregion
+    // --------------------------------
+    //#region DESC. INFOS
     transG2Item.description = promo.promo_name;
     transG2Item.quantite = quantityToUse;
     let promoResultAmountRemoved = 0;
@@ -577,9 +696,17 @@ const _transformCartPromoToPartialG2Item = async (promo, associatedNoArticle, qu
     }
     transG2Item.prixUnitaire = promoResultAmountRemoved * -1;
     transG2Item.pourcEscompte = 0;
+    //#endregion
+    // --------------------------------
+    //#region CONDITIONAL INFOS
+    // A. If promo is payment incentive promo, or shipping to Ontario, flag no taxes applied props
     const shouldRemoveTaxes = promo.applies_to == Cart_1.CartPromoAppliesToEnum.TOTAL_AFTER_TAXES || options.shippingToOntario;
     transG2Item.taxableTPS = !shouldRemoveTaxes;
     transG2Item.taxableTVQ = !shouldRemoveTaxes;
+    //#endregion
+    // --------------------------------
+    //#region G2 PROD DATA
+    // Fetch item from G2 if sku defined. If found, use to set certain variables.
     if (!!defaultSku) {
         try {
             transG2Item = await _updateItemWithG2Prod(defaultSku, transG2Item, options, space, orgId, {
@@ -595,25 +722,40 @@ const _transformCartPromoToPartialG2Item = async (promo, associatedNoArticle, qu
         transG2Item.noArticle = '999999999-1';
         transG2Item.pourcEscompte = 0;
     }
+    // If sku not found in G2, add price and escompte modified props so G2 does not override them
     if (transG2Item.noArticle == '999999999-1') {
         transG2Item.prixModifieUtilisateur = true;
         transG2Item.escompteModifieUtilisateur = true;
     }
+    //#endregion
     return {
         g2Item: transG2Item,
         internalMsgForItem: !!extraMsg.length ? `${extraMsg.join(', ')}` : ''
     };
 };
+/**
+ * Fetch product fron G2 with sku provided, then update new G2 item with provided props.
+ * @param sku
+ * @param transG2Item
+ * @param options
+ * @param space
+ * @param org
+ * @param valuesToUpdate
+ * @param addMessageToG2Order
+ */
 const _updateItemWithG2Prod = async (sku, transG2Item, options, space, orgId, valuesToUpdate, addMessageToG2Order) => {
     var _a;
     const g2Prod = await (0, g2_1.fetchProductFromG2WithSku)(sku, space, orgId);
     if (!!g2Prod) {
+        // TODO - Vérifier les prix ici aussi?
+        // A.Check if G2 sku different from dash sku. If so, use G2.
         if (valuesToUpdate.noArticle) {
             if (!!g2Prod.noArticle && g2Prod.noArticle !== sku) {
                 transG2Item.noArticle = g2Prod.noArticle;
                 transG2Item.sku = sku;
             }
         }
+        // B. Check if G2 name is different from dash name
         if (valuesToUpdate.description) {
             const g2Description = options.cartLocale == 'en' && !!g2Prod.article.description2
                 ? g2Prod.article.description2
@@ -622,12 +764,47 @@ const _updateItemWithG2Prod = async (sku, transG2Item, options, space, orgId, va
                 transG2Item.description = g2Prod.article.description;
             }
         }
+        // C. Generate message tp show under item based on G2 props
+        // ** NOTE - Finalement, les messages issus des articles G2 seront générés du côté de G2 directement!
+        // if (valuesToUpdate.message) {
+        // 	let underItemMessage = ''
+        // 	if (g2Prod.article.catégorie2 == 'NET') underItemMessage += '***net***'
+        // if (g2Prod.messages && !!g2Prod.messages.length) {
+        // 	for (let msg of g2Prod.messages) {
+        // 		switch (msg.codeMessage) {
+        // 			case 'RETOUR':
+        // 				underItemMessage += translateILang({
+        // 					fr: '***Aucun retour/échange sur ce matériel***',
+        // 					en: '***Aucun retour/échange sur ce matériel***'
+        // 				})
+        // 				break
+        // 			case 'BETON':
+        // 				underItemMessage += translateILang({
+        // 					fr: '***applicable à toutes les commandes***',
+        // 					en: '***applicable à toutes les commandes***'
+        // 				})
+        // 				break
+        // 			case 'ENGRAIS':
+        // 				if (!options.isPickup)
+        // 					underItemMessage += translateILang({
+        // 						fr: '****Attention engrais****',
+        // 						en: '****Attention engrais****'
+        // 					})
+        // 				break
+        // 		}
+        // 	}
+        // }
+        // transG2Item.message = underItemMessage || null
+        // }
     }
     else {
+        // Reset noArticle value to default sku. Billing departement will know to verify & add correct sku afterwards
         if (valuesToUpdate.noArticle) {
             transG2Item.noArticle = '999999999-1';
             transG2Item.sku = sku;
             transG2Item.pourcEscompte = 0;
+            // TODO - Should we set prixModifieUtilisateur & escompteModifieUtilisateur when sku not found in G2?
+            // Add message to notes in order
             if (!!addMessageToG2Order)
                 addMessageToG2Order(`Sku non-trouvé dans G2 : ${sku}`);
         }
@@ -641,13 +818,16 @@ const _updateItemWithG2Prod = async (sku, transG2Item, options, space, orgId, va
     }
     return transG2Item;
 };
+// #endregion
 const transformCreditNoteToG2Order = async (creditNote, cartId, space, orgId, isTest) => {
+    // Check if space has G2 set
     const g2Service = space.services({ field: 'external_service_name', value: 'G2' });
     if (!!!g2Service.length ||
         !!!(0, object_1.recursiveCheckObject)(g2Service[0], 'external_service_infos.specific_actions.save_order_to_g2')) {
         console.error('space does not have G2 in external_services or does not save order property. Returning!');
         return;
     }
+    // Fetch corresponding cart from database
     let correspondingCart;
     try {
         const cartQuery = await space.carts.get({ query: [{ field: 'id', operator: '==', value: cartId }] });
@@ -661,10 +841,13 @@ const transformCreditNoteToG2Order = async (creditNote, cartId, space, orgId, is
         console.log("couldn't find cart! returning");
         return;
     }
+    // Update cart with credit note
+    // 1. Ajust date
     correspondingCart.paid_at = creditNote.createdAt;
     if (!!correspondingCart.processed_by) {
         correspondingCart.processed_by = Object.assign(Object.assign({}, correspondingCart.processed_by), { date: creditNote.createdAt });
     }
+    // 2. Ajust items
     correspondingCart.items = correspondingCart.items
         .map((i) => {
         const sameInRefund = creditNote.items.find((refItem) => refItem.itemId === i.parent_product_id && refItem.variantId === i.sku);
@@ -674,12 +857,14 @@ const transformCreditNoteToG2Order = async (creditNote, cartId, space, orgId, is
         return i;
     })
         .filter((i) => !!i);
+    // 3. Ajust totals
     correspondingCart.subtotal = creditNote.subtotal * -1;
     correspondingCart.total = creditNote.total * -1;
     correspondingCart.taxes = creditNote.taxes.map((t) => (Object.assign(Object.assign({}, t), { taxes: t.taxes.map((tax) => (Object.assign(Object.assign({}, tax), { amount: (tax.amount || 0) * -1 }))) })));
     if (!!correspondingCart.subtotalWithoutPromotions) {
         correspondingCart.subtotalWithoutPromotions = creditNote.subtotalWithoutPromotions * -1;
     }
+    // 4. Ajust cart promos
     const currentCartPromos = (0, discount_1.getCartPromo)(Object.assign({}, correspondingCart)) || [];
     correspondingCart.promo_after_taxes_amount = creditNote.promoAfterTaxesAmount;
     correspondingCart.cart_promos_applied = (creditNote.promos || [])
@@ -697,6 +882,7 @@ const transformCreditNoteToG2Order = async (creditNote, cartId, space, orgId, is
         return sameInCreditNote;
     })
         .filter((p) => !!p);
+    // Call create g2OrderSlip function
     let transformedG2Order = await (0, exports.transformAddioCartToG2Order)(correspondingCart, space, orgId, isTest, creditNote);
     return transformedG2Order;
 };