sinfactura-types 1.10.656 → 1.10.657

package/dist/cart.d.ts

@@ -724,7 +724,11 @@ declare global {
      * cart, already rewritten without the promotion, in `data.basket`. "Every
      * checkout" is three surfaces: the storefront checkout, the till's
      * `POST /orders` converting a stored ticket, and a service-order delivery
-     * that folds the customer's basket in. When that rewrite loses a race to
+     * that folds the customer's basket in. All three return the rewritten cart
+     * in `data.basket`; the storefront's is the customer-audience projection
+     * (`cost` stripped), the till's and the delivery's keep `cost` like the
+     * operator `GET /baskets`. The storefront's `CART_PRICES_CHANGED` carries
+     * the full cart in `data.basket` the same way. When that rewrite loses a race to
      * another cart write the surfaces part: the till and the delivery still
      * answer `CART_PROMOTION_UNAVAILABLE`, only without `data.basket`, while the
      * storefront answers the cart writer's own code (`BASKET_VERSION_CONFLICT`

package/dist/cjs/serviceOrder.js

@@ -192,6 +192,11 @@ exports.MAX_SERVICE_PICTURES = 20;
  *   handover found goods in the customer's cart. Ask the operator whether they
  *   are charged in this delivery and resend with the decision; nothing was
  *   written.
+ * - `SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH` · 409 — the basket folded in
+ *   (`includeBasket: true`, a billable line) is priced in another currency than
+ *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
+ *   written and no order number was minted; bill the cart separately or resend
+ *   with `includeBasket: false`.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -242,6 +247,15 @@ exports.MAX_SERVICE_PICTURES = 20;
  *   minted and the status does not move, but the CART is written: the promotion
  *   is taken off the row and `data.basket` is the whole cart as it now stands,
  *   absent when that write lost a race. Retry to bill the undiscounted basket.
+ * - The same folded basket's COUPON refuses `COUPON_*` · 400 — `_NOT_FOUND`,
+ *   `_NOT_ACTIVE`, `_EXPIRED`, `_EXHAUSTED`, `_EXHAUSTED_AT_CHECKOUT`,
+ *   `_MIN_SUBTOTAL`, `_REQUIRES_CUSTOMER`, `_BUDGET_EXHAUSTED`,
+ *   `_CURRENCY_MISMATCH` (the till's checkout vocabulary, `CouponRefusal`), only
+ *   when the basket bills a line. Judged at the REDEMPTION instant, the
+ *   handover's last refusal: after the order number is minted, so a refusal
+ *   burns one, but no order row is written, the ticket stays `ready` and the
+ *   cart keeps its coupon. Remove the coupon from the cart (or decline the
+ *   basket) and retry.
  * - `VALIDATION_FAILED` · 400 — the body or query failed its schema.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
@@ -316,6 +330,7 @@ exports.SERVICE_ORDER_ERROR_CODES = [
     'CATEGORY_DISABLE_IN_PROGRESS',
     'SERVICE_BILLING_PRODUCT_IN_BASKET',
     'SERVICE_DELIVERY_BASKET_DECISION_REQUIRED',
+    'SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH',
     'PRODUCT_NOT_AVAILABLE',
     // The per-sale cap on the basket's sale lines (`ProductSaleLimitRefusal`).
     'PRODUCT_SALE_LIMIT_EXCEEDED',
@@ -363,4 +378,15 @@ exports.SERVICE_ORDER_ERROR_CODES = [
     // Delivery folding in a basket whose promotion ended, was paused or deleted;
     // the specific `PromotionRefusal` rides `data.reason`.
     'CART_PROMOTION_UNAVAILABLE',
+    // The same folded basket's coupon, redeemed after the ORD mint
+    // (`redeemCartCoupon`). Not `COUPON_RATE_LIMITED`: that is apply-time only.
+    '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',
 ];

package/dist/order.d.ts

@@ -18,7 +18,10 @@ declare global {
         value: number;
         /**
          * The MONEY this coupon took off this order, in the order's currency,
-         * after every clamp (`maxDiscountAmount`, and the cart's gross).
+         * after every clamp: `maxDiscountAmount`, the cart's gross, and a
+         * promotion on the same cart — the promotion takes precedence and this
+         * share absorbs the overflow (`couponShareOf`). A coupon that would take
+         * nothing after that clamp is not redeemed and not recorded at all.
          */
         amount: number;
         /** ms epoch the redemption was consumed — checkout, never apply. */

package/dist/serviceOrder.d.ts

@@ -1306,6 +1306,11 @@ export declare const MAX_SERVICE_PICTURES = 20;
  *   handover found goods in the customer's cart. Ask the operator whether they
  *   are charged in this delivery and resend with the decision; nothing was
  *   written.
+ * - `SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH` · 409 — the basket folded in
+ *   (`includeBasket: true`, a billable line) is priced in another currency than
+ *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
+ *   written and no order number was minted; bill the cart separately or resend
+ *   with `includeBasket: false`.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -1356,6 +1361,15 @@ export declare const MAX_SERVICE_PICTURES = 20;
  *   minted and the status does not move, but the CART is written: the promotion
  *   is taken off the row and `data.basket` is the whole cart as it now stands,
  *   absent when that write lost a race. Retry to bill the undiscounted basket.
+ * - The same folded basket's COUPON refuses `COUPON_*` · 400 — `_NOT_FOUND`,
+ *   `_NOT_ACTIVE`, `_EXPIRED`, `_EXHAUSTED`, `_EXHAUSTED_AT_CHECKOUT`,
+ *   `_MIN_SUBTOTAL`, `_REQUIRES_CUSTOMER`, `_BUDGET_EXHAUSTED`,
+ *   `_CURRENCY_MISMATCH` (the till's checkout vocabulary, `CouponRefusal`), only
+ *   when the basket bills a line. Judged at the REDEMPTION instant, the
+ *   handover's last refusal: after the order number is minted, so a refusal
+ *   burns one, but no order row is written, the ticket stays `ready` and the
+ *   cart keeps its coupon. Remove the coupon from the cart (or decline the
+ *   basket) and retry.
  * - `VALIDATION_FAILED` · 400 — the body or query failed its schema.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
@@ -1363,6 +1377,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", "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", "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", "PRODUCT_NOT_AVAILABLE", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "FX_CONVERSION_UNAVAILABLE", "TRANSACT_ITEMS_LIMIT_EXCEEDED", "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"];
+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", "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", "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_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 type ServiceOrderErrorCode = (typeof SERVICE_ORDER_ERROR_CODES)[number];
 export {};

package/dist/serviceOrder.js

@@ -189,6 +189,11 @@ export const MAX_SERVICE_PICTURES = 20;
  *   handover found goods in the customer's cart. Ask the operator whether they
  *   are charged in this delivery and resend with the decision; nothing was
  *   written.
+ * - `SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH` · 409 — the basket folded in
+ *   (`includeBasket: true`, a billable line) is priced in another currency than
+ *   the ticket (`data.basketCurrency`, `data.serviceCurrency`). Nothing was
+ *   written and no order number was minted; bill the cart separately or resend
+ *   with `includeBasket: false`.
  * - `SERVICE_RENOTIFY_*` — `mode: 'renotify'`. `_TOO_SOON` (429) carries
  *   `lastNotifiedAt` and `retryAfterMs`; `_IMPERSONATED` (403) means a support
  *   session cannot message the customer — the store must resend it itself;
@@ -239,6 +244,15 @@ export const MAX_SERVICE_PICTURES = 20;
  *   minted and the status does not move, but the CART is written: the promotion
  *   is taken off the row and `data.basket` is the whole cart as it now stands,
  *   absent when that write lost a race. Retry to bill the undiscounted basket.
+ * - The same folded basket's COUPON refuses `COUPON_*` · 400 — `_NOT_FOUND`,
+ *   `_NOT_ACTIVE`, `_EXPIRED`, `_EXHAUSTED`, `_EXHAUSTED_AT_CHECKOUT`,
+ *   `_MIN_SUBTOTAL`, `_REQUIRES_CUSTOMER`, `_BUDGET_EXHAUSTED`,
+ *   `_CURRENCY_MISMATCH` (the till's checkout vocabulary, `CouponRefusal`), only
+ *   when the basket bills a line. Judged at the REDEMPTION instant, the
+ *   handover's last refusal: after the order number is minted, so a refusal
+ *   burns one, but no order row is written, the ticket stays `ready` and the
+ *   cart keeps its coupon. Remove the coupon from the cart (or decline the
+ *   basket) and retry.
  * - `VALIDATION_FAILED` · 400 — the body or query failed its schema.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
@@ -313,6 +327,7 @@ export const SERVICE_ORDER_ERROR_CODES = [
     'CATEGORY_DISABLE_IN_PROGRESS',
     'SERVICE_BILLING_PRODUCT_IN_BASKET',
     'SERVICE_DELIVERY_BASKET_DECISION_REQUIRED',
+    'SERVICE_DELIVERY_BASKET_CURRENCY_MISMATCH',
     'PRODUCT_NOT_AVAILABLE',
     // The per-sale cap on the basket's sale lines (`ProductSaleLimitRefusal`).
     'PRODUCT_SALE_LIMIT_EXCEEDED',
@@ -360,4 +375,15 @@ export const SERVICE_ORDER_ERROR_CODES = [
     // Delivery folding in a basket whose promotion ended, was paused or deleted;
     // the specific `PromotionRefusal` rides `data.reason`.
     'CART_PROMOTION_UNAVAILABLE',
+    // The same folded basket's coupon, redeemed after the ORD mint
+    // (`redeemCartCoupon`). Not `COUPON_RATE_LIMITED`: that is apply-time only.
+    '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',
 ];

package/package.json

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