platform-types 1.10.802 → 1.10.804

package/dist/account.d.ts

@@ -183,6 +183,11 @@ declare global {
          */
         paymentRefSource?: PaymentReceivedSource;
         paymentRefId?: string;
+        /**
+         * On a refund obligation's in-transit debit (SK `RIT#{obligationId}`, `paymentRef*` naming the linked
+         * payment): the obligation whose refund the debit books. Absent on every other row.
+         */
+        refundObligationId?: string;
     }
     /**
      * `POST /account` — a new customer-ledger movement. Mirrors the request side of

package/dist/audit.d.ts

@@ -164,6 +164,19 @@ declare global {
      * words stay on the attempt row.
      */
      | 'payment_attempt_resolved'
+    /**
+     * An operator closed one of the order's refund obligations (`POST /refund-obligations { mode: 'close' }`).
+     * `before`: `obligationId`, `state`, `holdReason?`. `after`: `obligationId`, `state` (`'closed'`), `by`
+     * (`'operator'`), `payout` (`'drawer'` | `'none'`) and the operator's reason as `'[present]'` |
+     * `'[absent]'` — presence only, the words stay on the obligation's `closure`.
+     */
+     | 'refund_obligation_closed'
+    /**
+     * An operator reopened one of the order's refund obligations held behind a `reimbursed` chargeback
+     * (`POST /refund-obligations { mode: 'reopen' }`). `before`: `obligationId`, `state` (`'held'`),
+     * `holdReason`. `after`: `obligationId`, `state`, `refundDueAt?` and the reason by presence only.
+     */
+     | 'refund_obligation_reopened'
     /** HISTORICAL: written only by the removed outbound MercadoPago refund; kept so old timeline rows still parse. */
      | 'payment_refunded'
     /** At least one till tender leg was appended (an absorbed replay writes none). */

package/dist/cjs/refundObligation.js

@@ -8,15 +8,16 @@
  * order) and closes on its own when Mercado Pago reports the refund, when an
  * operator closes a payment attempt's resolution as `refunded`, or when a
  * chargeback settled the money back. An open dispute holds it; a lifted dispute
- * reopens it. Nothing here moves money or writes a ledger row: closure records a
- * fact.
+ * reopens it. Closure moves no money and writes no ledger row: it records a fact.
+ * The one ledger write is the creator's in-transit debit of a linked payment's
+ * credit ({@link RefundObligationLedgerCredit}), at creation.
  *
  * ⚠️ The stored row carries none of the main table's index-key attributes
  * (`status`, `customerId`, `dated`, `updatedAt`, `terminalId`, `inboxKey`), so it
  * joins no GSI: `state` replaces `status`, `revisedAt` replaces `updatedAt`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REFUND_OBLIGATION_DUE_SOURCE = exports.REFUND_OBLIGATION_CLOSED_BY = exports.REFUND_OBLIGATION_HOLD_REASONS = exports.REFUND_OBLIGATION_STATES = exports.REFUND_OBLIGATION_KINDS = void 0;
+exports.REFUND_OBLIGATION_PAYOUTS = exports.REFUND_OBLIGATION_ACTION_MODES = exports.REFUND_OBLIGATION_LIST_FILTERS = exports.REFUND_OBLIGATION_REASON_MAX = exports.REFUND_OBLIGATION_DUE_SOURCE = exports.REFUND_OBLIGATION_CLOSED_BY = exports.REFUND_OBLIGATION_HOLD_REASONS = exports.REFUND_OBLIGATION_STATES = exports.REFUND_OBLIGATION_KINDS = void 0;
 /**
  * - `provider` — paid through Mercado Pago; closes when the provider reports the
  *   refund (`paymentId` is set).
@@ -40,7 +41,8 @@ exports.REFUND_OBLIGATION_STATES = ['awaiting-goods', 'open', 'overdue', 'held',
  * Why an obligation is `held`. `dispute-open` reopens on its own once the
  * dispute is lifted; `reimbursed` (Mercado Pago covered the seller) never does —
  * only an operator's decision moves it. A stored row with no `holdReason` reads
- * as `dispute-open`.
+ * as `dispute-open`. Once the operator reopened a `reimbursed` hold
+ * (`reimbursedDecision`), that chargeback no longer holds the obligation.
  */
 exports.REFUND_OBLIGATION_HOLD_REASONS = ['dispute-open', 'reimbursed'];
 /**
@@ -63,3 +65,14 @@ exports.REFUND_OBLIGATION_CLOSED_BY = [
 ];
 /** Where a {@link StatutoryInstant} came from: the platform global it was computed with. */
 exports.REFUND_OBLIGATION_DUE_SOURCE = 'global:refundObligationDueDays';
+/** The longest operator `reason` `POST /refund-obligations` accepts, in characters after trimming. */
+exports.REFUND_OBLIGATION_REASON_MAX = 500;
+/**
+ * The `state` filter of `GET /refund-obligations`: one {@link RefundObligationState}, or `pending` — every
+ * state but `closed`, the operator's working queue.
+ */
+exports.REFUND_OBLIGATION_LIST_FILTERS = [...exports.REFUND_OBLIGATION_STATES, 'pending'];
+/** The modes of `POST /refund-obligations`. */
+exports.REFUND_OBLIGATION_ACTION_MODES = ['close', 'reopen'];
+/** The one payout `POST /refund-obligations { mode: 'close' }` can record: cash from the operator's till. */
+exports.REFUND_OBLIGATION_PAYOUTS = ['drawer'];

package/dist/cjs/socket.js

@@ -734,6 +734,10 @@ exports.isSocketAction = isSocketAction;
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
 exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -745,6 +749,7 @@ exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'catalogStatus',
     'updatedAt',
     'lastMovementAt',
+    'ivaType',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/cjs/storefrontDesignRegistry.js

@@ -114,12 +114,15 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
-const liveToggle = (key, labelKey, helpKey, label, help) => ({
+const liveToggle = (key, labelKey, helpKey, label, help, 
+// Per key: a toggle that changes what a shopper sees for every store that has
+// never written it ships `false`. Defaults to `true`, the three original toggles.
+defaultValue = true) => ({
     ...LIVE_METADATA,
     key,
     allowedLayers: ['WEB#store'],
     storage: { source: 'store', override: 'ecommerce.config' },
-    defaultValue: true,
+    defaultValue,
     valueType: 'boolean',
     valueSchema: { type: 'boolean' },
     literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
@@ -145,6 +148,13 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
         showIvaAlert: liveToggle('showIvaAlert', 'STOREFRONT_SHOW_IVA_ALERT_LABEL', 'STOREFRONT_SHOW_IVA_ALERT_HELP', 'Mostrar aviso de IVA', 'Mostrar el aviso de IVA incluido en los precios.'),
         showCurrencySelector: liveToggle('showCurrencySelector', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_LABEL', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_HELP', 'Mostrar selector de moneda', 'Permitir elegir la moneda de visualización en la tienda.'),
         enableSaveForLater: liveToggle('enableSaveForLater', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_LABEL', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_HELP', 'Permitir guardar para después', 'Mostrar los controles para guardar productos de la cesta para después.'),
+        /*
+         * Display only: every public price slot carries `netOfIva` whatever this says
+         * (absent only for a product with no declarable IVA rate), so a flip needs no
+         * catalogue refetch. The storefront shows the «+ IVA» line when this is on AND
+         * the block is present. Default off: a store opts in.
+         */
+        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Mostrar también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },

package/dist/pricing.d.ts

@@ -109,5 +109,43 @@ declare global {
         promo?: PricePromo;
         visibleOnStorefront?: boolean;
     } & CurrencyStamp);
+    /**
+     * Net-of-IVA display figures for one public price slot, computed server-side
+     * as `calculateItemNeto(figure, 1, ivaPercent, 1, 'decimal').neto` from the
+     * product's `ivaType`, each figure first rounded to the store's `priceDecimals`
+     * as it is charged — for a unit in the voucher's currency, the per-unit `neto`
+     * a new invoice prints for the same undiscounted unit (gross rounded to 2 dp
+     * first, then backed out). Absent, too, when a figure cannot be netted.
+     *
+     * ⚠️ DISPLAY ONLY: nothing charges, quotes, totals or invoices these. The
+     * charged figure is the slot's `amount`, always.
+     *
+     * Each net shares the stamp of the gross it nets, with no FX step: `amount`
+     * and `baseAmount` the slot's, `promo` the promo's, each break its own.
+     *
+     * Sent whatever `ecommerce.config.showNetPlusIva` says; that setting only
+     * decides whether the storefront renders it. ABSENT when the product carries
+     * no declarable IVA rate — never a 0 % fallback.
+     */
+    interface PublicPriceNet {
+        amount: number;
+        /** Present iff the slot carries `baseAmount`. */
+        baseAmount?: number;
+        /** Net of `promo.amount`; present iff the slot carries `promo`. */
+        promo?: number;
+        /** One per `breaks` entry of the slot, same `minQty`, same order. */
+        breaks?: Array<{
+            minQty: number;
+            amount: number;
+        }>;
+    }
+    /**
+     * A price slot as a PUBLIC read emits it (web catalogue reads, customer
+     * `products` frames). A read-time extension of {@link PriceSlot}, never
+     * stored: `Product.prices` stays `PriceSlot[]`, so no writer can persist a net.
+     */
+    type PublicPriceSlot = PriceSlot & {
+        netOfIva?: PublicPriceNet;
+    };
 }
 export {};

package/dist/product.d.ts

@@ -32,8 +32,10 @@ declare global {
     type ProductUnitsInput = Omit<ProductUnits, 'unitRevision'>;
     /** The display declaration plus the purchase-unit factor; `unitRevision` stays server-only. */
     type PublicProductUnits = Pick<ProductUnits, 'baseUnit' | 'purchaseUnit' | 'packLabel' | 'baseUnitsPerPurchaseUnit'>;
-    type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration'> & {
+    type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration' | 'prices'> & {
         units?: PublicProductUnits | null;
+        /** The shopper's one applicable slot, with its read-time `netOfIva` when the product is rated. */
+        prices?: PublicPriceSlot[];
     };
     /** Anonymous Web GET /products lookup; the tenant comes from the public store context. */
     interface PublicProductsByIdsInput {

package/dist/refundObligation.d.ts

@@ -7,8 +7,9 @@
  * order) and closes on its own when Mercado Pago reports the refund, when an
  * operator closes a payment attempt's resolution as `refunded`, or when a
  * chargeback settled the money back. An open dispute holds it; a lifted dispute
- * reopens it. Nothing here moves money or writes a ledger row: closure records a
- * fact.
+ * reopens it. Closure moves no money and writes no ledger row: it records a fact.
+ * The one ledger write is the creator's in-transit debit of a linked payment's
+ * credit ({@link RefundObligationLedgerCredit}), at creation.
  *
  * ⚠️ The stored row carries none of the main table's index-key attributes
  * (`status`, `customerId`, `dated`, `updatedAt`, `terminalId`, `inboxKey`), so it
@@ -37,7 +38,8 @@ export declare const REFUND_OBLIGATION_STATES: readonly ["awaiting-goods", "open
  * Why an obligation is `held`. `dispute-open` reopens on its own once the
  * dispute is lifted; `reimbursed` (Mercado Pago covered the seller) never does —
  * only an operator's decision moves it. A stored row with no `holdReason` reads
- * as `dispute-open`.
+ * as `dispute-open`. Once the operator reopened a `reimbursed` hold
+ * (`reimbursedDecision`), that chargeback no longer holds the obligation.
  */
 export declare const REFUND_OBLIGATION_HOLD_REASONS: readonly ["dispute-open", "reimbursed"];
 /**
@@ -54,6 +56,17 @@ export declare const REFUND_OBLIGATION_HOLD_REASONS: readonly ["dispute-open", "
 export declare const REFUND_OBLIGATION_CLOSED_BY: readonly ["detected-refund", "resolution-refunded", "operator", "chargeback", "api-refund"];
 /** Where a {@link StatutoryInstant} came from: the platform global it was computed with. */
 export declare const REFUND_OBLIGATION_DUE_SOURCE = "global:refundObligationDueDays";
+/** The longest operator `reason` `POST /refund-obligations` accepts, in characters after trimming. */
+export declare const REFUND_OBLIGATION_REASON_MAX = 500;
+/**
+ * The `state` filter of `GET /refund-obligations`: one {@link RefundObligationState}, or `pending` — every
+ * state but `closed`, the operator's working queue.
+ */
+export declare const REFUND_OBLIGATION_LIST_FILTERS: readonly ["awaiting-goods", "open", "overdue", "held", "closed", "pending"];
+/** The modes of `POST /refund-obligations`. */
+export declare const REFUND_OBLIGATION_ACTION_MODES: readonly ["close", "reopen"];
+/** The one payout `POST /refund-obligations { mode: 'close' }` can record: cash from the operator's till. */
+export declare const REFUND_OBLIGATION_PAYOUTS: readonly ["drawer"];
 declare global {
     type RefundObligationKind = (typeof REFUND_OBLIGATION_KINDS)[number];
     type RefundObligationState = (typeof REFUND_OBLIGATION_STATES)[number];
@@ -66,12 +79,32 @@ declare global {
         /** The rule it was computed from, e.g. `global:refundObligationDueDays`. */
         source: string;
     }
-    /** The link credit an obligation's money was booked to, when there is one. */
+    /**
+     * The payment-link credit an obligation's money was booked to, when there is one: the customer's ledger
+     * still holds it as a credit, so the creator debits the share being refunded ("in transit") in its own
+     * transaction, one `ACCOUNT#` row per obligation.
+     */
     interface RefundObligationLedgerCredit {
-        /** The `ACCOUNT#{storeId}` row's SK. */
+        /** The `ACCOUNT#{storeId}` credit row's SK — the per-source payment row's `accountId`. */
         accountId: string;
         /** The customer whose balance the credit moved. */
         customerId: string;
+        /** The partition of the payment the credit came from. */
+        source: PaymentReceivedSource;
+        /** The payment the credit came from: the per-source row's SK. */
+        paymentId: string;
+    }
+    /**
+     * The operator's decision that a `reimbursed` chargeback does not discharge the obligation (`POST
+     * /refund-obligations { mode: 'reopen' }`). While it stands, the payment's `reimbursed` chargeback no
+     * longer holds the obligation; a later hold (a new dispute) removes it.
+     */
+    interface RefundObligationReimbursedDecision {
+        by: 'operator';
+        /** Unix ms. */
+        at: number;
+        /** The store user who decided. */
+        actor?: string;
     }
     /** How an obligation was closed. */
     interface RefundObligationClosure {
@@ -111,6 +144,8 @@ declare global {
         holdReason?: RefundObligationHoldReason;
         /** The state a hold came from; a reopen returns to it (`overdue` returns to `open`). */
         heldFrom?: Exclude<RefundObligationState, 'held' | 'closed'>;
+        /** Set by the operator's reopen of a `reimbursed` hold; removed by any later hold. */
+        reimbursedDecision?: RefundObligationReimbursedDecision;
         /** Bumped by every move, for a compare-and-set. */
         revision: number;
         /** When the refund is due. Set by the move to `open`; removed by a hold. */
@@ -123,5 +158,75 @@ declare global {
         /** Unix ms of the last move. */
         revisedAt: number;
     }
+    type RefundObligationListFilter = (typeof REFUND_OBLIGATION_LIST_FILTERS)[number];
+    /**
+     * The query of `GET /refund-obligations` (App host, `staffToken`, the `payments` capability). Reads the
+     * token's store only, in obligation-id order (`orderId` first).
+     */
+    interface RefundObligationListQuery {
+        state?: RefundObligationListFilter;
+        /** Only this order's obligations (`ORD` plus 6–10 digits). */
+        orderId?: string;
+        /** Rows EVALUATED per page, 1–100 (default 25): a page can be short or empty with `nextCursor` present. */
+        limit?: number;
+        /** The previous page's `nextCursor`, bound to the store and to `state` + `orderId`. */
+        cursor?: string;
+    }
+    /**
+     * `data` of `GET /refund-obligations`. Page on `nextCursor`'s presence, never on the page's length. A
+     * `held` row always carries `holdReason` (a stored row with none reads as `dispute-open`): an open dispute
+     * offers no action; a `reimbursed` one awaits the operator's close or reopen.
+     */
+    interface RefundObligationListResponse {
+        obligations: RefundObligation[];
+        /** Opaque. Absent on the last page. */
+        nextCursor?: string;
+    }
+    /**
+     * `POST /refund-obligations` (App host, `adminToken`, the `payments` capability). Strict body.
+     *
+     * - `close` — the operator settled it: `closure.by: 'operator'`. From `open`, `overdue`, `awaiting-goods`
+     *   or a `reimbursed` hold; never from a `dispute-open` hold. `reason` is required for an `offline` one
+     *   and stored on `closure`. `payout: 'drawer'` (an `offline` one only) records the cash leaving the
+     *   operator's till as one drawer `refund` event in the same transaction.
+     * - `reopen` — a `reimbursed` hold the operator decides is still owed: back to the state it was held
+     *   from, with a fresh `refundDueAt` when that is `open`, and `reimbursedDecision` recorded so the same
+     *   `reimbursed` chargeback never holds it again.
+     *
+     * `expectedRevision` is the `revision` of the row the operator acted on.
+     */
+    type RefundObligationActionRequest = {
+        mode: 'close';
+        /** The obligation's `obligationId`: `{orderId}#{parentId}#{kind}#{paymentId | 'till'}`, else 400. */
+        obligationId: string;
+        expectedRevision: number;
+        /** 1–{@link REFUND_OBLIGATION_REASON_MAX} characters after trimming. Required for `offline`. */
+        reason?: string;
+        payout?: (typeof REFUND_OBLIGATION_PAYOUTS)[number];
+    } | {
+        mode: 'reopen';
+        /** The obligation's `obligationId`: `{orderId}#{parentId}#{kind}#{paymentId | 'till'}`, else 400. */
+        obligationId: string;
+        expectedRevision: number;
+        /** 1–{@link REFUND_OBLIGATION_REASON_MAX} characters after trimming. Recorded by presence only. */
+        reason?: string;
+    };
+    /** `data` of a successful `POST /refund-obligations`: the obligation as it now stands. */
+    interface RefundObligationActionResponse {
+        obligation: RefundObligation;
+    }
+    /** `data` of `409 REFUND_OBLIGATION_CHANGED`: the obligation as it now stands — review it and resend. */
+    interface RefundObligationChangedData {
+        obligation: RefundObligation;
+    }
+    /**
+     * `data` of `409 REFUND_OBLIGATION_NOT_ACTIONABLE`: the state that refuses the mode — `closed` (with its
+     * `closure`, so a replay after success reads what it did), or `held` with its `holdReason`.
+     */
+    interface RefundObligationNotActionableData {
+        state: RefundObligationState;
+        holdReason?: RefundObligationHoldReason;
+        closure?: RefundObligationClosure;
+    }
 }
 export {};

package/dist/refundObligation.js

@@ -7,8 +7,9 @@
  * order) and closes on its own when Mercado Pago reports the refund, when an
  * operator closes a payment attempt's resolution as `refunded`, or when a
  * chargeback settled the money back. An open dispute holds it; a lifted dispute
- * reopens it. Nothing here moves money or writes a ledger row: closure records a
- * fact.
+ * reopens it. Closure moves no money and writes no ledger row: it records a fact.
+ * The one ledger write is the creator's in-transit debit of a linked payment's
+ * credit ({@link RefundObligationLedgerCredit}), at creation.
  *
  * ⚠️ The stored row carries none of the main table's index-key attributes
  * (`status`, `customerId`, `dated`, `updatedAt`, `terminalId`, `inboxKey`), so it
@@ -37,7 +38,8 @@ export const REFUND_OBLIGATION_STATES = ['awaiting-goods', 'open', 'overdue', 'h
  * Why an obligation is `held`. `dispute-open` reopens on its own once the
  * dispute is lifted; `reimbursed` (Mercado Pago covered the seller) never does —
  * only an operator's decision moves it. A stored row with no `holdReason` reads
- * as `dispute-open`.
+ * as `dispute-open`. Once the operator reopened a `reimbursed` hold
+ * (`reimbursedDecision`), that chargeback no longer holds the obligation.
  */
 export const REFUND_OBLIGATION_HOLD_REASONS = ['dispute-open', 'reimbursed'];
 /**
@@ -60,3 +62,14 @@ export const REFUND_OBLIGATION_CLOSED_BY = [
 ];
 /** Where a {@link StatutoryInstant} came from: the platform global it was computed with. */
 export const REFUND_OBLIGATION_DUE_SOURCE = 'global:refundObligationDueDays';
+/** The longest operator `reason` `POST /refund-obligations` accepts, in characters after trimming. */
+export const REFUND_OBLIGATION_REASON_MAX = 500;
+/**
+ * The `state` filter of `GET /refund-obligations`: one {@link RefundObligationState}, or `pending` — every
+ * state but `closed`, the operator's working queue.
+ */
+export const REFUND_OBLIGATION_LIST_FILTERS = [...REFUND_OBLIGATION_STATES, 'pending'];
+/** The modes of `POST /refund-obligations`. */
+export const REFUND_OBLIGATION_ACTION_MODES = ['close', 'reopen'];
+/** The one payout `POST /refund-obligations { mode: 'close' }` can record: cash from the operator's till. */
+export const REFUND_OBLIGATION_PAYOUTS = ['drawer'];

package/dist/socket.d.ts

@@ -172,8 +172,12 @@ export interface SocketMessage<T = unknown> {
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
-export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt"];
+export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType"];
 /**
  * `data` of a **partial** `products` frame — the projection every stock-moving
  * write announces, and the only `products` shape that is not a whole `Product`.

package/dist/socket.js

@@ -730,6 +730,10 @@ export const isSocketAction = (value) => typeof value === 'string' && SOCKET_ACT
  * {@link ProductRemovedFrameData} marker instead of a priced patch.
  * `catalogStatus` is carried for the same reason: a stock movement on a draft or
  * archived product becomes that marker too, never a republished row.
+ *
+ * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
+ * fan-out re-prices the frame, and without the rate a merged frame would leave a
+ * stale net beside a new gross. The customer copy still drops the Id itself.
  */
 export const PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -741,6 +745,7 @@ export const PRODUCT_STOCK_FRAME_FIELDS = [
     'catalogStatus',
     'updatedAt',
     'lastMovementAt',
+    'ivaType',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/storefrontDesignRegistry.d.ts

@@ -1035,7 +1035,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1061,7 +1061,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1087,7 +1087,7 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
                 readonly source: "store";
                 readonly override: "ecommerce.config";
             };
-            readonly defaultValue: true;
+            readonly defaultValue: boolean;
             readonly valueType: "boolean";
             readonly valueSchema: {
                 readonly type: "boolean";
@@ -1106,6 +1106,32 @@ export declare const STOREFRONT_DESIGN_REGISTRY: {
             readonly ownership: "storefront-operation";
             readonly excludedFromSnapshot: true;
         };
+        readonly showNetPlusIva: {
+            readonly key: "showNetPlusIva";
+            readonly allowedLayers: readonly ["WEB#store"];
+            readonly storage: {
+                readonly source: "store";
+                readonly override: "ecommerce.config";
+            };
+            readonly defaultValue: boolean;
+            readonly valueType: "boolean";
+            readonly valueSchema: {
+                readonly type: "boolean";
+            };
+            readonly literal: {
+                readonly kind: "key";
+                readonly label: "STOREFRONT_SHOW_NET_PLUS_IVA_LABEL";
+                readonly help: "STOREFRONT_SHOW_NET_PLUS_IVA_HELP";
+                readonly defaults: {
+                    readonly label: string;
+                    readonly help: string;
+                };
+            };
+            readonly audience: "public";
+            readonly lifecycle: "live";
+            readonly ownership: "storefront-operation";
+            readonly excludedFromSnapshot: true;
+        };
         readonly prices: {
             readonly storage: {
                 readonly source: "catalogue";

package/dist/storefrontDesignRegistry.js

@@ -106,12 +106,15 @@ const LIVE_METADATA = {
     ownership: 'storefront-operation',
     excludedFromSnapshot: true,
 };
-const liveToggle = (key, labelKey, helpKey, label, help) => ({
+const liveToggle = (key, labelKey, helpKey, label, help, 
+// Per key: a toggle that changes what a shopper sees for every store that has
+// never written it ships `false`. Defaults to `true`, the three original toggles.
+defaultValue = true) => ({
     ...LIVE_METADATA,
     key,
     allowedLayers: ['WEB#store'],
     storage: { source: 'store', override: 'ecommerce.config' },
-    defaultValue: true,
+    defaultValue,
     valueType: 'boolean',
     valueSchema: { type: 'boolean' },
     literal: { kind: 'key', label: labelKey, help: helpKey, defaults: { label, help } },
@@ -137,6 +140,13 @@ export const STOREFRONT_DESIGN_REGISTRY = {
         showIvaAlert: liveToggle('showIvaAlert', 'STOREFRONT_SHOW_IVA_ALERT_LABEL', 'STOREFRONT_SHOW_IVA_ALERT_HELP', 'Mostrar aviso de IVA', 'Mostrar el aviso de IVA incluido en los precios.'),
         showCurrencySelector: liveToggle('showCurrencySelector', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_LABEL', 'STOREFRONT_SHOW_CURRENCY_SELECTOR_HELP', 'Mostrar selector de moneda', 'Permitir elegir la moneda de visualización en la tienda.'),
         enableSaveForLater: liveToggle('enableSaveForLater', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_LABEL', 'STOREFRONT_ENABLE_SAVE_FOR_LATER_HELP', 'Permitir guardar para después', 'Mostrar los controles para guardar productos de la cesta para después.'),
+        /*
+         * Display only: every public price slot carries `netOfIva` whatever this says
+         * (absent only for a product with no declarable IVA rate), so a flip needs no
+         * catalogue refetch. The storefront shows the «+ IVA» line when this is on AND
+         * the block is present. Default off: a store opts in.
+         */
+        showNetPlusIva: liveToggle('showNetPlusIva', 'STOREFRONT_SHOW_NET_PLUS_IVA_LABEL', 'STOREFRONT_SHOW_NET_PLUS_IVA_HELP', 'Mostrar precio neto + IVA', 'Mostrar también el precio sin IVA, con la leyenda «+ IVA», junto al precio final. Nunca reemplaza al precio final.', false),
         prices: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         stock: { ...LIVE_METADATA, storage: { source: 'catalogue' } },
         checkout: { ...LIVE_METADATA, storage: { source: 'store' } },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.802",
+	"version": "1.10.804",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",