@hed-hog/finance 0.0.253 → 0.0.256

package/hedhog/frontend/messages/pt.json

@@ -99,11 +99,114 @@
       "description": "Não há aprovações pendentes."
     }
   },
+  "PersonFieldWithCreate": {
+    "sheet": {
+      "title": "Novo {entityLabel}",
+      "description": "Apenas nome e tipo são obrigatórios. Você pode completar os demais dados agora ou depois."
+    },
+    "common": {
+      "select": "Selecione"
+    },
+    "types": {
+      "individual": "Pessoa Física",
+      "company": "Pessoa Jurídica"
+    },
+    "fields": {
+      "name": "Nome",
+      "type": "Tipo",
+      "documentIndividualOptional": "CPF (opcional)",
+      "documentCompanyOptional": "CNPJ (opcional)",
+      "emailOptional": "E-mail (opcional)",
+      "phoneOptional": "Telefone (opcional)",
+      "addressOptional": "Endereço (opcional)"
+    },
+    "placeholders": {
+      "name": "Nome do {entityLabel}",
+      "email": "{entityLabel}@empresa.com",
+      "phone": "(11) 99999-9999",
+      "addressLine1": "Rua, número, complemento",
+      "city": "Cidade",
+      "state": "UF"
+    },
+    "search": {
+      "placeholder": "Digite para buscar pessoa...",
+      "loading": "Buscando pessoas...",
+      "noResults": "Nenhuma pessoa encontrada"
+    },
+    "actions": {
+      "cancel": "Cancelar",
+      "saveEntity": "Salvar {entityLabel}",
+      "createNew": "Criar novo cadastro",
+      "clearSelection": "Limpar seleção",
+      "createEntityAria": "Criar novo {entityLabel}"
+    },
+    "messages": {
+      "createdSuccess": "{entityLabel} criado com sucesso",
+      "createdError": "Não foi possível criar {entityLabel}"
+    }
+  },
+  "FinanceEntityFieldWithCreate": {
+    "validation": {
+      "nameRequired": "Nome é obrigatório"
+    },
+    "fields": {
+      "name": "Nome"
+    },
+    "actions": {
+      "cancel": "Cancelar",
+      "save": "Salvar",
+      "createCategoryAria": "Criar nova categoria",
+      "createCostCenterAria": "Criar novo centro de custo"
+    },
+    "categorySheet": {
+      "title": "Nova categoria",
+      "description": "Cadastre uma nova categoria para usar neste lançamento.",
+      "namePlaceholder": "Nome da categoria"
+    },
+    "costCenterSheet": {
+      "title": "Novo centro de custo",
+      "description": "Cadastre um novo centro de custo para usar neste lançamento.",
+      "namePlaceholder": "Nome do centro de custo"
+    },
+    "messages": {
+      "categoryCreateSuccess": "Categoria criada com sucesso",
+      "categoryCreateError": "Não foi possível criar categoria",
+      "costCenterCreateSuccess": "Centro de custo criado com sucesso",
+      "costCenterCreateError": "Não foi possível criar centro de custo"
+    }
+  },
   "PayableInstallmentsPage": {
     "common": {
       "select": "Selecione...",
       "cancel": "Cancelar",
-      "save": "Salvar"
+      "save": "Salvar",
+      "upload": {
+        "label": "Arquivo da fatura (opcional)",
+        "upload": "Upload",
+        "change": "Trocar arquivo",
+        "remove": "Remover",
+        "selectedPrefix": "Arquivo:",
+        "uploadingProgress": "Upload em andamento: {progress}%",
+        "processingAi": "Analisando documento com IA",
+        "lowConfidence": "Confiança da extração: {confidence}%",
+        "fillingWithAi": "Preenchendo com IA...",
+        "uploadingFile": "Enviando arquivo..."
+      }
+    },
+    "validation": {
+      "documentRequired": "Documento é obrigatório",
+      "supplierRequired": "Fornecedor é obrigatório",
+      "dueDateRequired": "Vencimento é obrigatório",
+      "amountGreaterThanZero": "Valor deve ser maior que zero",
+      "invalidInstallmentCount": "Quantidade de parcelas inválida",
+      "installmentsMin": "Mínimo de 1 parcela",
+      "installmentsMax": "Máximo de 120 parcelas",
+      "installmentDueDateRequired": "Vencimento da parcela é obrigatório",
+      "installmentAmountGreaterThanZero": "Valor da parcela deve ser maior que zero",
+      "installmentsRequired": "Informe ao menos uma parcela",
+      "installmentsCountMismatch": "Quantidade de parcelas não confere com o detalhamento",
+      "installmentsSumMismatch": "A soma das parcelas deve ser igual ao valor total",
+      "installmentRequired": "Parcela obrigatória"
     },
     "newTitle": {
       "action": "Novo Título",
@@ -169,9 +272,75 @@
         "approve": "Aprovar",
         "settle": "Baixar",
         "reverse": "Estornar",
-        "cancel": "Cancelar"
+        "cancel": "Cancelar",
+        "openAttachment": "Abrir anexo"
+      }
+    },
+    "dialogs": {
+      "cancel": {
+        "title": "Confirmar cancelamento",
+        "description": "Esta ação cancela o título e não pode ser desfeita automaticamente.",
+        "cancel": "Voltar",
+        "confirm": "Confirmar cancelamento"
+      },
+      "reverse": {
+        "title": "Confirmar estorno",
+        "description": "Informe o motivo do estorno. O sistema recalculará os saldos e status automaticamente.",
+        "reasonLabel": "Motivo do estorno",
+        "reasonPlaceholder": "Ex.: baixa duplicada",
+        "cancel": "Voltar",
+        "confirm": "Confirmar estorno"
       }
     },
+    "settleSheet": {
+      "title": "Registrar baixa",
+      "description": "Informe a parcela e o valor da baixa para o título {document}.",
+      "installmentLabel": "Parcela",
+      "installmentPlaceholder": "Selecione",
+      "installmentOption": "Parcela {number} - em aberto: {amount}",
+      "amountLabel": "Valor",
+      "descriptionLabel": "Descrição (opcional)",
+      "confirm": "Confirmar baixa"
+    },
+    "installmentsEditor": {
+      "title": "Parcelas",
+      "countLabel": "Quantidade de Parcelas",
+      "recalculate": "Recalcular automaticamente",
+      "autoRedistributeLabel": "Redistribuir automaticamente o restante ao editar parcela",
+      "autoRedistributeHint": "A redistribuição ocorre ao parar de digitar e ao sair do campo.",
+      "dueDateLabel": "Vencimento",
+      "amountLabel": "Valor",
+      "totalPrefix": "Soma das parcelas: {total}",
+      "adjustmentNeeded": "(ajuste necessário)"
+    },
+    "editTitle": {
+      "description": "Edite os dados do título enquanto estiver em rascunho."
+    },
+    "messages": {
+      "createSuccess": "Título criado com sucesso",
+      "createError": "Erro ao criar título",
+      "invalidFile": "Arquivo inválido",
+      "attachSuccess": "Arquivo relacionado com sucesso",
+      "aiExtractSuccess": "Dados da fatura extraídos e preenchidos automaticamente",
+      "aiExtractError": "Não foi possível extrair os dados automaticamente",
+      "uploadError": "Não foi possível enviar o arquivo",
+      "invalidTitleForEdit": "Título inválido para edição",
+      "updateSuccess": "Título atualizado com sucesso",
+      "updateError": "Não foi possível atualizar o título",
+      "editDraftOnly": "Apenas títulos em rascunho podem ser editados",
+      "cancelSuccess": "Título cancelado com sucesso",
+      "cancelError": "Não foi possível cancelar o título",
+      "approveSuccess": "Título aprovado com sucesso",
+      "approveError": "Não foi possível aprovar o título",
+      "noInstallmentForSettle": "Nenhuma parcela disponível para baixa",
+      "settleSuccess": "Baixa registrada com sucesso",
+      "settleError": "Não foi possível registrar a baixa",
+      "noActiveSettlementToReverse": "Nenhuma liquidação ativa para estornar",
+      "reverseDefaultReason": "Estorno realizado pela listagem de títulos",
+      "reverseSuccess": "Estorno realizado com sucesso",
+      "reverseError": "Não foi possível estornar a liquidação",
+      "openAttachmentError": "Não foi possível abrir o anexo"
+    },
     "footer": {
       "showing": "Mostrando {filtered} de {total} registros",
       "previous": "Anterior",
@@ -212,6 +381,8 @@
       "reverse": {
         "title": "Confirmar estorno",
         "description": "Esta ação estorna a liquidação selecionada, recalcula os saldos das parcelas e atualiza o status do título.",
+        "reasonLabel": "Motivo do estorno",
+        "reasonPlaceholder": "Ex.: baixa duplicada",
         "cancel": "Cancelar",
         "confirm": "Confirmar estorno"
       }
@@ -234,7 +405,9 @@
       "reverseSuccess": "Estorno realizado com sucesso",
       "reverseError": "Não foi possível estornar a liquidação",
       "cancelSuccess": "Título cancelado com sucesso",
-      "cancelError": "Não foi possível cancelar o título"
+      "cancelError": "Não foi possível cancelar o título",
+      "unreconcileSuccess": "Conciliação removida com sucesso",
+      "unreconcileError": "Não foi possível desconciliar a liquidação"
     },
     "documentData": {
       "title": "Dados do Documento",
@@ -300,6 +473,32 @@
       "reverseDialogConfirm": "Confirmar estorno",
       "none": "Nenhuma liquidação registrada"
     },
+    "settlementsHistory": {
+      "loading": "Carregando histórico de liquidações...",
+      "allocationsTitle": "Rateios",
+      "allocationInstallment": "Parcela",
+      "headers": {
+        "date": "Data",
+        "type": "Tipo",
+        "status": "Status",
+        "netAmount": "Valor Líquido",
+        "method": "Método",
+        "account": "Conta",
+        "reconciled": "Conciliação",
+        "actions": "Ações"
+      },
+      "normalType": "NORMAL",
+      "reversalType": "REVERSAL",
+      "reversedStatus": "ESTORNO",
+      "reconciled": {
+        "yes": "Conciliado",
+        "no": "Pendente"
+      },
+      "unreconcile": "Desconciliar",
+      "unreconcileLoading": "Desconciliando...",
+      "unreconcileFirst": "Desconciliar primeiro",
+      "reverse": "Estornar"
+    },
     "audit": { "none": "Nenhum evento de auditoria" }
   },
   "CollectionsDefaultPage": {
@@ -376,7 +575,33 @@
     "common": {
       "select": "Selecione...",
       "cancel": "Cancelar",
-      "save": "Salvar"
+      "save": "Salvar",
+      "upload": {
+        "label": "Arquivo da fatura (opcional)",
+        "upload": "Upload",
+        "change": "Trocar arquivo",
+        "remove": "Remover",
+        "selectedPrefix": "Arquivo:",
+        "uploadingProgress": "Upload em andamento: {progress}%",
+        "processingAi": "Analisando documento com IA",
+        "lowConfidence": "Confiança da extração: {confidence}%",
+        "fillingWithAi": "Preenchendo com IA...",
+        "uploadingFile": "Enviando arquivo..."
+      }
+    },
+    "validation": {
+      "documentRequired": "Documento é obrigatório",
+      "clientRequired": "Cliente é obrigatório",
+      "dueDateRequired": "Vencimento é obrigatório",
+      "amountGreaterThanZero": "Valor deve ser maior que zero",
+      "invalidInstallmentCount": "Quantidade de parcelas inválida",
+      "installmentsMin": "Mínimo de 1 parcela",
+      "installmentsMax": "Máximo de 120 parcelas",
+      "installmentDueDateRequired": "Vencimento da parcela é obrigatório",
+      "installmentAmountGreaterThanZero": "Valor da parcela deve ser maior que zero",
+      "installmentsRequired": "Informe ao menos uma parcela",
+      "installmentsCountMismatch": "Quantidade de parcelas não confere com o detalhamento",
+      "installmentsSumMismatch": "A soma das parcelas deve ser igual ao valor total"
     },
     "newTitle": {
       "action": "Novo Título",
@@ -436,9 +661,37 @@
         "viewDetails": "Ver Detalhes",
         "edit": "Editar",
         "registerReceipt": "Registrar Recebimento",
-        "sendCollection": "Enviar Cobrança"
+        "sendCollection": "Enviar Cobrança",
+        "openAttachment": "Abrir anexo"
       }
     },
+    "installmentsEditor": {
+      "title": "Parcelas",
+      "countLabel": "Quantidade de Parcelas",
+      "recalculate": "Recalcular automaticamente",
+      "autoRedistributeLabel": "Redistribuir automaticamente o restante ao editar parcela",
+      "dueDateLabel": "Vencimento",
+      "amountLabel": "Valor",
+      "totalPrefix": "Soma das parcelas: {total}",
+      "adjustmentNeeded": "(ajuste necessário)"
+    },
+    "editTitle": {
+      "description": "Edite os dados do título enquanto estiver em rascunho."
+    },
+    "messages": {
+      "createSuccess": "Título criado com sucesso",
+      "createError": "Erro ao criar título",
+      "invalidFile": "Arquivo inválido",
+      "attachSuccess": "Arquivo relacionado com sucesso",
+      "aiExtractSuccess": "Dados da fatura extraídos e preenchidos automaticamente",
+      "aiExtractError": "Não foi possível extrair os dados automaticamente",
+      "uploadError": "Não foi possível enviar o arquivo",
+      "invalidTitleForEdit": "Título inválido para edição",
+      "updateSuccess": "Título atualizado com sucesso",
+      "updateError": "Não foi possível atualizar o título",
+      "editDraftOnly": "Apenas títulos em rascunho podem ser editados",
+      "openAttachmentError": "Não foi possível abrir o anexo"
+    },
     "footer": {
       "showing": "Mostrando {filtered} de {total} registros",
       "previous": "Anterior",
@@ -465,9 +718,43 @@
     "actions": {
       "title": "Ações",
       "edit": "Editar",
+      "approve": "Aprovar",
       "registerReceipt": "Registrar Recebimento",
       "sendCollection": "Enviar Cobrança"
     },
+    "common": {
+      "cancel": "Cancelar"
+    },
+    "validation": {
+      "installmentRequired": "Parcela obrigatória",
+      "amountGreaterThanZero": "Valor deve ser maior que zero"
+    },
+    "settleSheet": {
+      "title": "Registrar recebimento",
+      "description": "Informe a parcela e o valor para baixa parcial ou total.",
+      "installmentLabel": "Parcela",
+      "installmentPlaceholder": "Selecione",
+      "installmentOption": "Parcela {number} - em aberto: {amount}",
+      "amountLabel": "Valor",
+      "descriptionLabel": "Descrição (opcional)",
+      "confirm": "Confirmar recebimento"
+    },
+    "reverseSheet": {
+      "title": "Confirmar estorno",
+      "description": "Esta ação estorna o recebimento e recalcula saldos e status.",
+      "reasonLabel": "Motivo do estorno",
+      "reasonPlaceholder": "Ex.: baixa duplicada",
+      "confirm": "Confirmar estorno"
+    },
+    "messages": {
+      "approveSuccess": "Título aprovado com sucesso",
+      "approveError": "Não foi possível aprovar o título",
+      "settleSuccess": "Recebimento registrado com sucesso",
+      "settleError": "Não foi possível registrar o recebimento",
+      "reverseSuccess": "Estorno realizado com sucesso",
+      "reverseError": "Não foi possível estornar o recebimento",
+      "reverseDefaultReason": "Estorno realizado no detalhe do título"
+    },
     "documentData": {
       "title": "Dados do Documento",
       "client": "Cliente",
@@ -521,6 +808,8 @@
       "discount": "Desconto",
       "account": "Conta",
       "method": "Método",
+      "actions": "Ações",
+      "reverseButton": "Estornar",
       "none": "Nenhum recebimento registrado"
     },
     "audit": { "none": "Nenhum evento de auditoria" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.253",
+  "version": "0.0.256",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -10,13 +10,13 @@
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
     "@hed-hog/api-pagination": "0.0.5",
-    "@hed-hog/contact": "0.0.251",
-    "@hed-hog/tag": "0.0.251",
     "@hed-hog/api-locale": "0.0.11",
+    "@hed-hog/contact": "0.0.254",
     "@hed-hog/api-prisma": "0.0.4",
-    "@hed-hog/api-types": "0.0.1",
+    "@hed-hog/tag": "0.0.254",
     "@hed-hog/api": "0.0.3",
-    "@hed-hog/core": "0.0.251"
+    "@hed-hog/core": "0.0.254",
+    "@hed-hog/api-types": "0.0.1"
   },
   "exports": {
     ".": {

package/src/finance.service.ts

@@ -1,5 +1,9 @@
 import { getLocaleText } from '@hed-hog/api-locale';
-import { PaginationDTO, PaginationService } from '@hed-hog/api-pagination';
+import {
+    PageOrderDirection,
+    PaginationDTO,
+    PaginationService,
+} from '@hed-hog/api-pagination';
 import { PrismaService } from '@hed-hog/api-prisma';
 import { AiService, FileService } from '@hed-hog/core';
 import {
@@ -2399,6 +2403,7 @@ export class FinanceService {
     status?: string,
   ) {
     const prismaStatus = this.mapStatusFromPt(status);
+    const search = paginationParams?.search?.trim();
     const where: any = {
       title_type: titleType,
     };
@@ -2407,15 +2412,45 @@ export class FinanceService {
       where.status = prismaStatus;
     }
 
-    return this.paginationService.paginate(
+    if (search) {
+      where.OR = [
+        {
+          document_number: {
+            contains: search,
+            mode: 'insensitive',
+          },
+        },
+        {
+          person: {
+            name: {
+              contains: search,
+              mode: 'insensitive',
+            },
+          },
+        },
+      ];
+    }
+
+    const normalizedPaginationParams: PaginationDTO = {
+      ...paginationParams,
+      sortField: paginationParams?.sortField || 'created_at',
+      sortOrder: paginationParams?.sortOrder || PageOrderDirection.Desc,
+    };
+
+    const paginated = await this.paginationService.paginate(
       this.prisma.financial_title,
-      paginationParams,
+      normalizedPaginationParams,
       {
         where,
         include: this.defaultTitleInclude(),
         orderBy: { created_at: 'desc' },
       },
     );
+
+    return {
+      ...paginated,
+      data: (paginated.data || []).map((title) => this.mapTitleToFront(title)),
+    };
   }
 
   private async getTitleById(id: number, titleType: TitleType, locale: string) {
@@ -3286,9 +3321,18 @@ export class FinanceService {
 
       await tx.settlement_allocation.create({
         data: {
-          settlement_id: settlement.id,
-          installment_id: installment.id,
+          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),
@@ -3459,7 +3503,7 @@ export class FinanceService {
           title_competence_date: Date | null;
         }>
       >`
-        SELECT DISTINCT
+        SELECT
           s.id,
           s.settlement_type::text,
           s.settled_at,
@@ -3479,6 +3523,7 @@ export class FinanceService {
         INNER JOIN financial_installment fi ON fi.id = sa.installment_id
         INNER JOIN financial_title ft ON ft.id = fi.title_id
         WHERE s.id = ${settlementId}
+        LIMIT 1
         FOR UPDATE OF s
       `;
 
@@ -3618,9 +3663,18 @@ export class FinanceService {
 
         await tx.settlement_allocation.create({
           data: {
-            settlement_id: reversalId,
-            installment_id: allocation.installment_id,
+            settlement: {
+              connect: {
+                id: reversalId,
+              },
+            },
+            financial_installment: {
+              connect: {
+                id: allocation.installment_id,
+              },
+            },
             allocated_amount_cents: -Math.abs(originalAmount),
+            amount_cents: -Math.abs(originalAmount),
             discount_cents: -Math.abs(allocation.discount_cents || 0),
             interest_cents: -Math.abs(allocation.interest_cents || 0),
             penalty_cents: -Math.abs(allocation.penalty_cents || 0),
@@ -4513,7 +4567,28 @@ export class FinanceService {
     return Math.round(value * 100);
   }
 
-  private fromCents(value: number) {
-    return Number((value / 100).toFixed(2));
+  private fromCents(value: number | bigint | string | null | undefined) {
+    if (value === null || value === undefined) {
+      return 0;
+    }
+
+    if (typeof value === 'bigint') {
+      const isNegative = value < BigInt(0);
+      const absoluteValue = isNegative ? -value : value;
+      const whole = absoluteValue / BigInt(100);
+      const cents = absoluteValue % BigInt(100);
+      const composedValue = Number(whole) + Number(cents) / 100;
+
+      return Number((isNegative ? -composedValue : composedValue).toFixed(2));
+    }
+
+    const numericValue =
+      typeof value === 'string' ? Number(value) : Number(value || 0);
+
+    if (!Number.isFinite(numericValue)) {
+      return 0;
+    }
+
+    return Number((numericValue / 100).toFixed(2));
   }
 }