platform-types 1.10.805 → 1.10.807

package/dist/cjs/notification.js

@@ -6,7 +6,8 @@ exports.WEB_NOTIFICATIONS_MAX_LIMIT = exports.CUSTOMER_NOTIFICATION_TYPES = expo
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
 // ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
-// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST do not select a
+// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
+// REFUND_OBLIGATION_OVERDUE do not select a
 // producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
@@ -236,6 +237,26 @@ var NotificationTypeEnum;
      * socket).
      */
     NotificationTypeEnum["STOREFRONT_QUOTE_REQUEST"] = "STOREFRONT_QUOTE_REQUEST";
+    /**
+     * A refund obligation went overdue: its due date passed and the hourly
+     * sweep, after reconciling the payment, still found the money owed
+     * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
+     * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
+     * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
+     * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
+     * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
+     * default-on when absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per `open` → `overdue` move: it rings only on that committed move,
+     * so an obligation a reopen sent back to `open` from a hold (a lifted
+     * dispute, the operator's decision) rings again on its new deadline. The
+     * daily repeat of an obligation already `overdue` writes the
+     * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
+     */
+    NotificationTypeEnum["REFUND_OBLIGATION_OVERDUE"] = "REFUND_OBLIGATION_OVERDUE";
 })(NotificationTypeEnum || (exports.NotificationTypeEnum = NotificationTypeEnum = {}));
 /**
  * The notification types a CUSTOMER bell can carry today; each links through

package/dist/cjs/store.js

@@ -187,6 +187,8 @@ exports.STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'DATA_FISCAL_URL_INVALID',
+    'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',
     'STORE_NOT_FOUND',
 ];

package/dist/notification.d.ts

@@ -213,7 +213,27 @@ export declare enum NotificationTypeEnum {
      * audience — the bell would reach a signed-in requester's own storefront
      * socket).
      */
-    STOREFRONT_QUOTE_REQUEST = "STOREFRONT_QUOTE_REQUEST"
+    STOREFRONT_QUOTE_REQUEST = "STOREFRONT_QUOTE_REQUEST",
+    /**
+     * A refund obligation went overdue: its due date passed and the hourly
+     * sweep, after reconciling the payment, still found the money owed
+     * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
+     * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
+     * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
+     * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
+     * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
+     * default-on when absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per `open` → `overdue` move: it rings only on that committed move,
+     * so an obligation a reopen sent back to `open` from a hold (a lifted
+     * dispute, the operator's decision) rings again on its new deadline. The
+     * daily repeat of an obligation already `overdue` writes the
+     * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
+     */
+    REFUND_OBLIGATION_OVERDUE = "REFUND_OBLIGATION_OVERDUE"
 }
 /**
  * The notification types a CUSTOMER bell can carry today; each links through

package/dist/notification.js

@@ -3,7 +3,8 @@
 // legacy opt-ins and explicit channel maps remain source data on USER rows.
 // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
 // ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
-// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST do not select a
+// PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
+// REFUND_OBLIGATION_OVERDUE do not select a
 // producer subscriber audience;
 // the consumer still reads the live USER row for each delivery channel.
 // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
@@ -233,6 +234,26 @@ export var NotificationTypeEnum;
      * socket).
      */
     NotificationTypeEnum["STOREFRONT_QUOTE_REQUEST"] = "STOREFRONT_QUOTE_REQUEST";
+    /**
+     * A refund obligation went overdue: its due date passed and the hourly
+     * sweep, after reconciling the payment, still found the money owed
+     * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
+     * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
+     *
+     * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
+     * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
+     * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
+     * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
+     * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
+     * default-on when absent. Additive — no backfill or consumer migration owed.
+     *
+     * Once per `open` → `overdue` move: it rings only on that committed move,
+     * so an obligation a reopen sent back to `open` from a hold (a lifted
+     * dispute, the operator's decision) rings again on its new deadline. The
+     * daily repeat of an obligation already `overdue` writes the
+     * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
+     */
+    NotificationTypeEnum["REFUND_OBLIGATION_OVERDUE"] = "REFUND_OBLIGATION_OVERDUE";
 })(NotificationTypeEnum || (NotificationTypeEnum = {}));
 /**
  * The notification types a CUSTOMER bell can carry today; each links through

package/dist/store.d.ts

@@ -528,8 +528,8 @@ declare global {
         /** Unix ms — when the retired label's redirect ends (its reservation end). */
         redirectUntil?: number;
     }
-    /** An identity or withdrawal fact {@link StorePublicLegal} could not resolve; the storefront warns or degrades on it. */
-    type StorePublicLegalMissing = 'razonSocial' | 'fiscalAddress' | 'email' | 'phone' | 'withdrawalChannel';
+    /** An identity, withdrawal or Data Fiscal fact {@link StorePublicLegal} could not resolve; the storefront warns or degrades on it. */
+    type StorePublicLegalMissing = 'razonSocial' | 'fiscalAddress' | 'email' | 'phone' | 'withdrawalChannel' | 'dataFiscal';
     /**
      * The consumer-law facts a storefront renders: the merchant identity disclosure, the
      * Botón de Arrepentimiento and the privacy-text variants. Built by the api at read time
@@ -572,6 +572,16 @@ declare global {
             /** `['mercadopago']` while any `paymentMethods` row is `storefront: 'mp-checkout-pro'`, whatever its audience rule; else `[]`. */
             onlinePayment: Array<'mercadopago'>;
         };
+        /**
+         * The shop's Formulario 960/D (Data Fiscal) link, from `integrations.afip.dataFiscal`.
+         * Absent when none is recorded, and `missing` then names `dataFiscal`.
+         * `matchesCurrentDomain` is `false` once the shop's public host is no longer the one the
+         * link was recorded for (RG 1415 art. 25 asks for a new form after a domain change).
+         */
+        dataFiscal?: {
+            url: string;
+            matchesCurrentDomain: boolean;
+        };
         missing: StorePublicLegalMissing[];
     }
     interface Store {
@@ -1780,6 +1790,21 @@ declare global {
          * clears it back to the default.
          */
         freight?: AfipFreightFiscal;
+        /**
+         * The shop's Formulario 960/D (Data Fiscal) link (RG 1415 art. 25). ADMIN-tier on
+         * `PATCH /store`, which takes `{ url }` only: `url` is `https:` on an ARCA host
+         * (`afip.gob.ar` or `arca.gob.ar`, subdomains included), and `domain` is STAMPED by the
+         * api with the shop's public host at write time, never taken from the body. `null`
+         * clears it. Published as `StorePublicLegal.dataFiscal`.
+         */
+        dataFiscal?: AfipDataFiscal;
+    }
+    /** {@link Afip.dataFiscal}: the link as recorded and the public host it was recorded for. */
+    interface AfipDataFiscal {
+        /** `https:` on `afip.gob.ar` / `arca.gob.ar` or a subdomain, normalised by the URL parser. */
+        url: string;
+        /** The shop's canonical public host when the link was written — bare host, no scheme. */
+        domain: string;
     }
     /**
      * Write shape for the `afip` key of `PATCH /store`'s body. The wire accepts an
@@ -1795,6 +1820,10 @@ declare global {
         iibbJurisdictions?: IibbJurisdictionConfig[] | null;
         actividades?: number[] | null;
         freight?: AfipFreightFiscal | null;
+        /** The link alone — the api stamps `domain` with the shop's public host and refuses one sent. */
+        dataFiscal?: {
+            url: string;
+        } | null;
     }
     /**
      * Write shape for the `config` key of `PATCH /store`'s body. Two things the
@@ -2591,5 +2620,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", "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", "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

@@ -182,6 +182,8 @@ export const STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'DATA_FISCAL_URL_INVALID',
+    'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',
     'STORE_NOT_FOUND',
 ];

package/package.json

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