sinfactura-types 1.6.35 → 1.6.36

package/dist/audit.d.ts

@@ -31,7 +31,7 @@ declare global {
         newValue: unknown;
     }
     type OrderAuditAction = 'order_created' | 'order_edited' | 'order_ready' | 'order_delivered' | 'order_delivery_cancelled' | 'order_disabled' | 'order_enabled' | 'order_returned' | 'discount_changed' | 'payment_method_changed' | 'delivery_method_changed' | 'delivery_address_changed' | 'invoice_created' | 'credit_note_created';
-    /** One ARCA fiscal SOAP interaction (FECAESolicitar | FECompConsultar). Stored raw (CUIT unmasked) for 10y; masked at read. */
+    /** One ARCA fiscal SOAP interaction (FECAESolicitar | FECompConsultar | ConstatarComprobante). Stored raw (CUIT unmasked) for 10y; masked at read. */
     interface FiscalAuditEvent {
         /** Schema version for forward-compat (start at 1). */
         schema_version: number;
@@ -41,8 +41,10 @@ declare global {
         tenant_store_id: string;
         /** Unix ms when the interaction completed. */
         ts: number;
-        /** Which ARCA fiscal op. */
-        operation: 'FECAESolicitar' | 'FECompConsultar';
+        /** Which ARCA fiscal op. `ConstatarComprobante` added for WSCDC
+         * third-party voucher verification (api#1500), which logs every check
+         * to this same table per its AC. */
+        operation: 'FECAESolicitar' | 'FECompConsultar' | 'ConstatarComprobante';
         /** Issuer CUIT (RAW — masked only at display). */
         cuit: string;
         /** AFIP environment the call hit. */

package/dist/invoice.d.ts

@@ -34,6 +34,12 @@ declare global {
         caeExpiration: string;
         observations?: string;
         fiscalStatus?: FiscalStatus;
+        arcaError?: ArcaError;
+        arcaObservations?: InvoiceObservation[];
+        caea?: string;
+        caeaPeriod?: string;
+        export?: ExportInvoiceFields;
+        fce?: FceFields;
         serviceStartDate?: number;
         serviceEndDate?: number;
         paymentDueDate?: number;
@@ -89,5 +95,115 @@ declare global {
         comprasCbte: string;
         comprasAlicuotas: string;
     }
+    /**
+     * ARCA Obs.Code/Obs.Msg pair, parsed from FECAESolicitar's Observaciones[]
+     * when Resultado='O' (approved-with-warnings). (api#1559)
+     *
+     * `code`/`msg` naming matches the already-shipped `FiscalAuditEvent.observaciones`
+     * / `.errores` shape (api#1498, audit.ts) rather than inventing a second
+     * convention for the same ARCA concept.
+     */
+    interface InvoiceObservation {
+        code: number;
+        msg: string;
+    }
+    /**
+     * Structured ARCA rejection/observation error (api#1380). Reused by
+     * `CAEAInformResult.errors` below rather than inventing a second shape.
+     */
+    interface ArcaError {
+        code: number;
+        msg: string;
+        category?: 'data_validation' | 'authorization' | 'fiscal_rules' | 'service' | 'infrastructure';
+        observations?: string[];
+    }
+    /** A single CAEA fortnightly period, requested and tracked per store. */
+    interface CAEAPeriod {
+        storeId: string;
+        period: string;
+        caea: string;
+        validFrom: string;
+        validTo: string;
+        status: 'active' | 'used' | 'informed' | 'expired';
+        invoiceCount: number;
+        informedAt?: string;
+    }
+    /** Result of requesting a new CAEA code for an upcoming period. */
+    interface CAEARequestResult {
+        period: CAEAPeriod;
+        requestedAt: string;
+    }
+    /** Result of informing ARCA of CAEA-stamped invoices for a period. */
+    interface CAEAInformResult {
+        period: string;
+        invoiceCount: number;
+        informedAt: string;
+        errors?: ArcaError[];
+    }
+    /** Export-invoice-specific fields, present only when Invoice.invoiceType === 19 (Factura E). */
+    interface ExportInvoiceFields {
+        dstCmp: number;
+        idImpositivo?: string;
+        monedaId: string;
+        monedaCtz: number;
+        incoterms?: string;
+        incotermsDs?: string;
+        permisoExistente?: 'S' | 'N';
+        permisoExistenteTipo?: string;
+        permisoExistenteNro?: string;
+        idiomaCbte: 1 | 2 | 3;
+        /** "Cancelación en Misma Moneda Extranjera" -- required only when settled in the same
+         * foreign currency the invoice was issued in (RG 5616/2024 FX-precision rule reaching
+         * voucher class E; added to the WSFEXV1 manual in v3.0.0, 2025-03-17). */
+        canMisMonExt?: boolean;
+    }
+    /** Reference data cached from WSFEXV1 `GetPARAM_*` operations, refreshed on a schedule. */
+    interface WsfexReferenceData {
+        currencies: {
+            id: string;
+            name: string;
+        }[];
+        countries: {
+            id: number;
+            name: string;
+        }[];
+        incoterms: {
+            id: string;
+            name: string;
+        }[];
+        languages: {
+            id: 1 | 2 | 3;
+            name: string;
+        }[];
+        voucherTypes: {
+            id: number;
+            name: string;
+        }[];
+        exportTypes: {
+            id: number;
+            name: string;
+        }[];
+        fetchedAt: string;
+    }
+    type FceStatus = 'emitted' | 'accepted' | 'rejected' | 'ceded';
+    /** FCE-specific fields, present only when Invoice.invoiceType is 201/202/203, 206/207/208, or 211/212/213. */
+    interface FceFields {
+        cbu: string;
+        sca: boolean;
+        status: FceStatus;
+        statusChangedAt?: string;
+        acceptanceDeadline: string;
+        cesionId?: string;
+    }
+    /**
+     * The annually/periodically-adjusted FCE threshold -- do not hard-code the
+     * amount anywhere else; read it from this single config source.
+     */
+    interface FceThresholdConfig {
+        amountArs: number;
+        effectiveFrom: string;
+        acceptanceWindowDays: number;
+        acceptanceWindowValidThrough?: string;
+    }
 }
 export {};

package/dist/order.d.ts

@@ -20,6 +20,8 @@ declare global {
             condFiscalName: string;
             cuit: string;
             razonSocial: string;
+            docType?: number;
+            docNumber?: string;
         };
         cost: number;
         total: number;

package/dist/store.d.ts

@@ -287,6 +287,7 @@ declare global {
         accessTicket_RSF?: string;
         hasCert?: boolean;
         hasKey?: boolean;
+        facturaMLegend?: 'retencion' | 'cbu_informada';
         certExpiry?: number;
     }
     type StoreAttributeNames = keyof Store;

package/dist/supplier.d.ts

@@ -48,6 +48,54 @@ declare global {
         exento?: number;
         cbteClass?: 'A' | 'B' | 'C';
     }
+    /**
+     * WSCDC `ConstatarComprobante` request (api#1500) -- verifies a
+     * third-party (supplier) voucher was genuinely authorized by ARCA before
+     * it's booked/credited as IVA input. Fields per the ticket's tech spec.
+     */
+    interface VoucherVerificationRequest {
+        cuit: string;
+        pointOfSale: number;
+        invoiceType: number;
+        invoiceNumber: number;
+        dated: number;
+        total: number;
+    }
+    /**
+     * WSCDC `ConstatarComprobante` result (api#1500). `result` mirrors the
+     * A/O/R convention already used for `FECAESolicitar`'s own `Resultado`
+     * and `FiscalAuditEvent` (Aceptado/Observado/Rechazado) -- every
+     * verification call is also logged to that same audit table per the
+     * ticket's AC (`FiscalAuditEvent.operation` includes `ConstatarComprobante`).
+     */
+    interface VoucherVerificationResult {
+        result: 'A' | 'O' | 'R';
+        reason?: string;
+        observations?: InvoiceObservation[];
+        verifiedAt: string;
+    }
+    /**
+     * `GET /reports?mode=supplier-invoices` per-date resume row (api#1550) --
+     * compras-side mirror of the ventas `mode=invoices` resume shape. Unlike
+     * ventas Invoice, SupplierInvoice has no CAE-authorization concept, so
+     * every row in range counts (no fiscalStatus filter).
+     */
+    interface SupplierInvoicesResumeRow {
+        date: number;
+        quantity: number;
+        neto10: number;
+        neto21: number;
+        neto27: number;
+        iva10: number;
+        iva21: number;
+        iva27: number;
+        noGravado: number;
+        exento: number;
+        total: number;
+    }
+    interface ReportSupplierInvoicesResponse {
+        resume: SupplierInvoicesResumeRow[];
+    }
     interface SupplierAccount {
         storeId: string;
         userId: string;

package/dist/userActivity.d.ts

@@ -390,7 +390,14 @@ declare global {
         target_user_id: string;
         initiator_role: string;
     }
-    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent;
+    interface IntegrationTokenRefreshedEvent extends UserActivityEventBase {
+        event: 'Integration Token Refreshed';
+        provider: 'mercadopago' | 'gmail';
+        outcome: 'refreshed' | 'disconnected' | 'skipped' | 'error';
+        trigger: 'operator-single' | 'operator-global';
+        detail?: string;
+    }
+    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent | IntegrationTokenRefreshedEvent;
 }
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8

package/dist/userActivity.js

@@ -22,6 +22,7 @@
 //   - 1.6.20 (+1 variant) — operator 2FA reset, target_user_id (api#1335)
 //   - 1.6.21 (+1 variant) — TOTP recovery codes generated (api#1336); method += 'recovery'
 //   - 1.6.34 (+field) — LiteralUpdatedEvent gains `scope`; new `LiteralScope` contract (api#1484)
+//   - (+1 variant) — IntegrationTokenRefreshedEvent (types#91, api#1540)
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8
  * Phase 3 verbs shipped in 1.6.13 (types#74). Imported by the api side

package/package.json

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