sinfactura-types 1.8.0 → 1.8.2

package/dist/invoice.d.ts

@@ -1,5 +1,26 @@
 declare global {
     type FiscalStatus = 'pending_cae' | 'authorized_cae' | 'authorized_caea' | 'caea_reported' | 'rejected' | 'voided';
+    /**
+     * One discriminated IVA alicuota on an issued voucher (api#1961).
+     *
+     * `id` is AFIP's WSFE `Iva[].Id`, which is ALSO the Libro IVA Digital alicuota
+     * code once 4-padded — verified against ARCA's *Tablas del SISTEMA* section 1:
+     * 0003 = 0,00 % · 0004 = 10,50 % · 0005 = 21,00 % · 0006 = 27,00 % ·
+     * 0008 = 5,00 % · 0009 = 2,50 %. Those six are the whole valid domain; Ids 1
+     * and 2 (No Gravado / Exento) are Codigos de Operacion, not alicuotas, and
+     * WSFEv1 rejects them inside `Iva[]`.
+     *
+     * A bucket is meaningful when `baseImp !== 0`: a 0 %-rated line has
+     * `importe === 0` but is still a real, declarable alicuota.
+     */
+    interface InvoiceAlicuota {
+        /** AFIP WSFE `Iva[].Id` — one of 3, 4, 5, 6, 8, 9. */
+        id: number;
+        /** Neto gravado at this rate. */
+        baseImp: number;
+        /** IVA liquidado at this rate; `0` for the 0 % rate. */
+        importe: number;
+    }
     interface Invoice {
         storeId: string;
         invoiceId: string;
@@ -28,6 +49,21 @@ declare global {
         neto21: number;
         iva10: number;
         iva21: number;
+        /**
+         * api#1961 — the FULL per-alicuota IVA breakdown, one entry per declared rate.
+         *
+         * The `neto10`/`neto21`/`iva10`/`iva21` quartet above only ever captured AFIP
+         * Iva Ids 4 (10,5 %) and 5 (21 %). The catalog has SIX rates, so the other
+         * four (0 %, 2,5 %, 5 %, 27 %) were declared to ARCA yet dropped from the row,
+         * while `total` included every bucket — silently under-reporting the Libro IVA
+         * Digital, the RG 3685 export, the F.2051 apertura and the invoice PDF.
+         *
+         * Forward-only, no backfill: absent on every row issued before api#1961, and
+         * never set on the WSFEX export path. Consumers MUST fall back to the legacy
+         * quartet when it is absent rather than treating an empty result as "no IVA".
+         * The quartet is retained, not deprecated — still written on every new row.
+         */
+        alicuotas?: InvoiceAlicuota[];
         discount?: number;
         total: number;
         cae: string;
@@ -327,6 +363,13 @@ declare global {
         effectiveFrom: string;
         acceptanceWindowDays: number;
         acceptanceWindowValidThrough?: string;
+        /**
+         * api#1754 — epoch-ms last-write trace, set by the api on every threshold
+         * write and echoed on GET /config + the POST response (api PLATFORM_API.md
+         * section 20). OPTIONAL by design: a row written before the field carries
+         * none, so a reader must not treat its absence as "never updated".
+         */
+        updatedAt?: number;
     }
 }
 export {};

package/dist/store.d.ts

@@ -109,6 +109,14 @@ declare global {
              * default — does NOT reinterpret existing Account rows.
              */
             defaultAccountCurrency?: string;
+            /**
+             * api#1768 / ADR-0004 section 5 — tenant opt-out from AI product
+             * enrichment. Absent is the (common) "tenant never touched the toggle"
+             * default and does NOT block; only an explicit `true` blocks. The api
+             * gate is fail-CLOSED on a read failure, but open on a missing field —
+             * do not conflate the two.
+             */
+            aiOptOut?: boolean;
             /**
              * api#1740 — per-category × per-channel notification/feedback defaults.
              * Store-level baseline the app layers per-device overrides on top of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinfactura-types",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "main": "dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",