platform-types 1.10.864 → 1.10.866

package/dist/cjs/order.js

@@ -207,8 +207,11 @@ exports.orderFulfilmentProgress = orderFulfilmentProgress;
  *   direction) and a `readyAt` change are refused. Voiding every shipment lifts
  *   it. Nothing was written.
  * - `ORDER_HAS_RETURNS` · 409 — the order carries at least one return and can no
- *   longer be edited, none of its shipments can be voided, and none of its
- *   señas refunded (`mode: 'deposit-refund'`). Nothing was written.
+ *   longer be edited, un-delivered (`mode: 'delivery'`, `delivered: false`),
+ *   none of its shipments can be voided, and none of its señas refunded
+ *   (`mode: 'deposit-refund'`). Also answered by the un-delivery and by a
+ *   shipment void (`mode: 'shipment-void'`) of an order holding a handed-off
+ *   purchase withdrawal (`awaiting-goods` or later). Nothing was written.
  * - `ORDER_CANCELLATION_NOT_PROTECTED` · 409 — `mode: 'cancel'` on an order with
  *   no cancel guard of the current generation, or with the switch off. Nothing
  *   was written.

package/dist/cjs/purchaseWithdrawal.js

@@ -26,11 +26,13 @@ exports.PURCHASE_WITHDRAWAL_VERIFICATION_FAILED = exports.SHOPPER_REQUEST_INTENT
  *   (`purchase-withdrawal-pending`) until an operator decides.
  * - `declined` — an operator declined it with a typed exemption reason.
  *   Terminal.
- * - `accepted` — an operator accepted it before delivery (shipped or not): the
- *   dispatch lock is released so the delivery can be recorded. Accepting an
- *   `accepted` withdrawal again once its order is delivered, while no open
- *   `purchase-withdrawal` RMA names it, hands it off as below. That also covers
- *   a row accepted after delivery before the hand-off shipped.
+ * - `accepted` — an operator accepted it on an order SHIPPED but not yet
+ *   delivered: the dispatch lock is released so the delivery can be recorded.
+ *   Accepting an `accepted` withdrawal again once its order is delivered, while
+ *   no open `purchase-withdrawal` RMA names it, hands it off as below. That also
+ *   covers a row accepted before fulfilment, or after delivery, by the code that
+ *   predates the cancellation and the hand-off. Before fulfilment an accept never
+ *   leaves a record `accepted`: it cancels the order (below).
  * - `awaiting-goods` — after delivery, the goods are on their way back. The
  *   operator's accept hands it off in one transaction: an `authorized` RMA
  *   (`source: 'purchase-withdrawal'`, `withdrawalId`, `collectByAt`), one
@@ -40,13 +42,18 @@ exports.PURCHASE_WITHDRAWAL_VERIFICATION_FAILED = exports.SHOPPER_REQUEST_INTENT
  *   `refundObligationDueDays` after that deadline, whether or not the goods
  *   came back, and moves the withdrawal to `refund-pending` when one is owed.
  * - `refund-pending` — money is owed back (an open refund obligation): reached
- *   from `awaiting-goods` at the collection deadline, or from `completed` by a
- *   late capture. Moves
+ *   from `requested` by an accept before fulfilment that cancelled a paid order
+ *   (or by a decision on an order another door cancelled, while one of the
+ *   withdrawal's obligations is still owed), from `awaiting-goods` at the
+ *   collection deadline, or from `completed` by a late capture. Moves
  *   to `completed` with the closure of its last open obligation, never while
  *   another one is open.
- * - `completed` — nothing is owed any more. Not final while money can still
- *   arrive: a late capture (a new payment approval the order's payment
- *   attempt refused to settle) moves it back to `refund-pending`.
+ * - `completed` — nothing is owed any more: reached from `requested` by an
+ *   accept before fulfilment that cancelled an order that received nothing (or
+ *   by a decision on an order another door cancelled, nothing owed), or from
+ *   `refund-pending`. Not final while money can still arrive: a late capture (a
+ *   new payment approval the order's payment attempt refused to settle) moves
+ *   it back to `refund-pending`.
  */
 exports.PURCHASE_WITHDRAWAL_STATES = [
     'requested',

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

@@ -2827,8 +2827,11 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  *   direction) and a `readyAt` change are refused. Voiding every shipment lifts
  *   it. Nothing was written.
  * - `ORDER_HAS_RETURNS` · 409 — the order carries at least one return and can no
- *   longer be edited, none of its shipments can be voided, and none of its
- *   señas refunded (`mode: 'deposit-refund'`). Nothing was written.
+ *   longer be edited, un-delivered (`mode: 'delivery'`, `delivered: false`),
+ *   none of its shipments can be voided, and none of its señas refunded
+ *   (`mode: 'deposit-refund'`). Also answered by the un-delivery and by a
+ *   shipment void (`mode: 'shipment-void'`) of an order holding a handed-off
+ *   purchase withdrawal (`awaiting-goods` or later). Nothing was written.
  * - `ORDER_CANCELLATION_NOT_PROTECTED` · 409 — `mode: 'cancel'` on an order with
  *   no cancel guard of the current generation, or with the switch off. Nothing
  *   was written.

package/dist/order.js

@@ -200,8 +200,11 @@ export const orderFulfilmentProgress = (order) => {
  *   direction) and a `readyAt` change are refused. Voiding every shipment lifts
  *   it. Nothing was written.
  * - `ORDER_HAS_RETURNS` · 409 — the order carries at least one return and can no
- *   longer be edited, none of its shipments can be voided, and none of its
- *   señas refunded (`mode: 'deposit-refund'`). Nothing was written.
+ *   longer be edited, un-delivered (`mode: 'delivery'`, `delivered: false`),
+ *   none of its shipments can be voided, and none of its señas refunded
+ *   (`mode: 'deposit-refund'`). Also answered by the un-delivery and by a
+ *   shipment void (`mode: 'shipment-void'`) of an order holding a handed-off
+ *   purchase withdrawal (`awaiting-goods` or later). Nothing was written.
  * - `ORDER_CANCELLATION_NOT_PROTECTED` · 409 — `mode: 'cancel'` on an order with
  *   no cancel guard of the current generation, or with the switch off. Nothing
  *   was written.

package/dist/purchaseWithdrawal.d.ts

@@ -23,11 +23,13 @@
  *   (`purchase-withdrawal-pending`) until an operator decides.
  * - `declined` — an operator declined it with a typed exemption reason.
  *   Terminal.
- * - `accepted` — an operator accepted it before delivery (shipped or not): the
- *   dispatch lock is released so the delivery can be recorded. Accepting an
- *   `accepted` withdrawal again once its order is delivered, while no open
- *   `purchase-withdrawal` RMA names it, hands it off as below. That also covers
- *   a row accepted after delivery before the hand-off shipped.
+ * - `accepted` — an operator accepted it on an order SHIPPED but not yet
+ *   delivered: the dispatch lock is released so the delivery can be recorded.
+ *   Accepting an `accepted` withdrawal again once its order is delivered, while
+ *   no open `purchase-withdrawal` RMA names it, hands it off as below. That also
+ *   covers a row accepted before fulfilment, or after delivery, by the code that
+ *   predates the cancellation and the hand-off. Before fulfilment an accept never
+ *   leaves a record `accepted`: it cancels the order (below).
  * - `awaiting-goods` — after delivery, the goods are on their way back. The
  *   operator's accept hands it off in one transaction: an `authorized` RMA
  *   (`source: 'purchase-withdrawal'`, `withdrawalId`, `collectByAt`), one
@@ -37,13 +39,18 @@
  *   `refundObligationDueDays` after that deadline, whether or not the goods
  *   came back, and moves the withdrawal to `refund-pending` when one is owed.
  * - `refund-pending` — money is owed back (an open refund obligation): reached
- *   from `awaiting-goods` at the collection deadline, or from `completed` by a
- *   late capture. Moves
+ *   from `requested` by an accept before fulfilment that cancelled a paid order
+ *   (or by a decision on an order another door cancelled, while one of the
+ *   withdrawal's obligations is still owed), from `awaiting-goods` at the
+ *   collection deadline, or from `completed` by a late capture. Moves
  *   to `completed` with the closure of its last open obligation, never while
  *   another one is open.
- * - `completed` — nothing is owed any more. Not final while money can still
- *   arrive: a late capture (a new payment approval the order's payment
- *   attempt refused to settle) moves it back to `refund-pending`.
+ * - `completed` — nothing is owed any more: reached from `requested` by an
+ *   accept before fulfilment that cancelled an order that received nothing (or
+ *   by a decision on an order another door cancelled, nothing owed), or from
+ *   `refund-pending`. Not final while money can still arrive: a late capture (a
+ *   new payment approval the order's payment attempt refused to settle) moves
+ *   it back to `refund-pending`.
  */
 export declare const PURCHASE_WITHDRAWAL_STATES: readonly ["requested", "declined", "accepted", "awaiting-goods", "refund-pending", "completed"];
 /**
@@ -516,7 +523,17 @@ declare global {
      * - `accept` / `decline` — decide a `requested` withdrawal under
      *   `expectedRevision` (the `revision` the operator acted on). A decline
      *   names one {@link PurchaseWithdrawalDeclineReason} and may carry a note.
-     *   Both release the order's dispatch lock in the same transaction.
+     *   Both release the order's dispatch lock in the same transaction. What an
+     *   accept does depends on the order as it stands: before fulfilment it
+     *   CANCELS the order (the record goes to `refund-pending` or `completed`, the
+     *   money it received is owed back and its credit note is queued) and can
+     *   answer `409 PURCHASE_WITHDRAWAL_FISCAL_IN_FLIGHT`
+     *   ({@link PurchaseWithdrawalFiscalInFlightData}), `409
+     *   ORDER_VERSION_CONFLICT`, `409 ORDER_CANCELLATION_LOCKED` or `502
+     *   PURCHASE_WITHDRAWAL_REFUND_BASIS_UNAVAILABLE`; shipped and undelivered it
+     *   moves the record to `accepted` alone; delivered it hands the withdrawal
+     *   off (`awaiting-goods`); on an order another door already cancelled it
+     *   decides the record alone (`refund-pending` or `completed`).
      * - `relay` — record a request the store received by email or WhatsApp and
      *   mint its code, which the operator then sends on that channel.
      */

package/dist/purchaseWithdrawal.js

@@ -23,11 +23,13 @@
  *   (`purchase-withdrawal-pending`) until an operator decides.
  * - `declined` — an operator declined it with a typed exemption reason.
  *   Terminal.
- * - `accepted` — an operator accepted it before delivery (shipped or not): the
- *   dispatch lock is released so the delivery can be recorded. Accepting an
- *   `accepted` withdrawal again once its order is delivered, while no open
- *   `purchase-withdrawal` RMA names it, hands it off as below. That also covers
- *   a row accepted after delivery before the hand-off shipped.
+ * - `accepted` — an operator accepted it on an order SHIPPED but not yet
+ *   delivered: the dispatch lock is released so the delivery can be recorded.
+ *   Accepting an `accepted` withdrawal again once its order is delivered, while
+ *   no open `purchase-withdrawal` RMA names it, hands it off as below. That also
+ *   covers a row accepted before fulfilment, or after delivery, by the code that
+ *   predates the cancellation and the hand-off. Before fulfilment an accept never
+ *   leaves a record `accepted`: it cancels the order (below).
  * - `awaiting-goods` — after delivery, the goods are on their way back. The
  *   operator's accept hands it off in one transaction: an `authorized` RMA
  *   (`source: 'purchase-withdrawal'`, `withdrawalId`, `collectByAt`), one
@@ -37,13 +39,18 @@
  *   `refundObligationDueDays` after that deadline, whether or not the goods
  *   came back, and moves the withdrawal to `refund-pending` when one is owed.
  * - `refund-pending` — money is owed back (an open refund obligation): reached
- *   from `awaiting-goods` at the collection deadline, or from `completed` by a
- *   late capture. Moves
+ *   from `requested` by an accept before fulfilment that cancelled a paid order
+ *   (or by a decision on an order another door cancelled, while one of the
+ *   withdrawal's obligations is still owed), from `awaiting-goods` at the
+ *   collection deadline, or from `completed` by a late capture. Moves
  *   to `completed` with the closure of its last open obligation, never while
  *   another one is open.
- * - `completed` — nothing is owed any more. Not final while money can still
- *   arrive: a late capture (a new payment approval the order's payment
- *   attempt refused to settle) moves it back to `refund-pending`.
+ * - `completed` — nothing is owed any more: reached from `requested` by an
+ *   accept before fulfilment that cancelled an order that received nothing (or
+ *   by a decision on an order another door cancelled, nothing owed), or from
+ *   `refund-pending`. Not final while money can still arrive: a late capture (a
+ *   new payment approval the order's payment attempt refused to settle) moves
+ *   it back to `refund-pending`.
  */
 export const PURCHASE_WITHDRAWAL_STATES = [
     'requested',

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