platform-types 1.10.733 → 1.10.734

package/dist/cjs/invoice.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICE_DOCUMENT_REFUSAL_CODES = exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = exports.INVOICE_ISSUANCE_REFUSAL_CODES = exports.INVOICE_POST_VOUCHER_ERROR_CODES = void 0;
+exports.INVOICE_NOT_AUTHORIZED_RECOVERIES = 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.
@@ -87,13 +87,33 @@ exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  *   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
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) 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.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all 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'];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+exports.INVOICE_NOT_AUTHORIZED_RECOVERIES = ['retry', 'support', 'final'];

package/dist/invoice.d.ts

@@ -354,6 +354,26 @@ declare global {
          * Forward-only; nothing reads it as anything but a deadline.
          */
         drainClaimUntil?: number;
+        /**
+         * `true` while a REJECTED row's order still shows it unsettled — the
+         * rejection committed, but the order's `invoices[]` entry could not be set to
+         * `rejected` in the same write. Written in that same rejection write, only
+         * then; REMOVEd by the repair that sets the entry — tried at once, then by the
+         * `order-copy-repair` queue's consumer, and by a pending-invoice drain pass
+         * that reaches the store's page (AFIP not known down, its AFIP client up).
+         * ABSENT on every other row, and forward-only.
+         */
+        orderCopyStale?: true;
+        /**
+         * The rejecting caller's ORDER-trail origin, written beside `orderCopyStale`
+         * in the same write and REMOVEd with it, so whichever repairer reaches the
+         * row records the caller's settle rather than its own. Forward-only.
+         */
+        orderCopyStaleOrigin?: Extract<OrderAuditOrigin, 'platform' | 'operator' | 'worker'>;
+        /** The rejecting caller's settle reason — ids only, code-authored. Beside `orderCopyStale`, REMOVEd with it. */
+        orderCopyStaleReason?: string;
+        /** The rejecting caller's actor `userId` (`''` = the system actor). Beside `orderCopyStale`, REMOVEd with it. */
+        orderCopyStaleActorId?: string;
         invoicePrinted?: boolean;
         /**
          * Server-derived ms epoch, stamped by the WSS `ack` handler on an
@@ -1006,15 +1026,36 @@ export declare const INVOICE_ISSUANCE_REFUSAL_RECOVERY: {
  *   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
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) 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.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all 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];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+export declare const INVOICE_NOT_AUTHORIZED_RECOVERIES: readonly ["retry", "support", "final"];
+export type InvoiceNotAuthorizedRecovery = (typeof INVOICE_NOT_AUTHORIZED_RECOVERIES)[number];
 export {};

package/dist/invoice.js

@@ -84,13 +84,33 @@ export const INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  *   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
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) 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.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all 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'];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+export const INVOICE_NOT_AUTHORIZED_RECOVERIES = ['retry', 'support', 'final'];

package/package.json

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