platform-types 1.10.838 → 1.10.840

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_TRANSITIONS = void 0;
+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;
 /**
  * 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
@@ -85,6 +85,8 @@ exports.SERVICE_TRANSITIONS = {
  * of an exhaustive `Record` cannot omit one. Same reasoning, and the same
  * assertion to a non-empty tuple, as `ORDER_FULFILMENT_STATUSES`.
  */
+/** Every {@link ServiceOrderDocument}, in the order the app offers them. */
+exports.SERVICE_ORDER_DOCUMENTS = ['recepcion', 'presupuesto', 'entrega', 'devolucion'];
 exports.SERVICE_STATUSES = Object.keys(exports.SERVICE_TRANSITIONS);
 /**
  * The statuses a service order can end in. Nothing transitions out of these.
@@ -264,6 +266,9 @@ exports.MAX_SERVICE_PICTURES = 20;
  *   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.
+ * - `PRINT_JOB_DOCUMENT_NOT_FOUND` · 404 — `GET ?mode=job-document`: the job is
+ *   unknown to the caller's store, is not a service-order job, was cancelled, is
+ *   still held, or ended without being sent. One answer for all five.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
  * role no mode admits); cross-cutting gating refusals are NOT repeated —
@@ -284,6 +289,8 @@ exports.SERVICE_ORDER_ERROR_CODES = [
     'REWORK_INDEX_UNAVAILABLE',
     'STORE_NOT_FOUND',
     'SERVICE_ORDER_NOT_FOUND',
+    // The print agent's `GET ?mode=job-document` — no fetchable service-order job by that id
+    'PRINT_JOB_DOCUMENT_NOT_FOUND',
     // Intake and edit
     'CUSTOMER_NOT_FOUND',
     'PARENT_SERVICE_ORDER_NOT_FOUND',

package/dist/cjs/socket.js

@@ -585,6 +585,8 @@ exports.SOCKET_ACTIONS = [
     'print-invoice',
     'print-product',
     'print-tag',
+    // A service-order document, id-only (`PrintServiceOrderFrameData`).
+    'print-service-order',
     'print_job_failed',
     // BE → agent: re-send your COMPLETE printer set (carries only `storeId`).
     // Needed because `register_printers` only fires on connect/local-change, so

package/dist/print.d.ts

@@ -440,8 +440,26 @@ declare global {
          */
         printers: PrintPrinterReport[];
     }
-    /** Print use cases that can be routed independently. */
-    type PrintUseCase = 'order' | 'invoice' | 'label' | 'tag' | 'receipt' | 'report';
+    /**
+     * Print use cases that can be routed independently. `service-order` is every
+     * service-order document (the intake receipt, the quote, the delivery and
+     * hand-back records) — PDF documents, routed apart from `receipt`, which is the
+     * ESC/POS ticket rule.
+     */
+    type PrintUseCase = 'order' | 'invoice' | 'label' | 'tag' | 'receipt' | 'report' | 'service-order';
+    /**
+     * `data` of the server → agent `print-service-order` frame. Id-only, always:
+     * the agent fetches the PDF with `GET /services?mode=job-document&jobId=…`,
+     * which renders the document THIS job names and nothing else. The ids are
+     * for display; the fetch reads them off the job, never off the request.
+     */
+    interface PrintServiceOrderFrameData {
+        jobId: string;
+        storeId: string;
+        serviceOrderId: string;
+        document: ServiceOrderDocument;
+        options?: PrintOptions;
+    }
     /**
      * One row of `PRINT_RULE#${storeId}` — at most one rule per
      * (`storeId`, `useCase`, `agentId`).
@@ -551,6 +569,10 @@ declare global {
         printerId?: string;
         orderId?: string;
         invoiceId?: string;
+        /** The service order a `service-order` job prints — dispatch-stamped, never written by an ack. */
+        serviceOrderId?: string;
+        /** Which document of {@link serviceOrderId} the job prints. */
+        serviceOrderDocument?: ServiceOrderDocument;
         detail?: string;
         /**
          * Machine-readable failure classification, when one is recognised. BE-side
@@ -564,11 +586,11 @@ declare global {
          * An automatic job (`Store.config.autoPrint`) adds three BE-side codes on
          * `error`: `PRINT_QUEUE_EXPIRED` — it was held for want of a connected
          * agent and its `heldUntil` passed — `AUTO_PRINT_SOURCE_GONE` — the
-         * order or invoice it was printing no longer exists when it was replayed —
+         * order, invoice or service order it was printing no longer exists when it was replayed —
          * and `AUTO_PRINT_NO_LONGER_ELIGIBLE` — at replay it no longer passed the
          * checks it was minted under (the store's switch for its event is off, the
          * order was cancelled or its ready / delivered mark cleared, the factura is
-         * a credit note), so it was never sent.
+         * a credit note, the service order was cancelled or disabled), so it was never sent.
          * A HELD job is `queued` with `NO_PRINTER_CONNECTED` and `heldUntil`.
          */
         errorCode?: string;

package/dist/purchaseWithdrawal.d.ts

@@ -151,6 +151,20 @@ declare global {
     type PurchaseWithdrawalIneligibleReason = (typeof PURCHASE_WITHDRAWAL_INELIGIBLE_REASONS)[number];
     type PurchaseWithdrawalGuestIntent = (typeof PURCHASE_WITHDRAWAL_GUEST_INTENTS)[number];
     type PurchaseWithdrawalFiscalInFlightCause = (typeof PURCHASE_WITHDRAWAL_FISCAL_IN_FLIGHT_CAUSES)[number];
+    /** A withdrawal credit note's failure cause: a return's, plus one only a withdrawal stores. */
+    type PurchaseWithdrawalCreditNoteErrorCode = ReturnCreditNoteErrorCode | 'RETURN_LEDGER_BASIS_UNAVAILABLE';
+    /** Why a withdrawal's credit note is `not_requested`: FAC already credited, no FAC yet, FAC rejected. */
+    type PurchaseWithdrawalCreditNoteSkip = 'fac-credited' | 'no-fac-counsel-pending' | 'fac-rejected';
+    /**
+     * The `return-credit-note` retry's refusal codes for a withdrawal's note: a return's, plus
+     * `PURCHASE_WITHDRAWAL_NOT_FOUND` (404) — no withdrawal row under that `orderId` and `withdrawalId`.
+     * Two of a return's codes cover more for a withdrawal:
+     * - `NC_OUTCOME_UNCONFIRMED` (503) also answers the handled waits — the factura the note credits, or an
+     *   earlier credit note of it, is still `pending_cae`. Nothing was issued; the `message` names which one.
+     * - `NC_NOT_REQUESTED` (409) also answers a `rejected` note stored without its allocation and order-index
+     *   subset: what to credit could not be determined, so the note is issued by hand, never retried.
+     */
+    type PurchaseWithdrawalCreditNoteRetryErrorCode = ReturnCreditNoteRetryErrorCode | 'PURCHASE_WITHDRAWAL_NOT_FOUND';
     /** One withdrawn order line, by its index in `Order.items`. */
     interface PurchaseWithdrawalLine {
         orderItemIndex: number;
@@ -247,6 +261,16 @@ declare global {
         declineReason?: PurchaseWithdrawalDeclineReason;
         /** The operator's own words on a decline. Removed by a customer erasure; never in an audit row. */
         declineNote?: string;
+        /** The credit note of the order's cancellation; absent when none was planned. Never moves `revision`. */
+        ncStatus?: ReturnCreditNoteStatus;
+        /** The credit note's ARCA voucher NUMBER (`String(invoice.invoiceNumber)`), once `authorized` — not an INVOICE id. */
+        creditNoteId?: string;
+        /** Machine-readable cause when `ncStatus` is `rejected`. */
+        ncErrorCode?: PurchaseWithdrawalCreditNoteErrorCode;
+        /** Unix ms — when the credit note last went into `pending`. */
+        ncPendingSince?: number;
+        /** Why `ncStatus` is `not_requested`. */
+        creditNoteSkip?: PurchaseWithdrawalCreditNoteSkip;
         /** Bumped by every move, for a compare-and-set. */
         revision: number;
         /** Unix ms. */
@@ -254,6 +278,11 @@ declare global {
         /** Unix ms of the last move. */
         revisedAt: number;
     }
+    /**
+     * What the `return-credit-note` retry answers for a withdrawal's note: its credit-note fields and the ids that
+     * name it, nothing else — the retry is open to a `creditNote` holder who may not read customers.
+     */
+    type PurchaseWithdrawalCreditNoteView = Pick<PurchaseWithdrawal, 'withdrawalId' | 'orderId' | 'ncStatus' | 'creditNoteId' | 'ncErrorCode' | 'ncPendingSince' | 'creditNoteSkip'>;
     /**
      * The undecided request an order carries, stamped on the ORDER row while
      * the request is `requested` and removed in the decision's transaction. Its

package/dist/return.d.ts

@@ -1011,6 +1011,14 @@ declare global {
         mode: 'return-credit-note';
         returnId: string;
     }
+    /** The same retry for the credit note of a purchase withdrawal's cancellation. */
+    interface RetryPurchaseWithdrawalCreditNoteRequest {
+        mode: 'return-credit-note';
+        orderId: string;
+        withdrawalId: string;
+    }
+    /** The `return-credit-note` body: a return's, or a purchase withdrawal's — never both. */
+    type RetryCreditNoteRequest = RetryReturnCreditNoteRequest | RetryPurchaseWithdrawalCreditNoteRequest;
     /**
      * `POST /orders` with `mode: 'return-disposition'` — re-grade ONE line of a
      * committed return. ADMIN/MANAGER only, and the `Idempotency-Key` header is

package/dist/serviceOrder.d.ts

@@ -1108,8 +1108,30 @@ declare global {
             by: string;
             at: number;
         };
+        /**
+         * `true` once any document of this order was dispatched to the print
+         * agents. Like `Order.orderPrinted` it means QUEUED, not printed — it is
+         * set before any agent has seen the job.
+         */
+        serviceOrderPrinted?: boolean;
+        /** The most recent print job's id, last-write-wins across all four documents. */
+        printJobId?: string;
+        /** Which document {@link printJobId} prints. */
+        printJobDocument?: ServiceOrderDocument;
+        /**
+         * ms epoch at which the agent confirmed {@link printJobId} printed. Absent =
+         * not confirmed. Removed by every new dispatch, so it always describes the
+         * CURRENT `printJobId`.
+         */
+        printedAt?: number;
         disabled: boolean;
     }
+    /**
+     * One printable service-order document — the `document` of
+     * `GET /services?mode=pdf` and of `POST /services {mode:'print'}`.
+     * `recepcion` is the intake receipt (comprobante de ingreso).
+     */
+    type ServiceOrderDocument = (typeof SERVICE_ORDER_DOCUMENTS)[number];
     /**
      * The running-timer sentinel — one row per technician, for exactly as long as
      * their timer runs. PK `SERVICETIMER#{storeId}`, SK `{technicianId}`.
@@ -1313,6 +1335,8 @@ export declare const SERVICE_TRANSITIONS: Readonly<Record<ServiceStatus, readonl
  * of an exhaustive `Record` cannot omit one. Same reasoning, and the same
  * assertion to a non-empty tuple, as `ORDER_FULFILMENT_STATUSES`.
  */
+/** Every {@link ServiceOrderDocument}, in the order the app offers them. */
+export declare const SERVICE_ORDER_DOCUMENTS: readonly ["recepcion", "presupuesto", "entrega", "devolucion"];
 export declare const SERVICE_STATUSES: [ServiceStatus, ...ServiceStatus[]];
 /**
  * The statuses a service order can end in. Nothing transitions out of these.
@@ -1481,12 +1505,15 @@ export declare const MAX_SERVICE_PICTURES = 20;
  *   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.
+ * - `PRINT_JOB_DOCUMENT_NOT_FOUND` · 404 — `GET ?mode=job-document`: the job is
+ *   unknown to the caller's store, is not a service-order job, was cancelled, is
+ *   still held, or ended without being sent. One answer for all five.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
  * role no mode admits); cross-cutting gating refusals are NOT repeated —
  * 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", "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", "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 type ServiceOrderErrorCode = (typeof SERVICE_ORDER_ERROR_CODES)[number];
 export {};

package/dist/serviceOrder.js

@@ -82,6 +82,8 @@ export const SERVICE_TRANSITIONS = {
  * of an exhaustive `Record` cannot omit one. Same reasoning, and the same
  * assertion to a non-empty tuple, as `ORDER_FULFILMENT_STATUSES`.
  */
+/** Every {@link ServiceOrderDocument}, in the order the app offers them. */
+export const SERVICE_ORDER_DOCUMENTS = ['recepcion', 'presupuesto', 'entrega', 'devolucion'];
 export const SERVICE_STATUSES = Object.keys(SERVICE_TRANSITIONS);
 /**
  * The statuses a service order can end in. Nothing transitions out of these.
@@ -261,6 +263,9 @@ export const MAX_SERVICE_PICTURES = 20;
  *   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.
+ * - `PRINT_JOB_DOCUMENT_NOT_FOUND` · 404 — `GET ?mode=job-document`: the job is
+ *   unknown to the caller's store, is not a service-order job, was cancelled, is
+ *   still held, or ended without being sent. One answer for all five.
  *
  * ⚠️ `ROLE_FORBIDDEN` here is the router's own role check (a print agent, or a
  * role no mode admits); cross-cutting gating refusals are NOT repeated —
@@ -281,6 +286,8 @@ export const SERVICE_ORDER_ERROR_CODES = [
     'REWORK_INDEX_UNAVAILABLE',
     'STORE_NOT_FOUND',
     'SERVICE_ORDER_NOT_FOUND',
+    // The print agent's `GET ?mode=job-document` — no fetchable service-order job by that id
+    'PRINT_JOB_DOCUMENT_NOT_FOUND',
     // Intake and edit
     'CUSTOMER_NOT_FOUND',
     'PARENT_SERVICE_ORDER_NOT_FOUND',

package/dist/socket.d.ts

@@ -26,7 +26,7 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
+export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print-service-order", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -582,6 +582,8 @@ export const SOCKET_ACTIONS = [
     'print-invoice',
     'print-product',
     'print-tag',
+    // A service-order document, id-only (`PrintServiceOrderFrameData`).
+    'print-service-order',
     'print_job_failed',
     // BE → agent: re-send your COMPLETE printer set (carries only `storeId`).
     // Needed because `register_printers` only fires on connect/local-change, so

package/dist/store.d.ts

@@ -108,6 +108,8 @@ declare global {
         orderReady?: boolean;
         /** The shipping tag, when an order with a delivery address is marked delivered. */
         deliveryTag?: boolean;
+        /** The intake receipt (comprobante de ingreso), when a service order is created. */
+        serviceOrderCreated?: boolean;
     }
     /**
      * One store-wide module a store can switch off for every user — the

package/package.json

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