platform-types 1.10.719 → 1.10.721

package/dist/cjs/invoice.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = exports.INVOICE_ISSUANCE_REFUSAL_CODES = exports.INVOICE_POST_VOUCHER_ERROR_CODES = void 0;
+exports.INVOICE_DOCUMENT_REFUSAL_CODES = exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = exports.INVOICE_ISSUANCE_REFUSAL_CODES = exports.INVOICE_POST_VOUCHER_ERROR_CODES = void 0;
 /**
  * The codes `POST /invoices` answers AFTER a voucher number was spent — ARCA
  * was asked, or a CAEA number was claimed — as a runtime value the app maps.
@@ -73,3 +73,27 @@ exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
     INVOICE_IDEMPOTENCY_PAYLOAD_MISMATCH: 'resend-issued-body',
     INVOICE_ISSUANCE_OUTCOME_UNCERTAIN: 'reconcile',
 };
+/**
+ * The codes the operator invoice DOCUMENT routes answer when they refuse to
+ * render or print an invoice — `GET /invoices?mode=pdf`, `POST /invoices`
+ * `{mode:'print'}` (every form: id-only, `contentType: 'pdf_uri'` and
+ * `'pdf_base64'`) and `{mode:'printEscpos'}` — as a runtime value a client maps.
+ * `GET /invoices?mode=one` answers `INVOICE_NOT_FOUND` too, for the same absent row,
+ * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
+ * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
+ * the factura it chose.
+ *
+ * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
+ *   store. Answered before any store read, render, print stamp, broadcast,
+ *   staged PDF, print job or email.
+ * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
+ *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   print refused here wrote nothing to the invoice and dispatched nothing.
+ *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
+ *   factura or full credit note with no client action (an FCE or partial
+ *   credit note waits for support). `rejected` is final — ARCA refused the
+ *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
+ *   before the field existed) is treated as authorized, whether or not it
+ *   carries a CAE.
+ */
+exports.INVOICE_DOCUMENT_REFUSAL_CODES = ['INVOICE_NOT_FOUND', 'INVOICE_NOT_AUTHORIZED'];

package/dist/cycleCount.d.ts

@@ -232,6 +232,9 @@ declare global {
          * with the caller's own earlier edit having landed — never proof of it,
          * since this is a user id and the same operator on a second device reads
          * the same.
+         *
+         * ⚠️ On a `cancelled` session read `cancelledBy` for who abandoned it —
+         * `updatedAt` moved with the cancel, `updatedBy` did not.
          */
         updatedBy?: string;
         /** The operator who opened it. */
@@ -397,6 +400,21 @@ declare global {
         finalizedAt?: number;
         /** The operator who applied them — not necessarily the one who opened the session. */
         finalizedBy?: string;
+        /**
+         * Unix ms the session was cancelled — stamped in the SAME conditional write
+         * that moves `status` to `cancelled`, so it never lands without the
+         * transition. Present only on a `cancelled` session, and ABSENT on one
+         * cancelled before this field existed — nothing is backfilled.
+         */
+        cancelledAt?: number;
+        /**
+         * The operator who cancelled it — the request's authenticated user id, as
+         * `finalizedBy` and `Order.cancelledBy` are, so under an impersonation
+         * session it names the impersonated store user, never the support
+         * operator, whose identity travels separately. Same write, presence rule
+         * and absence on older rows as `cancelledAt`.
+         */
+        cancelledBy?: string;
         /** Operator note. ⚠️ Never personal data — this row is not scrubbed and has no TTL. */
         notes?: string;
         /** Lowercase '#'-joined write-side index. Internal; not part of the read contract. */

package/dist/invoice.d.ts

@@ -992,4 +992,29 @@ export declare const INVOICE_ISSUANCE_REFUSAL_RECOVERY: {
     readonly INVOICE_IDEMPOTENCY_PAYLOAD_MISMATCH: "resend-issued-body";
     readonly INVOICE_ISSUANCE_OUTCOME_UNCERTAIN: "reconcile";
 };
+/**
+ * The codes the operator invoice DOCUMENT routes answer when they refuse to
+ * render or print an invoice — `GET /invoices?mode=pdf`, `POST /invoices`
+ * `{mode:'print'}` (every form: id-only, `contentType: 'pdf_uri'` and
+ * `'pdf_base64'`) and `{mode:'printEscpos'}` — as a runtime value a client maps.
+ * `GET /invoices?mode=one` answers `INVOICE_NOT_FOUND` too, for the same absent row,
+ * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
+ * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
+ * the factura it chose.
+ *
+ * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
+ *   store. Answered before any store read, render, print stamp, broadcast,
+ *   staged PDF, print job or email.
+ * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
+ *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   print refused here wrote nothing to the invoice and dispatched nothing.
+ *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
+ *   factura or full credit note with no client action (an FCE or partial
+ *   credit note waits for support). `rejected` is final — ARCA refused the
+ *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
+ *   before the field existed) is treated as authorized, whether or not it
+ *   carries a CAE.
+ */
+export declare const INVOICE_DOCUMENT_REFUSAL_CODES: readonly ["INVOICE_NOT_FOUND", "INVOICE_NOT_AUTHORIZED"];
+export type InvoiceDocumentRefusalCode = (typeof INVOICE_DOCUMENT_REFUSAL_CODES)[number];
 export {};

package/dist/invoice.js

@@ -70,3 +70,27 @@ export const INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
     INVOICE_IDEMPOTENCY_PAYLOAD_MISMATCH: 'resend-issued-body',
     INVOICE_ISSUANCE_OUTCOME_UNCERTAIN: 'reconcile',
 };
+/**
+ * The codes the operator invoice DOCUMENT routes answer when they refuse to
+ * render or print an invoice — `GET /invoices?mode=pdf`, `POST /invoices`
+ * `{mode:'print'}` (every form: id-only, `contentType: 'pdf_uri'` and
+ * `'pdf_base64'`) and `{mode:'printEscpos'}` — as a runtime value a client maps.
+ * `GET /invoices?mode=one` answers `INVOICE_NOT_FOUND` too, for the same absent row,
+ * `POST /invoices` `{mode:'email'}` answers both before anything is enqueued, and
+ * `POST /mercadolibre/events` `{mode:'reuploadFiscalDocument'}` answers both for
+ * the factura it chose.
+ *
+ * - `INVOICE_NOT_FOUND` · 404 — no invoice row has this id in the caller's
+ *   store. Answered before any store read, render, print stamp, broadcast,
+ *   staged PDF, print job or email.
+ * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
+ *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   print refused here wrote nothing to the invoice and dispatched nothing.
+ *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
+ *   factura or full credit note with no client action (an FCE or partial
+ *   credit note waits for support). `rejected` is final — ARCA refused the
+ *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
+ *   before the field existed) is treated as authorized, whether or not it
+ *   carries a CAE.
+ */
+export const INVOICE_DOCUMENT_REFUSAL_CODES = ['INVOICE_NOT_FOUND', 'INVOICE_NOT_AUTHORIZED'];

package/package.json

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