platform-types 1.10.865 → 1.10.866

package/dist/cjs/serviceOrder.js

@@ -34,7 +34,7 @@
  * A cancelled order can still have the device on the shelf.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVICE_ORDER_ERROR_CODES = exports.MAX_SERVICE_PICTURES = exports.SERVICE_CUSTODIES = exports.SERVICE_CUSTODY_TRANSITIONS = exports.SERVICE_TERMINAL_STATUSES = exports.SERVICE_STATUSES = exports.SERVICE_ORDER_DOCUMENTS = exports.SERVICE_TRANSITIONS = void 0;
+exports.SERVICE_ORDER_ERROR_CODES = exports.SERVICE_QUOTE_COMPLETION_DAYS_MAX = exports.SERVICE_QUOTE_COMPLETION_DAYS_MIN = exports.MAX_SERVICE_PICTURES = exports.SERVICE_CUSTODIES = exports.SERVICE_CUSTODY_TRANSITIONS = exports.SERVICE_TERMINAL_STATUSES = exports.SERVICE_STATUSES = exports.SERVICE_ORDER_DOCUMENTS = exports.SERVICE_TRANSITIONS = void 0;
 /**
  * The legal moves on a service order. Exhaustive over `ServiceStatus` by
  * construction — adding a status to the union without a row here is a typecheck
@@ -167,6 +167,13 @@ exports.SERVICE_CUSTODIES = Object.keys(exports.SERVICE_CUSTODY_TRANSITIONS);
  * separately by {@link MAX_IMAGE_BASE64_CHARS}.
  */
 exports.MAX_SERVICE_PICTURES = 20;
+/**
+ * The bounds of `ServiceQuote.completionDays` (art. 21(e), calendar days from
+ * approval). `POST /services { mode: 'quote', action: 'create' }` refuses a
+ * value outside them, or a fraction, with `400 VALIDATION_FAILED`.
+ */
+exports.SERVICE_QUOTE_COMPLETION_DAYS_MIN = 1;
+exports.SERVICE_QUOTE_COMPLETION_DAYS_MAX = 365;
 /**
  * `body.error` codes `/services` refuses with — every mode of `POST /services`
  * and every `GET /services` read (list, `?mode=unclaimed`, by id, `?mode=pdf`).
@@ -380,6 +387,8 @@ exports.SERVICE_ORDER_ERROR_CODES = [
     'SERVICE_QUOTE_CHANNEL_RESERVED',
     'SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE',
     'SERVICE_QUOTE_REASON_NOT_APPLICABLE',
+    // The customer's online approval of a version that states no term (art. 21(e))
+    'SERVICE_QUOTE_TERM_REQUIRED',
     'SERVICE_ORDER_QUOTE_CHANGED',
     // Renotify
     'SERVICE_ORDER_NOT_READY',

package/dist/cjs/serviceTracking.js

@@ -23,7 +23,7 @@
  * link minted earlier keeps reading (STORE_MODULES rule 4).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVICE_TRACKING_HANDLE_RE = exports.SERVICE_TRACKING_PATH_PREFIX = exports.SERVICE_TRACKING_LINK_ACTIONS = exports.SERVICE_TRACKING_CODE_RE = exports.SERVICE_TRACKING_CHALLENGE_HANDLE_RE = exports.SERVICE_TRACKING_QUOTE_DECISIONS = exports.SERVICE_TRACKING_CODE_VIAS = exports.SERVICE_TRACKING_DECISION_ERROR_CODES = exports.SERVICE_TRACKING_OPERATOR_ERROR_CODES = exports.SERVICE_TRACKING_ACCOUNT_ERROR_CODES = exports.SERVICE_TRACKING_ERROR_CODES = void 0;
+exports.SERVICE_TRACKING_HANDLE_RE = exports.SERVICE_TRACKING_PATH_PREFIX = exports.SERVICE_TRACKING_LINK_ACTIONS = exports.SERVICE_TRACKING_CODE_RE = exports.SERVICE_TRACKING_CHALLENGE_HANDLE_RE = exports.SERVICE_TRACKING_QUOTE_DECISIONS = exports.SERVICE_TRACKING_APPROVE_BLOCKS = exports.SERVICE_TRACKING_CODE_VIAS = exports.SERVICE_TRACKING_DECISION_ERROR_CODES = exports.SERVICE_TRACKING_OPERATOR_ERROR_CODES = exports.SERVICE_TRACKING_ACCOUNT_ERROR_CODES = exports.SERVICE_TRACKING_ERROR_CODES = void 0;
 /**
  * The refusals the PUBLIC tracking routes answer themselves.
  *
@@ -81,6 +81,11 @@ exports.SERVICE_TRACKING_OPERATOR_ERROR_CODES = [
  *   (the same decision again answers 200 with the current view and writes nothing).
  * - SERVICE_QUOTE_LAPSED (409, approve only): past `expiresAt`. A rejection is
  *   still accepted.
+ * - SERVICE_QUOTE_TERM_REQUIRED (409, approve only): the version states no term
+ *   (Ley 24.240 art. 21(e)) — neither `completionDays` nor a FUTURE
+ *   `promisedAt`. Checked before the code, so it spends no attempt. A rejection
+ *   is still accepted; the shop re-quotes with a term or sets a future
+ *   `promisedAt`.
  * - SERVICE_ORDER_QUOTE_CHANGED (409): the order moved under the decision — retry.
  * - SERVICE_ORDER_TERMINAL / SERVICE_ORDER_DISABLED (409): the ticket is closed
  *   or deleted.
@@ -96,6 +101,7 @@ exports.SERVICE_TRACKING_DECISION_ERROR_CODES = [
     'SERVICE_QUOTE_SUPERSEDED',
     'SERVICE_QUOTE_ALREADY_RESOLVED',
     'SERVICE_QUOTE_LAPSED',
+    'SERVICE_QUOTE_TERM_REQUIRED',
     'SERVICE_ORDER_QUOTE_CHANGED',
     'SERVICE_ORDER_TERMINAL',
     'SERVICE_ORDER_DISABLED',
@@ -103,6 +109,12 @@ exports.SERVICE_TRACKING_DECISION_ERROR_CODES = [
 ];
 /** Where the 6-digit decision code is sent: the phone or the email on file. */
 exports.SERVICE_TRACKING_CODE_VIAS = ['sms', 'email'];
+/**
+ * Why `ServiceTrackingDecision.canApprove` is false while `canDecide` is true,
+ * in the order they are checked: `lapsed` (past `expiresAt`), then
+ * `term_required` (no `completionDays` and no future `promisedAt`).
+ */
+exports.SERVICE_TRACKING_APPROVE_BLOCKS = ['lapsed', 'term_required'];
 /** The customer's two online answers to a presupuesto. */
 exports.SERVICE_TRACKING_QUOTE_DECISIONS = ['approve', 'reject'];
 /** A decision challenge handle: 16 random bytes, base64url (22 characters). */

package/dist/serviceOrder.d.ts

@@ -484,6 +484,16 @@ declare global {
         quotedAt?: number;
         /** Unix ms the offer lapses (Ley 24.240 art. 21(g)). */
         expiresAt?: number;
+        /**
+         * Art. 21(e): calendar days the work takes, counted from approval. Integer
+         * {@link SERVICE_QUOTE_COMPLETION_DAYS_MIN}–{@link SERVICE_QUOTE_COMPLETION_DAYS_MAX}.
+         * Set on create only; absent when the version states none.
+         *
+         * An ONLINE approval needs a stated term: this, or a future
+         * `ServiceOrder.promisedAt` (`409 SERVICE_QUOTE_TERM_REQUIRED` otherwise).
+         * A staff resolve does not.
+         */
+        completionDays?: number;
         approval?: ServiceQuoteApproval;
         /**
          * Set when `status` is `rejected`. ⚠️ NOT set on `expired`: a lapse is
@@ -1444,6 +1454,13 @@ export declare const SERVICE_CUSTODIES: [ServiceCustody, ...ServiceCustody[]];
  * separately by {@link MAX_IMAGE_BASE64_CHARS}.
  */
 export declare const MAX_SERVICE_PICTURES = 20;
+/**
+ * The bounds of `ServiceQuote.completionDays` (art. 21(e), calendar days from
+ * approval). `POST /services { mode: 'quote', action: 'create' }` refuses a
+ * value outside them, or a fraction, with `400 VALIDATION_FAILED`.
+ */
+export declare const SERVICE_QUOTE_COMPLETION_DAYS_MIN = 1;
+export declare const SERVICE_QUOTE_COMPLETION_DAYS_MAX = 365;
 /**
  * `body.error` codes `/services` refuses with — every mode of `POST /services`
  * and every `GET /services` read (list, `?mode=unclaimed`, by id, `?mode=pdf`).
@@ -1552,6 +1569,6 @@ export declare const MAX_SERVICE_PICTURES = 20;
  * check `GATING_ERROR_CODES` in addition. The deposit's opt-in idempotency
  * refusals are included here.
  */
-export declare const SERVICE_ORDER_ERROR_CODES: readonly ["UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "ROLE_FORBIDDEN", "PARENT_FILTER_CONFLICT", "VALIDATION_FAILED", "INVALID_CURSOR", "INVALID_FROM_DATE", "INVALID_TO_DATE", "INVALID_DATE_RANGE", "REWORK_INDEX_UNAVAILABLE", "STORE_NOT_FOUND", "SERVICE_ORDER_NOT_FOUND", "PRINT_JOB_DOCUMENT_NOT_FOUND", "CUSTOMER_NOT_FOUND", "PARENT_SERVICE_ORDER_NOT_FOUND", "SERVICE_TEMPLATE_NOT_FOUND", "SERVICE_TYPE_REQUIRED", "INVALID_IMAGE_REFERENCE", "MISSING_STORE_CONTEXT", "WARRANTY_BELOW_LEGAL_MINIMUM", "TECHNICIAN_NOT_FOUND", "TECHNICIAN_NOT_ELIGIBLE", "SERVICE_TRACKING_DISABLED", "SERVICE_TRACKING_NO_ADDRESS", "SERVICE_TRACKING_LINK_LAPSED", "SERVICE_TRACKING_VERIFICATION_FAILED", "SERVICE_TRACKING_TOKEN_INVALID", "ADMIN_REQUIRED", "CUSTODY_ILLEGAL_TRANSITION", "SERVICE_ORDER_BILLABLE_FROZEN", "SERVICE_ORDER_EDIT_CHANGED", "SERVICE_ORDER_DISABLED_STATE_UNCHANGED", "APPOINTMENT_NOT_FOUND", "APPOINTMENT_NOT_LINKABLE", "APPOINTMENT_NOT_OPEN", "APPOINTMENT_CUSTOMER_MISMATCH", "APPOINTMENT_VERSION_CONFLICT", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_ORDER_ILLEGAL_TRANSITION", "SERVICE_ORDER_STATUS_CHANGED", "SERVICE_ORDER_OUTCOME_REQUIRED", "SERVICE_ORDER_OUTCOME_NOT_ALLOWED", "SERVICE_ORDER_CUSTODY_NOT_RECEIVED", "SERVICE_ORDER_BILLABLE_NOT_AT_THIS_TRANSITION", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "SERVICE_ORDER_DEPOSIT_CHANGED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENCY_LOCK_CONTENTION", "SERVICE_DEPOSIT_CURRENCY_MISMATCH", "SERVICE_DEPOSIT_INVALID", "INVALID_AMOUNT", "DEFAULT_DRAWER_UNAVAILABLE", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "SERVICE_BILLING_PRODUCTS_UNAVAILABLE", "CATEGORY_NOT_FOUND", "CATEGORY_DISABLED", "CATEGORY_DISABLE_IN_PROGRESS", "SERVICE_BILLING_PRODUCT_IN_BASKET", "SERVICE_DELIVERY_BASKET_DECISION_REQUIRED", "SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH", "PRODUCT_NOT_AVAILABLE", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "FX_CONVERSION_UNAVAILABLE", "TRANSACT_ITEMS_LIMIT_EXCEEDED", "SERVICE_LINE_PRICE_TOO_LARGE", "SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED", "SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT", "SERVICE_PARTS_STOCK_INSUFFICIENT", "SERVICE_PARTS_PRODUCT_NOT_FOUND", "SERVICE_PARTS_LEDGER_FULL", "SERVICE_PARTS_TOO_MANY", "SERVICE_ORDER_PARTS_CHANGED", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_NOT_OFFERABLE", "SERVICE_QUOTE_HOLDS_TOO_MANY", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_QUOTE_CHANNEL_RESERVED", "SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE", "SERVICE_QUOTE_REASON_NOT_APPLICABLE", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_NOT_READY", "SERVICE_RENOTIFY_IMPERSONATED", "SERVICE_RENOTIFY_TOO_SOON", "SERVICE_RENOTIFY_CONFLICT", "SERVICE_RENOTIFY_NOT_RECORDED", "SERVICE_RENOTIFY_LEDGER_UNREADABLE", "SERVICE_RENOTIFY_NOT_DISPATCHED", "SERVICE_TIMER_ALREADY_RUNNING", "SERVICE_TIMER_NOT_RUNNING", "SERVICE_TIMER_STOP_CONFLICT", "TECHNICIAN_NOT_CLOCKED_IN", "SERVICE_ORDER_GONE", "SERVICE_WORKLOG_NOT_FOUND", "SERVICE_WORKLOG_NOT_REVERSIBLE", "SERVICE_WORKLOG_ALREADY_REVERSED", "SERVICE_ORDER_WORKLOG_CHANGED", "CART_PROMOTION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_EXHAUSTED_AT_CHECKOUT", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_CURRENCY_MISMATCH"];
+export declare const SERVICE_ORDER_ERROR_CODES: readonly ["UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "ROLE_FORBIDDEN", "PARENT_FILTER_CONFLICT", "VALIDATION_FAILED", "INVALID_CURSOR", "INVALID_FROM_DATE", "INVALID_TO_DATE", "INVALID_DATE_RANGE", "REWORK_INDEX_UNAVAILABLE", "STORE_NOT_FOUND", "SERVICE_ORDER_NOT_FOUND", "PRINT_JOB_DOCUMENT_NOT_FOUND", "CUSTOMER_NOT_FOUND", "PARENT_SERVICE_ORDER_NOT_FOUND", "SERVICE_TEMPLATE_NOT_FOUND", "SERVICE_TYPE_REQUIRED", "INVALID_IMAGE_REFERENCE", "MISSING_STORE_CONTEXT", "WARRANTY_BELOW_LEGAL_MINIMUM", "TECHNICIAN_NOT_FOUND", "TECHNICIAN_NOT_ELIGIBLE", "SERVICE_TRACKING_DISABLED", "SERVICE_TRACKING_NO_ADDRESS", "SERVICE_TRACKING_LINK_LAPSED", "SERVICE_TRACKING_VERIFICATION_FAILED", "SERVICE_TRACKING_TOKEN_INVALID", "ADMIN_REQUIRED", "CUSTODY_ILLEGAL_TRANSITION", "SERVICE_ORDER_BILLABLE_FROZEN", "SERVICE_ORDER_EDIT_CHANGED", "SERVICE_ORDER_DISABLED_STATE_UNCHANGED", "APPOINTMENT_NOT_FOUND", "APPOINTMENT_NOT_LINKABLE", "APPOINTMENT_NOT_OPEN", "APPOINTMENT_CUSTOMER_MISMATCH", "APPOINTMENT_VERSION_CONFLICT", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_ORDER_ILLEGAL_TRANSITION", "SERVICE_ORDER_STATUS_CHANGED", "SERVICE_ORDER_OUTCOME_REQUIRED", "SERVICE_ORDER_OUTCOME_NOT_ALLOWED", "SERVICE_ORDER_CUSTODY_NOT_RECEIVED", "SERVICE_ORDER_BILLABLE_NOT_AT_THIS_TRANSITION", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "SERVICE_ORDER_DEPOSIT_CHANGED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENCY_LOCK_CONTENTION", "SERVICE_DEPOSIT_CURRENCY_MISMATCH", "SERVICE_DEPOSIT_INVALID", "INVALID_AMOUNT", "DEFAULT_DRAWER_UNAVAILABLE", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "SERVICE_BILLING_PRODUCTS_UNAVAILABLE", "CATEGORY_NOT_FOUND", "CATEGORY_DISABLED", "CATEGORY_DISABLE_IN_PROGRESS", "SERVICE_BILLING_PRODUCT_IN_BASKET", "SERVICE_DELIVERY_BASKET_DECISION_REQUIRED", "SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH", "PRODUCT_NOT_AVAILABLE", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "FX_CONVERSION_UNAVAILABLE", "TRANSACT_ITEMS_LIMIT_EXCEEDED", "SERVICE_LINE_PRICE_TOO_LARGE", "SERVICE_PARTS_RESTORE_EXCEEDS_CONSUMED", "SERVICE_PARTS_RESTORE_EXCEEDS_AMOUNT", "SERVICE_PARTS_STOCK_INSUFFICIENT", "SERVICE_PARTS_PRODUCT_NOT_FOUND", "SERVICE_PARTS_LEDGER_FULL", "SERVICE_PARTS_TOO_MANY", "SERVICE_ORDER_PARTS_CHANGED", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_NOT_OFFERABLE", "SERVICE_QUOTE_HOLDS_TOO_MANY", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_QUOTE_CHANNEL_RESERVED", "SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE", "SERVICE_QUOTE_REASON_NOT_APPLICABLE", "SERVICE_QUOTE_TERM_REQUIRED", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_NOT_READY", "SERVICE_RENOTIFY_IMPERSONATED", "SERVICE_RENOTIFY_TOO_SOON", "SERVICE_RENOTIFY_CONFLICT", "SERVICE_RENOTIFY_NOT_RECORDED", "SERVICE_RENOTIFY_LEDGER_UNREADABLE", "SERVICE_RENOTIFY_NOT_DISPATCHED", "SERVICE_TIMER_ALREADY_RUNNING", "SERVICE_TIMER_NOT_RUNNING", "SERVICE_TIMER_STOP_CONFLICT", "TECHNICIAN_NOT_CLOCKED_IN", "SERVICE_ORDER_GONE", "SERVICE_WORKLOG_NOT_FOUND", "SERVICE_WORKLOG_NOT_REVERSIBLE", "SERVICE_WORKLOG_ALREADY_REVERSED", "SERVICE_ORDER_WORKLOG_CHANGED", "CART_PROMOTION_UNAVAILABLE", "COUPON_NOT_FOUND", "COUPON_NOT_ACTIVE", "COUPON_EXPIRED", "COUPON_EXHAUSTED", "COUPON_EXHAUSTED_AT_CHECKOUT", "COUPON_MIN_SUBTOTAL", "COUPON_REQUIRES_CUSTOMER", "COUPON_BUDGET_EXHAUSTED", "COUPON_CURRENCY_MISMATCH"];
 export type ServiceOrderErrorCode = (typeof SERVICE_ORDER_ERROR_CODES)[number];
 export {};

package/dist/serviceOrder.js

@@ -164,6 +164,13 @@ export const SERVICE_CUSTODIES = Object.keys(SERVICE_CUSTODY_TRANSITIONS);
  * separately by {@link MAX_IMAGE_BASE64_CHARS}.
  */
 export const MAX_SERVICE_PICTURES = 20;
+/**
+ * The bounds of `ServiceQuote.completionDays` (art. 21(e), calendar days from
+ * approval). `POST /services { mode: 'quote', action: 'create' }` refuses a
+ * value outside them, or a fraction, with `400 VALIDATION_FAILED`.
+ */
+export const SERVICE_QUOTE_COMPLETION_DAYS_MIN = 1;
+export const SERVICE_QUOTE_COMPLETION_DAYS_MAX = 365;
 /**
  * `body.error` codes `/services` refuses with — every mode of `POST /services`
  * and every `GET /services` read (list, `?mode=unclaimed`, by id, `?mode=pdf`).
@@ -377,6 +384,8 @@ export const SERVICE_ORDER_ERROR_CODES = [
     'SERVICE_QUOTE_CHANNEL_RESERVED',
     'SERVICE_QUOTE_CHANNEL_NOT_APPLICABLE',
     'SERVICE_QUOTE_REASON_NOT_APPLICABLE',
+    // The customer's online approval of a version that states no term (art. 21(e))
+    'SERVICE_QUOTE_TERM_REQUIRED',
     'SERVICE_ORDER_QUOTE_CHANGED',
     // Renotify
     'SERVICE_ORDER_NOT_READY',

package/dist/serviceTracking.d.ts

@@ -76,16 +76,27 @@ export type ServiceTrackingOperatorErrorCode = (typeof SERVICE_TRACKING_OPERATOR
  *   (the same decision again answers 200 with the current view and writes nothing).
  * - SERVICE_QUOTE_LAPSED (409, approve only): past `expiresAt`. A rejection is
  *   still accepted.
+ * - SERVICE_QUOTE_TERM_REQUIRED (409, approve only): the version states no term
+ *   (Ley 24.240 art. 21(e)) — neither `completionDays` nor a FUTURE
+ *   `promisedAt`. Checked before the code, so it spends no attempt. A rejection
+ *   is still accepted; the shop re-quotes with a term or sets a future
+ *   `promisedAt`.
  * - SERVICE_ORDER_QUOTE_CHANGED (409): the order moved under the decision — retry.
  * - SERVICE_ORDER_TERMINAL / SERVICE_ORDER_DISABLED (409): the ticket is closed
  *   or deleted.
  * - SERVICE_QUOTE_HOLDS_TOO_MANY (400, approve only): the version's parts cannot
  *   be reserved in one write; the shop must re-quote.
  */
-export declare const SERVICE_TRACKING_DECISION_ERROR_CODES: readonly ["SERVICE_TRACKING_TOKEN_INVALID", "SERVICE_TRACKING_VERIFICATION_FAILED", "SERVICE_TRACKING_DISABLED", "SERVICE_ORDER_NOT_FOUND", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_QUOTE_HOLDS_TOO_MANY"];
+export declare const SERVICE_TRACKING_DECISION_ERROR_CODES: readonly ["SERVICE_TRACKING_TOKEN_INVALID", "SERVICE_TRACKING_VERIFICATION_FAILED", "SERVICE_TRACKING_DISABLED", "SERVICE_ORDER_NOT_FOUND", "SERVICE_QUOTE_NOT_FOUND", "SERVICE_QUOTE_SUPERSEDED", "SERVICE_QUOTE_ALREADY_RESOLVED", "SERVICE_QUOTE_LAPSED", "SERVICE_QUOTE_TERM_REQUIRED", "SERVICE_ORDER_QUOTE_CHANGED", "SERVICE_ORDER_TERMINAL", "SERVICE_ORDER_DISABLED", "SERVICE_QUOTE_HOLDS_TOO_MANY"];
 export type ServiceTrackingDecisionErrorCode = (typeof SERVICE_TRACKING_DECISION_ERROR_CODES)[number];
 /** Where the 6-digit decision code is sent: the phone or the email on file. */
 export declare const SERVICE_TRACKING_CODE_VIAS: readonly ["sms", "email"];
+/**
+ * Why `ServiceTrackingDecision.canApprove` is false while `canDecide` is true,
+ * in the order they are checked: `lapsed` (past `expiresAt`), then
+ * `term_required` (no `completionDays` and no future `promisedAt`).
+ */
+export declare const SERVICE_TRACKING_APPROVE_BLOCKS: readonly ["lapsed", "term_required"];
 /** The customer's two online answers to a presupuesto. */
 export declare const SERVICE_TRACKING_QUOTE_DECISIONS: readonly ["approve", "reject"];
 /** A decision challenge handle: 16 random bytes, base64url (22 characters). */
@@ -183,6 +194,8 @@ declare global {
         quotedAt?: number;
         /** Unix ms the offer lapses (Ley 24.240 art. 21(g)). */
         expiresAt?: number;
+        /** Art. 21(e): calendar days the work takes, counted from approval (`ServiceQuote.completionDays`). */
+        completionDays?: number;
         parts: ServiceTrackingQuotePart[];
         /** Unix ms of the approval or the rejection. */
         decidedAt?: number;
@@ -201,6 +214,14 @@ declare global {
          * `true` on the link, `false` signed in (the session is the proof).
          */
         approveNeedsCode: boolean;
+        /**
+         * `canDecide` && not lapsed && the quote states a term (`completionDays`,
+         * or a `promisedAt` later than now). False while `canDecide` is true means
+         * only a rejection is offered; the link sends no code then.
+         */
+        canApprove: boolean;
+        /** Present iff `canDecide && !canApprove`; `'lapsed'` is checked first. */
+        approveBlockedBy?: (typeof SERVICE_TRACKING_APPROVE_BLOCKS)[number];
     }
     type ServiceTrackingCodeVia = (typeof SERVICE_TRACKING_CODE_VIAS)[number];
     type ServiceTrackingQuoteDecision = (typeof SERVICE_TRACKING_QUOTE_DECISIONS)[number];

package/dist/serviceTracking.js

@@ -78,6 +78,11 @@ export const SERVICE_TRACKING_OPERATOR_ERROR_CODES = [
  *   (the same decision again answers 200 with the current view and writes nothing).
  * - SERVICE_QUOTE_LAPSED (409, approve only): past `expiresAt`. A rejection is
  *   still accepted.
+ * - SERVICE_QUOTE_TERM_REQUIRED (409, approve only): the version states no term
+ *   (Ley 24.240 art. 21(e)) — neither `completionDays` nor a FUTURE
+ *   `promisedAt`. Checked before the code, so it spends no attempt. A rejection
+ *   is still accepted; the shop re-quotes with a term or sets a future
+ *   `promisedAt`.
  * - SERVICE_ORDER_QUOTE_CHANGED (409): the order moved under the decision — retry.
  * - SERVICE_ORDER_TERMINAL / SERVICE_ORDER_DISABLED (409): the ticket is closed
  *   or deleted.
@@ -93,6 +98,7 @@ export const SERVICE_TRACKING_DECISION_ERROR_CODES = [
     'SERVICE_QUOTE_SUPERSEDED',
     'SERVICE_QUOTE_ALREADY_RESOLVED',
     'SERVICE_QUOTE_LAPSED',
+    'SERVICE_QUOTE_TERM_REQUIRED',
     'SERVICE_ORDER_QUOTE_CHANGED',
     'SERVICE_ORDER_TERMINAL',
     'SERVICE_ORDER_DISABLED',
@@ -100,6 +106,12 @@ export const SERVICE_TRACKING_DECISION_ERROR_CODES = [
 ];
 /** Where the 6-digit decision code is sent: the phone or the email on file. */
 export const SERVICE_TRACKING_CODE_VIAS = ['sms', 'email'];
+/**
+ * Why `ServiceTrackingDecision.canApprove` is false while `canDecide` is true,
+ * in the order they are checked: `lapsed` (past `expiresAt`), then
+ * `term_required` (no `completionDays` and no future `promisedAt`).
+ */
+export const SERVICE_TRACKING_APPROVE_BLOCKS = ['lapsed', 'term_required'];
 /** The customer's two online answers to a presupuesto. */
 export const SERVICE_TRACKING_QUOTE_DECISIONS = ['approve', 'reject'];
 /** A decision challenge handle: 16 random bytes, base64url (22 characters). */

package/package.json

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