platform-types 1.10.809 → 1.10.811

package/dist/cart.d.ts

@@ -211,6 +211,25 @@ declare global {
          * while `ecommerce.config.showNetPlusIva` is on.
          */
         netOfIva?: number;
+        /**
+         * The «PRECIO SIN IMPUESTOS NACIONALES» amount of `price`, per unit:
+         * `netOfIva` minus the line's impuestos internos,
+         * `netOfIva − round2(netOfIva × internalTaxes.percent / 100)`, and
+         * `netOfIva` itself when the line records none. Present exactly when
+         * `netOfIva` is, except that an unreadable `internalTaxes` or a refused
+         * figure leaves it out alone.
+         *
+         * ⚠️ READ-TIME and DISPLAY ONLY, on the same customer exits as `netOfIva`
+         * and under the same rules: never stored, never on an operator copy, never
+         * charged or totalled. Not gated by `showNetPlusIva`.
+         */
+        netOfNationalTaxes?: number;
+        /**
+         * The product's `internalTaxes`, stamped from the product row at re-price
+         * time like `ivaType`: the input to `netOfNationalTaxes`. Absent means
+         * none. Rides the line onto `OrderLine`; no invoice reads it.
+         */
+        internalTaxes?: ProductInternalTaxes;
         listId?: number;
         currency?: string;
         currencyValue?: number;

package/dist/cjs/socket.js

@@ -738,6 +738,9 @@ exports.isSocketAction = isSocketAction;
  * `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.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
 exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -750,6 +753,7 @@ exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'updatedAt',
     'lastMovementAt',
     'ivaType',
+    'internalTaxes',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/cjs/store.js

@@ -153,6 +153,13 @@ exports.STORE_MODULE_ERROR_CODES = [
  *   `audienceClass: 'wholesale'` list (`store/_ecommercePatch.ts`), with
  *   `data: { field: 'ecommerce.config.wholesaleRequests' }`. The platform PUT
  *   answers it too.
+ * - `NET_PLUS_IVA_REQUIRES_RI` — an `ecommerce` save turns
+ *   `config.showNetPlusIva` on while the store's stored
+ *   `integrations.afip.condFiscal` is not `30` (Responsable Inscripto), unset
+ *   included (`store/_ecommercePatch.ts`), with
+ *   `data: { field: 'ecommerce.config.showNetPlusIva' }`; nothing is written and
+ *   one deduped ERROR row is kept per store. `false` and `null` are never
+ *   refused. The platform PUT answers it too.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.
@@ -187,6 +194,7 @@ exports.STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'NET_PLUS_IVA_REQUIRES_RI',
     'DATA_FISCAL_URL_INVALID',
     'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',

package/dist/cjs/storefrontDesignRegistry.js

@@ -153,6 +153,13 @@ exports.STOREFRONT_DESIGN_REGISTRY = {
          * (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.
+         *
+         * Responsable Inscripto only (`integrations.afip.condFiscal === 30`). Both
+         * writers refuse `true` on any other store with 409 NET_PLUS_IVA_REQUIRES_RI;
+         * `false` and `null` always pass. Storefront exits (web `GET /store`, the
+         * preview's store frame, the customer `stores` frame) send the EFFECTIVE value,
+         * stored flag AND RI; app reads (`GET /store`, the operator `/tenants` read)
+         * send the STORED one beside `integrations.afip.condFiscal`.
          */
         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' } },

package/dist/pricing.d.ts

@@ -143,9 +143,19 @@ declare global {
      * 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.
+     *
+     * `netOfNationalTaxes` is the «PRECIO SIN IMPUESTOS NACIONALES» amount
+     * (Resolución SIC 4/2025 art. 2(c)), the same shape as `netOfIva`, figure for
+     * figure: each `netOfIva` figure minus the product's impuestos internos
+     * (`Product.internalTaxes`), `net − round2(net × percent / 100)`. A product
+     * recording no internos gets the `netOfIva` figures. Present exactly when
+     * `netOfIva` is, except that an unreadable stored `internalTaxes` or a refused
+     * figure leaves it out alone. Never replaces `amount`, and is sent whatever
+     * `showNetPlusIva` says: the legend shows on every view.
      */
     type PublicPriceSlot = PriceSlot & {
         netOfIva?: PublicPriceNet;
+        netOfNationalTaxes?: PublicPriceNet;
     };
 }
 export {};

package/dist/product.d.ts

@@ -36,12 +36,25 @@ declare global {
         /** Server-owned; starts at 1 and increments when the declaration changes. */
         unitRevision: number;
     }
+    /**
+     * `Product.internalTaxes`: impuestos internos as a nominal `percent`,
+     * greater than 0 and less than 100, applied to the net of IVA. The legend
+     * amount is `netOfIva − round2(netOfIva × percent / 100)`. A rate only:
+     * a fixed amount per unit would need a currency and an FX step the
+     * per-figure net has none of. A later basis is an additive key.
+     */
+    interface ProductInternalTaxes {
+        percent: number;
+    }
     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' | 'prices'> & {
         units?: PublicProductUnits | null;
-        /** The shopper's one applicable slot, with its read-time `netOfIva` when the product is rated. */
+        /**
+         * The shopper's one applicable slot, with its read-time `netOfIva` and
+         * `netOfNationalTaxes` when the product is rated.
+         */
         prices?: PublicPriceSlot[];
     };
     /** Anonymous Web GET /products lookup; the tenant comes from the public store context. */
@@ -956,6 +969,19 @@ declare global {
         currencyValue?: number;
         currencyValueAt?: number;
         ivaType: number;
+        /**
+         * Impuestos internos the merchant records for this product, as a nominal
+         * rate: the input to the public `prices[].netOfNationalTaxes` and the cart
+         * line's `netOfNationalTaxes` («PRECIO SIN IMPUESTOS NACIONALES»). Absent
+         * means none. Written through `POST /products`, cleared through
+         * `removeFields: ['internalTaxes']`.
+         *
+         * ⚠️ DISPLAY INPUT ONLY. No invoice reads it: the voucher declares no
+         * impuestos internos tributo, so a product recording them still prints
+         * `$0,00` on the RG 5614 «Otros Impuestos Nacionales Indirectos» line.
+         * Never on a public product row; the shopper gets the net, never the rate.
+         */
+        internalTaxes?: ProductInternalTaxes;
         /** Optional category membership. New enabled membership atomically requires an existing, enabled, unfrozen category.
          * Cosmetic edits preserve legacy references; leaving or disabling remains allowed while frozen.
          */

package/dist/productGroup.d.ts

@@ -194,7 +194,7 @@ declare global {
      * (per combination only), `stock` (always 0), `tagIds` and `typedAttributes`
      * (set per child afterwards, through `POST /products`).
      */
-    type ProductVariantFields = Partial<Pick<Product, 'description' | 'categoryId' | 'brandId' | 'zone' | 'cost' | 'currency' | 'ivaType' | 'prices' | 'limit' | 'isService' | 'isNew' | 'hiddenFromStorefront' | 'sellableOn' | 'minStock' | 'reorderPoint' | 'safetyStock' | 'leadTimeDays' | 'serviceLevel' | 'lotTracking' | 'weightGrams' | 'lengthMm' | 'widthMm' | 'heightMm' | 'model' | 'seoTitle' | 'seoDescription' | 'attributes'>> & {
+    type ProductVariantFields = Partial<Pick<Product, 'description' | 'categoryId' | 'brandId' | 'zone' | 'cost' | 'currency' | 'ivaType' | 'internalTaxes' | 'prices' | 'limit' | 'isService' | 'isNew' | 'hiddenFromStorefront' | 'sellableOn' | 'minStock' | 'reorderPoint' | 'safetyStock' | 'leadTimeDays' | 'serviceLevel' | 'lotTracking' | 'weightGrams' | 'lengthMm' | 'widthMm' | 'heightMm' | 'model' | 'seoTitle' | 'seoDescription' | 'attributes'>> & {
         /** `draft` or `active`; omitted creates the child as `POST /products` does. */
         catalogStatus?: Exclude<CatalogStatus, 'archived'>;
         /**

package/dist/socket.d.ts

@@ -176,8 +176,11 @@ export interface SocketMessage<T = unknown> {
  * `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.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
-export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType"];
+export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType", "internalTaxes"];
 /**
  * `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

@@ -734,6 +734,9 @@ export const isSocketAction = (value) => typeof value === 'string' && SOCKET_ACT
  * `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.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
 export const PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -746,6 +749,7 @@ export const PRODUCT_STOCK_FRAME_FIELDS = [
     'updatedAt',
     'lastMovementAt',
     'ivaType',
+    'internalTaxes',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/store.d.ts

@@ -232,6 +232,8 @@ declare global {
      * data: { field: 'ecommerce.config.newCustomerPriceList', value: number }; nothing written.
      * `wholesaleRequests: true` on a store with no `audienceClass: 'wholesale'` list
      * refuses 409 WHOLESALE_LIST_REQUIRED; nothing written.
+     * `showNetPlusIva: true` on a store whose `integrations.afip.condFiscal` is not 30
+     * (Responsable Inscripto) refuses 409 NET_PLUS_IVA_REQUIRES_RI; nothing written.
      */
     interface EcommercePatchInput {
         config?: Pick<NonNullable<Ecommerce['config']>, 'showDefaultPriceList' | 'newCustomerPriceList' | 'registrationMode' | 'wholesaleRequests' | 'paymentHoldMinutes'> & StorefrontLiveSettingsPatch;
@@ -2606,6 +2608,13 @@ export type StoreModuleRefusalBody = {
  *   `audienceClass: 'wholesale'` list (`store/_ecommercePatch.ts`), with
  *   `data: { field: 'ecommerce.config.wholesaleRequests' }`. The platform PUT
  *   answers it too.
+ * - `NET_PLUS_IVA_REQUIRES_RI` — an `ecommerce` save turns
+ *   `config.showNetPlusIva` on while the store's stored
+ *   `integrations.afip.condFiscal` is not `30` (Responsable Inscripto), unset
+ *   included (`store/_ecommercePatch.ts`), with
+ *   `data: { field: 'ecommerce.config.showNetPlusIva' }`; nothing is written and
+ *   one deduped ERROR row is kept per store. `false` and `null` are never
+ *   refused. The platform PUT answers it too.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.
@@ -2620,5 +2629,5 @@ export type StoreModuleRefusalBody = {
  * checks, the display-currency lock, the storefront fence) are not listed
  * either. Cross-cutting refusals: check `GATING_ERROR_CODES` as well.
  */
-export declare const STORE_PATCH_ERROR_CODES: readonly ["STORE_CONFIG_FORBIDDEN", "STORE_ECOMMERCE_FORBIDDEN", "STORE_FISCAL_FIELD_FORBIDDEN", "STORE_JURISDICTION_FORBIDDEN", "AFIP_RELACION_FLAG_FORBIDDEN", "FX_TABLE_FORBIDDEN", "FX_AUTO_UPDATE_FORBIDDEN", "FIELD_NOT_WRITABLE_HERE", "AFIP_POINT_OF_SALE_NOT_CLEARABLE", "CURRENCY_CATALOG_ID_UNKNOWN", "ARS_RATE_MUST_BE_ONE", "CURRENCY_RATE_ABOVE_CEILING", "FX_CATALOG_ID_UNKNOWN", "FX_SOURCE_ID_UNKNOWN", "DISPLAY_CURRENCY_NOT_INVOICEABLE", "PRODUCT_CURRENCY_NOT_INVOICEABLE", "PRICE_LIST_NOT_FOUND", "DELIVERY_FEE_INVALID", "WHOLESALE_LIST_REQUIRED", "DATA_FISCAL_URL_INVALID", "STORE_PUBLIC_HOST_MISSING", "FORBIDDEN", "STORE_NOT_FOUND"];
+export declare const STORE_PATCH_ERROR_CODES: readonly ["STORE_CONFIG_FORBIDDEN", "STORE_ECOMMERCE_FORBIDDEN", "STORE_FISCAL_FIELD_FORBIDDEN", "STORE_JURISDICTION_FORBIDDEN", "AFIP_RELACION_FLAG_FORBIDDEN", "FX_TABLE_FORBIDDEN", "FX_AUTO_UPDATE_FORBIDDEN", "FIELD_NOT_WRITABLE_HERE", "AFIP_POINT_OF_SALE_NOT_CLEARABLE", "CURRENCY_CATALOG_ID_UNKNOWN", "ARS_RATE_MUST_BE_ONE", "CURRENCY_RATE_ABOVE_CEILING", "FX_CATALOG_ID_UNKNOWN", "FX_SOURCE_ID_UNKNOWN", "DISPLAY_CURRENCY_NOT_INVOICEABLE", "PRODUCT_CURRENCY_NOT_INVOICEABLE", "PRICE_LIST_NOT_FOUND", "DELIVERY_FEE_INVALID", "WHOLESALE_LIST_REQUIRED", "NET_PLUS_IVA_REQUIRES_RI", "DATA_FISCAL_URL_INVALID", "STORE_PUBLIC_HOST_MISSING", "FORBIDDEN", "STORE_NOT_FOUND"];
 export type StorePatchErrorCode = (typeof STORE_PATCH_ERROR_CODES)[number];

package/dist/store.js

@@ -148,6 +148,13 @@ export const STORE_MODULE_ERROR_CODES = [
  *   `audienceClass: 'wholesale'` list (`store/_ecommercePatch.ts`), with
  *   `data: { field: 'ecommerce.config.wholesaleRequests' }`. The platform PUT
  *   answers it too.
+ * - `NET_PLUS_IVA_REQUIRES_RI` — an `ecommerce` save turns
+ *   `config.showNetPlusIva` on while the store's stored
+ *   `integrations.afip.condFiscal` is not `30` (Responsable Inscripto), unset
+ *   included (`store/_ecommercePatch.ts`), with
+ *   `data: { field: 'ecommerce.config.showNetPlusIva' }`; nothing is written and
+ *   one deduped ERROR row is kept per store. `false` and `null` are never
+ *   refused. The platform PUT answers it too.
  *
  * Maintenance mode (`{ mode: 'maintenance', level }`, `store/_patchMaintenance.ts`):
  * - `FORBIDDEN` (403) — the caller is neither an ADMIN nor a MANAGER.
@@ -182,6 +189,7 @@ export const STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'NET_PLUS_IVA_REQUIRES_RI',
     'DATA_FISCAL_URL_INVALID',
     'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',

package/dist/storefrontDesignRegistry.js

@@ -145,6 +145,13 @@ export const STOREFRONT_DESIGN_REGISTRY = {
          * (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.
+         *
+         * Responsable Inscripto only (`integrations.afip.condFiscal === 30`). Both
+         * writers refuse `true` on any other store with 409 NET_PLUS_IVA_REQUIRES_RI;
+         * `false` and `null` always pass. Storefront exits (web `GET /store`, the
+         * preview's store frame, the customer `stores` frame) send the EFFECTIVE value,
+         * stored flag AND RI; app reads (`GET /store`, the operator `/tenants` read)
+         * send the STORED one beside `integrations.afip.condFiscal`.
          */
         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' } },

package/package.json

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