Version 5.0.4 Metadata suport added

Author: mendozagit

Common/Models/Comprobante.cs

@@ -342,7 +342,11 @@ public string Confirmacion
     public AllComplements AllComplements { get; set; } = new();
 
 
-
+    /// <summary>
+    /// Raw content in Base64 format.
+    /// </summary>
+    [XmlIgnore]
+    public string? Base64Content { get; set; }
 
     public void DeserializeComplements()
     {

Common/Models/MetaItem.cs

@@ -0,0 +1,166 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Xml.Serialization;
+
+namespace Fiscalapi.XmlDownloader.Common.Models
+{
+    public class MetaItem
+    {
+        /// <summary>
+        /// Folio de la factura - UUID
+        /// </summary>
+        public string InvoiceUuid { get; set; }
+
+        /// <summary>
+        /// RFC del emisor del comprobante - RfcEmisor
+        /// </summary>
+        [Required]
+        [StringLength(13)]
+        public string IssuerTin { get; set; }
+
+        /// <summary>
+        /// Nombre o razón social del emisor - NombreEmisor
+        /// </summary>
+        [Required]
+        public string IssuerName { get; set; }
+
+        /// <summary>
+        /// RFC del receptor del comprobante - RfcReceptor
+        /// </summary>
+        [Required]
+        [StringLength(13)]
+        public string RecipientTin { get; set; }
+
+        /// <summary>
+        /// Nombre o razón social del receptor - NombreReceptor
+        /// </summary>
+        [Required]
+        public string RecipientName { get; set; }
+
+        /// <summary>
+        /// RFC del Proveedor Autorizado de Certificación (PAC) - RfcPac
+        /// </summary>
+        [Required]
+        [StringLength(13)]
+        public string PacTin { get; set; }
+
+        /// <summary>
+        /// Fecha y hora de emisión del comprobante - FechaEmision
+        /// </summary>
+        public DateTime InvoiceDate { get; set; }
+
+        /// <summary>
+        /// Fecha y hora de certificación por el SAT - FechaCertificacionSat
+        /// </summary>
+        public DateTime? SatCertificationDate { get; set; }
+
+        /// <summary>
+        /// Monto total del comprobante - Monto
+        /// </summary>
+        [Range(0, double.MaxValue)]
+        public decimal Amount { get; set; }
+
+        /// <summary>
+        /// Tipo de comprobante (I = Ingreso, E = Egreso, T = Traslado, N = Nómina, P = Pago) - EfectoComprobante
+        /// </summary>
+        [Required]
+        [StringLength(1)]
+        public string InvoiceType { get; set; }
+
+        /// <summary>
+        /// Estatus del comprobante (1 = Vigente, 0 = Cancelado) - Estatus
+        /// </summary>
+        public int Status { get; set; }
+
+        /// <summary>
+        /// Fecha de cancelación del comprobante (si aplica) - FechaCancelacion
+        /// </summary>
+        public DateTime? CancellationDate { get; set; }
+
+
+        /// <summary>
+        /// Constructor con parámetros
+        /// </summary> 
+        public MetaItem(string invoiceUuid, string issuerTin, string issuerName, string recipientTin,
+            string recipientName, string pacTin, DateTime invoiceDate,
+            DateTime? satCertificationDate, decimal amount, string invoiceType,
+            int status, DateTime? cancellationDate = null)
+        {
+            InvoiceUuid = invoiceUuid;
+            IssuerTin = issuerTin;
+            IssuerName = issuerName;
+            RecipientTin = recipientTin;
+            RecipientName = recipientName;
+            PacTin = pacTin;
+            InvoiceDate = invoiceDate;
+            SatCertificationDate = satCertificationDate;
+            Amount = amount;
+            InvoiceType = invoiceType;
+            Status = status;
+            CancellationDate = cancellationDate;
+        }
+
+        /// <summary>
+        /// Método para parsear una línea de texto separada por ~ al objeto MetaItem
+        /// </summary>
+        public static MetaItem CreateFromString(string metadataTextLine)
+        {
+            if (string.IsNullOrWhiteSpace(metadataTextLine))
+                throw new ArgumentException("Los datos no pueden estar vacíos", nameof(metadataTextLine));
+
+            var fields = metadataTextLine.Split('~');
+
+            if (fields.Length < 11)
+                throw new ArgumentException("Formato de datos inválido. Se requieren al menos 11 campos",
+                    nameof(metadataTextLine));
+
+            return new MetaItem(
+                invoiceUuid: fields[0],
+                issuerTin: fields[1],
+                issuerName: fields[2],
+                recipientTin: fields[3],
+                recipientName: fields[4],
+                pacTin: fields[5],
+                invoiceDate: DateTime.Parse(fields[6]),
+                satCertificationDate: string.IsNullOrEmpty(fields[7]) ? null : DateTime.Parse(fields[7]),
+                amount: decimal.Parse(fields[8]),
+                invoiceType: fields[9],
+                status: int.Parse(fields[10]),
+                cancellationDate: fields.Length > 11 && !string.IsNullOrEmpty(fields[11])
+                    ? DateTime.Parse(fields[11])
+                    : null
+            );
+        }
+
+        /// <summary>
+        /// Convierte el objeto a string con formato separado por ~
+        /// </summary>
+        public override string ToString()
+        {
+            return $"{InvoiceUuid}~{IssuerTin}~{IssuerName}~{RecipientTin}~{RecipientName}~{PacTin}~" +
+                   $"{InvoiceDate:yyyy-MM-dd HH:mm:ss}~{SatCertificationDate?.ToString("yyyy-MM-dd HH:mm:ss")}~" +
+                   $"{Amount}~{InvoiceType}~{Status}~{CancellationDate?.ToString("yyyy-MM-dd HH:mm:ss")}";
+        }
+
+        /// <summary>
+        /// Indica si el comprobante está vigente
+        /// </summary>
+        public bool IsActive => Status == 1;
+
+        /// <summary>
+        /// Indica si el comprobante está cancelado
+        /// </summary>
+        public bool IsCancelled => Status == 0;
+
+
+        /// <summary>
+        /// Raw content in Base64 format.
+        /// </summary>
+        [XmlIgnore]
+        public string? Base64Content { get; set; }
+    }
+}

IXmlDownloaderService.cs

@@ -20,6 +20,7 @@
 using Fiscalapi.XmlDownloader.Download.Models;
 using Fiscalapi.XmlDownloader.Query.Models;
 using Fiscalapi.XmlDownloader.Verify.Models;
+using System.Runtime.CompilerServices;
 
 namespace Fiscalapi.XmlDownloader;
 
@@ -142,4 +143,33 @@ IAsyncEnumerable<Comprobante> GetComprobantesAsync(byte[] packageBytes,
     /// <returns>List of Comprobantes objects</returns>
     IAsyncEnumerable<Comprobante> GetComprobantesAsync(DownloadResponse downloadResponse,
         CancellationToken cancellationToken = default);
+
+
+    /// <summary>
+    /// Retrieves a list of MetaItems from a package represented by its extracted directory path.
+    /// </summary>
+    /// <param name="fullFilePath">Package .zip file path</param>
+    /// <param name="extractToPath">Path where to extract the zip file</param>
+    /// <param name="cancellationToken">CancellationToken</param>
+    /// <returns>A <see cref="IAsyncEnumerable{MetaItem}"/> of <see cref="MetaItem"/> objects.</returns>
+    IAsyncEnumerable<MetaItem> GetMetadataAsync(string fullFilePath, string extractToPath,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Retrieves a list of MetaItems from a package represented by its byte array.
+    /// </summary>
+    /// <param name="packageBytes">Package Bytes</param>
+    /// <param name="cancellationToken">CancellationToken</param>
+    /// <returns>A <see cref="IAsyncEnumerable{MetaItem}"/> of <see cref="MetaItem"/> objects.</returns>
+    IAsyncEnumerable<MetaItem> GetMetadataAsync(byte[] packageBytes,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Retrieves a list of MetaItems from a package represented by its DownloadResponse.
+    /// </summary>
+    /// <param name="downloadResponse">DownloadResponse</param>
+    /// <param name="cancellationToken">CancellationToken</param>
+    /// <returns>A <see cref="IAsyncEnumerable{MetaItem}"/> of <see cref="MetaItem"/> objects.</returns>
+    IAsyncEnumerable<MetaItem> GetMetadataAsync(DownloadResponse downloadResponse,
+        CancellationToken cancellationToken = default);
 }

XmlDownloader.csproj

@@ -4,7 +4,7 @@
 	  <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-	  <Version>5.0.3</Version>
+	  <Version>5.0.4</Version>
 	  <AssemblyVersion>$(Version)</AssemblyVersion>
 	  <FileVersion>$(Version)</FileVersion>
 	  <PackageVersion>$(Version)</PackageVersion>