platform-types 1.10.735 → 1.10.737

package/dist/cjs/fiscalConditions.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FISCAL_CONDITIONS = void 0;
+/**
+ * The ARCA fiscal-condition catalogue — the ONE definition. It maps each legacy
+ * `condFiscal` code to its display name, its ARCA `DocTipo` and the `CbteTipo`
+ * family that issuance resolves for it.
+ *
+ * Deliberately NOT `declare global`: it is a runtime value, so import it:
+ *
+ * ```ts
+ * import { FISCAL_CONDITIONS } from 'platform-types';
+ * ```
+ *
+ * The api re-exports this exact binding from `stacks/services/fiscalCatalogs.ts`,
+ * which is where invoice issuance reads it.
+ *
+ * ⚠️ **`condFiscal` is NOT a unique key.** Code `32` has two rows: «Iva Exento»
+ * (`DocTipo 80`, a domestic CUIT holder) and «Cliente del Exterior» (`DocTipo 91`).
+ * To NAME a code, prefer its `DocTipo 80` row and fall back to its only row, so
+ * `32` reads «Iva Exento» and `99`/`96` read Consumidor Final (spelled
+ * differently on the two rows):
+ *
+ * ```ts
+ * const rows = FISCAL_CONDITIONS.filter((c) => c.condFiscal === code);
+ * const name = (rows.find((c) => c.DocTipo === 80) ?? rows[0])?.name;
+ * ```
+ *
+ * `undefined` means a code this catalogue does not hold — issuance refuses such
+ * an order rather than guessing, so render it as unknown, never as a default.
+ *
+ * Provenance: these are AFIP-standardized catalogues, identical for every
+ * tenant, so a reviewed and versioned file is their home rather than a DynamoDB
+ * row an operator could silently edit. This is a byte-identical snapshot of the
+ * retired `STORE#CONFIG` row, cross-checked against both dev and prod, with ONE
+ * deliberate divergence: id 5's `CbteTipo.NC`/`ND` are corrected (see that row).
+ *
+ * `CbteTipo.NVC` is declared by `FiscalCondition` but was never populated on the
+ * live row and nothing reads it: the one hardcoded non-Responsable-Inscripto
+ * fallback in issuance sets its own literal `NVC: 16`. The `0` here is an inert
+ * placeholder that satisfies the type, not a real AFIP code.
+ */
+exports.FISCAL_CONDITIONS = [
+    {
+        id: 1,
+        name: 'Consumidor Final',
+        condFiscal: 99,
+        DocTipo: 99,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+    {
+        id: 2,
+        name: 'Responsable Inscripto',
+        condFiscal: 30,
+        DocTipo: 80,
+        CbteTipo: { FAC: 1, REC: 4, NC: 3, ND: 2, NVC: 0 },
+    },
+    {
+        id: 3,
+        name: 'Responsable Monotributo',
+        condFiscal: 20,
+        DocTipo: 80,
+        CbteTipo: { FAC: 1, REC: 4, NC: 3, ND: 2, NVC: 0 },
+    },
+    {
+        id: 4,
+        name: 'Iva Exento',
+        condFiscal: 32,
+        DocTipo: 80,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+    {
+        id: 5,
+        name: 'Cliente del Exterior',
+        condFiscal: 32,
+        DocTipo: 91,
+        // NC/ND corrected from the legacy snapshot, which had them transposed vs
+        // RG 5762 (52 = ND, 53 = NC). `.CbteTipo` is unreachable at runtime here:
+        // a `condFiscal` 32 lookup resolves to id 4, not id 5.
+        CbteTipo: { FAC: 51, REC: 54, NC: 53, ND: 52, NVC: 0 },
+    },
+    {
+        id: 6,
+        name: 'CONSUMIDOR FINAL',
+        condFiscal: 96,
+        DocTipo: 96,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+];

package/dist/cjs/index.js

@@ -52,6 +52,7 @@ __exportStar(require("./customerTimeline.js"), exports);
 __exportStar(require("./cycleCount.js"), exports);
 __exportStar(require("./delivery.js"), exports);
 __exportStar(require("./favorite.js"), exports);
+__exportStar(require("./fiscalConditions.js"), exports);
 __exportStar(require("./gating.js"), exports);
 __exportStar(require("./holdingCost.js"), exports);
 __exportStar(require("./demo.js"), exports);

package/dist/fiscalConditions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The ARCA fiscal-condition catalogue — the ONE definition. It maps each legacy
+ * `condFiscal` code to its display name, its ARCA `DocTipo` and the `CbteTipo`
+ * family that issuance resolves for it.
+ *
+ * Deliberately NOT `declare global`: it is a runtime value, so import it:
+ *
+ * ```ts
+ * import { FISCAL_CONDITIONS } from 'platform-types';
+ * ```
+ *
+ * The api re-exports this exact binding from `stacks/services/fiscalCatalogs.ts`,
+ * which is where invoice issuance reads it.
+ *
+ * ⚠️ **`condFiscal` is NOT a unique key.** Code `32` has two rows: «Iva Exento»
+ * (`DocTipo 80`, a domestic CUIT holder) and «Cliente del Exterior» (`DocTipo 91`).
+ * To NAME a code, prefer its `DocTipo 80` row and fall back to its only row, so
+ * `32` reads «Iva Exento» and `99`/`96` read Consumidor Final (spelled
+ * differently on the two rows):
+ *
+ * ```ts
+ * const rows = FISCAL_CONDITIONS.filter((c) => c.condFiscal === code);
+ * const name = (rows.find((c) => c.DocTipo === 80) ?? rows[0])?.name;
+ * ```
+ *
+ * `undefined` means a code this catalogue does not hold — issuance refuses such
+ * an order rather than guessing, so render it as unknown, never as a default.
+ *
+ * Provenance: these are AFIP-standardized catalogues, identical for every
+ * tenant, so a reviewed and versioned file is their home rather than a DynamoDB
+ * row an operator could silently edit. This is a byte-identical snapshot of the
+ * retired `STORE#CONFIG` row, cross-checked against both dev and prod, with ONE
+ * deliberate divergence: id 5's `CbteTipo.NC`/`ND` are corrected (see that row).
+ *
+ * `CbteTipo.NVC` is declared by `FiscalCondition` but was never populated on the
+ * live row and nothing reads it: the one hardcoded non-Responsable-Inscripto
+ * fallback in issuance sets its own literal `NVC: 16`. The `0` here is an inert
+ * placeholder that satisfies the type, not a real AFIP code.
+ */
+export declare const FISCAL_CONDITIONS: FiscalCondition[];

package/dist/fiscalConditions.js

@@ -0,0 +1,86 @@
+/**
+ * The ARCA fiscal-condition catalogue — the ONE definition. It maps each legacy
+ * `condFiscal` code to its display name, its ARCA `DocTipo` and the `CbteTipo`
+ * family that issuance resolves for it.
+ *
+ * Deliberately NOT `declare global`: it is a runtime value, so import it:
+ *
+ * ```ts
+ * import { FISCAL_CONDITIONS } from 'platform-types';
+ * ```
+ *
+ * The api re-exports this exact binding from `stacks/services/fiscalCatalogs.ts`,
+ * which is where invoice issuance reads it.
+ *
+ * ⚠️ **`condFiscal` is NOT a unique key.** Code `32` has two rows: «Iva Exento»
+ * (`DocTipo 80`, a domestic CUIT holder) and «Cliente del Exterior» (`DocTipo 91`).
+ * To NAME a code, prefer its `DocTipo 80` row and fall back to its only row, so
+ * `32` reads «Iva Exento» and `99`/`96` read Consumidor Final (spelled
+ * differently on the two rows):
+ *
+ * ```ts
+ * const rows = FISCAL_CONDITIONS.filter((c) => c.condFiscal === code);
+ * const name = (rows.find((c) => c.DocTipo === 80) ?? rows[0])?.name;
+ * ```
+ *
+ * `undefined` means a code this catalogue does not hold — issuance refuses such
+ * an order rather than guessing, so render it as unknown, never as a default.
+ *
+ * Provenance: these are AFIP-standardized catalogues, identical for every
+ * tenant, so a reviewed and versioned file is their home rather than a DynamoDB
+ * row an operator could silently edit. This is a byte-identical snapshot of the
+ * retired `STORE#CONFIG` row, cross-checked against both dev and prod, with ONE
+ * deliberate divergence: id 5's `CbteTipo.NC`/`ND` are corrected (see that row).
+ *
+ * `CbteTipo.NVC` is declared by `FiscalCondition` but was never populated on the
+ * live row and nothing reads it: the one hardcoded non-Responsable-Inscripto
+ * fallback in issuance sets its own literal `NVC: 16`. The `0` here is an inert
+ * placeholder that satisfies the type, not a real AFIP code.
+ */
+export const FISCAL_CONDITIONS = [
+    {
+        id: 1,
+        name: 'Consumidor Final',
+        condFiscal: 99,
+        DocTipo: 99,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+    {
+        id: 2,
+        name: 'Responsable Inscripto',
+        condFiscal: 30,
+        DocTipo: 80,
+        CbteTipo: { FAC: 1, REC: 4, NC: 3, ND: 2, NVC: 0 },
+    },
+    {
+        id: 3,
+        name: 'Responsable Monotributo',
+        condFiscal: 20,
+        DocTipo: 80,
+        CbteTipo: { FAC: 1, REC: 4, NC: 3, ND: 2, NVC: 0 },
+    },
+    {
+        id: 4,
+        name: 'Iva Exento',
+        condFiscal: 32,
+        DocTipo: 80,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+    {
+        id: 5,
+        name: 'Cliente del Exterior',
+        condFiscal: 32,
+        DocTipo: 91,
+        // NC/ND corrected from the legacy snapshot, which had them transposed vs
+        // RG 5762 (52 = ND, 53 = NC). `.CbteTipo` is unreachable at runtime here:
+        // a `condFiscal` 32 lookup resolves to id 4, not id 5.
+        CbteTipo: { FAC: 51, REC: 54, NC: 53, ND: 52, NVC: 0 },
+    },
+    {
+        id: 6,
+        name: 'CONSUMIDOR FINAL',
+        condFiscal: 96,
+        DocTipo: 96,
+        CbteTipo: { FAC: 6, REC: 9, NC: 8, ND: 7, NVC: 0 },
+    },
+];

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export * from './customerTimeline.ts';
 export * from './cycleCount.ts';
 export * from './delivery.ts';
 export * from './favorite.ts';
+export * from './fiscalConditions.ts';
 export * from './gating.ts';
 export * from './holdingCost.ts';
 export * from './demo.ts';

package/dist/index.js

@@ -36,6 +36,7 @@ export * from "./customerTimeline.js";
 export * from "./cycleCount.js";
 export * from "./delivery.js";
 export * from "./favorite.js";
+export * from "./fiscalConditions.js";
 export * from "./gating.js";
 export * from "./holdingCost.js";
 export * from "./demo.js";

package/dist/order.d.ts

@@ -953,11 +953,35 @@ declare global {
          * its own — method ids are per-catalog ordinals.
          */
         deliveryMethod?: number;
+        /**
+         * The receptor the order is invoiced to, as the creating client stated it.
+         *
+         * ⚠️ **Every key is optional, and readers must tolerate each one absent.**
+         * That is what the writers persist, not a loosening: the storefront checkout
+         * validates this object with every key optional and writes it verbatim (an
+         * empty object included), the presupuesto conversion passes the operator's
+         * object through, and only the operator create requires `condFiscal`.
+         *
+         * - `razonSocial` is routinely absent: a Consumidor Final receptor has no
+         *   legal name, and none may be invented for one. A class A or M factura
+         *   (an RI or Monotributo receptor) is never issued without one: issuance
+         *   fills a blank name from the platform Padrón cache for the CUIT, and
+         *   otherwise refuses `400 INVOICE_METHOD_RAZON_SOCIAL_MISSING` until the
+         *   operator completes it.
+         * - `condFiscalName` is display-only and usually absent. Never read it for
+         *   meaning: derive the name from `condFiscal` with the published
+         *   `FISCAL_CONDITIONS` catalogue (its docblock gives the lookup, since
+         *   `condFiscal` alone is not a unique key there).
+         * - `condFiscal` and `cuit` absent are a PERSISTABLE state, not an
+         *   invoiceable one: issuing a factura refuses the order with a coded `400`
+         *   (`INVOICE_METHOD_COND_FISCAL_INVALID`, `INVOICE_METHOD_CUIT_MISSING`)
+         *   until the operator completes it.
+         */
         invoiceMethod?: {
-            condFiscal: number;
-            condFiscalName: string;
-            cuit: string;
-            razonSocial: string;
+            condFiscal?: number;
+            condFiscalName?: string;
+            cuit?: string;
+            razonSocial?: string;
             /**
              * Explicit per-order ARCA receptor identity, decoupled from condFiscal
              * (ARCA DocTipo: 80 = CUIT, 96 = DNI, 99 = Consumidor Final — a

package/package.json

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