fiscalapi 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,25 @@
+export { FiscalapiClient } from './services/fiscalapi-client';
+export { IFiscalapiClient } from './abstractions/fiscalapi-client.interface';
+export { IFiscalapiService } from './abstractions/fiscalapi-service.interface';
+export { IApiKeyService } from './abstractions/api-key-service.interface';
+export { ICatalogService } from './abstractions/catalog-service.interface';
+export { IInvoiceService } from './abstractions/invoice-service.interface';
+export { IPersonService } from './abstractions/person-service.interface';
+export { IProductService } from './abstractions/product-service.interface';
+export { ITaxFileService } from './abstractions/tax-file-service.interface';
+export { ApiKey } from './models/api-key';
+export { Person } from './models/person';
+export { Product, ProductTax } from './models/product';
+export { TaxFile } from './models/tax-file';
+export { Invoice, InvoiceIssuer, InvoiceRecipient, InvoiceItem, InvoiceResponse, TaxCredential, RelatedInvoice, GlobalInformation, ItemTax, InvoicePayment, PaidInvoice, PaidInvoiceTax, CancelInvoiceRequest, CancelInvoiceResponse, InvoiceStatusRequest, InvoiceStatusResponse, CreatePdfRequest, SendInvoiceRequest } from './models/invoice';
+export { FiscalapiSettings } from './common/fiscalapi-settings';
+export { ApiResponse, ValidationFailure } from './common/api-response';
+export { PagedList } from './common/paged-list';
+export { FileResponse } from './common/file-response';
+export { BaseDto } from './common/base-dto';
+export { AuditableDto } from './common/auditable-dto';
+export { SerializableDto } from './common/serializable-dto';
+export { CatalogDto } from './common/catalog-dto';
+export { formatSatDate, parseSatDate, SAT_DATE_FORMAT } from './utils/date-utils';
+export { encodeToBase64, decodeFromBase64 } from './utils/encoding-utils';
+export { isNullOrUndefined, isNullOrEmpty, isArrayNullOrEmpty, isObjectEmpty } from './utils/validation-utils';

package/dist/types/models/api-key.d.ts

@@ -0,0 +1,21 @@
+import { BaseDto } from '../common/base-dto';
+/**
+ * Modelo API Key
+ * Representa una clave de autenticación en fiscalapi
+ */
+export interface ApiKey extends BaseDto {
+    /** El identificador único de la API key */
+    id?: string;
+    /** El entorno al que pertenece la API key */
+    environment?: string;
+    /** El API key. Este valor es el que se utiliza para autenticar las solicitudes */
+    apiKeyValue?: string;
+    /** El identificador único de la persona a la que pertenece la API key */
+    personId?: string;
+    /** El identificador único del tenant al que pertenece la API key */
+    tenantId?: string;
+    /** El estado de la API key. Valores: "0 Disabled  | 1 Enabled " */
+    apiKeyStatus?: number;
+    /** Nombre o descripción de la API key */
+    description?: string;
+}

package/dist/types/models/invoice.d.ts

@@ -0,0 +1,337 @@
+import { DateTime } from 'luxon';
+/**
+ * Modelo factura
+ * Contiene toda la información de una factura, como datos del emisor, receptor,
+ * productos/servicios, importes, método de pago, el tipo de factura, entre otros.
+ */
+export interface Invoice {
+    /** Código de la versión de la facura. Default: "4.0" */
+    versionCode?: string;
+    /** Es el número de serie que utiliza el contribuyente para control interno de su información */
+    series: string;
+    /** Es la fecha y hora de expedición del comprobante fiscal. Se expresa en la forma AAAA-MM-DDThh:mm:ss */
+    date: DateTime | string;
+    /** Consecutivo de facturas por cuenta. Se incrementa con cada factura generada en tu cuenta de Fiscalapi */
+    consecutive?: number;
+    /** Consecutivo de facturas por RFC emisor. Se incrementa por cada factura generada por el mismo RFC emisor */
+    number?: number;
+    /** Subtotal de la factura. Campo de solo lectura */
+    subtotal?: number;
+    /** Descuento aplicado a la factura. Campo de solo lectura */
+    discount?: number;
+    /** Total de la factura. Campo de solo lectura */
+    total?: number;
+    /** UUID de la factura, es el folio fiscal asignado por el SAT al momento del timbrado */
+    uuid?: string;
+    /** Código de la forma de pago para la factura. Catálogo del SAT c_FormaPago */
+    paymentFormCode?: string;
+    /** Código de la moneda utilizada para expresar los montos. Default: "MXN" */
+    currencyCode: string;
+    /** Código de tipo de factura. Catálogo del SAT c_TipoDeComprobante */
+    typeCode: string;
+    /** Código postal del emisor */
+    expeditionZipCode: string;
+    /** Código que se identifica si la factura ampara una operación de exportación. Default: "01" */
+    exportCode: string;
+    /** Código de método para la factura de pago del catálogo del SAT c_MetodoPago */
+    paymentMethodCode?: string;
+    /** Tipo de cambio FIX conforme a la moneda registrada en la factura. Default: 1 */
+    exchangeRate?: number;
+    /** El emisor de la factura */
+    issuer: InvoiceIssuer;
+    /** Receptor de la factura */
+    recipient: InvoiceRecipient;
+    /** Conceptos de la factura (productos o servicios) */
+    items?: InvoiceItem[];
+    /** Informacion global. Utilizado cuando se genera una factura global */
+    globalInformation?: GlobalInformation;
+    /** Facturas relacionadas */
+    relatedInvoices?: RelatedInvoice[];
+    /** Pago o pagos recibidos para liquidar parcial o totalmente una factura de ingreso emitida previamente */
+    payments?: InvoicePayment[];
+    /** Respuesta del SAT. Contiene la información del timbrado. (Sólo lectura) */
+    responses?: InvoiceResponse[];
+}
+/**
+ * Emisor de la factura
+ */
+export interface InvoiceIssuer {
+    /** ID de la persona (emisora) en fiscalapi */
+    id?: string;
+    /** RFC del emisor (Tax Identification Number) */
+    tin?: string;
+    /** Razón social del emisor sin regimen de capital */
+    legalName?: string;
+    /** Código del régimen fiscal del emisor. Catálogo del SAT c_RegimenFiscal */
+    taxRegimeCode?: string;
+    /** Sellos del emisor (archivos .cer y .key) */
+    taxCredentials?: TaxCredential[];
+}
+/**
+ * Sellos del emisor
+ */
+export interface TaxCredential {
+    /** Archivo en formato base64 */
+    base64File: string;
+    /** Tipo de archivo. 0: Cetifiacdo CSD (archivo .cer), 1: Llave privada (archivo .key) */
+    fileType: number;
+    /** Contraseña del archivo .key. Debe ser la misma en ambos objetos (.cer y .key) */
+    password: string;
+}
+/**
+ * Receptor de la factura
+ */
+export interface InvoiceRecipient {
+    /** ID de la persona (receptora) en fiscalapi */
+    id?: string;
+    /** RFC del receptor (Tax Identification Number) */
+    tin?: string;
+    /** Razón social del receptor sin regimen de capital */
+    legalName?: string;
+    /** Código del régimen fiscal del receptor. Catálogo del SAT c_RegimenFiscal */
+    taxRegimeCode?: string;
+    /** Código del uso CFDI. Catálogo del SAT c_UsoCFDI */
+    cfdiUseCode?: string;
+    /** Código postal del receptor */
+    zipCode?: string;
+    /** Correo electrónico del receptor. Para enviar la factura desde el dasborard */
+    email?: string;
+}
+/**
+ * Conceptos de la factura (productos o servicios)
+ */
+export interface InvoiceItem {
+    /** ID del producto en fiscalapi */
+    id?: string;
+    /** Código del producto o servicio del catálogo c_ClaveProdServ */
+    itemCode?: string;
+    /** Cantidad del producto o servicio */
+    quantity: number | string;
+    /** Cantidad monetaria del descuento aplicado al producto o servicio */
+    discount?: number | string;
+    /** Código de la unidad de medida del producto o servicio. Catálogo c_ClaveUnidad */
+    unitOfMeasurementCode?: string;
+    /** Descripción del producto o servicio */
+    description?: string;
+    /** Precio unitario del producto o servicio. (Sin impuestos) */
+    unitPrice?: number | string;
+    /** Código de obligaciones de impuesto aplicables al producto o servicio. Catálogo c_ObjetoImp */
+    taxObjectCode?: string;
+    /** SKU o clave del sistema externo que identifica al producto o servicio */
+    itemSku?: string;
+    /** Impuestos aplicables al producto o servicio */
+    itemTaxes?: ItemTax[];
+}
+/**
+ * Impuestos aplicables al producto o servicio
+ */
+export interface ItemTax {
+    /** Código del impuesto. Catálogo del SAT c_Impuesto */
+    taxCode: string;
+    /** Tipo de factor. Catálogo del SAT c_TipoFactor */
+    taxTypeCode: string;
+    /** Tasa del impuesto. Catálogo del SAT c_TasaOCuota  */
+    taxRate?: string | number;
+    /** Código que indica la naturaleza del impuesto. "T": Impuesto Traslado, "R": Impuesto Retenido */
+    taxFlagCode: string;
+}
+/**
+ * Informacion global para factura global
+ */
+export interface GlobalInformation {
+    /** Código de la periodicidad de la factura global. Catálogo del SAT c_Periodicidad */
+    periodicityCode: string;
+    /** Código del mes de la factura global. Catálogo del SAT c_Meses */
+    monthCode: string;
+    /** Año de la factura global a 4 dígitos */
+    year: number;
+}
+/**
+ * Facturas relacionadas
+ */
+export interface RelatedInvoice {
+    /** Código de la relación de la factura relacionada. Catálogo del SAT c_TipoRelacion */
+    relationshipTypeCode: string;
+    /** UUID de la factura relacionada */
+    uuid: string;
+}
+/**
+ * Pago o pagos recibidos
+ */
+export interface InvoicePayment {
+    /** Fecha de pago. Se expresa en la forma AAAA-MM-DDThh:mm:ss */
+    paymentDate: string;
+    /** Código de la forma de pago del pago recibido. Catálogo del SAT c_FormaPago */
+    paymentFormCode: string;
+    /** Código de la moneda utilizada en el pago. Catálogo del SAT c_Moneda. Default: "MXN" */
+    currencyCode: string;
+    /** Tipo de cambio FIX conforme a la moneda registrada en la factura. Default: 1 */
+    exchangeRate?: number | string;
+    /** Monto del pago */
+    amount: number | string;
+    /** RFC del banco origen. (Rfc del banco emisor del pago) */
+    sourceBankTin: string;
+    /** Cuenta bancaria origen. (Cuenta bancaria del banco emisor del pago) */
+    sourceBankAccount: string;
+    /** RFC del banco destino. (Rfc del banco receptor del pago) */
+    targetBankTin: string;
+    /** Cuenta bancaria destino (Cuenta bancaria del banco receptor del pago) */
+    targetBankAccount: string;
+    /** Facturas pagadas con el pago recibido */
+    paidInvoices: PaidInvoice[];
+}
+/**
+ * Facturas pagadas con el pago recibido
+ */
+export interface PaidInvoice {
+    /** UUID de la factura pagada */
+    uuid: string;
+    /** Serie de la factura pagada */
+    series: string;
+    /** Monto pagado pagado en la factura */
+    paymentAmount: number | string;
+    /** Folio de la factura pagada */
+    number: string;
+    /** Código de la moneda utilizada en la factura pagada. Default: "MXN" */
+    currencyCode: string;
+    /** Número de parcialidad */
+    partialityNumber: number;
+    /** Subtotal de la factura pagada */
+    subTotal: number | string;
+    /** Saldo anterior de la factura pagada */
+    previousBalance: number | string;
+    /** Saldo restante de la factura pagada */
+    remainingBalance: number | string;
+    /** Código de obligaciones de impuesto aplicables a la factura pagada */
+    taxObjectCode: string;
+    /** Equivalencia de la moneda. Default: 1 */
+    equivalence?: number | string;
+    /** Impuestos aplicables a la factura pagada */
+    paidInvoiceTaxes: PaidInvoiceTax[];
+}
+/**
+ * Impuestos aplicables a la factura pagada
+ */
+export interface PaidInvoiceTax {
+    /** Código del impuesto. Catálogo del SAT c_Impuesto */
+    taxCode: string;
+    /** Tipo de factor. Catálogo del SAT c_TipoFactor */
+    taxTypeCode: string;
+    /** Tasa del impuesto. Catálogo del SAT c_TasaOCuota */
+    taxRate: number | string;
+    /** Código que indica la naturaleza del impuesto. "T": Impuesto Traslado, "R": Impuesto Retenido */
+    taxFlagCode: string;
+}
+/**
+ * Respuesta del SAT. Contiene la información del timbrado
+ */
+export interface InvoiceResponse {
+    /** ID de la respuesta */
+    id?: string;
+    /** ID de la factura a la que pertenece la respuesta */
+    invoiceId?: string;
+    /** Folio Fiscal (UUID) proporcionado por el SAT tras el timbrado de la factura */
+    invoiceUuid?: string;
+    /** Número de certificado del emisor */
+    invoiceCertificateNumber?: string;
+    /** Sello digital del CFDI en formato Base64 */
+    invoiceBase64Sello?: string;
+    /** Fecha y hora de la firma electrónica del CFDI por parte del emisor */
+    invoiceSignatureDate?: Date;
+    /** Imagen del código QR en formato Base64 */
+    invoiceBase64QrCode?: string;
+    /** XML de la factura en formato Base64 */
+    invoiceBase64?: string;
+    /** Sello digital del SAT en formato Base64 */
+    satBase64Sello?: string;
+    /** Cadena original de la factura codificado en Base64 */
+    satBase64OriginalString?: string;
+    /** Número de certificado del SAT */
+    satCertificateNumber?: string;
+}
+/**
+ * Modelo de cancelación de facturas
+ */
+export interface CancelInvoiceRequest {
+    /** ID de la factura a cancelar */
+    id?: string;
+    /** UUID de la factura a cancelar */
+    invoiceUuid?: string;
+    /** RFC del emisor de la factura (Tax Identification Number) */
+    tin?: string;
+    /** Código del motivo de cancelación de la factura */
+    cancellationReasonCode: string;
+    /** UUID de la factura que sustituye a la factura cancelada */
+    replacementUuid?: string;
+    /** Sellos del emisor (archivos .cer y .key) */
+    taxCredentials?: TaxCredential[];
+}
+/**
+ * Modelo de respuesta de cancelación de facturas
+ */
+export interface CancelInvoiceResponse {
+    /** Acuse de cancelación en formato base64 */
+    base64CancellationAcknowledgement?: string;
+    /** Diccionario de UUIDs de facturas con su respectivo código de estatus de cancelación */
+    invoiceUuids?: Record<string, string>;
+}
+/**
+ * Modelo de generación de pdf
+ */
+export interface CreatePdfRequest {
+    /** ID de la factura para la cual se generará el PDF */
+    invoiceId: string;
+    /** Color de la banda del PDF en formato hexadecimal */
+    bandColor?: string;
+    /** Color de la fuente del texto sobre la banda en formato hexadecimal */
+    fontColor?: string;
+    /** Logotipo en formato base64 que se mostrará en el PDF */
+    base64Logo?: string;
+}
+/**
+ * Modelo de envío facturas por correo
+ */
+export interface SendInvoiceRequest {
+    /** ID de la factura para la cual se generará el PDF */
+    invoiceId: string;
+    /** Correo electrónico del destinatario */
+    toEmail: string;
+    /** Color de la banda del PDF en formato hexadecimal */
+    bandColor?: string;
+    /** Color de la fuente del texto sobre la banda en formato hexadecimal */
+    fontColor?: string;
+    /** Logotipo en formato base64 que se mostrará en el PDF */
+    base64Logo?: string;
+}
+/**
+ * Modelo para consultar estado de facturas
+ */
+export interface InvoiceStatusRequest {
+    /** Id de la factura a consultar */
+    id?: string;
+    /** RFC Emisor la factura */
+    issuerTin?: string;
+    /** RFC Receptor de la factura */
+    recipientTin?: string;
+    /** Total de la factura */
+    invoiceTotal?: number;
+    /** Folio fiscal factura a consultar */
+    invoiceUuid?: string;
+    /** Últimos ocho caracteres del sello digital del emisor */
+    last8DigitsIssuerSignature?: string;
+}
+/**
+ * Modelo de respuesta de consulta de estado de facturas
+ */
+export interface InvoiceStatusResponse {
+    /** Código de estatus retornado por el SAT */
+    statusCode: string;
+    /** Estado actual de la factura. Posibles valores: 'Vigente' | 'Cancelado' | 'No Encontrado' */
+    status: string;
+    /** Indica si la factura es cancelable. Posibles valores: 'Cancelable con aceptación' | 'No cancelable' | 'Cancelable sin aceptación' */
+    cancelableStatus: string;
+    /** Detalle del estatus de cancelación */
+    cancellationStatus: string;
+    /** Codigo que indica si el RFC Emisor se encuentra dentro de la lista negra de EFOS */
+    efosValidation: string;
+}

package/dist/types/models/person.d.ts

@@ -0,0 +1,42 @@
+import { BaseDto } from '../common/base-dto';
+import { CatalogDto } from '../common/catalog-dto';
+/**
+ * Modelo persona
+ * Contiene toda la información de una persona emisor o receptor
+ */
+export interface Person extends BaseDto {
+    /** Razón social de la persona sin régimen de capital */
+    legalName?: string;
+    /** Correo electrónico de la persona */
+    email?: string;
+    /** Contraseña para acceder al dashboard */
+    password?: string;
+    /** Régimen de capital de la persona */
+    capitalRegime?: string;
+    /** Código del régimen fiscal del emisor. Catálogo del SAT c_régimenFiscal. Valores: "601", "603", "605" */
+    satTaxRegimeId?: string;
+    /** Código del régimen fiscal del emisor expandido */
+    satTaxRegime?: CatalogDto;
+    /** Código de uso del CFDI por defecto cuando este emisor actúe como receptor. Catálogo del SAT c_UsoCFDI. Valores: "G01", "G02", "G03" */
+    satCfdiUseId?: string;
+    /** Código de uso del CFDI por defecto expandido */
+    satCfdiUse?: CatalogDto;
+    /** Tipo de persona, solo tiene fines informativos. Valores: "T", "C", "U" */
+    userTypeId?: string;
+    /** Tipo de persona expandido */
+    userType?: CatalogDto;
+    /** RFC del emisor (Tax Identification Number) */
+    tin?: string;
+    /** Código postal del emisor. Catálogo del SAT c_CodigoPostal */
+    zipCode?: string;
+    /** Foto de perfil del emisor en formato base64 */
+    base64Photo?: string;
+    /** Contraseña de los certificados CSD cuando es un emisor */
+    taxPassword?: string;
+    /** Saldo disponible en la cuenta del emisor. Atributo de sólo lectura */
+    availableBalance?: number;
+    /** Saldo en tránsito. Atributo de sólo lectura */
+    committedBalance?: number;
+    /** ID del tenant al que pertenece el emisor. Atributo de sólo lectura */
+    tenantId?: string;
+}

package/dist/types/models/product.d.ts

@@ -0,0 +1,49 @@
+import { BaseDto } from '../common/base-dto';
+import { CatalogDto } from '../common/catalog-dto';
+/**
+ * Modelo producto
+ * Contiene toda la información sobre un producto o servicio
+ */
+export interface Product extends BaseDto {
+    /** Identificador único del producto */
+    id?: string;
+    /** Descripción o nombre del producto */
+    description?: string;
+    /** Precio unitario del producto sin impuestos */
+    unitPrice?: number;
+    /** Código de la unidad de medida. Catálogo del SAT c_ClaveUnidad. Default: "H87" */
+    satUnitMeasurementId?: string;
+    /** Código de la unidad de medida. Catálogo del SAT c_ClaveUnidad expandido */
+    satUnitMeasurement?: CatalogDto;
+    /** Código que identifica las obligaciones fiscales del producto. Catálogo del SAT c_ObjetoImp. Default: "02" */
+    satTaxObjectId?: string;
+    /** Código que identifica las obligaciones fiscales del producto. Catálogo del SAT c_ObjetoImp expandido */
+    satTaxObject?: CatalogDto;
+    /** Código del producto o servicio. Catálogo del SAT c_ClaveProdServ. Default: "01010101" */
+    satProductCodeId?: string;
+    /** Código del producto o servicio. Catálogo del SAT c_ClaveProdServ expandido */
+    satProductCode?: CatalogDto;
+    /** Impuestos aplicables al producto. Default: [IVA 16%] */
+    productTaxes?: ProductTax[];
+}
+/**
+ * Impuesto de producto
+ */
+export interface ProductTax {
+    /** Id del producto asociado a este impuesto */
+    productId?: string;
+    /** Tasa del impuesto. El valor debe estar entre 0.00000 y 1.000000 p. ej. `0.160000` para un 16% de impuesto */
+    rate: number;
+    /** Impuesto. Catálogo del SAT c_Impuesto. "001" ISR | "002" IVA | "003" IEPS */
+    taxId: string;
+    /** Impuesto. Catálogo del SAT c_Impuesto. "001" ISR | "002" IVA | "003" IEPS Expandido */
+    tax?: CatalogDto;
+    /** Naturaleza del impuesto. "T" Traslado o "R" Retención */
+    taxFlagId: string;
+    /** Naturaleza del impuesto. "T" Traslado o "R" Retención Expandido */
+    taxFlag?: CatalogDto;
+    /** Tipo de impuesto "Tasa" Tasa | "Cuota" Cuota | "Exento" Exento */
+    taxTypeId: string;
+    /** Tipo de impuesto "Tasa" Tasa | "Cuota" Cuota | "Exento" Exento Expandido */
+    taxType?: CatalogDto;
+}

package/dist/types/models/tax-file.d.ts

@@ -0,0 +1,23 @@
+import { BaseDto } from '../common/base-dto';
+/**
+ * Modelo TaxFile
+ * Representa un componente individual de un par CSD - ya sea el certificado (.cer) o la llave privada (.key)
+ */
+export interface TaxFile extends BaseDto {
+    /** Id de la persona propietaria del certificado */
+    personId: string;
+    /** RFC del propietario del certificado. Debe coincidir con el RFC del certificado */
+    tin: string;
+    /** Archivo certificado o llave privada en formato base64. Para certificados debe ser el archivo .cer codificado en base64, para llaves privadas debe ser el archivo .key codificado en base64 */
+    base64File: string;
+    /** Tipo de archivo que se está enviando. Valores: "01" */
+    fileType: number;
+    /** Contraseña de la llave privada. Independientemente si se envía un certificado o una llave privada, siempre se debe enviar la contraseña de la llave privada */
+    password: string;
+    /** Fecha de inicio de vigencia del certificado o llave privada. Calculado automáticamente */
+    validFrom?: Date;
+    /** Fecha de fin de vigencia del certificado o llave privada. Calculado automáticamente */
+    validTo?: Date;
+    /** Numero de secuencia que identifica el par entre certificado y llave privada. Sólo con fines informativos */
+    sequence?: number;
+}

package/dist/types/sdk-constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Constantes utilizadas en todo el SDK
+ */
+export declare const SdkConstants: {
+    /**
+     * Formato de fecha SAT (para facturas mexicanas)
+     */
+    SAT_DATE_FORMAT: string;
+    /**
+     * Versión predeterminada de la API
+     */
+    DEFAULT_API_VERSION: string;
+    /**
+     * Zona horaria predeterminada
+     */
+    DEFAULT_TIME_ZONE: string;
+    /**
+     * Tiempo de espera HTTP predeterminado en milisegundos
+     */
+    DEFAULT_HTTP_TIMEOUT: number;
+};

package/dist/types/services/api-key-service.d.ts

@@ -0,0 +1,15 @@
+import { ApiKey } from '../models/api-key';
+import { IFiscalapiHttpClient } from '../http/fiscalapi-http-client.interface';
+import { BaseFiscalapiService } from './base-fiscalapi-service';
+import { IApiKeyService } from '..';
+/**
+ * Implementación del servicio de claves de API
+ */
+export declare class ApiKeyService extends BaseFiscalapiService<ApiKey> implements IApiKeyService {
+    /**
+     * Crea una nueva instancia del servicio de claves de API
+     * @param {IFiscalapiHttpClient} httpClient - Cliente HTTP
+     * @param {string} apiVersion - Versión de la API
+     */
+    constructor(httpClient: IFiscalapiHttpClient, apiVersion: string);
+}

package/dist/types/services/base-fiscalapi-service.d.ts

@@ -0,0 +1,72 @@
+import { AxiosRequestConfig } from 'axios';
+import { BaseDto } from '../common/base-dto';
+import { ApiResponse } from '../common/api-response';
+import { PagedList } from '../common/paged-list';
+import { IFiscalapiHttpClient } from '../http/fiscalapi-http-client.interface';
+import { IFiscalapiService, RequestOptions } from '../abstractions/fiscalapi-service.interface';
+/**
+ * Implementación base de un servicio de FiscalAPI
+ * @template T - Tipo de DTO que maneja el servicio
+ */
+export declare abstract class BaseFiscalapiService<T extends BaseDto> implements IFiscalapiService<T> {
+    /** Cliente HTTP */
+    protected readonly httpClient: IFiscalapiHttpClient;
+    /** Ruta del recurso */
+    protected readonly resourcePath: string;
+    /** Versión de la API */
+    protected readonly apiVersion: string;
+    /**
+     * Crea una nueva instancia del servicio base
+     * @param {IFiscalapiHttpClient} httpClient - Cliente HTTP
+     * @param {string} resourcePath - Ruta del recurso en la API
+     * @param {string} apiVersion - Versión de la API
+     */
+    constructor(httpClient: IFiscalapiHttpClient, resourcePath: string, apiVersion: string);
+    /**
+     * Construye una URL de endpoint de API
+     * @param {string} [path=''] - Segmento de ruta opcional
+     * @param {Record<string, string>} [queryParams] - Parámetros de consulta opcionales
+     * @returns {string} URL del endpoint
+     * @protected
+     */
+    protected buildEndpoint(path?: string, queryParams?: Record<string, string>): string;
+    /**
+     * Convierte los parámetros de consulta a un objeto compatible con la configuración de Axios
+     * @param {Record<string, string>} queryParams - Parámetros de consulta
+     * @returns {AxiosRequestConfig} Configuración de Axios con los parámetros
+     * @protected
+     */
+    protected createConfigWithParams(queryParams?: Record<string, string>): AxiosRequestConfig;
+    /**
+     * Ejecuta una petición HTTP personalizada con máxima flexibilidad
+     * @param {RequestOptions<TData>} options - Opciones para la petición
+     * @returns {Promise<ApiResponse<TResult>>} Resultado de la petición
+     * @template TResult - Tipo de resultado esperado
+     * @template TData - Tipo de datos de entrada
+     */
+    executeRequest<TResult, TData = any>(options: RequestOptions<TData>): Promise<ApiResponse<TResult>>;
+    /**
+     * @inheritdoc
+     */
+    getList(pageNumber: number, pageSize: number): Promise<ApiResponse<PagedList<T>>>;
+    /**
+     * @inheritdoc
+     */
+    getById(id: string, details?: boolean): Promise<ApiResponse<T>>;
+    /**
+     * @inheritdoc
+     */
+    create(model: T): Promise<ApiResponse<T>>;
+    /**
+     * @inheritdoc
+     */
+    update(model: T): Promise<ApiResponse<T>>;
+    /**
+     * @inheritdoc
+     */
+    delete(id: string): Promise<ApiResponse<boolean>>;
+    /**
+     * @inheritdoc
+     */
+    search(searchParams: Record<string, string>): Promise<ApiResponse<PagedList<T>>>;
+}

package/dist/types/services/catalog-service.d.ts

@@ -0,0 +1,34 @@
+import { CatalogDto } from '../common/catalog-dto';
+import { IFiscalapiHttpClient } from '../http/fiscalapi-http-client.interface';
+import { ApiResponse } from '../common/api-response';
+import { BaseFiscalapiService } from './base-fiscalapi-service';
+import { ICatalogService, PagedList } from '..';
+/**
+ * Implementación del servicio de catálogos
+ */
+export declare class CatalogService extends BaseFiscalapiService<CatalogDto> implements ICatalogService {
+    /**
+     * Crea una nueva instancia del servicio de catálogos
+     * @param {IFiscalapiHttpClient} httpClient - Cliente HTTP
+     * @param {string} apiVersion - Versión de la API
+     */
+    constructor(httpClient: IFiscalapiHttpClient, apiVersion: string);
+    /**
+    * Recupera un registro de un catálogo por catalogName y id.
+    *
+    * @param catalogName - Nombre del catálogo
+    * @param id - Id del registro en el catalogName
+    * @returns Promise que resuelve en una respuesta API con CatalogDto
+    */
+    getRecordById(catalogName: string, id: string): Promise<ApiResponse<CatalogDto>>;
+    /**
+    * Busca en un catálogo.
+    *
+    * @param catalogName - Catalog name. Must be a catalog retrieved from getList()
+    * @param searchText - Criterio de búsqueda. Debe tener 4 caracteres de longitud como mínimo.
+    * @param pageNumber - Numero de pagina a recuperar (default: 1)
+    * @param pageSize - Tamaño de la página entre 1 y 100 registros por página (default: 50)
+    * @returns Promise que resuelve en una respuesta API con lista paginada de CatalogDto
+    */
+    searchCatalog(catalogName: string, searchText: string, pageNumber?: number, pageSize?: number): Promise<ApiResponse<PagedList<CatalogDto>>>;
+}