washday-sdk 1.6.63 → 1.6.65

package/dist/api/companies/get.js

@@ -69,3 +69,23 @@ export const getCFDIAddonStatus = function (data) {
         }
     });
 };
+export const getAvailableSubscriptionPlans = function () {
+    return __awaiter(this, arguments, void 0, function* (data = {}) {
+        try {
+            const config = {
+                headers: { Authorization: `Bearer ${this.apiToken}` }
+            };
+            const params = new URLSearchParams();
+            if (data.companyId) {
+                params.set("companyId", data.companyId);
+            }
+            const query = params.toString();
+            const response = yield this.axiosInstance.get(`${GET_SET_BILLING}/subscription/available-plans${query ? `?${query}` : ""}`, config);
+            return response;
+        }
+        catch (error) {
+            console.error('Error fetching getAvailableSubscriptionPlans:', error);
+            throw error;
+        }
+    });
+};

package/dist/api/companies/post.js

@@ -99,3 +99,33 @@ export const disableCFDIAddon = function (data) {
         }
     });
 };
+export const previewSubscriptionPlanChange = function (data) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const config = {
+                headers: { Authorization: `Bearer ${this.apiToken}` }
+            };
+            const response = yield this.axiosInstance.post(`${GET_SET_BILLING}/subscription/change-plan/preview`, data, config);
+            return response;
+        }
+        catch (error) {
+            console.error('Error fetching previewSubscriptionPlanChange:', error);
+            throw error;
+        }
+    });
+};
+export const changeSubscriptionPlan = function (data) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const config = {
+                headers: { Authorization: `Bearer ${this.apiToken}` }
+            };
+            const response = yield this.axiosInstance.post(`${GET_SET_BILLING}/subscription/change-plan`, data, config);
+            return response;
+        }
+        catch (error) {
+            console.error('Error fetching changeSubscriptionPlan:', error);
+            throw error;
+        }
+    });
+};

package/dist/api/index.js

@@ -2,8 +2,8 @@ import { deleteCashierBoxById, deleteCashierBoxMovementById } from "./cashierbox
 import { getCashierBoxMovementsHistory, getCashierboxesById, getCashierboxesByStoreId } from "./cashierbox/get";
 import { addCashierBoxMovement, createCashierBox } from "./cashierbox/post";
 import { updateCashierBoxById, updateCashierBoxMovementById } from "./cashierbox/put";
-import { getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "./companies/get";
-import { disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "./companies/post";
+import { getAvailableSubscriptionPlans, getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "./companies/get";
+import { changeSubscriptionPlan, disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, previewSubscriptionPlanChange, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "./companies/post";
 import { updateCompanyById, updateCompanyLogoById, updateCompanySubscriptionBillingInfoById, updateCompanyTaxInfoById, updateGarmentAttributeCatalogsById } from "./companies/put";
 import { getCountries } from "./countries/get";
 import * as configEndpoints from "./config";
@@ -288,6 +288,9 @@ const WashdayClient = function WashdayClient(apiToken, env = 'PROD', clientId, c
         enableCFDIAddon: enableCFDIAddon,
         disableCFDIAddon: disableCFDIAddon,
         getCFDIAddonStatus: getCFDIAddonStatus,
+        getAvailableSubscriptionPlans: getAvailableSubscriptionPlans,
+        previewSubscriptionPlanChange: previewSubscriptionPlanChange,
+        changeSubscriptionPlan: changeSubscriptionPlan,
     });
     this.stripe = bindMethods(this, {
         createCreateSuscriptionCheckoutSession: createCreateSuscriptionCheckoutSession,

package/dist/utils/orders/calculateOrderTotal.js

@@ -46,7 +46,7 @@ export const calculateOrderTotal = (order, selectedCustomer, storeSettings, hasS
             : calculateTotalTaxesIncluded;
         const productTableImports = productTableCalculator(order, selectedCustomer, storeSettings, storeDiscounts, appliedOrderDiscounts, discountCodeObj);
         // === PRODUCT LINE TOTALS ===
-        const { totalQuantity, totalImportWithDiscount, totalImportWithoutDiscount, totalImporTaxes, totalDiscountAmount, totalSubtotalAmount } = getProductLineTotals(productTableImports);
+        const { totalQuantity, totalImportWithDiscount, totalImportWithoutDiscount, totalImporTaxes, totalDiscountAmount, totalSubtotalAmount, taxBreakdown } = getProductLineTotals(productTableImports);
         // === DISCOUNT CODE (monetario tipo NUMBER que se aplica una sola vez) ===
         let discountCodeAmount = 0;
         if (discountCodeObj &&
@@ -68,7 +68,7 @@ export const calculateOrderTotal = (order, selectedCustomer, storeSettings, hasS
             creditApplied -
             redeemPointsDiscount).toFixed(2);
         // === RETURN FINAL OBJECT ===
-        return Object.assign(Object.assign({}, order), { totalQuantity, customerDiscount: order.discountCode ? 0 : (_a = selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.customer) === null || _a === void 0 ? void 0 : _a.discount, productTotal: totalImportWithDiscount, taxesTotal: totalImporTaxes, total: orderTotal, creditApplied, redeemPointsApplied: redeemPointsDiscount, productTotalWithoutDiscount: totalImportWithoutDiscount, totalDiscountAmount: totalDiscountAmount + discountCodeAmount, shippingServiceTotal: shippingCost, appliedOrderDiscounts, subtotal: totalSubtotalAmount });
+        return Object.assign(Object.assign({}, order), { totalQuantity, customerDiscount: order.discountCode ? 0 : (_a = selectedCustomer === null || selectedCustomer === void 0 ? void 0 : selectedCustomer.customer) === null || _a === void 0 ? void 0 : _a.discount, productTotal: totalImportWithDiscount, taxesTotal: totalImporTaxes, taxBreakdown, total: orderTotal, creditApplied, redeemPointsApplied: redeemPointsDiscount, productTotalWithoutDiscount: totalImportWithoutDiscount, totalDiscountAmount: totalDiscountAmount + discountCodeAmount, shippingServiceTotal: shippingCost, appliedOrderDiscounts, subtotal: totalSubtotalAmount });
     }
     catch (error) {
         throw error;

package/dist/utils/orders/calculateTotalTaxesIncluded.js

@@ -1,5 +1,5 @@
 import { DiscountCodeTypes } from "../../enum";
-import { getProductTaxesPercentage } from "./helpers";
+import { calculateProductTaxBreakdown, getProductTaxesPercentage } from "./helpers";
 const getNormalizedId = (value) => {
     if (value === null || value === undefined) {
         return "";
@@ -106,6 +106,11 @@ export const calculateTotalTaxesIncluded = (order, selectedCustomer, storeSettin
         const productLineTotalWithDiscount = +(productNetTotalWithDiscount * taxFactor).toFixed(2);
         // Calcular el total de impuestos como la diferencia entre bruto y neto con descuento
         const totalTaxesApplied = +(productLineTotalWithDiscount - productNetTotalWithDiscount).toFixed(2);
+        const taxBreakdown = calculateProductTaxBreakdown({
+            product: current,
+            store: storeSettings,
+            lineTaxAmount: totalTaxesApplied,
+        });
         const lineDiscount = +(discountAmountPerUnit * qty).toFixed(2);
         return {
             product: current,
@@ -113,6 +118,7 @@ export const calculateTotalTaxesIncluded = (order, selectedCustomer, storeSettin
             productLineImportTotal, // Total bruto sin descuento (incluye extra y IVA)
             productLineTotalWithDiscount, // Total bruto con descuento aplicado sobre el precio ajustado
             productLineTaxesTotal: totalTaxesApplied,
+            taxBreakdown,
             lineDiscountAmount: lineDiscount,
             productLineSubtotal: productNetTotalWithoutDiscount // Subtotal neto (sin IVA)
         };

package/dist/utils/orders/calculateTotalTaxesOverPrice.js

@@ -1,5 +1,5 @@
 import { BuyAndGetConditionsTypes, DiscountCodeTypes } from "../../enum";
-import { getProductTaxesPercentage } from "./helpers";
+import { calculateProductTaxBreakdown, getProductTaxesPercentage } from "./helpers";
 const getNormalizedId = (value) => {
     if (value === null || value === undefined) {
         return "";
@@ -91,6 +91,11 @@ export const calculateTotalTaxesOverPrice = (order, selectedCustomer, storeSetti
         const taxes = subtotal * taxPercentage;
         // Resultados finales:
         const totalTaxesApplied = +taxes.toFixed(2);
+        const taxBreakdown = calculateProductTaxBreakdown({
+            product: current,
+            store: storeSettings,
+            lineTaxAmount: totalTaxesApplied,
+        });
         const lineDiscount = +(productDiscount * qty).toFixed(2);
         // Precio total con descuento, reaplicando impuestos
         const prodLinePriceWithDiscount = +((subtotal * (1 + taxPercentage))).toFixed(2);
@@ -102,6 +107,7 @@ export const calculateTotalTaxesOverPrice = (order, selectedCustomer, storeSetti
             // Total final con descuento, con impuestos incluidos
             productLineTotalWithDiscount: prodLinePriceWithDiscount,
             productLineTaxesTotal: totalTaxesApplied,
+            taxBreakdown,
             lineDiscountAmount: lineDiscount,
             // Subtotal neto (sin impuestos) con descuento aplicado
             productLineSubtotal: subtotal

package/dist/utils/orders/helpers.js

@@ -84,6 +84,103 @@ export const getProductTaxesPercentage = (productObj, store) => {
     const tax3 = getTaxValue(store.taxThree, productObj.taxExemptThree);
     return tax1 + tax2 + tax3;
 };
+const TAX_SLOTS = [
+    { key: "taxOne", taxField: "taxOne", exemptField: "taxExemptOne" },
+    { key: "taxTwo", taxField: "taxTwo", exemptField: "taxExemptTwo" },
+    { key: "taxThree", taxField: "taxThree", exemptField: "taxExemptThree" },
+];
+const round2 = (value) => Math.round((Number(value || 0) + Number.EPSILON) * 100) / 100;
+const getApplicableTaxesForProduct = (productObj, store) => {
+    return TAX_SLOTS.reduce((acc, slot) => {
+        var _a, _b;
+        if (productObj[slot.exemptField]) {
+            return acc;
+        }
+        const tax = store[slot.taxField];
+        const rate = Number((_a = tax === null || tax === void 0 ? void 0 : tax.value) !== null && _a !== void 0 ? _a : 0);
+        if (!Number.isFinite(rate) || rate <= 0) {
+            return acc;
+        }
+        acc.push({
+            key: slot.key,
+            name: String((_b = tax === null || tax === void 0 ? void 0 : tax.name) !== null && _b !== void 0 ? _b : slot.key),
+            rate,
+            weight: Math.round(rate * 100),
+        });
+        return acc;
+    }, []);
+};
+const allocateByWeights = (total, weights) => {
+    if (weights.length === 0)
+        return [];
+    if (total <= 0)
+        return new Array(weights.length).fill(0);
+    const safeWeights = weights.map((weight) => Math.max(0, Math.trunc(weight)));
+    const sum = safeWeights.reduce((acc, weight) => acc + weight, 0);
+    if (sum <= 0)
+        return new Array(weights.length).fill(0);
+    const raw = safeWeights.map((weight) => (total * weight) / sum);
+    const floors = raw.map((amount) => Math.floor(amount));
+    let remaining = total - floors.reduce((acc, amount) => acc + amount, 0);
+    const order = raw
+        .map((amount, index) => ({ index, frac: amount - Math.floor(amount) }))
+        .sort((a, b) => b.frac - a.frac);
+    const out = floors.slice();
+    for (let index = 0; index < order.length && remaining > 0; index += 1) {
+        out[order[index].index] += 1;
+        remaining -= 1;
+    }
+    return out;
+};
+export const aggregateTaxBreakdown = (items) => {
+    const byKey = new Map();
+    items.forEach((item) => {
+        if (!item || Number(item.amount || 0) <= 0) {
+            return;
+        }
+        const existing = byKey.get(item.key);
+        if (existing) {
+            existing.amount = round2(existing.amount + item.amount);
+            return;
+        }
+        byKey.set(item.key, Object.assign(Object.assign({}, item), { amount: round2(item.amount) }));
+    });
+    return TAX_SLOTS.map((slot) => byKey.get(slot.key)).filter((item) => Boolean(item && item.amount > 0));
+};
+export const normalizeTaxBreakdownToTotal = (items, total) => {
+    const target = round2(total);
+    if (target <= 0) {
+        return [];
+    }
+    const aggregated = aggregateTaxBreakdown(items);
+    if (aggregated.length === 0) {
+        return [];
+    }
+    const sum = round2(aggregated.reduce((acc, item) => acc + item.amount, 0));
+    const diff = round2(target - sum);
+    if (diff !== 0) {
+        const lastIndex = aggregated.length - 1;
+        aggregated[lastIndex] = Object.assign(Object.assign({}, aggregated[lastIndex]), { amount: round2(aggregated[lastIndex].amount + diff) });
+    }
+    return aggregated.filter((item) => item.amount > 0);
+};
+export const calculateProductTaxBreakdown = ({ product, store, lineTaxAmount, }) => {
+    const applicableTaxes = getApplicableTaxesForProduct(product, store);
+    const target = round2(lineTaxAmount);
+    if (target <= 0 || applicableTaxes.length === 0) {
+        return [];
+    }
+    const amounts = allocateByWeights(Math.round(target * 100), applicableTaxes.map((tax) => tax.weight)).map((amountCents) => round2(amountCents / 100));
+    return normalizeTaxBreakdownToTotal(applicableTaxes.map((tax, index) => {
+        var _a;
+        return ({
+            key: tax.key,
+            name: tax.name,
+            rate: tax.rate,
+            amount: (_a = amounts[index]) !== null && _a !== void 0 ? _a : 0,
+        });
+    }), target);
+};
 export const getProductLineTotals = (productLinesTotals) => {
     const totalQuantity = +productLinesTotals.reduce((acum, line) => acum + line.qty, 0).toFixed(2);
     const totalImportWithDiscount = +productLinesTotals
@@ -101,13 +198,15 @@ export const getProductLineTotals = (productLinesTotals) => {
     const totalSubtotalAmount = +productLinesTotals
         .reduce((acum, line) => acum + line.productLineSubtotal, 0)
         .toFixed(2);
+    const taxBreakdown = normalizeTaxBreakdownToTotal(productLinesTotals.flatMap((line) => line.taxBreakdown || []), totalImporTaxes);
     return {
         totalQuantity,
         totalImportWithDiscount,
         totalImportWithoutDiscount,
         totalImporTaxes,
         totalDiscountAmount,
-        totalSubtotalAmount
+        totalSubtotalAmount,
+        taxBreakdown
     };
 };
 export const getShippingCost = (discountObject, requireShippingService, store) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "washday-sdk",
-  "version": "1.6.63",
+  "version": "1.6.65",
   "description": "Washday utilities functions and API",
   "main": "dist/index.js",
   "type": "module",

package/src/api/companies/get.ts

@@ -1,5 +1,8 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
-import { GetCFDIAddonStatusRequest } from "../../interfaces/Company";
+import {
+  GetAvailableSubscriptionPlansRequest,
+  GetCFDIAddonStatusRequest,
+} from "../../interfaces/Company";
 
 const GET_SET_COMPANIES = 'api/company';
 const GET_SET_BILLING = 'api/billing';
@@ -58,3 +61,27 @@ export const getCFDIAddonStatus = async function (
     throw error;
   }
 };
+
+export const getAvailableSubscriptionPlans = async function (
+  this: WashdayClientInstance,
+  data: GetAvailableSubscriptionPlansRequest = {},
+): Promise<any> {
+  try {
+    const config = {
+      headers: { Authorization: `Bearer ${this.apiToken}` }
+    };
+    const params = new URLSearchParams();
+    if (data.companyId) {
+      params.set("companyId", data.companyId);
+    }
+    const query = params.toString();
+    const response = await this.axiosInstance.get(
+      `${GET_SET_BILLING}/subscription/available-plans${query ? `?${query}` : ""}`,
+      config,
+    );
+    return response;
+  } catch (error) {
+    console.error('Error fetching getAvailableSubscriptionPlans:', error);
+    throw error;
+  }
+};

package/src/api/companies/post.ts

@@ -1,5 +1,9 @@
 import { WashdayClientInstance } from "../../interfaces/Api";
-import { CFDIAddonToggleRequest } from "../../interfaces/Company";
+import {
+    ApplySubscriptionPlanChangeRequest,
+    CFDIAddonToggleRequest,
+    PreviewSubscriptionPlanChangeRequest,
+} from "../../interfaces/Company";
 import axiosInstance from "../axiosInstance";
 const GET_SET_COMPANIES = 'api/company';
 const GET_SET_BILLING = 'api/billing';
@@ -91,3 +95,35 @@ export const disableCFDIAddon = async function (
         throw error;
     }
 }
+
+export const previewSubscriptionPlanChange = async function (
+    this: WashdayClientInstance,
+    data: PreviewSubscriptionPlanChangeRequest
+): Promise<any> {
+    try {
+        const config = {
+            headers: { Authorization: `Bearer ${this.apiToken}` }
+        };
+        const response = await this.axiosInstance.post(`${GET_SET_BILLING}/subscription/change-plan/preview`, data, config);
+        return response;
+    } catch (error) {
+        console.error('Error fetching previewSubscriptionPlanChange:', error);
+        throw error;
+    }
+}
+
+export const changeSubscriptionPlan = async function (
+    this: WashdayClientInstance,
+    data: ApplySubscriptionPlanChangeRequest
+): Promise<any> {
+    try {
+        const config = {
+            headers: { Authorization: `Bearer ${this.apiToken}` }
+        };
+        const response = await this.axiosInstance.post(`${GET_SET_BILLING}/subscription/change-plan`, data, config);
+        return response;
+    } catch (error) {
+        console.error('Error fetching changeSubscriptionPlan:', error);
+        throw error;
+    }
+}

package/src/api/index.ts

@@ -3,8 +3,8 @@ import { deleteCashierBoxById, deleteCashierBoxMovementById } from "./cashierbox
 import { getCashierBoxMovementsHistory, getCashierboxesById, getCashierboxesByStoreId } from "./cashierbox/get";
 import { addCashierBoxMovement, createCashierBox } from "./cashierbox/post";
 import { updateCashierBoxById, updateCashierBoxMovementById } from "./cashierbox/put";
-import { getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "./companies/get";
-import { disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "./companies/post";
+import { getAvailableSubscriptionPlans, getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "./companies/get";
+import { changeSubscriptionPlan, disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, previewSubscriptionPlanChange, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "./companies/post";
 import { updateCompanyById, updateCompanyLogoById, updateCompanySubscriptionBillingInfoById, updateCompanyTaxInfoById, updateGarmentAttributeCatalogsById } from "./companies/put";
 import { getCountries } from "./countries/get";
 import * as configEndpoints from "./config";
@@ -295,6 +295,9 @@ const WashdayClient: WashdayClientConstructor = function WashdayClient(this: Was
         enableCFDIAddon: enableCFDIAddon,
         disableCFDIAddon: disableCFDIAddon,
         getCFDIAddonStatus: getCFDIAddonStatus,
+        getAvailableSubscriptionPlans: getAvailableSubscriptionPlans,
+        previewSubscriptionPlanChange: previewSubscriptionPlanChange,
+        changeSubscriptionPlan: changeSubscriptionPlan,
     });
     this.stripe = bindMethods(this, {
         createCreateSuscriptionCheckoutSession: createCreateSuscriptionCheckoutSession,

package/src/index.ts

@@ -8,6 +8,13 @@ export * from './interfaces/Customer';
 export * from './interfaces/DomainUrls';
 export * from './interfaces/GoogleMaps';
 export * from './interfaces/Attendance';
+export type {
+  IOrderPricingSnapshot,
+  IOrderPricingSnapshotLine,
+  IOrderPricingSnapshotTotals,
+  ITaxBreakdownItem,
+  TaxBreakdownKey,
+} from './interfaces/Order';
 export type { StartMPOAuthFlowRequest } from './api/integrations/post';
 export type {
   CreateCFDISubscriptionCheckoutSessionRequest,

package/src/interfaces/Api.ts

@@ -2,8 +2,8 @@ import { deleteCashierBoxById, deleteCashierBoxMovementById } from "../api/cashi
 import { getCashierBoxMovementsHistory, getCashierboxesById, getCashierboxesByStoreId } from "../api/cashierbox/get";
 import { addCashierBoxMovement, createCashierBox } from "../api/cashierbox/post";
 import { updateCashierBoxById, updateCashierBoxMovementById } from "../api/cashierbox/put";
-import { getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "../api/companies/get";
-import { disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "../api/companies/post";
+import { getAvailableSubscriptionPlans, getCFDIAddonStatus, getCompanyById, getCompanyOrdersMetrics, getGarmentAttributeCatalogs } from "../api/companies/get";
+import { changeSubscriptionPlan, disableBillingOverage, disableCFDIAddon, enableBillingOverage, enableCFDIAddon, previewSubscriptionPlanChange, updateCFDIOrgLogo, updateCompanyTaxInfoCertificates } from "../api/companies/post";
 import { updateCompanyById, updateCompanyLogoById, updateCompanySubscriptionBillingInfoById, updateCompanyTaxInfoById, updateGarmentAttributeCatalogsById } from "../api/companies/put";
 import { getCountries } from "../api/countries/get";
 import * as configEndpoints from "../api/config";
@@ -280,6 +280,9 @@ export interface WashdayClientInstance {
         enableCFDIAddon: typeof enableCFDIAddon;
         disableCFDIAddon: typeof disableCFDIAddon;
         getCFDIAddonStatus: typeof getCFDIAddonStatus;
+        getAvailableSubscriptionPlans: typeof getAvailableSubscriptionPlans;
+        previewSubscriptionPlanChange: typeof previewSubscriptionPlanChange;
+        changeSubscriptionPlan: typeof changeSubscriptionPlan;
     };
     stripe: {
         createCreateSuscriptionCheckoutSession: typeof createCreateSuscriptionCheckoutSession;

package/src/interfaces/Company.ts

@@ -54,7 +54,98 @@ export interface GetCFDIAddonStatusRequest {
     companyId: string;
 }
 
+export type SubscriptionPlanChangePlan = "basic" | "standard" | "premium";
+export type SubscriptionPlanChangeDirection = "upgrade" | "downgrade" | "same_plan";
+export type SubscriptionPlanChangeBehavior =
+    | "immediate_prorated_charge"
+    | "contact_support"
+    | "no_change";
+export type SubscriptionPlanChangeAddon = "cfdi" | "orders_overage";
+
+export interface GetAvailableSubscriptionPlansRequest {
+    companyId?: string;
+}
+
+export interface AvailableSubscriptionPlan {
+    plan: SubscriptionPlanChangePlan;
+    priceId: string;
+    amount: number;
+    currency: string;
+    interval: string | null;
+    displayPrice: string;
+}
+
+export interface AvailableSubscriptionPlansResponse {
+    currentPlan: SubscriptionPlanChangePlan;
+    currentPlanPriceId: string;
+    country: string;
+    currency: string;
+    plans: AvailableSubscriptionPlan[];
+}
+
+export interface PreviewSubscriptionPlanChangeRequest {
+    companyId?: string;
+    targetPlan: SubscriptionPlanChangePlan;
+}
+
+export interface PlanChangePreviewLine {
+    description: string;
+    amount: number;
+    currency: string;
+    amountFormatted?: string;
+    proration?: boolean;
+    priceId?: string;
+    type?: "credit" | "charge" | "tax" | "addon" | "plan";
+}
+
+export interface PlanChangePreviewResponse {
+    status: "preview_ready" | "downgrade_not_supported" | "no_change";
+    currentPlan: SubscriptionPlanChangePlan;
+    targetPlan: SubscriptionPlanChangePlan;
+    direction: SubscriptionPlanChangeDirection;
+    behavior: SubscriptionPlanChangeBehavior;
+    prorationDate?: number;
+    currency: string;
+    amountDueNow: number;
+    amountDueNowFormatted?: string;
+    subtotal?: number;
+    tax?: number | null;
+    total?: number;
+    currentPeriodEnd?: string;
+    nextBillingDate?: string;
+    currentPlanPriceId?: string;
+    targetPlanPriceId: string;
+    preservedAddons: SubscriptionPlanChangeAddon[];
+    lines: PlanChangePreviewLine[];
+    message: string;
+}
+
+export interface ApplySubscriptionPlanChangeRequest {
+    companyId?: string;
+    targetPlan: SubscriptionPlanChangePlan;
+    expectedCurrentPlanPriceId: string;
+    expectedTargetPlanPriceId: string;
+    expectedProrationDate: number;
+    previewIdempotencyKey?: string;
+    idempotencyKey?: string;
+}
+
+export interface ApplySubscriptionPlanChangeResponse {
+    status: "applied" | "requires_payment_action" | "payment_failed" | "pending_update" | "no_change";
+    currentPlan: SubscriptionPlanChangePlan;
+    targetPlan: SubscriptionPlanChangePlan;
+    subscriptionId: string;
+    invoiceId?: string;
+    hostedInvoiceUrl?: string;
+    paymentIntentClientSecret?: string;
+    amountDueNow?: number;
+    currency?: string;
+    currentPeriodEnd?: string;
+    message: string;
+}
+
 export interface IStripeSettings {
+    planPriceId?: string | null;
     stripeCFDISubID: string | null;
     stripeCFDISubItemID: string | null;
     cfdiBillingMode?: CFDIBillingMode;

package/src/interfaces/Order.ts

@@ -46,6 +46,61 @@ export interface IOrderPaymentLines {
     facturapiPaymentInvoiceID?: string | null,
 }
 
+export type TaxBreakdownKey = "taxOne" | "taxTwo" | "taxThree";
+
+export interface ITaxBreakdownItem {
+    key: TaxBreakdownKey;
+    name: string;
+    rate: number;
+    amount: number;
+}
+
+export interface IOrderPricingSnapshotLine {
+    lineId: string;
+    quantity: number;
+    netBeforeDiscount: number;
+    netDiscount: number;
+    netAfterDiscount: number;
+    tax: number;
+    taxBreakdown?: ITaxBreakdownItem[];
+    grossBeforeDiscount: number;
+    gross: number;
+}
+
+export interface IOrderPricingSnapshotTotals {
+    totalQuantity: number;
+    productTotal: number;
+    productTotalWithoutDiscount: number;
+    taxesTotal: number;
+    taxBreakdown?: ITaxBreakdownItem[];
+    shippingServiceTotal: number;
+    orderLevelDiscountGross?: number;
+    discountTotalGrossLines?: number;
+    totalDiscountGross?: number;
+    subtotalBeforeDiscountNet: number;
+    subtotalNetAfterDiscount: number;
+    discountTotalNet: number;
+    creditApplied: number;
+    redeemPointsApplied: number;
+    total: number;
+}
+
+export interface IOrderPricingSnapshot {
+    version: string;
+    engine: string;
+    engineVersion?: string;
+    calculatedAt: Date;
+    currency: string;
+    taxesType: "included" | "over_price";
+    express: boolean;
+    discountCodeId?: string;
+    redeemPointsAsPaymentAmount: number;
+    totalsCents: IOrderPricingSnapshotTotals;
+    lines: IOrderPricingSnapshotLine[];
+    appliedOrderDiscounts: Record<string, number>;
+    meta?: Record<string, any>;
+}
+
 export interface IOrderPhaseCompletion {
     source: RouteOrderCompletionSource,
     confirmedAt?: Date | null,
@@ -73,6 +128,7 @@ export interface IOrder {
     taxThree?: ITaxConfig,
     creditApplied: number,
     taxesTotal: number,
+    taxBreakdown?: ITaxBreakdownItem[],
     total: number,
     totalQuantity: number,
     productTotal: number,
@@ -110,6 +166,7 @@ export interface IOrder {
     appliedDiscountCodes: Array<string> | null,
     paymentLines: Array<IOrderPaymentLines> | Array<string> | any,
     facturapiInvoiceID?: string | null,
+    pricingSnapshot?: IOrderPricingSnapshot | null,
 }
 
 

package/src/interfaces/Product.ts

@@ -2,6 +2,7 @@ import { IStore } from "./Store"
 import { IStoreImage } from "./StoreImage"
 import { IUser } from "./User"
 import { OrderProductLineStatus } from "../enum"
+import type { ITaxBreakdownItem } from "./Order"
 
 export interface ProductLineTotals {
     product: IOrderProduct,
@@ -9,6 +10,7 @@ export interface ProductLineTotals {
     productLineImportTotal: number,
     productLineTotalWithDiscount: number,
     productLineTaxesTotal: number,
+    taxBreakdown?: ITaxBreakdownItem[],
     lineDiscountAmount: number
     productLineSubtotal: number
 }

package/src/utils/orders/calculateOrderTotal.ts

@@ -75,7 +75,8 @@ export const calculateOrderTotal = (
       totalImportWithoutDiscount,
       totalImporTaxes,
       totalDiscountAmount,
-      totalSubtotalAmount
+      totalSubtotalAmount,
+      taxBreakdown
     } = getProductLineTotals(productTableImports);
 
     // === DISCOUNT CODE (monetario tipo NUMBER que se aplica una sola vez) ===
@@ -127,6 +128,7 @@ export const calculateOrderTotal = (
       customerDiscount: order.discountCode ? 0 : selectedCustomer?.customer?.discount,
       productTotal: totalImportWithDiscount,
       taxesTotal: totalImporTaxes,
+      taxBreakdown,
       total: orderTotal,
       creditApplied,
       redeemPointsApplied: redeemPointsDiscount, // ✅ NUEVO CAMPO

package/src/utils/orders/calculateTotalTaxesIncluded.ts

@@ -1,6 +1,6 @@
 import { DiscountCodeTypes } from "../../enum";
 import { IOrderProduct } from "../../interfaces/Product";
-import { getProductTaxesPercentage } from "./helpers";
+import { calculateProductTaxBreakdown, getProductTaxesPercentage } from "./helpers";
 
 const getNormalizedId = (value: any): string => {
   if (value === null || value === undefined) {
@@ -124,6 +124,11 @@ export const calculateTotalTaxesIncluded = (
 
     // Calcular el total de impuestos como la diferencia entre bruto y neto con descuento
     const totalTaxesApplied = +(productLineTotalWithDiscount - productNetTotalWithDiscount).toFixed(2);
+    const taxBreakdown = calculateProductTaxBreakdown({
+      product: current,
+      store: storeSettings,
+      lineTaxAmount: totalTaxesApplied,
+    });
 
     const lineDiscount = +(discountAmountPerUnit * qty).toFixed(2);
 
@@ -133,6 +138,7 @@ export const calculateTotalTaxesIncluded = (
       productLineImportTotal,           // Total bruto sin descuento (incluye extra y IVA)
       productLineTotalWithDiscount,     // Total bruto con descuento aplicado sobre el precio ajustado
       productLineTaxesTotal: totalTaxesApplied,
+      taxBreakdown,
       lineDiscountAmount: lineDiscount,
       productLineSubtotal: productNetTotalWithoutDiscount // Subtotal neto (sin IVA)
     };

package/src/utils/orders/calculateTotalTaxesOverPrice.ts

@@ -1,5 +1,5 @@
 import { BuyAndGetConditionsTypes, DiscountCodeTypes } from "../../enum";
-import { getProductTaxesPercentage } from "./helpers";
+import { calculateProductTaxBreakdown, getProductTaxesPercentage } from "./helpers";
 
 const getNormalizedId = (value: any): string => {
   if (value === null || value === undefined) {
@@ -107,6 +107,11 @@ export const calculateTotalTaxesOverPrice = (
 
     // Resultados finales:
     const totalTaxesApplied = +taxes.toFixed(2);
+    const taxBreakdown = calculateProductTaxBreakdown({
+      product: current,
+      store: storeSettings,
+      lineTaxAmount: totalTaxesApplied,
+    });
     const lineDiscount = +(productDiscount * qty).toFixed(2);
 
     // Precio total con descuento, reaplicando impuestos
@@ -120,6 +125,7 @@ export const calculateTotalTaxesOverPrice = (
       // Total final con descuento, con impuestos incluidos
       productLineTotalWithDiscount: prodLinePriceWithDiscount,
       productLineTaxesTotal: totalTaxesApplied,
+      taxBreakdown,
       lineDiscountAmount: lineDiscount,
       // Subtotal neto (sin impuestos) con descuento aplicado
       productLineSubtotal: subtotal

package/src/utils/orders/helpers.ts

@@ -2,6 +2,7 @@ import { BuyAndGetConditionsTypes, DiscountCodeTypes } from "../../enum";
 import { ICustomer } from "../../interfaces/Customer";
 import { IOrderProduct, ProductLineTotals } from "../../interfaces/Product";
 import { IStore, ITaxConfig } from "../../interfaces/Store";
+import type { ITaxBreakdownItem, TaxBreakdownKey } from "../../interfaces/Order";
 
 const getNormalizedId = (value: any): string => {
   if (value === null || value === undefined) {
@@ -105,6 +106,154 @@ export const getProductTaxesPercentage = (productObj: IOrderProduct, store: ISto
   return tax1 + tax2 + tax3;
 };
 
+const TAX_SLOTS: Array<{
+  key: TaxBreakdownKey;
+  taxField: "taxOne" | "taxTwo" | "taxThree";
+  exemptField: "taxExemptOne" | "taxExemptTwo" | "taxExemptThree";
+}> = [
+  { key: "taxOne", taxField: "taxOne", exemptField: "taxExemptOne" },
+  { key: "taxTwo", taxField: "taxTwo", exemptField: "taxExemptTwo" },
+  { key: "taxThree", taxField: "taxThree", exemptField: "taxExemptThree" },
+];
+
+type ApplicableTax = {
+  key: TaxBreakdownKey;
+  name: string;
+  rate: number;
+  weight: number;
+};
+
+const round2 = (value: number): number =>
+  Math.round((Number(value || 0) + Number.EPSILON) * 100) / 100;
+
+const getApplicableTaxesForProduct = (
+  productObj: IOrderProduct,
+  store: IStore
+): ApplicableTax[] => {
+  return TAX_SLOTS.reduce<ApplicableTax[]>((acc, slot) => {
+    if (productObj[slot.exemptField]) {
+      return acc;
+    }
+
+    const tax = store[slot.taxField] as ITaxConfig | undefined;
+    const rate = Number(tax?.value ?? 0);
+    if (!Number.isFinite(rate) || rate <= 0) {
+      return acc;
+    }
+
+    acc.push({
+      key: slot.key,
+      name: String(tax?.name ?? slot.key),
+      rate,
+      weight: Math.round(rate * 100),
+    });
+    return acc;
+  }, []);
+};
+
+const allocateByWeights = (total: number, weights: number[]): number[] => {
+  if (weights.length === 0) return [];
+  if (total <= 0) return new Array(weights.length).fill(0);
+
+  const safeWeights = weights.map((weight) => Math.max(0, Math.trunc(weight)));
+  const sum = safeWeights.reduce((acc, weight) => acc + weight, 0);
+  if (sum <= 0) return new Array(weights.length).fill(0);
+
+  const raw = safeWeights.map((weight) => (total * weight) / sum);
+  const floors = raw.map((amount) => Math.floor(amount));
+  let remaining = total - floors.reduce((acc, amount) => acc + amount, 0);
+  const order = raw
+    .map((amount, index) => ({ index, frac: amount - Math.floor(amount) }))
+    .sort((a, b) => b.frac - a.frac);
+
+  const out = floors.slice();
+  for (let index = 0; index < order.length && remaining > 0; index += 1) {
+    out[order[index].index] += 1;
+    remaining -= 1;
+  }
+  return out;
+};
+
+export const aggregateTaxBreakdown = (
+  items: ITaxBreakdownItem[]
+): ITaxBreakdownItem[] => {
+  const byKey = new Map<TaxBreakdownKey, ITaxBreakdownItem>();
+
+  items.forEach((item) => {
+    if (!item || Number(item.amount || 0) <= 0) {
+      return;
+    }
+    const existing = byKey.get(item.key);
+    if (existing) {
+      existing.amount = round2(existing.amount + item.amount);
+      return;
+    }
+    byKey.set(item.key, { ...item, amount: round2(item.amount) });
+  });
+
+  return TAX_SLOTS.map((slot) => byKey.get(slot.key)).filter(
+    (item): item is ITaxBreakdownItem => Boolean(item && item.amount > 0)
+  );
+};
+
+export const normalizeTaxBreakdownToTotal = (
+  items: ITaxBreakdownItem[],
+  total: number
+): ITaxBreakdownItem[] => {
+  const target = round2(total);
+  if (target <= 0) {
+    return [];
+  }
+
+  const aggregated = aggregateTaxBreakdown(items);
+  if (aggregated.length === 0) {
+    return [];
+  }
+
+  const sum = round2(aggregated.reduce((acc, item) => acc + item.amount, 0));
+  const diff = round2(target - sum);
+  if (diff !== 0) {
+    const lastIndex = aggregated.length - 1;
+    aggregated[lastIndex] = {
+      ...aggregated[lastIndex],
+      amount: round2(aggregated[lastIndex].amount + diff),
+    };
+  }
+
+  return aggregated.filter((item) => item.amount > 0);
+};
+
+export const calculateProductTaxBreakdown = ({
+  product,
+  store,
+  lineTaxAmount,
+}: {
+  product: IOrderProduct;
+  store: IStore;
+  lineTaxAmount: number;
+}): ITaxBreakdownItem[] => {
+  const applicableTaxes = getApplicableTaxesForProduct(product, store);
+  const target = round2(lineTaxAmount);
+  if (target <= 0 || applicableTaxes.length === 0) {
+    return [];
+  }
+
+  const amounts = allocateByWeights(
+    Math.round(target * 100),
+    applicableTaxes.map((tax) => tax.weight)
+  ).map((amountCents) => round2(amountCents / 100));
+
+  return normalizeTaxBreakdownToTotal(
+    applicableTaxes.map((tax, index) => ({
+      key: tax.key,
+      name: tax.name,
+      rate: tax.rate,
+      amount: amounts[index] ?? 0,
+    })),
+    target
+  );
+};
+
 export const getProductLineTotals = (productLinesTotals: ProductLineTotals[]) => {
   const totalQuantity = +productLinesTotals.reduce((acum, line) => acum + line.qty, 0).toFixed(2);
   const totalImportWithDiscount = +productLinesTotals
@@ -122,6 +271,10 @@ export const getProductLineTotals = (productLinesTotals: ProductLineTotals[]) =>
   const totalSubtotalAmount = +productLinesTotals
     .reduce((acum, line) => acum + line.productLineSubtotal, 0)
     .toFixed(2);
+  const taxBreakdown = normalizeTaxBreakdownToTotal(
+    productLinesTotals.flatMap((line) => line.taxBreakdown || []),
+    totalImporTaxes
+  );
 
   return {
     totalQuantity,
@@ -129,7 +282,8 @@ export const getProductLineTotals = (productLinesTotals: ProductLineTotals[]) =>
     totalImportWithoutDiscount,
     totalImporTaxes,
     totalDiscountAmount,
-    totalSubtotalAmount
+    totalSubtotalAmount,
+    taxBreakdown
   };
 };
 

package/test/companies.subscriptionPlanChange.test.ts

@@ -0,0 +1,92 @@
+import { getAvailableSubscriptionPlans } from "../src/api/companies/get";
+import {
+  changeSubscriptionPlan,
+  previewSubscriptionPlanChange,
+} from "../src/api/companies/post";
+import type {
+  ApplySubscriptionPlanChangeRequest,
+  PlanChangePreviewResponse,
+} from "../src/interfaces/Company";
+
+describe("subscription plan change company endpoints", () => {
+  it("fetches available plans through the billing endpoint", async () => {
+    const get = jest.fn().mockResolvedValue({ data: { data: { plans: [] } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { get },
+    } as any;
+
+    await getAvailableSubscriptionPlans.call(client, { companyId: "company-1" });
+
+    expect(get).toHaveBeenCalledWith(
+      "api/billing/subscription/available-plans?companyId=company-1",
+      { headers: { Authorization: "Bearer token-1" } },
+    );
+  });
+
+  it("fetches available plans without sending an undefined companyId", async () => {
+    const get = jest.fn().mockResolvedValue({ data: { data: { plans: [] } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { get },
+    } as any;
+
+    await getAvailableSubscriptionPlans.call(client, {});
+
+    expect(get).toHaveBeenCalledWith(
+      "api/billing/subscription/available-plans",
+      { headers: { Authorization: "Bearer token-1" } },
+    );
+  });
+
+  it("previews a subscription plan change through the billing endpoint", async () => {
+    const post = jest.fn().mockResolvedValue({
+      data: {
+        data: {
+          status: "preview_ready",
+          prorationDate: 1770000000,
+        } satisfies Partial<PlanChangePreviewResponse>,
+      },
+    });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+
+    await previewSubscriptionPlanChange.call(client, {
+      companyId: "company-1",
+      targetPlan: "premium",
+    });
+
+    expect(post).toHaveBeenCalledWith(
+      "api/billing/subscription/change-plan/preview",
+      { companyId: "company-1", targetPlan: "premium" },
+      { headers: { Authorization: "Bearer token-1" } },
+    );
+  });
+
+  it("applies a subscription plan change with expected preview fields", async () => {
+    const post = jest.fn().mockResolvedValue({ data: { data: { status: "applied" } } });
+    const client = {
+      apiToken: "token-1",
+      axiosInstance: { post },
+    } as any;
+    const payload: ApplySubscriptionPlanChangeRequest = {
+      companyId: "company-1",
+      targetPlan: "premium",
+      expectedCurrentPlanPriceId: "price_standard",
+      expectedTargetPlanPriceId: "price_premium",
+      expectedProrationDate: 1770000000,
+      previewIdempotencyKey: "preview-1",
+      idempotencyKey: "apply-1",
+    };
+
+    await changeSubscriptionPlan.call(client, payload);
+
+    expect(post).toHaveBeenCalledWith(
+      "api/billing/subscription/change-plan",
+      payload,
+      { headers: { Authorization: "Bearer token-1" } },
+    );
+  });
+});

package/test/orders.calculateOrderTotalTaxBreakdown.test.ts

@@ -0,0 +1,147 @@
+import { utils } from "../src";
+
+const selectedCustomer = {
+  customer: {
+    credit: 0,
+    discount: 0,
+  },
+};
+
+describe("calculateOrderTotal taxBreakdown", () => {
+  it("over_price adds taxBreakdown without changing existing totals", () => {
+    const result = utils.calculateOrderTotal(
+      {
+        express: false,
+        products: [
+          { _id: "p1", qty: 1, quantity: 1, price: 100, expressPrice: 100, extraAmount: 0 },
+          {
+            _id: "p2",
+            qty: 1,
+            quantity: 1,
+            price: 100,
+            expressPrice: 100,
+            extraAmount: 0,
+            taxExemptOne: true,
+          },
+        ],
+        buyAndGetProducts: [],
+        discountCode: null,
+      },
+      selectedCustomer as any,
+      {
+        taxesType: "over_price",
+        taxOne: { name: "IVA", value: 16 },
+        taxTwo: { name: "Local", value: 3 },
+        orderPageConfig: { shippingServiceCost: 0 },
+      } as any,
+      false,
+      [],
+      null,
+      0
+    );
+
+    expect(result.taxesTotal).toBe(22);
+    expect(result.total).toBe(222);
+    expect(result.taxBreakdown).toEqual([
+      { key: "taxOne", name: "IVA", rate: 16, amount: 16 },
+      { key: "taxTwo", name: "Local", rate: 3, amount: 6 },
+    ]);
+  });
+
+  it("included distributes extracted tax across all configured taxes", () => {
+    const result = utils.calculateOrderTotal(
+      {
+        express: false,
+        products: [{ _id: "p", qty: 1, quantity: 1, price: 120, expressPrice: 120, extraAmount: 0 }],
+        buyAndGetProducts: [],
+        discountCode: null,
+      },
+      selectedCustomer as any,
+      {
+        taxesType: "included",
+        taxOne: { name: "IVA", value: 16 },
+        taxTwo: { name: "Local", value: 3 },
+        taxThree: { name: "Eco", value: 1 },
+        orderPageConfig: { shippingServiceCost: 0 },
+      } as any,
+      false,
+      [],
+      null,
+      0
+    );
+
+    expect(result.taxesTotal).toBe(20);
+    expect(result.total).toBe(120);
+    expect(result.taxBreakdown).toEqual([
+      { key: "taxOne", name: "IVA", rate: 16, amount: 16 },
+      { key: "taxTwo", name: "Local", rate: 3, amount: 3 },
+      { key: "taxThree", name: "Eco", rate: 1, amount: 1 },
+    ]);
+  });
+
+  it("returns empty taxBreakdown when no tax amount remains after a free item promo", () => {
+    const result = utils.calculateOrderTotal(
+      {
+        express: false,
+        products: [
+          {
+            _id: "p",
+            qty: 1,
+            quantity: 1,
+            price: 100,
+            expressPrice: 100,
+            extraAmount: 0,
+            isBuyAndGetProduct: true,
+          },
+        ],
+        buyAndGetProducts: [],
+        discountCode: "discount-1",
+      },
+      selectedCustomer as any,
+      {
+        taxesType: "over_price",
+        taxOne: { name: "IVA", value: 16 },
+        orderPageConfig: { shippingServiceCost: 0 },
+      } as any,
+      false,
+      [],
+      {
+        type: "buyXGetY",
+        buyAndGetConditions: [{ getDiscountType: "free", discountValue: 0 }],
+      },
+      0
+    );
+
+    expect(result.taxesTotal).toBe(0);
+    expect(result.taxBreakdown).toEqual([]);
+  });
+
+  it("over_price preserves one-cent rounded total tax across low-value multi-tax lines", () => {
+    const result = utils.calculateOrderTotal(
+      {
+        express: false,
+        products: [{ _id: "p", qty: 1, quantity: 1, price: 0.17, expressPrice: 0.17, extraAmount: 0 }],
+        buyAndGetProducts: [],
+        discountCode: null,
+      },
+      selectedCustomer as any,
+      {
+        taxesType: "over_price",
+        taxOne: { name: "T1", value: 1 },
+        taxTwo: { name: "T2", value: 1 },
+        taxThree: { name: "T3", value: 1 },
+        orderPageConfig: { shippingServiceCost: 0 },
+      } as any,
+      false,
+      [],
+      null,
+      0
+    );
+
+    const breakdownTotal = result.taxBreakdown.reduce((sum: number, item: any) => sum + item.amount, 0);
+
+    expect(result.taxesTotal).toBe(0.01);
+    expect(result.taxBreakdown.length).toBeGreaterThan(0);
+    expect(+breakdownTotal.toFixed(2)).toBe(result.taxesTotal);
+  });
+});