@silexpert/core 2.0.121 → 2.0.122

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silexpert/core",
-  "version": "2.0.121",
+  "version": "2.0.122",
   "description": "Silex Core perform HTTP Request and object binding. Silex core helps developers to retrieve and return formatted object",
   "keywords": [
     "accounting",

package/ts/api/resources/Exercice.ts

@@ -10,6 +10,7 @@ import {
   GenerateProjectExercice,
   IGedFile,
   SendPreviewProjectExercice,
+  QuerySignUrlForProject,
 } from '../../types/index.js';
 import { Resource } from '../Resource.js';
 
@@ -71,6 +72,10 @@ export class Exercice extends Resource {
     });
   }
 
+  getSignUrlForProject(params: QuerySignUrlForProject): Promise<string> {
+    return this.axios.$get('exercices/project/sign-url', { params });
+  }
+
   getProgress(idExercice: number): Promise<number> {
     return this.axios.$get(`exercices/${idExercice}/progress`);
   }

package/ts/types/Enum/EInvoicingStatusCode.ts

@@ -17,89 +17,103 @@ export enum EInvoicingStatusCode {
 
 export const EInvoicingStatusCodeMetadata: Record<
   EInvoicingStatusCode,
-  { shortLabel: string; label: string; color: string; description?: string }
+  { shortLabel: string; label: string; pluralLabel: string; color: string; description?: string }
 > = {
   [EInvoicingStatusCode.DEPOSITED]: {
     shortLabel: 'Déposée',
     label: 'Déposée',
+    pluralLabel: 'Déposées',
     color: 'cerulean',
     description: 'Facture déposée et contrôles techniques validés.',
   },
   [EInvoicingStatusCode.ISSUED]: {
     shortLabel: 'Émise',
     label: 'Émise par la plateforme',
+    pluralLabel: 'Émises',
     color: 'success',
     description: 'Facture transmise au réseau de facturation.',
   },
   [EInvoicingStatusCode.RECEIVED]: {
     shortLabel: 'Reçue',
     label: 'Reçue',
+    pluralLabel: 'Reçues',
     color: 'success',
     description: 'Facture reçue par la plateforme du destinataire.',
   },
   [EInvoicingStatusCode.MADE_AVAILABLE]: {
     shortLabel: 'Mise à disposition',
     label: 'Mise à disposition',
+    pluralLabel: 'Mises à disposition',
     color: 'fire',
     description: 'Facture disponible pour le destinataire.',
   },
   [EInvoicingStatusCode.HANDLED]: {
     shortLabel: 'Prise en charge',
     label: 'Prise en charge',
+    pluralLabel: 'Prises en charge',
     color: 'fire',
     description: 'Facture en cours de traitement par le destinataire.',
   },
   [EInvoicingStatusCode.APPROVED]: {
     shortLabel: 'Approuvée',
     label: 'Approuvée',
+    pluralLabel: 'Approuvées',
     color: 'success',
     description: 'Facture entièrement acceptée.',
   },
   [EInvoicingStatusCode.PARTIALLY_APPROVED]: {
     shortLabel: 'Approbation partielle',
     label: 'Approbation partielle',
+    pluralLabel: 'Approbations partielles',
     color: 'error',
     description: 'Facture partiellement acceptée.',
   },
   [EInvoicingStatusCode.IN_DISPUTE]: {
     shortLabel: 'En litige',
     label: 'En litige',
+    pluralLabel: 'En litige',
     color: 'error',
     description: 'Facture contestée par le destinataire.',
   },
   [EInvoicingStatusCode.SUSPENDED]: {
     shortLabel: 'Suspendue',
     label: 'Suspendue',
+    pluralLabel: 'Suspendues',
     color: 'error',
     description: 'Traitement suspendu, informations attendues.',
   },
   [EInvoicingStatusCode.COMPLETED]: {
     shortLabel: 'Complétée',
     label: 'Complétée',
+    pluralLabel: 'Complétées',
     color: 'fire',
     description: 'Informations complémentaires transmises.',
   },
   [EInvoicingStatusCode.REFUSED]: {
     shortLabel: 'Refusée',
     label: 'Refusée',
+    pluralLabel: 'Refusées',
     color: 'error',
     description: 'Facture refusée par le destinataire.',
   },
   [EInvoicingStatusCode.PAYMENT_TRANSMITTED]: {
     shortLabel: 'Paiement transmis',
     label: 'Paiement transmis',
+    pluralLabel: 'Paiements transmis',
     color: 'success',
     description: 'Paiement déclaré par le destinataire.',
   },
   [EInvoicingStatusCode.PAID]: {
     shortLabel: 'Encaissée',
     label: 'Encaissée',
+    pluralLabel: 'Encaissées',
     color: 'success',
     description: 'Paiement reçu et confirmé.',
   },
   [EInvoicingStatusCode.REJECTED]: {
     shortLabel: 'Rejetée',
     label: 'Rejetée',
+    pluralLabel: 'Rejetées',
     color: 'error',
     description: 'Facture rejetée, correction nécessaire.',
   },

package/ts/types/Enum/Unit.ts

@@ -30,6 +30,7 @@ export enum UnitId {
   HECTARE = 20,
   MINUTE = 21,
   GRAM = 22,
+  UNIT = 23,
 }
 
 export type IUnitList = Array<{ name: string; id: number; shortName: string; eInvoicingCode: string | null }>;
@@ -41,6 +42,12 @@ export const Unit: IUnit = {
     shortName: 'art',
     codeEN16931: 'NAR',
   },
+  UNIT: {
+    id: UnitId.UNIT,
+    name: 'Unité',
+    shortName: 'u',
+    codeEN16931: 'NAR',
+  },
   HOUR: {
     id: UnitId.HOUR,
     name: 'Heure',

package/ts/types/Interface/api/balanceSheet/UpdateBalanceSheet.ts

@@ -54,4 +54,9 @@ export class UpdateBalanceSheet {
   @IsString()
   @IsOptional()
   token?: string;
+
+  @ApiPropertyOptional()
+  @IsString()
+  @IsOptional()
+  projectSignatureLink?: string;
 }

package/ts/types/Interface/api/commercialManagement/Read.ts

@@ -21,6 +21,7 @@ export type ReadEstimateInvoice = IEstimateInvoice & { id: number };
 
 export type ReadProductEditing = IProductInvoice & {
   totalTaxExcluded: number;
+  totalTaxExcludedRounded: number;
   unitFormatted: string;
   vatFormatted: string;
   discountFormatted: string | null;

package/ts/types/Interface/api/exercice/QueryExercice.ts

@@ -1,5 +1,5 @@
-import { IsBoolean, IsDate, IsIn, IsOptional } from 'class-validator';
-import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsBoolean, IsDate, IsIn, IsOptional, IsString } from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { ToBoolean } from '../../../../utils/transforms/boolean.transform.js';
 
 export class QueryExercice {
@@ -44,3 +44,9 @@ export class QueryExerciceProject {
   @IsOptional()
   type?: 'juridical' | 'default';
 }
+
+export class QuerySignUrlForProject {
+  @ApiProperty()
+  @IsString()
+  token: string;
+}

package/ts/types/Interface/models/IBalanceSheet.ts

@@ -17,6 +17,7 @@ export class IBalanceSheet {
   netIncome?: number;
   total?: number;
   token?: string | null;
+  projectSignatureLink?: string | null;
   idFile?: number;
   attestationDetail?: string;
   endDate?: Date;

package/ts/utils/amount.ts

@@ -1,6 +1,13 @@
 import { MathematicalSign } from '../types/Enum/Util.js';
 import { FormattedAmount } from '../types/Interface/api/amount/FormattedAmount.js';
 
+// Round the magnitude first so negative half-cent values match the formatter's symmetric rounding.
+export function roundAmountToInteger(value: number): number {
+  const roundedAbsoluteValue = Math.round(Math.abs(value));
+  if (roundedAbsoluteValue === 0) return 0;
+  return value < 0 ? -roundedAbsoluteValue : roundedAbsoluteValue;
+}
+
 export function integerToFormattedAmountString(value: number): string {
   const abs = Math.abs(value / 100);
   let integer = Math.trunc(abs);

package/ts/utils/commercialManagement/document.ts

@@ -73,7 +73,7 @@ export function generateCommercialDocument(
   }
 
   const totalVats = sumBy(vats, (v) => round(v.amount));
-  const totalTaxExcluded = sumBy(products, (p) => round(p.totalTaxExcluded));
+  const totalTaxExcluded = sumBy(products, 'totalTaxExcludedRounded');
 
   const totalTaxIncluded = totalTaxExcluded + totalVats;
 

package/ts/utils/commercialManagement/product.ts

@@ -3,7 +3,7 @@ import { IProductInvoice, ReadProductEditing } from '../../types/index.js';
 import { Unit } from '../../types/Enum/Unit.js';
 import { DiscountType, VatMarginCategyList } from '../../types/Enum/CommercialManagement.js';
 import { getById } from './vat.js';
-import { integerToFormattedAmountString } from '../amount.js';
+import { integerToFormattedAmountString, roundAmountToInteger } from '../amount.js';
 
 export function getDiscount(product: IProductInvoice): number {
   if (product.discount2 === null || product.discount2 === undefined || product.discount2 <= 0) return 0;
@@ -24,16 +24,20 @@ export function getTotalTaxExcluded(product: IProductInvoice): number {
 }
 
 export function productToReadProductEditing(payload: IProductInvoice): ReadProductEditing {
+  const totalTaxExcluded = getTotalTaxExcluded(payload);
+  const totalTaxExcludedRounded = roundAmountToInteger(totalTaxExcluded);
+
   return {
     ...payload,
-    totalTaxExcluded: getTotalTaxExcluded(payload),
+    totalTaxExcluded,
+    totalTaxExcludedRounded,
     unitFormatted: Object.values(Unit).find((unit) => unit.id === payload.unit)?.shortName ?? '',
     vatFormatted: getById(payload.idVat)?.saleName ?? '',
     priceTaxExcludedFormatted: isDefined(payload.priceTaxExcluded)
       ? integerToFormattedAmountString(payload.priceTaxExcluded)
       : null,
     totalTaxExcludedFormatted: isDefined(payload.priceTaxExcluded)
-      ? integerToFormattedAmountString(getTotalTaxExcluded(payload))
+      ? integerToFormattedAmountString(totalTaxExcludedRounded)
       : null,
     discountFormatted:
       payload.discount2 && payload.discount2 > 0 ? integerToFormattedAmountString(getDiscount(payload)) : null,

package/ts/utils/commercialManagement/vat.ts

@@ -1,6 +1,6 @@
 import { sumBy } from 'lodash-es';
 import { Vat, VatType } from '../../types/Enum/Vat.js';
-import { integerToFormattedAmountString } from '../amount.js';
+import { integerToFormattedAmountString, roundAmountToInteger } from '../amount.js';
 import { ReadProductEditing, ReadVatEditing } from '../../types/index.js';
 
 export function getAmount(amount: number | null, vatValue: number): number {
@@ -15,19 +15,17 @@ export function getById(id: number): VatType | undefined {
 
 export function vatToReadVatEditing(products: ReadProductEditing[]): ReadVatEditing {
   const { idVat } = products[0];
+  const base = sumBy(products, 'totalTaxExcludedRounded');
+  const amount = roundAmountToInteger(getAmount(base, getById(idVat)?.value ?? 0));
+
   return {
     id: idVat,
     name: getById(idVat)?.saleName ?? '',
-    amount: sumBy(products, (p) => getAmount(p.totalTaxExcluded, getById(idVat)?.value ?? 0)),
+    amount,
     value: getById(idVat)?.value ?? 0,
-    baseFormatted: integerToFormattedAmountString(
-      sumBy(products, (p) => (p.totalTaxExcluded ? +p.totalTaxExcluded : 0)),
-    ),
-    amountFormatted: integerToFormattedAmountString(
-      (sumBy(products, (p) => (p.totalTaxExcluded ? +p.totalTaxExcluded : 0)) * (getById(idVat)?.value ?? 0)) / 100,
-    ),
-    toPay:
-      (sumBy(products, (p) => (p.totalTaxExcluded ? +p.totalTaxExcluded : 0)) * (getById(idVat)?.value ?? 0)) / 100,
-    base: sumBy(products, (p) => (p.totalTaxExcluded ? +p.totalTaxExcluded : 0)),
+    baseFormatted: integerToFormattedAmountString(base),
+    amountFormatted: integerToFormattedAmountString(amount),
+    toPay: amount,
+    base,
   };
 }

package/ts/utils/tests/document.spec.ts

@@ -2,6 +2,9 @@ import { describe, expect, test } from 'vitest';
 import { generateCommercialDocument } from '../commercialManagement/document.js';
 import { EstimateInvoiceType } from '../../types/Enum/EstimateInvoice.js';
 import { CreateInvoiceDocument } from '../../types/Interface/api/commercialManagement/Create.js';
+import { DiscountType } from '../../types/Enum/CommercialManagement.js';
+import { Unit } from '../../types/Enum/Unit.js';
+import { Vat } from '../../types/Enum/Vat.js';
 
 // Payload reproducing a real-world case where the seller address fields (`name`, `street`,
 // `number`, `zipCode`, `city`) are entirely absent from the object, not just `null`.
@@ -113,4 +116,96 @@ describe('generateCommercialDocument', () => {
 
     expect(result.body).not.toContain('<p>undefined</p>');
   });
+
+  test('should calculate VAT from rounded line totals after discounts and fractional quantities', () => {
+    const payload = {
+      ...payloadWithoutSellerAddress,
+      products: Array.from({ length: 6 }, (_, index) => ({
+        idVat: Vat.TX_20.id,
+        unit: Unit.ITEM.id,
+        itemSaleName: `Rounded line ${index + 1}`,
+        priceTaxExcluded: 101,
+        quantity: 1.0049,
+        discount2: 100,
+        discountType: DiscountType.PERCENT,
+        reorder: index,
+      })),
+    } as unknown as CreateInvoiceDocument;
+
+    const result = generateCommercialDocument(EstimateInvoiceType.FACTURE, payload);
+
+    expect(result.body).toContain('1,00€');
+    expect(result.data.vats).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ base: 600, amount: 120, baseFormatted: '6,00', amountFormatted: '1,20' }),
+      ]),
+    );
+    expect(result.data.totalTaxExcluded).toBe(600);
+    expect(result.data.totalTaxIncluded).toBe(720);
+    expect(result.data.totalTaxIncludedFormatted).toBe('7,20');
+  });
+
+  test('should use the rounded half-cent line amount in the PDF and VAT recap', () => {
+    const payload = {
+      ...payloadWithoutSellerAddress,
+      products: [
+        {
+          idVat: Vat.TX_20.id,
+          unit: Unit.ITEM.id,
+          itemSaleName: 'Half-cent line',
+          priceTaxExcluded: 201,
+          quantity: 0.5,
+        },
+      ],
+    } as unknown as CreateInvoiceDocument;
+
+    const result = generateCommercialDocument(EstimateInvoiceType.FACTURE, payload);
+
+    expect(result.body).toContain('1,01€');
+    expect(result.data.products[0]).toMatchObject({
+      totalTaxExcluded: 100.5,
+      totalTaxExcludedRounded: 101,
+      totalTaxExcludedFormatted: '1,01',
+    });
+    expect(result.data.vats).toEqual(
+      expect.arrayContaining([expect.objectContaining({ base: 101, baseFormatted: '1,01' })]),
+    );
+    expect(result.data.totalTaxExcluded).toBe(101);
+    expect(result.data.totalTaxExcludedFormatted).toBe('1,01');
+  });
+
+  test('should round negative credit note lines symmetrically across VAT rates', () => {
+    const payload = {
+      ...payloadWithoutSellerAddress,
+      products: [
+        {
+          idVat: Vat.TX_5_5.id,
+          unit: Unit.ITEM.id,
+          itemSaleName: 'Half-cent VAT line',
+          priceTaxExcluded: -200,
+          quantity: 0.5,
+        },
+        {
+          idVat: Vat.TX_20.id,
+          unit: Unit.ITEM.id,
+          itemSaleName: 'Half-cent line',
+          priceTaxExcluded: -201,
+          quantity: 0.5,
+        },
+      ],
+    } as unknown as CreateInvoiceDocument;
+
+    const result = generateCommercialDocument(EstimateInvoiceType.AVOIR, payload);
+
+    expect(result.body).toContain('- 1,00€');
+    expect(result.body).toContain('- 1,01€');
+    expect(result.data.vats).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ value: 5.5, base: -100, amount: -6, baseFormatted: '- 1,00' }),
+        expect.objectContaining({ value: 20, base: -101, amount: -20, baseFormatted: '- 1,01' }),
+      ]),
+    );
+    expect(result.data.totalTaxExcluded).toBe(-201);
+    expect(result.data.totalTaxIncluded).toBe(-227);
+  });
 });