@acontplus/ng-common 1.0.6 → 1.0.8

package/types/acontplus-ng-common.d.ts

@@ -124,30 +124,82 @@ interface ReportPort {
  */
 declare enum SALE_CODE_REPORT {
     /**
-     * SALE REPORT RENTABILIDAD
+     * REPORTE FACTURA
      */
-    SRR = "SRR",
+    RF = "RF",
+    /**
+     * FACTURA GENERAL
+     */
+    FG = "FG",
+    /**
+     * REPORTE NOTA ENTREGA
+     */
+    RNE = "RNE",
+    /**
+     * REPORTE NOTA CREDITO
+     */
+    RNC = "RNCC",
     /**
-     * SALE REPORT RENTABILIDAD CUSTOM
+     * NOTA CREDITO GENERAL
      */
-    SRRC = "SRRC",
+    NCRG = "NCRG",
     /**
-     * SALE REPORT INVOICE GENERAL
+     * REPORTE PROFORMA
      */
-    FG = "FG"
+    PR = "PR",
+    /**
+     * REPORTE RENTABILIDAD
+     */
+    SRR = "SRR",
+    /**
+     * REPORTE RENTABILIDAD CUSTOM
+     */
+    SRRC = "SRRC"
 }
 /**
  * Códigos de reportes de compras
  */
 declare enum PURCHASE_CODE_REPORT {
     /**
-     * REPORTE COMPRAS NOTA HIDDEN
+     * REPORTE LIQUIDACION COMPRA
+     */
+    RLC = "RLC",
+    /**
+     * REPORTE COMPRA DETALLE
+     */
+    RCD = "RCD",
+    /**
+     * REPORTE FACTURA COMPRA
+     */
+    RFC = "RFC",
+    /**
+     * REPORTE COMPRAS NOTA HIDDEN (No Habitual)
      */
     RCNH = "RCNH",
     /**
-     * REPORTE LIQUIDACION COMPRA
+     * ORDEN COMPRA
      */
-    RLC = "RLC"
+    ROC = "ROC",
+    /**
+     * REPORTE COMPRAS
+     */
+    RCP = "RCP",
+    /**
+     * REPORTE RECEPCION FACTURA
+     */
+    RRF = "RRF",
+    /**
+     * RECEPCION NOTA CREDITO
+     */
+    RRNC = "RRNC",
+    /**
+     * RECEPCION RETENCION GENERAL
+     */
+    RRG = "RRG",
+    /**
+     * REPORTE RECEPCION NOTA DEBITO
+     */
+    RRND = "RRND"
 }
 /**
  * Códigos de reportes de contabilidad
@@ -164,16 +216,56 @@ declare enum ACCOUNTING_CODE_REPORT {
     /**
      * ASIENTO CONTABLE ESTADO LIBRO CAJA
      */
-    ACELC = "ACELC"
+    ACELC = "ACELC",
+    /**
+     * REPORTE CONTROL CAJA
+     */
+    RCC = "RCC",
+    /**
+     * REPORTE MOVIMIENTO CAJA
+     */
+    RMIE = "RMIE",
+    /**
+     * CONTABILIDAD DETALLE CONTROL CAJA
+     */
+    CDCC = "CDCC"
 }
 /**
- * Códigos de reportes de clientes
+ * Códigos de reportes de clientes y cartera
  */
 declare enum CUSTOMER_CODE_REPORT {
     /**
      * REPORTE CLIENTE LISTADO
      */
-    RCL = "RCL"
+    RCL = "RCL",
+    /**
+     * CUENTA POR COBRAR
+     */
+    CCR = "CCR",
+    /**
+     * CONTABILIDAD CARTERA PROVEEDOR
+     */
+    CCP = "CCP",
+    /**
+     * CONTABILIDAD CARTERA PROVEEDOR CUOTA
+     */
+    CCPC = "CCPC",
+    /**
+     * CONTABILIDAD COBROS POR CUOTAS
+     */
+    RCXC = "RCXC",
+    /**
+     * CONTABILIDAD COBROS POR DOCUMENTOS
+     */
+    RCXD = "RCXD",
+    /**
+     * CONTABILIDAD COBROS POR PAGOS
+     */
+    RCXP = "RCXP",
+    /**
+     * REPORTE ANTICIPO
+     */
+    RA = "RA"
 }
 /**
  * Códigos de reportes de inventario
@@ -249,6 +341,32 @@ declare enum ELECTRONIC_DOCUMENT_CODE {
      */
     NORMAL = "NORMAL"
 }
+/**
+ * Códigos de reporte de Facturación Electrónico
+ */
+declare enum BILLING_CODE_REPORT {
+    /**
+     * FACTURACION ELECTRONICA GENERAL
+     */
+    FEG = "FEG",
+    /**
+     * REPORTE RETENCION
+     */
+    RRC = "RRC"
+}
+/**
+ * Códigos de aprobación de documentos
+ */
+declare enum APPROVAL_CODE_REPORT {
+    /**
+     * APROBACION FACTURA
+     */
+    PRE_F = "RAC",
+    /**
+     * APROBACION NOTA ENTREGA
+     */
+    P_NE = "P-NE"
+}
 /**
  * Formatos de reporte disponibles
  */
@@ -257,6 +375,15 @@ declare enum REPORT_FORMAT {
     EXCEL = "excel",
     WORD = "word"
 }
+/**
+ * Códigos de soporte técnico
+ */
+declare enum TECHNICAL_SUPPORT_CODE_REPORT {
+    /**
+     * REPORTE SOPORTE TECNICO
+     */
+    RTS = "RTS"
+}
 
 declare const API_PATHS: {
     readonly WHATSAPP: "common/whatsapp-cloud";
@@ -568,13 +695,25 @@ declare class PrinterAdapter implements PrinterPort {
     static ɵprov: i0.ɵɵInjectableDeclaration<PrinterAdapter>;
 }
 
+/**
+ * Tipo union con todos los códigos de reporte soportados
+ */
+type ReportCode = SALE_CODE_REPORT | PURCHASE_CODE_REPORT | ACCOUNTING_CODE_REPORT | CUSTOMER_CODE_REPORT | INVENTORY_CODE_REPORT | ELECTRONIC_DOCUMENT_CODE | APPROVAL_CODE_REPORT | TECHNICAL_SUPPORT_CODE_REPORT | BILLING_CODE_REPORT;
 interface ReportDocumentData {
-    codDoc: string;
+    codDoc?: string;
     codEstab?: string;
     id?: number;
     serie?: string;
     [key: string]: any;
 }
+/**
+ * Opciones para construir un reporte
+ */
+interface BuildReportOptions {
+    codeReport: ReportCode | string;
+    data: ReportDocumentData;
+    format?: 'pdf' | 'excel' | 'word';
+}
 interface ReportParams {
     hasService?: boolean;
     reportParams: string;
@@ -584,7 +723,7 @@ interface ReportConfig {
     codigo: string;
     hasService: boolean;
     useV1Api: boolean;
-    idField: string;
+    idField?: string;
     extraDataParams?: Record<string, any>;
     includeEstabInData?: boolean;
     includeCodigoInData?: boolean;
@@ -599,45 +738,55 @@ declare class ReportParamsBuilder {
     /**
      * Construye los parámetros de reporte según el tipo de documento
      *
-     * @param docData - Datos del documento con codDoc y parámetros adicionales
+     * @param codeReport - Código del reporte (FG, SRR, FV, RCNH, etc.)
+     * @param docData - Datos del documento con parámetros adicionales
      * @param format - Formato del reporte: 'pdf' | 'excel' | 'word'
      * @returns Objeto con hasService, reportParams (string JSON) y dataParams (string JSON)
      *
      * @example
      * ```typescript
      * const params = ReportParamsBuilder.buildParams(
-     *   { codDoc: ELECTRONIC_DOCUMENT_CODE.FV, id: 123, codEstab: '001' },
+     *   SALE_CODE_REPORT.FG,
+     *   { codDoc: '01', tipo: 2, codEstab: '001' },
      *   'pdf'
      * );
      * // Resultado:
      * // {
      * //   hasService: true,
-     * //   reportParams: "{\"codigo\":\"FV\",\"format\":\"pdf\",\"hasParams\":true,...}",
-     * //   dataParams: "{\"id\":123,\"codEstab\":\"001\",\"codigo\":\"FV\"}"
+     * //   reportParams: "{\"codigo\":\"FG\",\"format\":\"pdf\",\"hasParams\":false}",
+     * //   dataParams: "{\"codDoc\":\"01\",\"tipo\":2,\"codEstab\":\"001\"}"
      * // }
      * ```
      */
-    static buildParams(docData: ReportDocumentData, format?: 'pdf' | 'excel' | 'word'): ReportParams;
+    static buildParams(codeReport: ReportCode | string, docData: ReportDocumentData, format?: 'pdf' | 'excel' | 'word'): ReportParams;
     /**
-     * Determina si debe usar la API v1 según el tipo de documento
+     * Determina si debe usar la API v1 o v2 según el código de reporte
+     *
+     * Algunos reportes (como documentos electrónicos) usan API v1,
+     * mientras que otros (reportes de ventas, inventario) usan API v2.
      *
-     * @param codDoc - Código del documento (FV, NE, NC, etc.)
-     * @returns true si debe usar API v1, false para API v2
+     * @param codeReport - Código del reporte
+     * @returns true para API v1, false para API v2
      *
      * @example
      * ```typescript
+     * // Documentos electrónicos usan v1
      * const useV1 = ReportParamsBuilder.shouldUseV1Api(ELECTRONIC_DOCUMENT_CODE.FV);
-     * // useV1 = true (documentos electrónicos usan v1)
+     * console.log(useV1); // true
      *
+     * // Reportes de ventas usan v2
      * const useV1Sales = ReportParamsBuilder.shouldUseV1Api(SALE_CODE_REPORT.FG);
-     * // useV1Sales = false (reportes de ventas usan v2)
+     * console.log(useV1Sales); // false
+     *
+     * // Uso manual (normalmente no necesario, build() lo hace automáticamente)
+     * const apiVersion = useV1 ? '/reporte/download' : '/v2/reporte/download';
      * ```
      */
-    static shouldUseV1Api(codDoc: string): boolean;
+    static shouldUseV1Api(codeReport: ReportCode | string): boolean;
     /**
      * Obtiene la configuración para un tipo de documento
      *
-     * @param codDoc - Código del documento
+     * @param codeReport - Código del reporte (FG, SRR, FV, etc.)
      * @returns Configuración del reporte
      * @throws Error si el tipo de documento no está soportado
      * @private
@@ -671,7 +820,7 @@ declare class ReportParamsBuilder {
      * - codEstab: Código de establecimiento (según configuración)
      * - codigo: Código del reporte (según configuración)
      * - Parámetros extra específicos del tipo (extraDataParams)
-     * - Todos los parámetros adicionales del docData (excepto codDoc, codEstab, id, serie)
+     * - Todos los parámetros adicionales del docData (excepto codEstab, id, serie)
      *
      * @param docData - Datos del documento con parámetros adicionales
      * @param config - Configuración del tipo de reporte
@@ -681,100 +830,171 @@ declare class ReportParamsBuilder {
      * @example
      * ```typescript
      * // Input:
-     * docData = { codDoc: 'FG', tipo: 2, codEstab: '001', fechaInicio: '2024-01-01' }
+     * docData = { codDoc: '01', tipo: 2, codEstab: '001', fechaInicio: '2024-01-01' }
      * config = { idField: 'id', includeEstabInData: false, ... }
      *
      * // Output:
-     * "{\"tipo\":2,\"fechaInicio\":\"2024-01-01\"}"
+     * "{\"codDoc\":\"01\",\"tipo\":2,\"fechaInicio\":\"2024-01-01\"}"
      * ```
      */
     private static buildDataParams;
     /**
      * Construye las opciones completas para generar un reporte
      *
-     * @param docData - Datos del documento con codDoc y parámetros adicionales
+     * @param codeReport - Código del reporte (FG, SRR, FV, RCNH, etc.) - REQUERIDO
+     * @param docData - Datos del documento con parámetros adicionales (sin codeReport)
      * @param format - Formato del reporte: 'pdf' | 'excel' | 'word'
-     * @returns Objeto con data (para enviar al backend), format y useV1Api
+    /**
+     * Construye las opciones completas para generar un reporte
+     *
+     * Método principal que acepta un objeto con opciones tipadas.
+     * Proporciona IntelliSense y validación de tipos en tiempo de desarrollo.
+     *
+     * @param options - Opciones del reporte
+     * @param options.codeReport - Código del reporte (tipado: SALE_CODE_REPORT, PURCHASE_CODE_REPORT, etc.)
+     * @param options.data - Datos del documento (codDoc, tipo, fechas, etc.)
+     * @param options.format - Formato de salida: 'pdf' | 'excel' | 'word' (opcional, por defecto 'pdf')
+     * @returns Objeto con data, format y useV1Api para enviar a la facade
      *
      * @example
      * ```typescript
-     * const options = ReportParamsBuilder.build(
-     *   { codDoc: ELECTRONIC_DOCUMENT_CODE.FV, id: 123, codEstab: '001' },
-     *   'pdf'
-     * );
-     * // Resultado:
-     * // {
-     * //   data: { hasService: true, reportParams: "{...}", dataParams: "{...}" },
-     * //   format: 'pdf',
-     * //   useV1Api: true
-     * // }
+     * // Ejemplo 1: Reporte de ventas
+     * const options = ReportParamsBuilder.build({
+     *   codeReport: SALE_CODE_REPORT.FG,
+     *   data: {
+     *     tipo: 2,
+     *     ckFecha: true,
+     *     codEstab: 'ESTAB-000000216',
+     *     fechaInicio: '2024-01-01',
+     *     fechaFin: '2024-12-31',
+     *     userRoleId: '307'
+     *   },
+     *   format: 'pdf'
+     * });
+     *
+     * // Ejemplo 2: Documento electrónico con codDoc variable
+     * const options2 = ReportParamsBuilder.build({
+     *   codeReport: ELECTRONIC_DOCUMENT_CODE.FV,
+     *   data: {
+     *     id: 123,
+     *     codDoc: '01',  // ← Variable, va a dataParams
+     *     codEstab: '001'
+     *   }
+     *   // format es opcional, por defecto 'pdf'
+     * });
+     *
+     * // Ejemplo 3: Reporte de inventario
+     * const options3 = ReportParamsBuilder.build({
+     *   codeReport: INVENTORY_CODE_REPORT.ARTICULO_PVP,
+     *   data: {
+     *     tipo: 2,
+     *     stockStatusCode: 1,
+     *     idTarifa: 3
+     *   },
+     *   format: 'excel'
+     * });
      *
      * // Usar con facade
-     * this.reportFacade.generate(options).subscribe();
+     * this.reportFacade.open(options).subscribe();
+     * this.reportFacade.download(options2).subscribe();
      * ```
      */
-    static build(docData: ReportDocumentData, format?: 'pdf' | 'excel' | 'word'): {
+    static build(options: BuildReportOptions): {
         data: ReportParams;
         format: "pdf" | "excel" | "word";
         useV1Api: boolean;
     };
     /**
-     * Obtiene la lista de tipos de documento soportados
+     * Obtiene la lista de códigos de reporte soportados
      *
-     * @returns Array con todos los códigos de documento soportados
+     * Devuelve un array con todos los códigos de reporte configurados
+     * en el builder (FV, NE, FG, SRR, RCNH, etc.)
+     *
+     * @returns Array con todos los códigos de reporte disponibles
      *
      * @example
      * ```typescript
      * const types = ReportParamsBuilder.getSupportedDocumentTypes();
-     * // ['FV', 'NE', 'NC', 'ND', 'GR', 'SRR', 'SRRC', 'FG', ...]
+     * console.log(types);
+     * // ['FV', 'NE', 'NC', 'ND', 'GR', 'NORMAL', 'SRR', 'SRRC', 'FG',
+     * //  'RCNH', 'RLC', 'RCEGR', 'ACEDFP', 'ACELC', 'RCL', 'RK', ...]
+     *
+     * // Usar para validación
+     * if (types.includes(myCode)) {
+     *   // Código válido
+     * }
      * ```
      */
     static getSupportedDocumentTypes(): string[];
     /**
-     * Verifica si un tipo de documento está soportado
+     * Verifica si un código de reporte está soportado
+     *
+     * Útil para validar códigos antes de generar reportes,
+     * especialmente cuando el código viene dinámicamente.
      *
-     * @param codDoc - Código del documento a verificar
-     * @returns true si el documento está soportado, false en caso contrario
+     * @param codeReport - Código del reporte a verificar
+     * @returns true si el código está soportado, false en caso contrario
      *
      * @example
      * ```typescript
-     * if (ReportParamsBuilder.isDocumentTypeSupported('FV')) {
-     *   // Generar reporte
+     * // Validación con enum
+     * if (ReportParamsBuilder.isDocumentTypeSupported(SALE_CODE_REPORT.FG)) {
+     *   console.log('Código FG soportado');
+     * }
+     *
+     * // Validación con string dinámico
+     * const dynamicCode = getUserSelectedCode();
+     * if (ReportParamsBuilder.isDocumentTypeSupported(dynamicCode)) {
+     *   const options = ReportParamsBuilder.build({
+     *     codeReport: dynamicCode,
+     *     data: {...}
+     *   });
      * } else {
-     *   console.error('Tipo de documento no soportado');
+     *   console.error('Código no soportado:', dynamicCode);
      * }
      * ```
      */
-    static isDocumentTypeSupported(codDoc: string): boolean;
+    static isDocumentTypeSupported(codeReport: ReportCode | string): boolean;
     /**
      * Registra un nuevo tipo de reporte dinámicamente
      *
-     * Permite agregar soporte para nuevos tipos de reportes en runtime
+     * Permite agregar soporte para códigos de reporte personalizados
      * sin modificar el código fuente de la librería.
+     * Útil para reportes específicos de cada aplicación.
      *
-     * @param codDoc - Código único del documento
+     * @param codeReport - Código único del reporte personalizado
      * @param config - Configuración completa del reporte
      *
      * @example
      * ```typescript
-     * // Agregar un nuevo tipo de reporte personalizado
-     * ReportParamsBuilder.registerReportType('CUSTOM_REPORT', {
-     *   codigo: 'CUSTOM_REPORT',
+     * // Registrar un reporte personalizado
+     * ReportParamsBuilder.registerReportType('MI_REPORTE_CUSTOM', {
+     *   codigo: 'MI_REPORTE_CUSTOM',
      *   hasService: true,
      *   useV1Api: false,
      *   idField: 'id',
      *   hasParams: true,
-     *   extraDataParams: { customField: 'value' }
+     *   includeEstabInData: true,
+     *   extraDataParams: {
+     *     tipoCustom: 'especial',
+     *     version: 2
+     *   }
      * });
      *
-     * // Ahora se puede usar
-     * const options = ReportParamsBuilder.build(
-     *   { codDoc: 'CUSTOM_REPORT', id: 123 },
-     *   'pdf'
-     * );
+     * // Ahora se puede usar como cualquier otro reporte
+     * const options = ReportParamsBuilder.build({
+     *   codeReport: 'MI_REPORTE_CUSTOM',
+     *   data: { id: 123, codEstab: '001' },
+     *   format: 'pdf'
+     * });
+     *
+     * // Verificar si fue registrado
+     * console.log(
+     *   ReportParamsBuilder.isDocumentTypeSupported('MI_REPORTE_CUSTOM')
+     * ); // true
      * ```
      */
-    static registerReportType(codDoc: string, config: ReportConfig): void;
+    static registerReportType(codeReport: string, config: ReportConfig): void;
 }
 
 interface DocumentDeliveryData {
@@ -932,5 +1152,5 @@ declare class WhatsAppSender implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<WhatsAppSender, "acp-whatsapp-sender", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { ACCOUNTING_CODE_REPORT, API_PATHS, CUSTOMER_CODE_REPORT, DOCUMENT_TYPES, ELECTRONIC_DOCUMENT_CODE, FileMapperUtil, GreenWhatsAppAdapter, INVENTORY_CODE_REPORT, MetaWhatsAppAdapter, PRINTER_PORT, PURCHASE_CODE_REPORT, PhoneFormatterUtil, PrinterAdapter, PrinterFacade, REPORT_FORMAT, REPORT_PORT, ReportAdapter, ReportFacade, ReportParamsBuilder, SALE_CODE_REPORT, WHATSAPP_MESSAGING_PORT, WhatsAppMessageBuilder, WhatsAppMessagingFacade, WhatsAppSender };
-export type { ApiResponse, DocumentData, DocumentDeliveryData, DocumentDeliveryParams, PhoneValidationResult, PrintConfig, PrintParams, PrinterPort, ReportDocumentData, ReportOptions, ReportParams, ReportPort, WhatsAppDocumentMessage, WhatsAppDocumentRequest, WhatsAppDocumentTemplateMessage, WhatsAppDocumentTemplateRequest, WhatsAppMessageResponse, WhatsAppMessages, WhatsAppMessagingPort, WhatsAppProviderStatus, WhatsAppResponse, WhatsAppSendConfig, WhatsAppStatusResponse, WhatsAppTemplateMessage, WhatsAppTextMessage, WhatsAppTextRequest, WhatsAppTextTemplateRequest };
+export { ACCOUNTING_CODE_REPORT, API_PATHS, APPROVAL_CODE_REPORT, BILLING_CODE_REPORT, CUSTOMER_CODE_REPORT, DOCUMENT_TYPES, ELECTRONIC_DOCUMENT_CODE, FileMapperUtil, GreenWhatsAppAdapter, INVENTORY_CODE_REPORT, MetaWhatsAppAdapter, PRINTER_PORT, PURCHASE_CODE_REPORT, PhoneFormatterUtil, PrinterAdapter, PrinterFacade, REPORT_FORMAT, REPORT_PORT, ReportAdapter, ReportFacade, ReportParamsBuilder, SALE_CODE_REPORT, TECHNICAL_SUPPORT_CODE_REPORT, WHATSAPP_MESSAGING_PORT, WhatsAppMessageBuilder, WhatsAppMessagingFacade, WhatsAppSender };
+export type { ApiResponse, BuildReportOptions, DocumentData, DocumentDeliveryData, DocumentDeliveryParams, PhoneValidationResult, PrintConfig, PrintParams, PrinterPort, ReportCode, ReportDocumentData, ReportOptions, ReportParams, ReportPort, WhatsAppDocumentMessage, WhatsAppDocumentRequest, WhatsAppDocumentTemplateMessage, WhatsAppDocumentTemplateRequest, WhatsAppMessageResponse, WhatsAppMessages, WhatsAppMessagingPort, WhatsAppProviderStatus, WhatsAppResponse, WhatsAppSendConfig, WhatsAppStatusResponse, WhatsAppTemplateMessage, WhatsAppTextMessage, WhatsAppTextRequest, WhatsAppTextTemplateRequest };