@hed-hog/finance 0.0.364 → 0.0.366

package/src/finance.service.ts

@@ -26,7 +26,10 @@ import { CreateCostCenterDto } from './dto/create-cost-center.dto';
 import { CreateCurrencyDto } from './dto/create-currency.dto';
 import { CreateFinanceCategoryDto } from './dto/create-finance-category.dto';
 import { CreateFinanceTagDto } from './dto/create-finance-tag.dto';
-import { CreateFinancialTitleDto } from './dto/create-financial-title.dto';
+import {
+  CreateFinancialInstallmentDto,
+  CreateFinancialTitleDto,
+} from './dto/create-financial-title.dto';
 import { CreatePeriodCloseDto } from './dto/create-period-close.dto';
 import { CreateTransferDto } from './dto/create-transfer.dto';
 import { MoveFinanceCategoryDto } from './dto/move-finance-category.dto';
@@ -5113,8 +5116,29 @@ export class FinanceService {
       );
     }
 
+    if (rule && (data.installments || []).some((installment) => installment.paid)) {
+      throw new BadRequestException(
+        getLocaleText(
+          'recurringCannotBePaid',
+          locale,
+          'Recurring titles cannot be created as already paid',
+        ),
+      );
+    }
+
     const isRecurring = Boolean(rule);
-    const installments = isRecurring
+    type NormalizedInstallment = {
+      installment_number: number;
+      due_date: string;
+      amount_cents: number;
+      paid?: boolean;
+      paid_at?: string;
+      paid_amount_cents?: number;
+      discount_cents?: number;
+      interest_cents?: number;
+      penalty_cents?: number;
+    };
+    const installments: NormalizedInstallment[] = isRecurring
       ? this.buildRecurrenceInstallments(
           data.due_date,
           rule!.frequency,
@@ -5124,7 +5148,11 @@ export class FinanceService {
         )
       : this.normalizeAndValidateInstallments(data, locale);
 
-    const createdTitleId = await this.prisma.$transaction(async (tx) => {
+    const hasPaidInstallments = installments.some(
+      (installment) => installment.paid,
+    );
+
+    const createResult = await this.prisma.$transaction(async (tx) => {
       const person = await tx.person.findUnique({
         where: { id: data.person_id },
         select: { id: true },
@@ -5188,6 +5216,19 @@ export class FinanceService {
         }
       }
 
+      if (hasPaidInstallments && data.bank_account_id) {
+        const bankAccount = await tx.bank_account.findUnique({
+          where: { id: data.bank_account_id },
+          select: { id: true },
+        });
+
+        if (!bankAccount) {
+          throw new BadRequestException(
+            getLocaleText('bankAccountNotFound', locale, 'Bank account not found'),
+          );
+        }
+      }
+
       await this.assertDateNotInClosedPeriod(
         tx,
         data.competence_date
@@ -5205,7 +5246,7 @@ export class FinanceService {
           person_id: data.person_id,
           title_type: titleType,
           status: 'draft',
-          document_number: data.document_number,
+          document_number: data.document_number?.trim() || null,
           description: data.description,
           competence_date: data.competence_date
             ? this.parseLocalDate(data.competence_date)
@@ -5230,6 +5271,13 @@ export class FinanceService {
         });
       }
 
+      const appliedSettlements: Array<{
+        settlementId: number;
+        installmentId: number;
+        openAmountCentsBefore: number;
+        openAmountCentsAfter: number;
+      }> = [];
+
       for (let index = 0; index < installments.length; index++) {
         const installment = installments[index];
         const amountCents = installment.amount_cents;
@@ -5262,25 +5310,84 @@ export class FinanceService {
             },
           });
         }
+
+        if (installment.paid) {
+          const appliedSettlement = await this.applyInstallmentSettlement(tx, {
+            title: { id: title.id, person_id: data.person_id },
+            titleType,
+            installmentId: createdInstallment.id,
+            amountCents: installment.paid_amount_cents ?? amountCents,
+            settledAt: this.parseLocalDate(
+              installment.paid_at || installment.due_date,
+            ),
+            bankAccountId: data.bank_account_id ?? null,
+            paymentChannel: data.payment_channel,
+            discountCents: installment.discount_cents,
+            interestCents: installment.interest_cents,
+            penaltyCents: installment.penalty_cents,
+            userId,
+          });
+
+          appliedSettlements.push(appliedSettlement);
+        }
       }
 
+      const finalStatus =
+        appliedSettlements.length > 0
+          ? await this.recalculateTitleStatus(tx, title.id)
+          : 'draft';
+
       await this.createAuditLog(tx, {
         action: 'CREATE_TITLE',
         entityTable: 'financial_title',
         entityId: String(title.id),
         actorUserId: userId,
-        summary: `Created ${titleType} title ${title.id} in draft`,
+        summary: `Created ${titleType} title ${title.id} in ${finalStatus}`,
         afterData: JSON.stringify({
-          status: 'draft',
+          status: finalStatus,
           total_amount_cents: this.toCents(data.total_amount),
         }),
       });
 
-      return title.id;
+      for (const appliedSettlement of appliedSettlements) {
+        await this.createAuditLog(tx, {
+          action: 'SETTLE_INSTALLMENT',
+          entityTable: 'financial_title',
+          entityId: String(title.id),
+          actorUserId: userId,
+          summary: `Settled installment ${appliedSettlement.installmentId} of title ${title.id}`,
+          beforeData: JSON.stringify({
+            title_status: 'draft',
+            installment_open_amount_cents:
+              appliedSettlement.openAmountCentsBefore,
+          }),
+          afterData: JSON.stringify({
+            title_status: finalStatus,
+            installment_open_amount_cents:
+              appliedSettlement.openAmountCentsAfter,
+            settlement_id: appliedSettlement.settlementId,
+            bank_reconciliation_id: null,
+          }),
+        });
+      }
+
+      return {
+        titleId: title.id,
+        settlementIds: appliedSettlements.map(
+          (appliedSettlement) => appliedSettlement.settlementId,
+        ),
+      };
     });
 
-    const createdTitle = await this.getTitleById(createdTitleId, titleType, locale);
-    this.financeRealtime.publish({ domain: 'installment', type: 'created', entityId: createdTitleId });
+    const createdTitle = await this.getTitleById(
+      createResult.titleId,
+      titleType,
+      locale,
+    );
+    this.financeRealtime.publish({ domain: 'installment', type: 'created', entityId: createResult.titleId });
+    for (const settlementId of createResult.settlementIds) {
+      this.financeRealtime.publish({ domain: 'settlement', type: 'settled', entityId: settlementId });
+    }
     return this.mapTitleToFront(createdTitle, data.payment_channel);
   }
 
@@ -5438,7 +5545,7 @@ export class FinanceService {
         where: { id: title.id },
         data: {
           person_id: data.person_id,
-          document_number: data.document_number,
+          document_number: data.document_number?.trim() || null,
           description: data.description,
           competence_date: data.competence_date
             ? this.parseLocalDate(data.competence_date)
@@ -5602,7 +5709,7 @@ export class FinanceService {
   ) {
     const fallbackDueDate = data.due_date;
     const totalAmountCents = this.toCents(data.total_amount);
-    const sourceInstallments =
+    const sourceInstallments: CreateFinancialInstallmentDto[] =
       data.installments && data.installments.length > 0
         ? data.installments
         : [
@@ -5639,10 +5746,31 @@ export class FinanceService {
           );
         }
 
+        const paidAmountCents =
+          installment.paid_amount != null
+            ? this.toCents(installment.paid_amount)
+            : amountCents;
+
+        if (installment.paid && paidAmountCents > amountCents) {
+          throw new BadRequestException(
+            getLocaleText(
+              'paidAmountExceedsInstallment',
+              locale,
+              'Paid amount cannot exceed installment amount',
+            ),
+          );
+        }
+
         return {
           installment_number: installment.installment_number || index + 1,
           due_date: installmentDueDate,
           amount_cents: amountCents,
+          paid: installment.paid === true,
+          paid_at: installment.paid_at,
+          paid_amount_cents: paidAmountCents,
+          discount_cents: this.toCents(installment.discount || 0),
+          interest_cents: this.toCents(installment.interest || 0),
+          penalty_cents: this.toCents(installment.penalty || 0),
         };
       },
     );
@@ -5925,6 +6053,163 @@ export class FinanceService {
     return this.mapTitleToFront(updatedTitle);
   }
 
+  private async applyInstallmentSettlement(
+    tx: any,
+    params: {
+      title: { id: number; person_id: number };
+      titleType: TitleType;
+      installmentId: number;
+      amountCents: number;
+      settledAt: Date;
+      bankAccountId?: number | null;
+      paymentChannel?: string;
+      discountCents?: number;
+      interestCents?: number;
+      penaltyCents?: number;
+      description?: string | null;
+      userId?: number;
+    },
+  ) {
+    const { title, titleType, installmentId, amountCents, settledAt } = params;
+
+    await this.assertDateNotInClosedPeriod(
+      tx,
+      settledAt,
+      'settle installment',
+    );
+
+    const installment = await tx.financial_installment.findFirst({
+      where: {
+        id: installmentId,
+        title_id: title.id,
+      },
+      select: {
+        id: true,
+        title_id: true,
+        amount_cents: true,
+        open_amount_cents: true,
+        due_date: true,
+        status: true,
+      },
+    });
+
+    if (!installment) {
+      throw new BadRequestException('Installment not found for this title');
+    }
+
+    if (installment.status === 'settled' || installment.status === 'canceled') {
+      if (installment.status === 'settled') {
+        throw new ConflictException('Parcela já liquidada');
+      }
+
+      throw new ConflictException('Parcela cancelada não pode receber baixa');
+    }
+
+    if (amountCents > installment.open_amount_cents) {
+      throw new ConflictException('Settlement amount exceeds open amount');
+    }
+
+    const paymentMethodId = await this.resolvePaymentMethodId(
+      tx,
+      params.paymentChannel,
+    );
+
+    const settlement = await tx.settlement.create({
+      data: {
+        person_id: title.person_id,
+        bank_account_id: params.bankAccountId || null,
+        payment_method_id: paymentMethodId,
+        settlement_type: titleType,
+        status: 'confirmed',
+        settled_at: settledAt,
+        amount_cents: amountCents,
+        description: params.description?.trim() || null,
+        created_by_user_id: params.userId,
+      },
+    });
+
+    await tx.settlement_allocation.create({
+      data: {
+        settlement: {
+          connect: {
+            id: settlement.id,
+          },
+        },
+        financial_installment: {
+          connect: {
+            id: installment.id,
+          },
+        },
+        allocated_amount_cents: amountCents,
+        amount_cents: amountCents,
+        discount_cents: params.discountCents || 0,
+        interest_cents: params.interestCents || 0,
+        penalty_cents: params.penaltyCents || 0,
+      },
+    });
+
+    const decrementResult = await tx.financial_installment.updateMany({
+      where: {
+        id: installment.id,
+        open_amount_cents: {
+          gte: amountCents,
+        },
+      },
+      data: {
+        open_amount_cents: {
+          decrement: amountCents,
+        },
+      },
+    });
+
+    if (decrementResult.count !== 1) {
+      throw new BadRequestException(
+        'Installment was updated concurrently, please try again',
+      );
+    }
+
+    const updatedInstallment = await tx.financial_installment.findUnique({
+      where: {
+        id: installment.id,
+      },
+      select: {
+        id: true,
+        amount_cents: true,
+        open_amount_cents: true,
+        due_date: true,
+        status: true,
+      },
+    });
+
+    if (!updatedInstallment) {
+      throw new NotFoundException('Installment not found');
+    }
+
+    const nextInstallmentStatus = this.resolveInstallmentStatus(
+      Number(updatedInstallment.amount_cents),
+      Number(updatedInstallment.open_amount_cents),
+      updatedInstallment.due_date,
+    );
+
+    if (updatedInstallment.status !== nextInstallmentStatus) {
+      await tx.financial_installment.update({
+        where: {
+          id: updatedInstallment.id,
+        },
+        data: {
+          status: nextInstallmentStatus,
+        },
+      });
+    }
+
+    return {
+      settlementId: settlement.id as number,
+      installmentId: installment.id as number,
+      openAmountCentsBefore: Number(installment.open_amount_cents),
+      openAmountCentsAfter: Number(updatedInstallment.open_amount_cents),
+    };
+  }
+
   private async settleTitleInstallment(
     titleId: number,
     data: SettleInstallmentDto,
@@ -5978,60 +6263,19 @@ export class FinanceService {
         );
       }
 
-      await this.assertDateNotInClosedPeriod(
-        tx,
+      const appliedSettlement = await this.applyInstallmentSettlement(tx, {
+        title: { id: title.id, person_id: title.person_id },
+        titleType,
+        installmentId: data.installment_id,
+        amountCents,
         settledAt,
-        'settle installment',
-      );
-
-      const installment = await tx.financial_installment.findFirst({
-        where: {
-          id: data.installment_id,
-          title_id: title.id,
-        },
-        select: {
-          id: true,
-          title_id: true,
-          amount_cents: true,
-          open_amount_cents: true,
-          due_date: true,
-          status: true,
-        },
-      });
-
-      if (!installment) {
-        throw new BadRequestException('Installment not found for this title');
-      }
-
-      if (installment.status === 'settled' || installment.status === 'canceled') {
-        if (installment.status === 'settled') {
-          throw new ConflictException('Parcela já liquidada');
-        }
-
-        throw new ConflictException('Parcela cancelada não pode receber baixa');
-      }
-
-      if (amountCents > installment.open_amount_cents) {
-        throw new ConflictException('Settlement amount exceeds open amount');
-      }
-
-      const paymentMethodId = await this.resolvePaymentMethodId(
-        tx,
-        data.payment_channel,
-      );
-
-      const settlement = await tx.settlement.create({
-        data: {
-          person_id: title.person_id,
-          bank_account_id: data.bank_account_id || null,
-          payment_method_id: paymentMethodId,
-          settlement_type: titleType,
-          status: 'confirmed',
-          settled_at: settledAt,
-          amount_cents: amountCents,
-          description: data.description?.trim() || null,
-          created_by_user_id: userId,
-        },
+        bankAccountId: data.bank_account_id,
+        paymentChannel: data.payment_channel,
+        discountCents: this.toCents(data.discount || 0),
+        interestCents: this.toCents(data.interest || 0),
+        penaltyCents: this.toCents(data.penalty || 0),
+        description: data.description,
+        userId,
       });
 
       let reconciliationId: number | null = null;
@@ -6085,7 +6329,7 @@ export class FinanceService {
         const createdReconciliation = await tx.bank_reconciliation.create({
           data: {
             bank_statement_line_id: statementLine.id,
-            settlement_id: settlement.id,
+            settlement_id: appliedSettlement.settlementId,
             status: 'reconciled',
             matched_at: settledAt,
             reconciled_at: settledAt,
@@ -6111,80 +6355,6 @@ export class FinanceService {
         }
       }
 
-      await tx.settlement_allocation.create({
-        data: {
-          settlement: {
-            connect: {
-              id: settlement.id,
-            },
-          },
-          financial_installment: {
-            connect: {
-              id: installment.id,
-            },
-          },
-          allocated_amount_cents: amountCents,
-          amount_cents: amountCents,
-          discount_cents: this.toCents(data.discount || 0),
-          interest_cents: this.toCents(data.interest || 0),
-          penalty_cents: this.toCents(data.penalty || 0),
-        },
-      });
-
-      const decrementResult = await tx.financial_installment.updateMany({
-        where: {
-          id: installment.id,
-          open_amount_cents: {
-            gte: amountCents,
-          },
-        },
-        data: {
-          open_amount_cents: {
-            decrement: amountCents,
-          },
-        },
-      });
-
-      if (decrementResult.count !== 1) {
-        throw new BadRequestException(
-          'Installment was updated concurrently, please try again',
-        );
-      }
-
-      const updatedInstallment = await tx.financial_installment.findUnique({
-        where: {
-          id: installment.id,
-        },
-        select: {
-          id: true,
-          amount_cents: true,
-          open_amount_cents: true,
-          due_date: true,
-          status: true,
-        },
-      });
-
-      if (!updatedInstallment) {
-        throw new NotFoundException('Installment not found');
-      }
-
-      const nextInstallmentStatus = this.resolveInstallmentStatus(
-        Number(updatedInstallment.amount_cents),
-        Number(updatedInstallment.open_amount_cents),
-        updatedInstallment.due_date,
-      );
-
-      if (updatedInstallment.status !== nextInstallmentStatus) {
-        await tx.financial_installment.update({
-          where: {
-            id: updatedInstallment.id,
-          },
-          data: {
-            status: nextInstallmentStatus,
-          },
-        });
-      }
-
       const previousTitleStatus = title.status;
       const nextTitleStatus = await this.recalculateTitleStatus(tx, title.id);
 
@@ -6193,15 +6363,15 @@ export class FinanceService {
         entityTable: 'financial_title',
         entityId: String(title.id),
         actorUserId: userId,
-        summary: `Settled installment ${installment.id} of title ${title.id}`,
+        summary: `Settled installment ${appliedSettlement.installmentId} of title ${title.id}`,
         beforeData: JSON.stringify({
           title_status: previousTitleStatus,
-          installment_open_amount_cents: installment.open_amount_cents,
+          installment_open_amount_cents: appliedSettlement.openAmountCentsBefore,
         }),
         afterData: JSON.stringify({
           title_status: nextTitleStatus,
-          installment_open_amount_cents: updatedInstallment.open_amount_cents,
-          settlement_id: settlement.id,
+          installment_open_amount_cents: appliedSettlement.openAmountCentsAfter,
+          settlement_id: appliedSettlement.settlementId,
           bank_reconciliation_id: reconciliationId,
         }),
       });
@@ -6220,7 +6390,7 @@ export class FinanceService {
 
         return {
           title: updatedTitle,
-          settlementId: settlement.id,
+          settlementId: appliedSettlement.settlementId,
           reconciliationId,
         };
       });