arca-sdk 1.2.2 → 1.3.0

package/dist/index.d.cts

@@ -635,6 +635,10 @@ declare class WsfeService {
      * Valida que todos los items tengan alícuota IVA definida
      */
     private validateItemsWithVAT;
+    /**
+     * Valida obligatoriamente al comprador cuando el monto es mayor o igual a $10.000.000 para consumidor final
+     */
+    private validateBuyer;
     /**
      * Calcula el IVA agrupado por alícuota (requerido por ARCA para Factura A/B)
      */
@@ -710,8 +714,10 @@ interface Taxpayer {
     mainActivity?: string;
     /** ¿Está inscripto en IVA? */
     isVATRegistered: boolean;
-    /** ¿Es monotributista? */
+    /** ¿Es monotributista (Régimen General o Social)? */
     isMonotax: boolean;
+    /** ¿Es exclusivamente Monotributista Social / Autónomo / Promovido? */
+    isSocialMonotax: boolean;
     /** ¿Es exento de IVA? */
     isVATExempt: boolean;
 }
@@ -767,6 +773,123 @@ declare class PadronService {
     private toArray;
 }
 
+/**
+ * Configuration for CaeaService (identical to WsfeConfig)
+ */
+type CaeaConfig = WsfeConfig;
+/**
+ * Request parameter for soliciting a CAEA
+ */
+interface CAEASolicitarRequest {
+    /** Period in AAAAMM format (e.g. '202606') */
+    period: string;
+    /** Quinzena order (1 for days 1-15, 2 for days 16-end) */
+    order: number;
+}
+/**
+ * Response representing a solicited CAEA
+ */
+interface CAEASolicitarResponse {
+    /** The obtained CAEA code */
+    caea: string;
+    /** The period (AAAAMM) */
+    period: number;
+    /** The order of the fortnight (1 or 2) */
+    order: number;
+    /** Expiry date of the CAEA (YYYYMMDD) */
+    expiryDate: string;
+    /** Actual date of processing (YYYYMMDD) */
+    actualDate: string;
+    /** Reception date (YYYYMMDD) */
+    receptionDate: string;
+    /** Limit date for reporting invoices under this CAEA (YYYYMMDD) */
+    limitDate: string;
+}
+/**
+ * Response for querying a CAEA (same fields as CAEASolicitarResponse)
+ */
+type CAEAConsultarResponse = CAEASolicitarResponse;
+/**
+ * Invoice emitted under contingency that needs to be reported in batch
+ */
+interface CaeaInvoice {
+    /** Type of invoice (e.g. InvoiceType.FACTURA_A, FACTURA_B, etc.) */
+    invoiceType: InvoiceType;
+    /** Concept (e.g. BillingConcept.PRODUCTS, SERVICES, etc.) */
+    concept: BillingConcept;
+    /** Invoice number (correlative) */
+    invoiceNumber: number;
+    /** Date of the invoice (default: today) */
+    date?: Date;
+    /** Buyer information */
+    buyer?: Buyer;
+    /** Items included in the invoice */
+    items: InvoiceItem[];
+    /** Associated invoices (required for Credit/Debit Notes) */
+    associatedInvoices?: AssociatedInvoice[];
+    /** Optional parameters (e.g., VatCondition RG 5616) */
+    optionals?: InvoiceOptional[];
+    /** Prices already include VAT (default: false) */
+    includesVAT?: boolean;
+}
+/**
+ * Response for reporting CAEA invoices
+ */
+interface CAEARegInformativoResponse {
+    /** The reported CAEA */
+    caea: string;
+    /** The status result ('A' = Approved, 'R' = Rejected) */
+    result: 'A' | 'R';
+    /** Point of sale */
+    pointOfSale: number;
+    /** Invoice type reported */
+    invoiceType: number;
+    /** Any observations/warnings returned by ARCA */
+    observations?: string[];
+}
+
+/**
+ * Servicio de Código de Autorización Electrónico Anticipado (CAEA)
+ *
+ * Provee soporte para el esquema de contingencia obligatorio de ARCA
+ * según Resoluciones Generales RG 5782/2025 y RG 5785/2025.
+ */
+declare class CaeaService {
+    private config;
+    constructor(config: CaeaConfig);
+    private validateConfig;
+    /**
+     * Solicita un CAEA (Código de Autorización Electrónico Anticipado) para una quincena específica (FECAEASolicitar).
+     */
+    solicitCAEA(params: CAEASolicitarRequest): Promise<CAEASolicitarResponse>;
+    /**
+     * Consulta un CAEA ya emitido (FECAEAConsultar).
+     */
+    getCAEA(caea: string): Promise<CAEAConsultarResponse>;
+    /**
+     * Rinde/registra informativamente los comprobantes emitidos en contingencia local bajo un CAEA específico (FECAEARegInformativo).
+     * Soporta el envío en lotes de comprobantes homogéneos del mismo tipo de factura y punto de venta.
+     */
+    reportCAEAPeriod(params: {
+        caea: string;
+        invoices: CaeaInvoice[];
+    }): Promise<CAEARegInformativoResponse>;
+    /**
+     * Informa que un CAEA no tuvo movimientos en la quincena (FECAEASinMovimientoInformar).
+     */
+    reportCAEANoMovement(params: {
+        caea: string;
+    }): Promise<void>;
+    /**
+     * Consulta si se informó la falta de movimientos de un CAEA (FECAEASinMovimientoConsultar).
+     */
+    getCAEANoMovement(caea: string): Promise<any>;
+    /**
+     * Mapea alícuotas numéricas a los códigos internos de ARCA
+     */
+    private getVATCode;
+}
+
 /**
  * Genera la URL completa con el código QR para un comprobante emitido.
  * Implementa la versión oficial con orden estricto de campos según spec de ARCA.
@@ -779,4 +902,4 @@ declare class PadronService {
  */
 declare function generateQRUrl(caeResponse: CAEResponse, issuerCUIT: string, total: number, buyer?: Buyer): string;
 
-export { type Activity, type Address, ArcaAuthError, type ArcaConfig, ArcaError, ArcaNetworkError, ArcaValidationError, BillingConcept, type Buyer, type CAEResponse, type Environment, type InvoiceDetails, type InvoiceItem, InvoiceType, type IssueInvoiceRequest, type LoginTicket, PadronService, type PointOfSale, type ServiceStatus, TaxIdType, type TaxRecord, type Taxpayer, type TaxpayerResponse, type TaxpayerServiceConfig, type TokenStorage, VatCondition, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generateQRUrl };
+export { type Activity, type Address, ArcaAuthError, type ArcaConfig, ArcaError, ArcaNetworkError, ArcaValidationError, BillingConcept, type Buyer, type CAEAConsultarResponse, type CAEARegInformativoResponse, type CAEASolicitarRequest, type CAEASolicitarResponse, type CAEResponse, type CaeaConfig, type CaeaInvoice, CaeaService, type Environment, type InvoiceDetails, type InvoiceItem, InvoiceType, type IssueInvoiceRequest, type LoginTicket, PadronService, type PointOfSale, type ServiceStatus, TaxIdType, type TaxRecord, type Taxpayer, type TaxpayerResponse, type TaxpayerServiceConfig, type TokenStorage, VatCondition, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generateQRUrl };

package/dist/index.d.ts

@@ -635,6 +635,10 @@ declare class WsfeService {
      * Valida que todos los items tengan alícuota IVA definida
      */
     private validateItemsWithVAT;
+    /**
+     * Valida obligatoriamente al comprador cuando el monto es mayor o igual a $10.000.000 para consumidor final
+     */
+    private validateBuyer;
     /**
      * Calcula el IVA agrupado por alícuota (requerido por ARCA para Factura A/B)
      */
@@ -710,8 +714,10 @@ interface Taxpayer {
     mainActivity?: string;
     /** ¿Está inscripto en IVA? */
     isVATRegistered: boolean;
-    /** ¿Es monotributista? */
+    /** ¿Es monotributista (Régimen General o Social)? */
     isMonotax: boolean;
+    /** ¿Es exclusivamente Monotributista Social / Autónomo / Promovido? */
+    isSocialMonotax: boolean;
     /** ¿Es exento de IVA? */
     isVATExempt: boolean;
 }
@@ -767,6 +773,123 @@ declare class PadronService {
     private toArray;
 }
 
+/**
+ * Configuration for CaeaService (identical to WsfeConfig)
+ */
+type CaeaConfig = WsfeConfig;
+/**
+ * Request parameter for soliciting a CAEA
+ */
+interface CAEASolicitarRequest {
+    /** Period in AAAAMM format (e.g. '202606') */
+    period: string;
+    /** Quinzena order (1 for days 1-15, 2 for days 16-end) */
+    order: number;
+}
+/**
+ * Response representing a solicited CAEA
+ */
+interface CAEASolicitarResponse {
+    /** The obtained CAEA code */
+    caea: string;
+    /** The period (AAAAMM) */
+    period: number;
+    /** The order of the fortnight (1 or 2) */
+    order: number;
+    /** Expiry date of the CAEA (YYYYMMDD) */
+    expiryDate: string;
+    /** Actual date of processing (YYYYMMDD) */
+    actualDate: string;
+    /** Reception date (YYYYMMDD) */
+    receptionDate: string;
+    /** Limit date for reporting invoices under this CAEA (YYYYMMDD) */
+    limitDate: string;
+}
+/**
+ * Response for querying a CAEA (same fields as CAEASolicitarResponse)
+ */
+type CAEAConsultarResponse = CAEASolicitarResponse;
+/**
+ * Invoice emitted under contingency that needs to be reported in batch
+ */
+interface CaeaInvoice {
+    /** Type of invoice (e.g. InvoiceType.FACTURA_A, FACTURA_B, etc.) */
+    invoiceType: InvoiceType;
+    /** Concept (e.g. BillingConcept.PRODUCTS, SERVICES, etc.) */
+    concept: BillingConcept;
+    /** Invoice number (correlative) */
+    invoiceNumber: number;
+    /** Date of the invoice (default: today) */
+    date?: Date;
+    /** Buyer information */
+    buyer?: Buyer;
+    /** Items included in the invoice */
+    items: InvoiceItem[];
+    /** Associated invoices (required for Credit/Debit Notes) */
+    associatedInvoices?: AssociatedInvoice[];
+    /** Optional parameters (e.g., VatCondition RG 5616) */
+    optionals?: InvoiceOptional[];
+    /** Prices already include VAT (default: false) */
+    includesVAT?: boolean;
+}
+/**
+ * Response for reporting CAEA invoices
+ */
+interface CAEARegInformativoResponse {
+    /** The reported CAEA */
+    caea: string;
+    /** The status result ('A' = Approved, 'R' = Rejected) */
+    result: 'A' | 'R';
+    /** Point of sale */
+    pointOfSale: number;
+    /** Invoice type reported */
+    invoiceType: number;
+    /** Any observations/warnings returned by ARCA */
+    observations?: string[];
+}
+
+/**
+ * Servicio de Código de Autorización Electrónico Anticipado (CAEA)
+ *
+ * Provee soporte para el esquema de contingencia obligatorio de ARCA
+ * según Resoluciones Generales RG 5782/2025 y RG 5785/2025.
+ */
+declare class CaeaService {
+    private config;
+    constructor(config: CaeaConfig);
+    private validateConfig;
+    /**
+     * Solicita un CAEA (Código de Autorización Electrónico Anticipado) para una quincena específica (FECAEASolicitar).
+     */
+    solicitCAEA(params: CAEASolicitarRequest): Promise<CAEASolicitarResponse>;
+    /**
+     * Consulta un CAEA ya emitido (FECAEAConsultar).
+     */
+    getCAEA(caea: string): Promise<CAEAConsultarResponse>;
+    /**
+     * Rinde/registra informativamente los comprobantes emitidos en contingencia local bajo un CAEA específico (FECAEARegInformativo).
+     * Soporta el envío en lotes de comprobantes homogéneos del mismo tipo de factura y punto de venta.
+     */
+    reportCAEAPeriod(params: {
+        caea: string;
+        invoices: CaeaInvoice[];
+    }): Promise<CAEARegInformativoResponse>;
+    /**
+     * Informa que un CAEA no tuvo movimientos en la quincena (FECAEASinMovimientoInformar).
+     */
+    reportCAEANoMovement(params: {
+        caea: string;
+    }): Promise<void>;
+    /**
+     * Consulta si se informó la falta de movimientos de un CAEA (FECAEASinMovimientoConsultar).
+     */
+    getCAEANoMovement(caea: string): Promise<any>;
+    /**
+     * Mapea alícuotas numéricas a los códigos internos de ARCA
+     */
+    private getVATCode;
+}
+
 /**
  * Genera la URL completa con el código QR para un comprobante emitido.
  * Implementa la versión oficial con orden estricto de campos según spec de ARCA.
@@ -779,4 +902,4 @@ declare class PadronService {
  */
 declare function generateQRUrl(caeResponse: CAEResponse, issuerCUIT: string, total: number, buyer?: Buyer): string;
 
-export { type Activity, type Address, ArcaAuthError, type ArcaConfig, ArcaError, ArcaNetworkError, ArcaValidationError, BillingConcept, type Buyer, type CAEResponse, type Environment, type InvoiceDetails, type InvoiceItem, InvoiceType, type IssueInvoiceRequest, type LoginTicket, PadronService, type PointOfSale, type ServiceStatus, TaxIdType, type TaxRecord, type Taxpayer, type TaxpayerResponse, type TaxpayerServiceConfig, type TokenStorage, VatCondition, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generateQRUrl };
+export { type Activity, type Address, ArcaAuthError, type ArcaConfig, ArcaError, ArcaNetworkError, ArcaValidationError, BillingConcept, type Buyer, type CAEAConsultarResponse, type CAEARegInformativoResponse, type CAEASolicitarRequest, type CAEASolicitarResponse, type CAEResponse, type CaeaConfig, type CaeaInvoice, CaeaService, type Environment, type InvoiceDetails, type InvoiceItem, InvoiceType, type IssueInvoiceRequest, type LoginTicket, PadronService, type PointOfSale, type ServiceStatus, TaxIdType, type TaxRecord, type Taxpayer, type TaxpayerResponse, type TaxpayerServiceConfig, type TokenStorage, VatCondition, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generateQRUrl };