feat: Add acteDepot parameter to TEJ XML export endpoints and update filename generation

- Introduced acteDepot query parameter in ExportFactureDepenseToTejXmlEndpoint and ExportProviderInvoiceToTejXmlEndpoint to handle initial and rectificative declarations.
- Updated XML export logic to include acteDepot in the generated XML and filename, ensuring compliance with TEJ requirements.
- Enhanced TejXmlExportService to support acteDepot in both export methods, improving flexibility for users.
- Added localization entries for TEJ export messages, enhancing user experience in multiple languages.

Author: Nieze-BenMansour

src/TunNetCom.SilkRoadErp.Sales.Api/Features/FactureDepense/ExportToTejXml/ExportFactureDepenseToTejXmlEndpoint.cs

@@ -30,6 +30,7 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
         [FromServices] IActiveAccountingYearService activeAccountingYearService,
         [FromServices] IAccountingYearFinancialParametersService financialParametersService,
         int id,
+        [FromQuery] string? acteDepot = "0",
         CancellationToken cancellationToken = default)
     {
         try
@@ -160,6 +161,8 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
                     "Le matricule fiscal de l'entreprise doit être au format 7 chiffres et une lettre clé (ex. 0001238L).");
             }
 
+            var acteDepotValue = acteDepot == "1" ? "1" : "0";
+
             var xmlBytes = exportService.ExportFactureDepenseToTejXml(
                 factureDepense,
                 tiers,
@@ -169,7 +172,8 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
                 refCertifChezDeclarant: refCertifTej,
                 normalizedDeclarantMatricule: matriculeNormaliseResult,
                 normalizedBeneficiaireMatricule: tiersMatriculeNormalise,
-                beneficiaireTel8Digits: telDigitsOnly);
+                beneficiaireTel8Digits: telDigitsOnly,
+                acteDepot: acteDepotValue);
 
             var validationErrors = TejXsdValidator.Validate(xmlBytes)
                 .Where(e => !e.Contains("introuvable", StringComparison.OrdinalIgnoreCase))
@@ -183,8 +187,7 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
 
             var exercice = factureDepense.Date.Year;
             var mois = factureDepense.Date.Month.ToString("D2");
-            const string codeActe = "0";
-            var filename = $"{matriculeNormaliseResult}-{exercice}-{mois}-{codeActe}.xml";
+            var filename = $"{matriculeNormaliseResult}-{exercice}-{mois}-{acteDepotValue}.xml";
 
             logger.LogInformation("TEJ XML export completed successfully for FactureDepense Id {Id}", id);
 

src/TunNetCom.SilkRoadErp.Sales.Api/Features/FactureDepense/GetFacturesDepenseTotals/GetFacturesDepenseTotalsEndpoint.cs

@@ -0,0 +1,45 @@
+using Carter;
+using Microsoft.AspNetCore.Mvc;
+using TunNetCom.SilkRoadErp.Sales.Api.Infrastructure.Constants;
+using TunNetCom.SilkRoadErp.Sales.Contracts.FactureDepense;
+
+namespace TunNetCom.SilkRoadErp.Sales.Api.Features.FactureDepense.GetFacturesDepenseTotals;
+
+public class GetFacturesDepenseTotalsEndpoint : ICarterModule
+{
+    public void AddRoutes(IEndpointRouteBuilder app)
+    {
+        _ = app.MapGet("/api/factures-depenses/totals", HandleGetTotalsAsync)
+            .RequireAuthorization($"Permission:{Permissions.ViewFactureDepense}")
+            .WithTags(EndpointTags.FactureDepense)
+            .Produces<FactureDepenseTotalsResponse>(StatusCodes.Status200OK)
+            .Produces(StatusCodes.Status500InternalServerError);
+    }
+
+    public static async Task<Results<Ok<FactureDepenseTotalsResponse>, StatusCodeHttpResult>> HandleGetTotalsAsync(
+        [FromServices] IMediator mediator,
+        [FromServices] ILogger<GetFacturesDepenseTotalsEndpoint> logger,
+        [FromQuery] int? accountingYearId = null,
+        [FromQuery] DateTime? startDate = null,
+        [FromQuery] DateTime? endDate = null,
+        [FromQuery] int? tiersDepenseFonctionnementId = null,
+        CancellationToken cancellationToken = default)
+    {
+        try
+        {
+            logger.LogInformation(
+                "GetFacturesDepenseTotalsEndpoint called with accountingYearId: {AccountingYearId}, startDate: {StartDate}, endDate: {EndDate}, tiersId: {TiersId}",
+                accountingYearId, startDate, endDate, tiersDepenseFonctionnementId);
+
+            var response = await mediator.Send(
+                new GetFacturesDepenseTotalsQuery(accountingYearId, startDate, endDate, tiersDepenseFonctionnementId),
+                cancellationToken);
+            return TypedResults.Ok(response);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Error calculating factures dépense totals");
+            return TypedResults.StatusCode(500);
+        }
+    }
+}

src/TunNetCom.SilkRoadErp.Sales.Api/Features/FactureDepense/GetFacturesDepenseTotals/GetFacturesDepenseTotalsQuery.cs

@@ -0,0 +1,9 @@
+using TunNetCom.SilkRoadErp.Sales.Contracts.FactureDepense;
+
+namespace TunNetCom.SilkRoadErp.Sales.Api.Features.FactureDepense.GetFacturesDepenseTotals;
+
+public record GetFacturesDepenseTotalsQuery(
+    int? AccountingYearId = null,
+    DateTime? StartDate = null,
+    DateTime? EndDate = null,
+    int? TiersDepenseFonctionnementId = null) : IRequest<FactureDepenseTotalsResponse>;

src/TunNetCom.SilkRoadErp.Sales.Api/Features/FactureDepense/GetFacturesDepenseTotals/GetFacturesDepenseTotalsQueryHandler.cs

@@ -0,0 +1,45 @@
+using Microsoft.EntityFrameworkCore;
+using TunNetCom.SilkRoadErp.Sales.Contracts.FactureDepense;
+using TunNetCom.SilkRoadErp.Sales.Domain.Entites;
+
+namespace TunNetCom.SilkRoadErp.Sales.Api.Features.FactureDepense.GetFacturesDepenseTotals;
+
+public class GetFacturesDepenseTotalsQueryHandler(SalesContext context)
+    : IRequestHandler<GetFacturesDepenseTotalsQuery, FactureDepenseTotalsResponse>
+{
+    public async Task<FactureDepenseTotalsResponse> Handle(GetFacturesDepenseTotalsQuery request, CancellationToken cancellationToken)
+    {
+        var q = context.FactureDepense.AsNoTracking().AsQueryable();
+
+        if (request.AccountingYearId.HasValue)
+            q = q.Where(f => f.AccountingYearId == request.AccountingYearId.Value);
+
+        if (request.TiersDepenseFonctionnementId.HasValue)
+            q = q.Where(f => f.IdTiersDepenseFonctionnement == request.TiersDepenseFonctionnementId.Value);
+
+        if (request.StartDate.HasValue)
+            q = q.Where(f => f.Date >= request.StartDate.Value);
+
+        if (request.EndDate.HasValue)
+        {
+            var endDateInclusive = request.EndDate.Value.Date.AddDays(1).AddTicks(-1);
+            q = q.Where(f => f.Date <= endDateInclusive);
+        }
+
+        var totals = await q
+            .Select(f => new
+            {
+                HT = f.BaseHT0 + f.BaseHT7 + f.BaseHT13 + f.BaseHT19,
+                TVA = f.MontantTVA0 + f.MontantTVA7 + f.MontantTVA13 + f.MontantTVA19,
+                TTC = f.MontantTotal
+            })
+            .ToListAsync(cancellationToken);
+
+        return new FactureDepenseTotalsResponse
+        {
+            TotalHT = totals.Sum(t => t.HT),
+            TotalTVA = totals.Sum(t => t.TVA),
+            TotalTTC = totals.Sum(t => t.TTC)
+        };
+    }
+}

src/TunNetCom.SilkRoadErp.Sales.Api/Features/ProviderInvoices/ExportToTejXml/ExportProviderInvoiceToTejXmlEndpoint.cs

@@ -29,6 +29,7 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
         [FromServices] IActiveAccountingYearService activeAccountingYearService,
         [FromServices] IAccountingYearFinancialParametersService financialParametersService,
         int invoiceNumber,
+        [FromQuery] string? acteDepot = "0",
         CancellationToken cancellationToken = default)
     {
         try
@@ -197,6 +198,8 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
                     "Le matricule fiscal de l'entreprise doit être au format 7 chiffres et une lettre clé (ex. 0001238L).");
             }
 
+            var acteDepotValue = acteDepot == "1" ? "1" : "0";
+
             // Generate XML : montant avant retenue + ref F+AV+AF ; la plateforme TEJ effectue le calcul de retenue
             var xmlBytes = exportService.ExportProviderInvoiceToTejXml(
                 factureFournisseur,
@@ -208,7 +211,8 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
                 refCertifChezDeclarant: refCertifTej,
                 normalizedDeclarantMatricule: matriculeNormaliseResult,
                 normalizedBeneficiaireMatricule: providerMatriculeNormalise,
-                beneficiaireTel8Digits: telDigitsOnly);
+                beneficiaireTel8Digits: telDigitsOnly,
+                acteDepot: acteDepotValue);
 
             // Validate against TEJ XSD when schema is available
             var validationErrors = TejXsdValidator.Validate(xmlBytes)
@@ -224,8 +228,7 @@ public static async Task<Results<FileContentHttpResult, BadRequest<string>, NotF
             // Generate filename per regulatory format: [MATRICULEFISCAL]-[EXERCICE]-[mois]-[code acte].xml
             var exercice = factureFournisseur.Date.Year;
             var mois = factureFournisseur.Date.Month.ToString("D2");
-            const string codeActe = "0"; // 0 = déclaration initiale
-            var filename = $"{matriculeNormaliseResult}-{exercice}-{mois}-{codeActe}.xml";
+            var filename = $"{matriculeNormaliseResult}-{exercice}-{mois}-{acteDepotValue}.xml";
 
             logger.LogInformation("TEJ XML export completed successfully for invoice {InvoiceNumber}", invoiceNumber);