facturas initial added+

Author: mendozagit

examples/main.ts

@@ -1,4 +1,5 @@
-import { FiscalapiClient, FiscalapiSettings, Person, Product, TaxFile } from '../src';
+import { DateTime } from 'luxon';
+import { FiscalapiClient, FiscalapiSettings, Invoice, Person, Product, TaxFile } from '../src';
 import { inspect } from 'util';
 inspect.defaultOptions.depth = null; // Deshabilitar la profundidad de inspección para objetos anidados la salida de la consola
 inspect.defaultOptions.colors = true; // Habilitar colores para la salida de la consola
@@ -218,6 +219,79 @@ async function main() : Promise<void> {
 
 
 
+    // Listar facturas
+    // const apiResponse = await client.invoices.getList(1, 2);
+    // console.log('apiResponse:', apiResponse);
+
+    // Obtener factura por ID
+    // const apiResponse = await client.invoices.getById("7a8cce85-1592-4e3d-9621-364c82d36091", true);
+    // console.log('apiResponse:', apiResponse);
+
+
+
+    // Crear factura
+  
+    const invoice: Invoice = {
+      versionCode: "4.0",
+      series: "F",
+      date:  DateTime.now().toFormat("yyyy-MM-dd'T'HH:mm:ss"),
+      paymentFormCode: "01",
+      paymentMethodCode: "PUE",
+      currencyCode: "MXN",
+      typeCode: "I",
+      expeditionZipCode: "42501",
+      exchangeRate: 1,
+      exportCode: "01",
+      issuer: {
+        tin: "FUNK671228PH6",
+        legalName: "KARLA FUENTE NOLASCO",
+        taxRegimeCode: "621",
+        taxCredentials: [
+          {
+            base64File: base64Cert,
+            fileType: 0,
+            password: password
+          },
+          {
+            base64File: base64Key,
+            fileType: 1,
+            password: password
+          }
+        ]
+      },
+      recipient: {
+        tin: "EKU9003173C9",
+        legalName: "ESCUELA KEMPER URGATE",
+        zipCode: "42501",
+        taxRegimeCode: "601",
+        cfdiUseCode: "G01",
+        email: "someone@somewhere.com"
+      },
+      items: [
+        {
+          itemCode: "01010101",
+          quantity: 9.5,
+          unitOfMeasurementCode: "E48",
+          description: "Invoicing software as a service",
+          unitPrice: 3587.75,
+          taxObjectCode: "02",
+          itemSku: "7506022301697",
+          discount: 255.85,
+          itemTaxes: [
+            {
+              taxCode: "002",
+              taxTypeCode: "Tasa",
+              taxRate: 0.160000,
+              taxFlagCode: "T"
+            }
+          ]
+        }
+      ]
+    };
+
+    const apiResponse = await client.invoices.create(invoice);
+    console.log('apiResponse:', apiResponse);
+
 
     console.log('End Fiscalapi node...'); 
   } catch (error: unknown) {

src/abstractions/fiscalapi-service.interface.ts

@@ -1,3 +1,4 @@
+import { AxiosRequestConfig } from 'axios';
 import { ApiResponse } from '../common/api-response';
 import { BaseDto } from '../common/base-dto';
 import { PagedList } from '../common/paged-list';
@@ -67,16 +68,43 @@ export interface IFiscalapiService<T extends BaseDto> {
     data?: TData
   ): Promise<ApiResponse<TResult>>;
 
+  // /**
+  //  * Ejecuta una operación personalizada en el recurso sin necesidad de un ID específico
+  //  * @param {string} operation - Nombre de la operación
+  //  * @param {TData} data - Datos para la operación
+  //  * @returns {Promise<ApiResponse<TResult>>} Resultado de la operación
+  //  * @template TResult - Tipo de resultado esperado
+  //  * @template TData - Tipo de datos de entrada
+  //  */
+  // executeOperation<TResult, TData>(
+  //   operation: string,
+  //   data: TData,
+  //   method: 'POST' | 'PUT' | 'DELETE'
+  // ): Promise<ApiResponse<TResult>>;
+
   /**
    * Ejecuta una operación personalizada en el recurso sin necesidad de un ID específico
-   * @param {string} operation - Nombre de la operación
-   * @param {TData} data - Datos para la operación
+   * @param {OperationOptions<TData>} options - Opciones para la operación
    * @returns {Promise<ApiResponse<TResult>>} Resultado de la operación
    * @template TResult - Tipo de resultado esperado
    * @template TData - Tipo de datos de entrada
    */
-  executeOperation<TResult, TData>(
-    operation: string,
-    data: TData
-  ): Promise<ApiResponse<TResult>>;
-}
+  executeOperation<TResult, TData = any>( options: OperationOptions<TData>): Promise<ApiResponse<TResult>>;
+}
+
+  /**
+   * Opciones para ejecutar una operación
+   * @template TData - Tipo de datos de entrada
+   */
+  export type OperationOptions<TData = any> = {
+    /** Ruta o nombre de la operación */
+    path: string;
+    /** Datos para la operación (opcional) */
+    data?: TData;
+    /** Parámetros de consulta (opcional) */
+    queryParams?: Record<string, string>;
+    /** Método HTTP a utilizar */
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Configuración adicional para Axios (opcional) */
+    config?: AxiosRequestConfig;
+  }

src/abstractions/invoice-service.interface.ts

@@ -5,7 +5,9 @@ import {
   CancelInvoiceRequest, 
   CancelInvoiceResponse, 
   CreatePdfRequest, 
-  SendInvoiceRequest 
+  SendInvoiceRequest,
+  InvoiceStatusRequest,
+  InvoiceStatusResponse
 } from '../models/invoice';
 import { IFiscalapiService } from './fiscalapi-service.interface';
 
@@ -14,23 +16,37 @@ import { IFiscalapiService } from './fiscalapi-service.interface';
  */
 export interface IInvoiceService extends IFiscalapiService<Invoice> {
   /**
-   * Crea un PDF de una factura
+   * Cancela una factura
+   * @param {CancelInvoiceRequest} request - Solicitud para cancelar factura
+   * @returns {Promise<ApiResponse<CancelInvoiceResponse>>} Respuesta de la cancelación
+   */
+  cancel(request: CancelInvoiceRequest): Promise<ApiResponse<CancelInvoiceResponse>>;
+  
+  /**
+   * Obtiene el PDF de una factura
    * @param {CreatePdfRequest} request - Solicitud para crear PDF
    * @returns {Promise<ApiResponse<FileResponse>>} Respuesta con el archivo PDF
    */
-  createPdf(request: CreatePdfRequest): Promise<ApiResponse<FileResponse>>;
+  getPdf(request: CreatePdfRequest): Promise<ApiResponse<FileResponse>>;
+  
+  /**
+   * Obtiene el XML de una factura
+   * @param {string} id - ID de la factura
+   * @returns {Promise<ApiResponse<FileResponse>>} Respuesta con el archivo XML
+   */
+  getXml(id: string): Promise<ApiResponse<FileResponse>>;
 
   /**
    * Envía una factura por correo electrónico
    * @param {SendInvoiceRequest} request - Solicitud para enviar factura
    * @returns {Promise<ApiResponse<boolean>>} Resultado de la operación
    */
-  sendInvoice(request: SendInvoiceRequest): Promise<ApiResponse<boolean>>;
+  send(request: SendInvoiceRequest): Promise<ApiResponse<boolean>>;
 
   /**
-   * Cancela una factura
-   * @param {CancelInvoiceRequest} request - Solicitud para cancelar factura
-   * @returns {Promise<ApiResponse<CancelInvoiceResponse>>} Respuesta de la cancelación
+   * Obtiene el estado de una factura
+   * @param {InvoiceStatusRequest} request - Solicitud para consultar estado
+   * @returns {Promise<ApiResponse<InvoiceStatusResponse>>} Respuesta con el estado de la factura
    */
-  cancelInvoice(request: CancelInvoiceRequest): Promise<ApiResponse<CancelInvoiceResponse>>;
+  getStatus(request: InvoiceStatusRequest): Promise<ApiResponse<InvoiceStatusResponse>>;
 }

src/common/file-response.ts

@@ -1,6 +1,7 @@
 
 /**
- * File response from the API
+ * File response from the API.
+ *Por ejemplo: Modelo de respuesta de generación de PDF o recuperación de XML
  */
 export interface FileResponse {
     /**

src/http/fiscalapi-http-client.interface.ts

@@ -55,6 +55,7 @@ export interface IFiscalapiHttpClient {
    */
   deleteAsync(endpoint: string, config?: AxiosRequestConfig): Promise<ApiResponse<boolean>>;
 
+
   /**
    * Realiza una petición PATCH a la API
    * @param endpoint - Punto final de la API

src/http/fiscalapi-http-client.ts

@@ -271,9 +271,17 @@ export class FiscalapiHttpClient implements IFiscalapiHttpClient {
     endpoint: string, 
     config?: AxiosRequestConfig
   ): Promise<ApiResponse<boolean>> {
+    if (!config) {
+      config = {
+        method: 'DELETE'
+      };
+    }
     return this.executeAsync<boolean>(this.httpClient.delete(endpoint, config));
   }
 
+
+
+
   /**
    * Realiza una petición PATCH a la API
    * @param {string} endpoint - Punto final de la API

src/index.ts

@@ -1,3 +1,4 @@
+import { Addendum } from './../dist/types/models/invoice.d';
 
 // Exportar API pública
 
@@ -26,11 +27,9 @@ export {
   InvoiceItem,
   InvoiceResponse,
   TaxCredential,
-  FileType,
   RelatedInvoice,
   GlobalInformation,
-  Addendum,
-  InvoiceItemTax,
+  ItemTax,
   InvoicePayment,
   PaidInvoice,
   PaidInvoiceTax,