@hed-hog/finance 0.0.363 → 0.0.365

package/hedhog/frontend/messages/en.json

@@ -186,6 +186,7 @@
       "select": "Select...",
       "cancel": "Cancel",
       "save": "Save",
+      "saveAndNew": "Save and new",
       "upload": {
         "label": "Invoice file (optional)",
         "upload": "Upload",
@@ -201,7 +202,6 @@
     },
     "draftStatus": "Draft saved {relativeLabel} • Last saved: {absoluteLabel}",
     "validation": {
-      "documentRequired": "Document is required",
       "supplierRequired": "Supplier is required",
       "dueDateRequired": "Due date is required",
       "amountGreaterThanZero": "Amount must be greater than zero",
@@ -214,13 +214,32 @@
       "installmentsCountMismatch": "Installments count does not match detailed schedule",
       "installmentsSumMismatch": "Installments sum must match total amount",
       "installmentRequired": "Installment is required",
-      "recurrenceEndOrCount": "Provide an end date or number of repetitions"
+      "recurrenceEndOrCount": "Provide an end date or number of repetitions",
+      "paymentDateRequired": "Payment date is required",
+      "bankAccountRequired": "Bank account is required",
+      "paidAmountInvalid": "Paid amount must be greater than zero and at most the total amount",
+      "installmentPaymentDateRequired": "Provide the payment date for installments marked as paid"
     },
     "titleType": {
-      "label": "Entry type",
+      "label": "Payment terms",
+      "cash": "Single payment",
       "installment": "Installments",
       "recurring": "Recurring"
     },
+    "paidToggle": {
+      "label": "Already paid?",
+      "hint": "The settlement is recorded automatically on save."
+    },
+    "payment": {
+      "dateLabel": "Payment date",
+      "bankAccountLabel": "Bank account",
+      "bankAccountPlaceholder": "Select an account",
+      "paidAmountLabel": "Amount paid",
+      "interestLabel": "Interest",
+      "penaltyLabel": "Fine",
+      "discountLabel": "Discount",
+      "installmentsHint": "Mark the paid installments in the Payment terms section."
+    },
     "recurrenceEditor": {
       "title": "Recurrence",
       "description": "Configure the title recurrence frequency",
@@ -245,15 +264,15 @@
       "descriptionPlaceholder": "Title description..."
     },
     "fields": {
-      "document": "Document",
+      "document": "Document number",
       "supplier": "Supplier",
-      "competency": "Competency",
-      "dueDate": "Due Date",
-      "totalValue": "Total Value",
-      "totalValueRecurring": "Amount per Period",
+      "competency": "Competency month",
+      "dueDate": "Due date",
+      "totalValue": "Total amount",
+      "totalValueRecurring": "Amount per period",
       "category": "Category",
-      "costCenter": "Cost Center",
-      "paymentMethod": "Payment Method",
+      "costCenter": "Cost center",
+      "paymentMethod": "Payment method",
       "description": "Description"
     },
     "paymentMethods": {
@@ -309,7 +328,7 @@
     "sections": {
       "main": {
         "title": "Main data",
-        "description": "Provide document, supplier, dates, and the total title amount."
+        "description": "Provide supplier, document, due date, and the title amount."
       },
       "installments": {
         "title": "Installments",
@@ -319,6 +338,19 @@
         "title": "Recurrence",
         "description": "Configure the title repetition frequency."
       },
+      "paymentCondition": {
+        "title": "Payment terms",
+        "description": "Choose single payment, installments, or recurring.",
+        "summary": {
+          "cash": "Single payment • due {date}",
+          "installments": "{count} installments • first due {date}",
+          "recurring": "Recurring • {frequency}"
+        }
+      },
+      "details": {
+        "title": "Classification and details",
+        "description": "Competency, category, cost center, and notes."
+      },
       "classification": {
         "title": "Financial classification",
         "description": "Assign category, cost center, and payment method to organize the operation."
@@ -387,12 +419,14 @@
     },
     "installmentsEditor": {
       "title": "Installments",
-      "countLabel": "Installments Count",
+      "countLabel": "Number of installments",
       "recalculate": "Recalculate automatically",
       "autoRedistributeLabel": "Automatically redistribute remaining amount when editing installment",
       "autoRedistributeHint": "Redistribution occurs after typing stops and on field blur.",
       "dueDateLabel": "Due date",
       "amountLabel": "Amount",
+      "paidLabel": "Paid",
+      "paymentDateLabel": "Payment date",
       "totalPrefix": "Installments total: {total}",
       "adjustmentNeeded": "(adjustment needed)"
     },
@@ -665,6 +699,7 @@
       "select": "Select...",
       "cancel": "Cancel",
       "save": "Save",
+      "saveAndNew": "Save and new",
       "upload": {
         "label": "Invoice file (optional)",
         "upload": "Upload",
@@ -680,7 +715,6 @@
     },
     "draftStatus": "Draft saved {relativeLabel} • Last saved: {absoluteLabel}",
     "validation": {
-      "documentRequired": "Document is required",
       "clientRequired": "Client is required",
       "dueDateRequired": "Due date is required",
       "amountGreaterThanZero": "Amount must be greater than zero",
@@ -692,13 +726,32 @@
       "installmentsRequired": "Provide at least one installment",
       "installmentsCountMismatch": "Installments count does not match detailed schedule",
       "installmentsSumMismatch": "Installments sum must match total amount",
-      "recurrenceEndOrCount": "Provide an end date or number of repetitions"
+      "recurrenceEndOrCount": "Provide an end date or number of repetitions",
+      "paymentDateRequired": "Receipt date is required",
+      "bankAccountRequired": "Bank account is required",
+      "paidAmountInvalid": "Received amount must be greater than zero and at most the total amount",
+      "installmentPaymentDateRequired": "Provide the receipt date for installments marked as received"
     },
     "titleType": {
-      "label": "Entry type",
+      "label": "Receipt terms",
+      "cash": "Single payment",
       "installment": "Installments",
       "recurring": "Recurring"
     },
+    "paidToggle": {
+      "label": "Already received?",
+      "hint": "The receipt is recorded automatically on save."
+    },
+    "payment": {
+      "dateLabel": "Receipt date",
+      "bankAccountLabel": "Bank account",
+      "bankAccountPlaceholder": "Select an account",
+      "paidAmountLabel": "Amount received",
+      "interestLabel": "Interest",
+      "penaltyLabel": "Fine",
+      "discountLabel": "Discount",
+      "installmentsHint": "Mark the received installments in the Receipt terms section."
+    },
     "recurrenceEditor": {
       "title": "Recurrence",
       "description": "Configure the title recurrence frequency",
@@ -723,15 +776,15 @@
       "descriptionPlaceholder": "Title description..."
     },
     "fields": {
-      "document": "Document",
+      "document": "Document number",
       "client": "Client",
-      "competency": "Competency",
-      "dueDate": "Due Date",
-      "totalValue": "Total Value",
-      "totalValueRecurring": "Amount per Period",
+      "competency": "Competency month",
+      "dueDate": "Due date",
+      "totalValue": "Total amount",
+      "totalValueRecurring": "Amount per period",
       "category": "Category",
-      "costCenter": "Cost Center",
-      "channel": "Receiving Channel",
+      "costCenter": "Cost center",
+      "channel": "Receipt method",
       "description": "Description"
     },
     "channels": {
@@ -785,7 +838,7 @@
     "sections": {
       "main": {
         "title": "Main data",
-        "description": "Provide document, client, dates, and the total title amount."
+        "description": "Provide client, document, due date, and the title amount."
       },
       "installments": {
         "title": "Installments",
@@ -795,6 +848,19 @@
         "title": "Recurrence",
         "description": "Configure the title repetition frequency."
       },
+      "paymentCondition": {
+        "title": "Receipt terms",
+        "description": "Choose single payment, installments, or recurring.",
+        "summary": {
+          "cash": "Single payment • due {date}",
+          "installments": "{count} installments • first due {date}",
+          "recurring": "Recurring • {frequency}"
+        }
+      },
+      "details": {
+        "title": "Classification and details",
+        "description": "Competency, category, cost center, and notes."
+      },
       "classification": {
         "title": "Financial classification",
         "description": "Assign category, cost center, and receiving channel to organize the operation."
@@ -829,12 +895,14 @@
     },
     "installmentsEditor": {
       "title": "Installments",
-      "countLabel": "Installments Count",
+      "countLabel": "Number of installments",
       "recalculate": "Recalculate automatically",
       "autoRedistributeLabel": "Automatically redistribute remaining amount when editing installment",
       "autoRedistributeHint": "Redistribution occurs after typing stops and on field blur.",
       "dueDateLabel": "Due date",
       "amountLabel": "Amount",
+      "paidLabel": "Received",
+      "paymentDateLabel": "Receipt date",
       "totalPrefix": "Installments total: {total}",
       "adjustmentNeeded": "(adjustment needed)"
     },

package/hedhog/frontend/messages/pt.json

@@ -171,6 +171,7 @@
       "select": "Selecione...",
       "cancel": "Cancelar",
       "save": "Salvar",
+      "saveAndNew": "Salvar e novo",
       "upload": {
         "label": "Arquivo da fatura (opcional)",
         "upload": "Upload",
@@ -186,7 +187,6 @@
     },
     "draftStatus": "Rascunho salvo {relativeLabel} • Último salvamento: {absoluteLabel}",
     "validation": {
-      "documentRequired": "Documento é obrigatório",
       "supplierRequired": "Fornecedor é obrigatório",
       "dueDateRequired": "Vencimento é obrigatório",
       "amountGreaterThanZero": "Valor deve ser maior que zero",
@@ -199,13 +199,32 @@
       "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",
-      "recurrenceEndOrCount": "Informe a data de término ou o número de repetições"
+      "recurrenceEndOrCount": "Informe a data de término ou o número de repetições",
+      "paymentDateRequired": "Informe a data do pagamento",
+      "bankAccountRequired": "Informe a conta bancária",
+      "paidAmountInvalid": "O valor pago deve ser maior que zero e no máximo o valor total",
+      "installmentPaymentDateRequired": "Informe a data de pagamento das parcelas marcadas como pagas"
     },
     "titleType": {
-      "label": "Tipo de lançamento",
+      "label": "Condição de pagamento",
+      "cash": "À vista",
       "installment": "Parcelado",
       "recurring": "Recorrente"
     },
+    "paidToggle": {
+      "label": "Já foi pago?",
+      "hint": "A baixa será registrada automaticamente ao salvar."
+    },
+    "payment": {
+      "dateLabel": "Data do pagamento",
+      "bankAccountLabel": "Conta bancária",
+      "bankAccountPlaceholder": "Selecione a conta",
+      "paidAmountLabel": "Valor pago",
+      "interestLabel": "Juros",
+      "penaltyLabel": "Multa",
+      "discountLabel": "Desconto",
+      "installmentsHint": "Marque as parcelas pagas na seção Condição de pagamento."
+    },
     "recurrenceEditor": {
       "title": "Recorrência",
       "description": "Configure a periodicidade do título",
@@ -230,15 +249,15 @@
       "descriptionPlaceholder": "Descrição do título..."
     },
     "fields": {
-      "document": "Documento",
+      "document": "Nº do documento",
       "supplier": "Fornecedor",
-      "competency": "Competência",
-      "dueDate": "Vencimento",
-      "totalValue": "Valor Total",
-      "totalValueRecurring": "Valor por Período",
+      "competency": "Mês de competência",
+      "dueDate": "Data de vencimento",
+      "totalValue": "Valor total",
+      "totalValueRecurring": "Valor por período",
       "category": "Categoria",
-      "costCenter": "Centro de Custo",
-      "paymentMethod": "Forma de Pagamento",
+      "costCenter": "Centro de custo",
+      "paymentMethod": "Forma de pagamento",
       "description": "Descrição"
     },
     "paymentMethods": {
@@ -294,7 +313,7 @@
     "sections": {
       "main": {
         "title": "Dados principais",
-        "description": "Informe documento, fornecedor, datas e valor total do título."
+        "description": "Informe fornecedor, documento, vencimento e valor do título."
       },
       "installments": {
         "title": "Parcelas",
@@ -304,6 +323,19 @@
         "title": "Recorrência",
         "description": "Configure a frequência de repetição do título."
       },
+      "paymentCondition": {
+        "title": "Condição de pagamento",
+        "description": "Defina se o lançamento é à vista, parcelado ou recorrente.",
+        "summary": {
+          "cash": "À vista • vence em {date}",
+          "installments": "{count}x • 1ª parcela em {date}",
+          "recurring": "Recorrente • {frequency}"
+        }
+      },
+      "details": {
+        "title": "Classificação e detalhes",
+        "description": "Competência, categoria, centro de custo e observações."
+      },
       "classification": {
         "title": "Classificação financeira",
         "description": "Associe categoria, centro de custo e forma de pagamento para organizar a operação."
@@ -372,12 +404,14 @@
     },
     "installmentsEditor": {
       "title": "Parcelas",
-      "countLabel": "Quantidade de Parcelas",
+      "countLabel": "Número 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",
+      "paidLabel": "Paga",
+      "paymentDateLabel": "Data do pagamento",
       "totalPrefix": "Soma das parcelas: {total}",
       "adjustmentNeeded": "(ajuste necessário)"
     },
@@ -650,6 +684,7 @@
       "select": "Selecione...",
       "cancel": "Cancelar",
       "save": "Salvar",
+      "saveAndNew": "Salvar e novo",
       "upload": {
         "label": "Arquivo da fatura (opcional)",
         "upload": "Upload",
@@ -665,7 +700,6 @@
     },
     "draftStatus": "Rascunho salvo {relativeLabel} • Último salvamento: {absoluteLabel}",
     "validation": {
-      "documentRequired": "Documento é obrigatório",
       "clientRequired": "Cliente é obrigatório",
       "dueDateRequired": "Vencimento é obrigatório",
       "amountGreaterThanZero": "Valor deve ser maior que zero",
@@ -677,13 +711,32 @@
       "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",
-      "recurrenceEndOrCount": "Informe a data de término ou o número de repetições"
+      "recurrenceEndOrCount": "Informe a data de término ou o número de repetições",
+      "paymentDateRequired": "Informe a data do recebimento",
+      "bankAccountRequired": "Informe a conta bancária",
+      "paidAmountInvalid": "O valor recebido deve ser maior que zero e no máximo o valor total",
+      "installmentPaymentDateRequired": "Informe a data de recebimento das parcelas marcadas como recebidas"
     },
     "titleType": {
-      "label": "Tipo de lançamento",
+      "label": "Condição de recebimento",
+      "cash": "À vista",
       "installment": "Parcelado",
       "recurring": "Recorrente"
     },
+    "paidToggle": {
+      "label": "Já foi recebido?",
+      "hint": "O recebimento será registrado automaticamente ao salvar."
+    },
+    "payment": {
+      "dateLabel": "Data do recebimento",
+      "bankAccountLabel": "Conta bancária",
+      "bankAccountPlaceholder": "Selecione a conta",
+      "paidAmountLabel": "Valor recebido",
+      "interestLabel": "Juros",
+      "penaltyLabel": "Multa",
+      "discountLabel": "Desconto",
+      "installmentsHint": "Marque as parcelas recebidas na seção Condição de recebimento."
+    },
     "recurrenceEditor": {
       "title": "Recorrência",
       "description": "Configure a periodicidade do título",
@@ -708,15 +761,15 @@
       "descriptionPlaceholder": "Descrição do título..."
     },
     "fields": {
-      "document": "Documento",
+      "document": "Nº do documento",
       "client": "Cliente",
-      "competency": "Competência",
-      "dueDate": "Vencimento",
-      "totalValue": "Valor Total",
-      "totalValueRecurring": "Valor por Período",
+      "competency": "Mês de competência",
+      "dueDate": "Data de vencimento",
+      "totalValue": "Valor total",
+      "totalValueRecurring": "Valor por período",
       "category": "Categoria",
-      "costCenter": "Centro de Custo",
-      "channel": "Canal de Recebimento",
+      "costCenter": "Centro de custo",
+      "channel": "Forma de recebimento",
       "description": "Descrição"
     },
     "channels": {
@@ -770,7 +823,7 @@
     "sections": {
       "main": {
         "title": "Dados principais",
-        "description": "Informe documento, cliente, datas e valor total do título."
+        "description": "Informe cliente, documento, vencimento e valor do título."
       },
       "installments": {
         "title": "Parcelas",
@@ -780,6 +833,19 @@
         "title": "Recorrência",
         "description": "Configure a frequência de repetição do título."
       },
+      "paymentCondition": {
+        "title": "Condição de recebimento",
+        "description": "Defina se o lançamento é à vista, parcelado ou recorrente.",
+        "summary": {
+          "cash": "À vista • vence em {date}",
+          "installments": "{count}x • 1ª parcela em {date}",
+          "recurring": "Recorrente • {frequency}"
+        }
+      },
+      "details": {
+        "title": "Classificação e detalhes",
+        "description": "Competência, categoria, centro de custo e observações."
+      },
       "classification": {
         "title": "Classificação financeira",
         "description": "Associe categoria, centro de custo e canal de recebimento para organizar a operação."
@@ -814,12 +880,14 @@
     },
     "installmentsEditor": {
       "title": "Parcelas",
-      "countLabel": "Quantidade de Parcelas",
+      "countLabel": "Número 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",
+      "paidLabel": "Recebida",
+      "paymentDateLabel": "Data do recebimento",
       "totalPrefix": "Soma das parcelas: {total}",
       "adjustmentNeeded": "(ajuste necessário)"
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.363",
+  "version": "0.0.365",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -12,11 +12,11 @@
     "@hed-hog/api": "0.0.8",
     "@hed-hog/api-pagination": "0.0.7",
     "@hed-hog/api-locale": "0.0.14",
-    "@hed-hog/crm": "0.0.362",
     "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/crm": "0.0.365",
+    "@hed-hog/tag": "0.0.365",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/core": "0.0.362",
-    "@hed-hog/tag": "0.0.362"
+    "@hed-hog/core": "0.0.365"
   },
   "exports": {
     ".": {

package/src/dto/create-financial-title.dto.ts

@@ -2,10 +2,10 @@ import { getLocaleText } from '@hed-hog/api-locale';
 import { Type } from 'class-transformer';
 import {
     IsArray,
+    IsBoolean,
     IsDateString,
     IsIn,
     IsInt,
-    IsNotEmpty,
     IsNumber,
     IsOptional,
     IsString,
@@ -63,16 +63,42 @@ export class CreateFinancialInstallmentDto {
       getLocaleText('validation.installmentAmountMin', args.value),
   })
   amount: number;
+
+  @IsOptional()
+  @IsBoolean()
+  paid?: boolean;
+
+  @IsOptional()
+  @IsDateString()
+  paid_at?: string;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0.01)
+  paid_amount?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  discount?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  interest?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  penalty?: number;
 }
 
 export class CreateFinancialTitleDto {
+  @IsOptional()
   @IsString({
     message: (args) => getLocaleText('validation.documentMustBeString', args.value),
   })
-  @IsNotEmpty({
-    message: (args) => getLocaleText('validation.documentRequired', args.value),
-  })
-  document_number: string;
+  document_number?: string;
 
   @IsInt({
     message: (args) => getLocaleText('validation.personIdMustBeNumber', args.value),
@@ -142,6 +168,11 @@ export class CreateFinancialTitleDto {
   })
   payment_channel?: string;
 
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  bank_account_id?: number;
+
   @IsOptional()
   @IsString({
     message: (args) =>