Merge pull request #5 from FiscalAPI/feat/descarga-retenciones-info-pagos

feat/descarga retenciones info pagos added

Author: mendozagit

Auth/AuthService.cs

@@ -51,9 +51,10 @@ public AuthService(ILogger<AuthService> logger)
     /// Authenticates with SAT using the provided credential and returns the authentication token
     /// </summary>
     public async Task<AuthResponse> AuthenticateAsync(ICredential credential,
-        ILogger logger, CancellationToken cancellationToken = default)
+        ServiceEndpoints endpoints, ILogger logger, CancellationToken cancellationToken = default)
     {
-        logger.LogInformation("Starting SAT authentication process for RFC: {Rfc}", credential.Certificate.Rfc);
+        logger.LogInformation("Starting SAT authentication process for RFC: {Rfc}, ServiceType: {ServiceType}", 
+            credential.Certificate.Rfc, endpoints.ServiceType);
 
         try
         {
@@ -70,10 +71,10 @@ public async Task<AuthResponse> AuthenticateAsync(ICredential credential,
                 signature);
 
             // Send request
-            logger.LogInformation("Sending authentication request to SAT. URL: {Url}", SatUrl.AuthUrl);
+            logger.LogInformation("Sending authentication request to SAT. URL: {Url}", endpoints.AuthUrl);
             var satResponse = await SendRequestAsync(
-                url: SatUrl.AuthUrl,
-                action: SatUrl.AuthAction,
+                url: endpoints.AuthUrl,
+                action: ServiceEndpoints.AuthAction,
                 payload: authXml,
                 cancellationToken: cancellationToken);
 

Auth/IAuthService.cs

@@ -16,6 +16,7 @@
 
 using Fiscalapi.Credentials.Core;
 using Fiscalapi.XmlDownloader.Auth.Models;
+using Fiscalapi.XmlDownloader.Common.Http;
 using Microsoft.Extensions.Logging;
 
 namespace Fiscalapi.XmlDownloader.Auth;
@@ -29,8 +30,9 @@ public interface IAuthService
     /// Authenticates with SAT using the provided credential and returns the authentication token.
     /// </summary>
     /// <param name="credential"></param>
+    /// <param name="endpoints">Service endpoints to use for authentication</param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <param name="logger">Logger</param>
     /// <returns></returns>
-    Task<AuthResponse> AuthenticateAsync(ICredential credential, ILogger logger, CancellationToken cancellationToken = default);
+    Task<AuthResponse> AuthenticateAsync(ICredential credential, ServiceEndpoints endpoints, ILogger logger, CancellationToken cancellationToken = default);
 }

Common/Enums/ServiceType.cs

@@ -0,0 +1,34 @@
+/*
+ * ============================================================================
+ * Mozilla Public License 2.0 (MPL-2.0)
+ * Autor: FISCAL API S. DE R.L. DE C.V. - https://fiscalapi.com
+ * ============================================================================
+ *
+ * Este código está sujeto a los términos de la Mozilla Public License v2.0.
+ * Licencia completa: https://mozilla.org/MPL/2.0
+ *
+ * AVISO: Este software se proporciona "tal como está" sin garantías de ningún
+ * tipo. Al usar, modificar o distribuir este código debe mantener esta
+ * atribución y las referencias al autor.
+ *
+ * ============================================================================
+ */
+
+namespace Fiscalapi.XmlDownloader.Common.Enums;
+
+/// <summary>
+/// Tipo de servicio de descarga masiva del SAT.
+/// </summary>
+public enum ServiceType
+{
+    /// <summary>
+    /// Servicio para descarga de CFDI regulares y metadatos
+    /// </summary>
+    Cfdi,
+
+    /// <summary>
+    /// Servicio para descarga de CFDI de retenciones e información de pagos
+    /// </summary>
+    Retenciones
+}
+

Common/Http/SatUrl.cs

@@ -0,0 +1,101 @@
+/*
+ * ============================================================================
+ * Mozilla Public License 2.0 (MPL-2.0)
+ * Autor: FISCAL API S. DE R.L. DE C.V. - https://fiscalapi.com
+ * ============================================================================
+ *
+ * Este código está sujeto a los términos de la Mozilla Public License v2.0.
+ * Licencia completa: https://mozilla.org/MPL/2.0
+ *
+ * AVISO: Este software se proporciona "tal como está" sin garantías de ningún
+ * tipo. Al usar, modificar o distribuir este código debe mantener esta
+ * atribución y las referencias al autor.
+ *
+ * ============================================================================
+ */
+
+using Fiscalapi.XmlDownloader.Common.Enums;
+
+namespace Fiscalapi.XmlDownloader.Common.Http;
+
+/// <summary>
+/// Clase inmutable que encapsula todos los endpoints del servicio de descarga masiva del SAT.
+/// Use ServiceEndpoints.Cfdi() para "CFDI regulares"
+/// Use ServiceEndpoints.Retenciones() para "CFDI de retenciones e información de pagos"
+/// </summary>
+public sealed class ServiceEndpoints
+{
+    /// <summary>
+    /// URL del servicio de autenticación
+    /// </summary>
+    public string AuthUrl { get; }
+
+    /// <summary>
+    /// URL del servicio de solicitud de descarga
+    /// </summary>
+    public string QueryUrl { get; }
+
+    /// <summary>
+    /// URL del servicio de verificación de solicitud
+    /// </summary>
+    public string VerifyUrl { get; }
+
+    /// <summary>
+    /// URL del servicio de descarga de paquetes
+    /// </summary>
+    public string DownloadUrl { get; }
+
+    /// <summary>
+    /// Tipo de servicio (CFDI o Retenciones)
+    /// </summary>
+    public ServiceType ServiceType { get; }
+
+    // SOAP Actions (constantes que no cambian entre CFDI y Retenciones)
+    public const string AuthAction = "http://DescargaMasivaTerceros.gob.mx/IAutenticacion/Autentica";
+    public const string RequestIssuedAction = "http://DescargaMasivaTerceros.sat.gob.mx/ISolicitaDescargaService/SolicitaDescargaEmitidos";
+    public const string RequestReceivedAction = "http://DescargaMasivaTerceros.sat.gob.mx/ISolicitaDescargaService/SolicitaDescargaRecibidos";
+    public const string RequestUuidAction = "http://DescargaMasivaTerceros.sat.gob.mx/ISolicitaDescargaService/SolicitaDescargaFolio";
+    public const string VerifyAction = "http://DescargaMasivaTerceros.sat.gob.mx/IVerificaSolicitudDescargaService/VerificaSolicitudDescarga";
+    public const string DownloadAction = "http://DescargaMasivaTerceros.sat.gob.mx/IDescargaMasivaTercerosService/Descargar";
+
+    /// <summary>
+    /// Constructor privado para crear instancias inmutables
+    /// </summary>
+    private ServiceEndpoints(string authUrl, string queryUrl, string verifyUrl, string downloadUrl, ServiceType serviceType)
+    {
+        AuthUrl = authUrl ?? throw new ArgumentNullException(nameof(authUrl));
+        QueryUrl = queryUrl ?? throw new ArgumentNullException(nameof(queryUrl));
+        VerifyUrl = verifyUrl ?? throw new ArgumentNullException(nameof(verifyUrl));
+        DownloadUrl = downloadUrl ?? throw new ArgumentNullException(nameof(downloadUrl));
+        ServiceType = serviceType;
+    }
+
+    /// <summary>
+    /// Crea una instancia con los endpoints para "CFDI regulares"
+    /// </summary>
+    public static ServiceEndpoints Cfdi()
+    {
+        return new ServiceEndpoints(
+            authUrl: "https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/Autenticacion/Autenticacion.svc",
+            queryUrl: "https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/SolicitaDescargaService.svc",
+            verifyUrl: "https://cfdidescargamasivasolicitud.clouda.sat.gob.mx/VerificaSolicitudDescargaService.svc",
+            downloadUrl: "https://cfdidescargamasiva.clouda.sat.gob.mx/DescargaMasivaService.svc",
+            serviceType: ServiceType.Cfdi
+        );
+    }
+
+    /// <summary>
+    /// Crea una instancia con los endpoints para "CFDI de retenciones e información de pagos"
+    /// </summary>
+    public static ServiceEndpoints Retenciones()
+    {
+        return new ServiceEndpoints(
+            authUrl: "https://retendescargamasivasolicitud.clouda.sat.gob.mx/Autenticacion/Autenticacion.svc",
+            queryUrl: "https://retendescargamasivasolicitud.clouda.sat.gob.mx/SolicitaDescargaService.svc",
+            verifyUrl: "https://retendescargamasivasolicitud.clouda.sat.gob.mx/VerificaSolicitudDescargaService.svc",
+            downloadUrl: "https://retendescargamasiva.clouda.sat.gob.mx/DescargaMasivaService.svc",
+            serviceType: ServiceType.Retenciones
+        );
+    }
+}
+

Common/Http/ServiceEndpoints.cs

@@ -54,19 +54,20 @@ public DownloadService(ILogger<DownloadService> logger)
     /// <param name="credential">Fiel</param>
     /// <param name="authToken">Authentication token</param>
     /// <param name="packageId">PackageID</param>
+    /// <param name="endpoints">Service endpoints to use for download</param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <param name="logger">Logger</param>
     /// <returns>DownloadResponse</returns>
     public async Task<DownloadResponse> DownloadAsync(ICredential credential, Token authToken, string packageId,
-        ILogger logger, CancellationToken cancellationToken = default)
+        ServiceEndpoints endpoints, ILogger logger, CancellationToken cancellationToken = default)
     {
         var toDigest = CreateDigest(packageId, credential.Certificate.Rfc);
         var signature = CreateSignature(credential, toDigest);
         var requestXml = BuildEnvelope(packageId, credential.Certificate.Rfc, signature);
 
         var satResponse = await SendRequestAsync(
-            url: SatUrl.DownloadUrl,
-            action: SatUrl.DownloadAction,
+            url: endpoints.DownloadUrl,
+            action: ServiceEndpoints.DownloadAction,
             payload: requestXml,
             token: authToken.Value,
             cancellationToken: cancellationToken);

Download/DownloadService.cs

@@ -16,6 +16,7 @@
 
 using Fiscalapi.Credentials.Core;
 using Fiscalapi.XmlDownloader.Auth.Models;
+using Fiscalapi.XmlDownloader.Common.Http;
 using Fiscalapi.XmlDownloader.Download.Models;
 using Microsoft.Extensions.Logging;
 
@@ -32,9 +33,10 @@ public interface IDownloadService
     /// <param name="credential">Fiel</param>
     /// <param name="authToken">Authentication token</param>
     /// <param name="packageId">PackageID</param>
+    /// <param name="endpoints">Service endpoints to use for download</param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <param name="logger">Logger</param>
     /// <returns>DownloadResponse</returns>
     Task<DownloadResponse> DownloadAsync(ICredential credential, Token authToken, string packageId,
-         ILogger logger, CancellationToken cancellationToken = default);
+         ServiceEndpoints endpoints, ILogger logger, CancellationToken cancellationToken = default);
 }

Download/IDownloadService.cs

@@ -31,7 +31,6 @@ namespace Fiscalapi.XmlDownloader;
 
 public static class DownloaderExtensions
 {
-    //private const string SatFormat = "yyyy-MM-ddTHH:mm:ss.fffZ";
     private const string SatFormat = "yyyy-MM-ddTHH:mm:ss.000Z";
 
     /// <summary>

DownloaderExtensions.cs

@@ -16,6 +16,8 @@
 
 using Fiscalapi.Credentials.Core;
 using Fiscalapi.XmlDownloader.Auth.Models;
+using Fiscalapi.XmlDownloader.Common.Enums;
+using Fiscalapi.XmlDownloader.Common.Http;
 using Fiscalapi.XmlDownloader.Common.Models;
 using Fiscalapi.XmlDownloader.Download.Models;
 using Fiscalapi.XmlDownloader.Query.Models;
@@ -40,27 +42,53 @@ public interface IXmlDownloaderService
     /// </summary>
     public Token? Token { get; set; }
 
+    /// <summary>
+    /// Service endpoints currently configured for the service (CFDI or Retenciones).
+    /// </summary>
+    public ServiceEndpoints ServiceEndpoints { get; }
+
+    /// <summary>
+    /// Sets the service type (CFDI or Retenciones) and switches endpoints accordingly.
+    /// If the current token is from a different service type, it will be invalidated to force re-authentication.
+    /// If Credential is set, re-authentication will be performed automatically.
+    /// </summary>
+    /// <param name="serviceType">The service type to switch to</param>
+    /// <param name="forceReauthenticate">If true, invalidates the current token even if it matches the service type</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Task representing the asynchronous operation</returns>
+    Task SetServiceType(ServiceType serviceType, bool forceReauthenticate = false, CancellationToken cancellationToken = default);
+
 
     /// <summary>
     /// Authenticates the user with SAT and retrieves an authentication token using the provided certificate and key in Base64 format.
+    /// </summary>
     /// <param name="base64Cer">Base64 Fiel Certificate</param>
     /// <param name="base64Key">Base64 Fiel PrivateKey</param>
     /// <param name="password">Plain Fiel PrivateKey's Password Phrase</param>
-    /// <param name="cancellationToken"></param>
+    /// <param name="endpoints">Service endpoints to use for authentication. Defaults to CFDI endpoints if null.</param>
+    /// <param name="cancellationToken">Cancellation token</param>
     /// <returns>AuthResponse</returns>
-    /// </summary>
     Task<AuthResponse> AuthenticateAsync(string base64Cer, string base64Key, string password,
-        CancellationToken cancellationToken = default);
+        ServiceEndpoints? endpoints = null, CancellationToken cancellationToken = default);
+    /// <summary>
+    /// Authenticates the user with SAT and retrieves an authentication token given the Fiel credential.
+    /// </summary>
+    /// <param name="credential"></param>
+    /// <param name="endpoints">Service endpoints to use for authentication. Defaults to CFDI endpoints if null.</param>
+    /// <param name="cancellationToken"></param>
+    /// <returns>AuthResponse</returns>
+    Task<AuthResponse> AuthenticateAsync(ICredential credential, ServiceEndpoints? endpoints = null, CancellationToken cancellationToken = default);
 
 
     /// <summary>
-    /// Authenticates the user with SAT and retrieves an authentication token given the Fiel credential.
+    /// Authenticates the user to CFDI endpoints with SAT and retrieves an authentication token given the Fiel credential.
     /// </summary>
     /// <param name="credential"></param>
     /// <param name="cancellationToken"></param>
     /// <returns>AuthResponse</returns>
     Task<AuthResponse> AuthenticateAsync(ICredential credential, CancellationToken cancellationToken = default);
 
+
     /// <summary>
     /// Creates a 'download request' to the SAT with the specified query parameters.
     /// </summary>

IXmlDownloaderService.cs

@@ -16,6 +16,7 @@
 
 using Fiscalapi.Credentials.Core;
 using Fiscalapi.XmlDownloader.Auth.Models;
+using Fiscalapi.XmlDownloader.Common.Http;
 using Fiscalapi.XmlDownloader.Query.Models;
 using Microsoft.Extensions.Logging;
 
@@ -32,9 +33,10 @@ public interface IQueryService
     /// <param name="credential">Fiel</param>
     /// <param name="authToken">Authentication token</param>
     /// <param name="parameters">Request parameters</param>
+    /// <param name="endpoints">Service endpoints to use for the query</param>
     /// <param name="cancellationToken">CancellationToken</param>
     /// <param name="logger">Logger</param>
     /// <returns>QueryResponse</returns>
     Task<QueryResponse> CreateAsync(ICredential credential, Token authToken,
-        QueryParameters parameters, ILogger logger, CancellationToken cancellationToken = default);
+        QueryParameters parameters, ServiceEndpoints endpoints, ILogger logger, CancellationToken cancellationToken = default);
 }