platform-types 1.10.810 → 1.10.812

package/dist/cjs/product.js

@@ -7,10 +7,11 @@ exports.BASE_QUANTITY_DECIMAL_PLACES = 6;
 exports.MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
+exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc', 'name_asc', 'name_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

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/product.d.ts

@@ -4,10 +4,11 @@ export declare const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export declare const MAX_BASE_QUANTITY = 1000000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc"];
+export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc", "name_asc", "name_desc"];
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
@@ -298,8 +299,12 @@ declare global {
          * currency, an open offer counting as the price, no quantity break. Rows the
          * caller is shown no price for (a hidden slot, every row for a guest of a
          * store that hides prices) come LAST in both directions; equal prices and
-         * that unpriced tail are newest first. A price sort reads the whole filtered
-         * set on every page, so a set too large for one read is 400
+         * that unpriced tail are newest first. `name_asc` / `name_desc` = the
+         * shown product name, Spanish collation, case- and accent-insensitive,
+         * digits compared as numbers («HP 96» before «HP 904»); names that compare
+         * equal are newest first, and a row with no name comes LAST in both
+         * directions. A price or name sort reads the whole filtered set on every
+         * page, so a set too large for one read is 400
          * `DISCOVERY_SORT_UNSUPPORTED` after the reads, with `supportedSorts`
          * naming what that query can be served in, and a read the time budget cut
          * short is 503 `PRODUCT_LOOKUP_INCOMPLETE` (retryable). A price cursor is
@@ -406,12 +411,12 @@ declare global {
     }
     /** Refusals of Web `GET /products?mode=discover`. */
     type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED'
-    /** 503: a price-sorted walk the time budget cut short; retry. */
+    /** 503: a price- or name-sorted walk the time budget cut short; retry. */
      | 'PRODUCT_LOOKUP_INCOMPLETE';
     /**
      * 400 body for a `sort` the api does not serve for this request; `supportedSorts` lists what
-     * it does — every member for an unknown value, the non-price sorts when a price sort's
-     * filtered set was too large to read whole.
+     * it does — every member for an unknown value, the sorts that need no whole-set read when a
+     * price or name sort's filtered set was too large to read whole.
      */
     interface DiscoverySortRefusal {
         message: string;

package/dist/product.js

@@ -4,10 +4,11 @@ export const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export const MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; `price_asc` / `price_desc` are the caller's own price
- * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
+ * descending product id; `price_asc` / `price_desc` are the caller's own price;
+ * `name_asc` / `name_desc` are the product name under a Spanish collation (see
+ * `PublicProductDiscoverInput.sort`).
  */
-export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
+export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc', 'name_asc', 'name_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

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.810",
+	"version": "1.10.812",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",