@hed-hog/finance 0.0.251 → 0.0.253

package/hedhog/frontend/app/accounts-payable/installments/page.tsx.ejs

@@ -1729,6 +1729,8 @@ export default function TitulosPagarPage() {
   const [search, setSearch] = useState('');
   const [statusFilter, setStatusFilter] = useState<string>('');
   const [editingTitleId, setEditingTitleId] = useState<string | null>(null);
+  const [approvingTitleId, setApprovingTitleId] = useState<string | null>(null);
+  const [reversingTitleId, setReversingTitleId] = useState<string | null>(null);
   const [cancelingTitleId, setCancelingTitleId] = useState<string | null>(null);
 
   const editingTitle = useMemo(
@@ -1792,13 +1794,97 @@ export default function TitulosPagarPage() {
 
       await refetch();
       showToastHandler?.('success', 'Título cancelado com sucesso');
-    } catch {
-      showToastHandler?.('error', 'Não foi possível cancelar o título');
+    } catch (error: any) {
+      const message = error?.response?.data?.message;
+      showToastHandler?.(
+        'error',
+        typeof message === 'string' && message.trim()
+          ? message
+          : 'Não foi possível cancelar o título'
+      );
     } finally {
       setCancelingTitleId(null);
     }
   };
 
+  const handleApproveTitle = async (titleId: string) => {
+    if (!titleId || approvingTitleId) {
+      return;
+    }
+
+    setApprovingTitleId(titleId);
+    try {
+      await request({
+        url: `/finance/accounts-payable/installments/${titleId}/approve`,
+        method: 'PATCH',
+      });
+
+      await refetch();
+      showToastHandler?.('success', 'Título aprovado com sucesso');
+    } catch (error: any) {
+      const message = error?.response?.data?.message;
+      showToastHandler?.(
+        'error',
+        typeof message === 'string' && message.trim()
+          ? message
+          : 'Não foi possível aprovar o título'
+      );
+    } finally {
+      setApprovingTitleId(null);
+    }
+  };
+
+  const handleSettleTitle = (titleId: string) => {
+    router.push(
+      `/finance/accounts-payable/installments/${titleId}?action=settle`
+    );
+  };
+
+  const handleReverseTitle = async (title: any) => {
+    const titleId = title?.id;
+
+    if (!titleId || reversingTitleId) {
+      return;
+    }
+
+    const settlementToReverse = (title?.parcelas || [])
+      .flatMap((parcela: any) => parcela?.liquidacoes || [])
+      .find((liquidacao: any) => {
+        return (
+          !!liquidacao?.settlementId &&
+          liquidacao?.status !== 'reversed' &&
+          liquidacao?.status !== 'estornado'
+        );
+      });
+
+    if (!settlementToReverse?.settlementId) {
+      showToastHandler?.('error', 'Nenhuma liquidação ativa para estornar');
+      return;
+    }
+
+    setReversingTitleId(titleId);
+    try {
+      await request({
+        url: `/finance/accounts-payable/installments/${titleId}/settlements/${settlementToReverse.settlementId}/reverse`,
+        method: 'PATCH',
+        data: {},
+      });
+
+      await refetch();
+      showToastHandler?.('success', 'Estorno realizado com sucesso');
+    } catch (error: any) {
+      const message = error?.response?.data?.message;
+      showToastHandler?.(
+        'error',
+        typeof message === 'string' && message.trim()
+          ? message
+          : 'Não foi possível estornar a liquidação'
+      );
+    } finally {
+      setReversingTitleId(null);
+    }
+  };
+
   const filteredTitulos = titulosPagar.filter((titulo) => {
     const matchesSearch =
       titulo.documento.toLowerCase().includes(search.toLowerCase()) ||
@@ -1985,23 +2071,32 @@ export default function TitulosPagarPage() {
                         </DropdownMenuItem>
                         <DropdownMenuSeparator />
                         <DropdownMenuItem
-                          disabled={titulo.status !== 'rascunho'}
+                          disabled={
+                            titulo.status !== 'rascunho' ||
+                            approvingTitleId === titulo.id
+                          }
+                          onClick={() => void handleApproveTitle(titulo.id)}
                         >
                           <CheckCircle className="mr-2 h-4 w-4" />
                           {t('table.actions.approve')}
                         </DropdownMenuItem>
                         <DropdownMenuItem
                           disabled={
-                            !['aberto', 'parcial'].includes(titulo.status)
+                            !['aberto', 'parcial', 'vencido'].includes(
+                              titulo.status
+                            )
                           }
+                          onClick={() => handleSettleTitle(titulo.id)}
                         >
                           <Download className="mr-2 h-4 w-4" />
                           {t('table.actions.settle')}
                         </DropdownMenuItem>
                         <DropdownMenuItem
                           disabled={
-                            !['parcial', 'liquidado'].includes(titulo.status)
+                            !['parcial', 'liquidado'].includes(titulo.status) ||
+                            reversingTitleId === titulo.id
                           }
+                          onClick={() => void handleReverseTitle(titulo)}
                         >
                           <Undo className="mr-2 h-4 w-4" />
                           {t('table.actions.reverse')}

package/hedhog/frontend/app/accounts-receivable/installments/[id]/page.tsx.ejs

@@ -22,14 +22,6 @@ import {
   CardHeader,
   CardTitle,
 } from '@/components/ui/card';
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogFooter,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog';
 import {
   DropdownMenu,
   DropdownMenuContent,
@@ -54,6 +46,13 @@ import {
   SelectTrigger,
   SelectValue,
 } from '@/components/ui/select';
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+} from '@/components/ui/sheet';
 import { StatusBadge } from '@/components/ui/status-badge';
 import {
   Table,
@@ -522,21 +521,21 @@ export default function TituloReceberDetalhePage() {
               </DropdownMenuContent>
             </DropdownMenu>
 
-            <Dialog
+            <Sheet
               open={isSettleDialogOpen}
               onOpenChange={setIsSettleDialogOpen}
             >
-              <DialogContent>
-                <DialogHeader>
-                  <DialogTitle>Registrar recebimento</DialogTitle>
-                  <DialogDescription>
+              <SheetContent className="w-full sm:max-w-lg overflow-y-auto">
+                <SheetHeader>
+                  <SheetTitle>Registrar recebimento</SheetTitle>
+                  <SheetDescription>
                     Informe a parcela e o valor para baixa parcial ou total.
-                  </DialogDescription>
-                </DialogHeader>
+                  </SheetDescription>
+                </SheetHeader>
 
                 <Form {...settleForm}>
                   <form
-                    className="space-y-4"
+                    className="space-y-4 px-1"
                     onSubmit={settleForm.handleSubmit(handleSettle)}
                   >
                     <FormField
@@ -618,7 +617,7 @@ export default function TituloReceberDetalhePage() {
                       )}
                     />
 
-                    <DialogFooter>
+                    <div className="flex justify-end gap-2 pt-2">
                       <Button
                         type="button"
                         variant="outline"
@@ -630,11 +629,11 @@ export default function TituloReceberDetalhePage() {
                       <Button type="submit" disabled={isSettling}>
                         Confirmar recebimento
                       </Button>
-                    </DialogFooter>
+                    </div>
                   </form>
                 </Form>
-              </DialogContent>
-            </Dialog>
+              </SheetContent>
+            </Sheet>
           </div>
         }
       />

package/hedhog/frontend/app/page.tsx.ejs

@@ -221,8 +221,12 @@ function Alertas({
     (e) => e.statusConciliacao === 'pendente'
   ).length;
 
-  const periodoBase = periodoAberto?.inicio ? new Date(periodoAberto.inicio) : new Date();
-  const mes = new Intl.DateTimeFormat(locale, { month: 'long' }).format(periodoBase);
+  const periodoBase = periodoAberto?.inicio
+    ? new Date(periodoAberto.inicio)
+    : new Date();
+  const mes = new Intl.DateTimeFormat(locale, { month: 'long' }).format(
+    periodoBase
+  );
   const periodoAtual = `${mes.charAt(0).toUpperCase()}${mes.slice(1)}/${periodoBase.getFullYear()}`;
 
   return (
@@ -281,6 +285,9 @@ export default function DashboardPage() {
   } = data;
 
   const getPessoaById = (id?: string) => pessoas.find((p) => p.id === id);
+  const titulosPagarAprovados = titulosPagar.filter(
+    (titulo) => titulo.status !== 'rascunho' && titulo.status !== 'cancelado'
+  );
 
   return (
     <Page>
@@ -335,7 +342,7 @@ export default function DashboardPage() {
           </CardContent>
         </Card>
         <Alertas
-          titulosPagar={titulosPagar}
+          titulosPagar={titulosPagarAprovados}
           extratos={extratos}
           periodoAberto={periodoAberto}
           locale={locale}
@@ -344,7 +351,7 @@ export default function DashboardPage() {
       </div>
 
       <ProximosVencimentos
-        titulosPagar={titulosPagar}
+        titulosPagar={titulosPagarAprovados}
         titulosReceber={titulosReceber}
         getPessoaById={getPessoaById}
         t={t}

package/hedhog/frontend/messages/en.json

@@ -198,6 +198,44 @@
       "reverse": "Reverse",
       "cancel": "Cancel"
     },
+    "validation": {
+      "installmentRequired": "Installment is required",
+      "amountGreaterThanZero": "Amount must be greater than zero"
+    },
+    "dialogs": {
+      "cancel": {
+        "title": "Confirm cancellation",
+        "description": "This action changes the title status to canceled and does not remove audit records.",
+        "cancel": "Cancel",
+        "confirm": "Confirm cancellation"
+      },
+      "reverse": {
+        "title": "Confirm reversal",
+        "description": "This action reverses the selected settlement, recalculates installment balances, and updates the title status.",
+        "cancel": "Cancel",
+        "confirm": "Confirm reversal"
+      }
+    },
+    "settleSheet": {
+      "title": "Register settlement",
+      "description": "Provide the installment and settlement amount. The backend validates status and amount limits automatically.",
+      "installmentLabel": "Installment",
+      "installmentPlaceholder": "Select",
+      "installmentOption": "Installment {number} - open amount: {amount}",
+      "amountLabel": "Amount",
+      "descriptionLabel": "Description (optional)",
+      "confirm": "Confirm settlement"
+    },
+    "messages": {
+      "approveSuccess": "Title approved successfully",
+      "approveError": "Could not approve the title",
+      "settleSuccess": "Settlement registered successfully",
+      "settleError": "Could not register settlement",
+      "reverseSuccess": "Reversal completed successfully",
+      "reverseError": "Could not reverse the settlement",
+      "cancelSuccess": "Title canceled successfully",
+      "cancelError": "Could not cancel the title"
+    },
     "documentData": {
       "title": "Document Data",
       "supplier": "Supplier",
@@ -254,6 +292,12 @@
       "fine": "Fine",
       "account": "Account",
       "method": "Method",
+      "actions": "Actions",
+      "reverseButton": "Reverse",
+      "reverseDialogTitle": "Confirm reversal",
+      "reverseDialogDescription": "This action creates a reversal for the settlement and recalculates balances and status.",
+      "reverseDialogCancel": "Cancel",
+      "reverseDialogConfirm": "Confirm reversal",
       "none": "No settlement recorded"
     },
     "audit": { "none": "No audit event" }

package/hedhog/frontend/messages/pt.json

@@ -198,6 +198,44 @@
       "reverse": "Estornar",
       "cancel": "Cancelar"
     },
+    "validation": {
+      "installmentRequired": "Parcela obrigatória",
+      "amountGreaterThanZero": "Valor deve ser maior que zero"
+    },
+    "dialogs": {
+      "cancel": {
+        "title": "Confirmar cancelamento",
+        "description": "Essa ação altera o título para cancelado e não remove os registros de auditoria.",
+        "cancel": "Cancelar",
+        "confirm": "Confirmar cancelamento"
+      },
+      "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.",
+        "cancel": "Cancelar",
+        "confirm": "Confirmar estorno"
+      }
+    },
+    "settleSheet": {
+      "title": "Registrar baixa",
+      "description": "Informe a parcela e o valor da baixa. O backend valida os estados e limites de valor automaticamente.",
+      "installmentLabel": "Parcela",
+      "installmentPlaceholder": "Selecione",
+      "installmentOption": "Parcela {number} - em aberto: {amount}",
+      "amountLabel": "Valor",
+      "descriptionLabel": "Descrição (opcional)",
+      "confirm": "Confirmar baixa"
+    },
+    "messages": {
+      "approveSuccess": "Título aprovado com sucesso",
+      "approveError": "Não foi possível aprovar o título",
+      "settleSuccess": "Baixa registrada com sucesso",
+      "settleError": "Não foi possível registrar a baixa",
+      "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"
+    },
     "documentData": {
       "title": "Dados do Documento",
       "supplier": "Fornecedor",
@@ -254,6 +292,12 @@
       "fine": "Multa",
       "account": "Conta",
       "method": "Método",
+      "actions": "Ações",
+      "reverseButton": "Estornar",
+      "reverseDialogTitle": "Confirmar estorno",
+      "reverseDialogDescription": "Esta ação cria o estorno da liquidação e recalcula saldos e status.",
+      "reverseDialogCancel": "Cancelar",
+      "reverseDialogConfirm": "Confirmar estorno",
       "none": "Nenhuma liquidação registrada"
     },
     "audit": { "none": "Nenhum evento de auditoria" }

package/hedhog/query/constraints.sql

@@ -102,7 +102,9 @@ BEGIN
 	SELECT COALESCE(SUM(sa.allocated_amount_cents), 0)
 	INTO allocated_total_cents
 	FROM settlement_allocation sa
-	WHERE sa.installment_id = target_installment_id;
+	INNER JOIN settlement s ON s.id = sa.settlement_id
+	WHERE sa.installment_id = target_installment_id
+	AND s.status <> 'reversed';
 
 	IF allocated_total_cents > installment_amount_cents THEN
 		RAISE EXCEPTION

package/hedhog/query/settlement-auditability.sql

@@ -0,0 +1,175 @@
+-- Settlement auditability, reversal linkage and reconciliation helpers
+-- Idempotent script for PostgreSQL
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+    FROM pg_type
+    WHERE typname = 'settlement_entry_type_enum'
+  ) THEN
+    CREATE TYPE settlement_entry_type_enum AS ENUM ('normal', 'reversal');
+  END IF;
+END $$;
+
+ALTER TABLE settlement
+  ADD COLUMN IF NOT EXISTS entry_type settlement_entry_type_enum;
+
+UPDATE settlement
+SET entry_type = 'normal'
+WHERE entry_type IS NULL;
+
+ALTER TABLE settlement
+  ALTER COLUMN entry_type SET DEFAULT 'normal';
+
+ALTER TABLE settlement
+  ALTER COLUMN entry_type SET NOT NULL;
+
+ALTER TABLE settlement
+  ADD COLUMN IF NOT EXISTS reverses_settlement_id INTEGER;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+    FROM pg_constraint
+    WHERE conname = 'fk_settlement_reverses_settlement'
+  ) THEN
+    ALTER TABLE settlement
+      ADD CONSTRAINT fk_settlement_reverses_settlement
+      FOREIGN KEY (reverses_settlement_id)
+      REFERENCES settlement(id)
+      ON DELETE RESTRICT
+      ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+CREATE UNIQUE INDEX IF NOT EXISTS uq_settlement_reverses_settlement_id
+  ON settlement(reverses_settlement_id)
+  WHERE reverses_settlement_id IS NOT NULL;
+
+DO $$
+BEGIN
+  BEGIN
+    ALTER TABLE settlement
+      ALTER COLUMN amount_cents TYPE BIGINT USING amount_cents::BIGINT;
+  EXCEPTION
+    WHEN undefined_column THEN
+      NULL;
+  END;
+END $$;
+
+ALTER TABLE settlement_allocation
+  ADD COLUMN IF NOT EXISTS amount_cents BIGINT;
+
+UPDATE settlement_allocation
+SET amount_cents = allocated_amount_cents
+WHERE amount_cents IS NULL;
+
+ALTER TABLE settlement_allocation
+  ALTER COLUMN amount_cents SET NOT NULL;
+
+DO $$
+BEGIN
+  BEGIN
+    ALTER TABLE settlement_allocation
+      ALTER COLUMN allocated_amount_cents TYPE BIGINT USING allocated_amount_cents::BIGINT;
+  EXCEPTION
+    WHEN undefined_column THEN
+      NULL;
+  END;
+END $$;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+    FROM pg_constraint
+    WHERE conname = 'chk_settlement_allocation_amount_non_zero'
+  ) THEN
+    ALTER TABLE settlement_allocation
+      ADD CONSTRAINT chk_settlement_allocation_amount_non_zero
+      CHECK (amount_cents <> 0);
+  END IF;
+END $$;
+
+ALTER TABLE bank_reconciliation
+  ADD COLUMN IF NOT EXISTS reconciled_at TIMESTAMPTZ(6);
+
+ALTER TABLE bank_reconciliation
+  ADD COLUMN IF NOT EXISTS reconciled_by_user_id INTEGER;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1
+    FROM pg_constraint
+    WHERE conname = 'fk_bank_reconciliation_reconciled_by_user'
+  ) THEN
+    ALTER TABLE bank_reconciliation
+      ADD CONSTRAINT fk_bank_reconciliation_reconciled_by_user
+      FOREIGN KEY (reconciled_by_user_id)
+      REFERENCES "user"(id)
+      ON DELETE SET NULL
+      ON UPDATE CASCADE;
+  END IF;
+END $$;
+
+CREATE INDEX IF NOT EXISTS idx_settlement_settled_at
+  ON settlement(settled_at);
+
+CREATE INDEX IF NOT EXISTS idx_settlement_entry_type
+  ON settlement(entry_type);
+
+CREATE OR REPLACE FUNCTION fn_prevent_settlement_updates()
+RETURNS TRIGGER
+LANGUAGE plpgsql
+AS $$
+BEGIN
+  RAISE EXCEPTION 'Settlement is immutable. Create a reversal instead of updating settlement %', NEW.id;
+END;
+$$;
+
+DROP TRIGGER IF EXISTS trg_prevent_settlement_updates ON settlement;
+
+CREATE TRIGGER trg_prevent_settlement_updates
+BEFORE UPDATE ON settlement
+FOR EACH ROW
+EXECUTE FUNCTION fn_prevent_settlement_updates();
+
+CREATE OR REPLACE VIEW v_settlement_history AS
+SELECT
+  fi.title_id,
+  s.id AS settlement_id,
+  s.entry_type,
+  s.reverses_settlement_id,
+  CASE
+    WHEN s.entry_type = 'reversal' THEN s.reverses_settlement_id
+    ELSE s.id
+  END AS settlement_group_id,
+  s.settlement_type,
+  s.status,
+  s.settled_at,
+  s.amount_cents,
+  s.payment_method_id,
+  s.bank_account_id,
+  s.description,
+  s.external_reference,
+  s.created_by_user_id,
+  s.created_at,
+  s.updated_at,
+  sa.installment_id,
+  fi.installment_number,
+  sa.amount_cents AS allocation_amount_cents,
+  sa.discount_cents,
+  sa.interest_cents,
+  sa.penalty_cents,
+  br.id AS bank_reconciliation_id,
+  CASE
+    WHEN br.id IS NOT NULL THEN TRUE
+    ELSE FALSE
+  END AS reconciled
+FROM settlement s
+INNER JOIN settlement_allocation sa ON sa.settlement_id = s.id
+INNER JOIN financial_installment fi ON fi.id = sa.installment_id
+LEFT JOIN bank_reconciliation br ON br.settlement_id = s.id;

package/hedhog/table/bank_reconciliation.yaml

@@ -20,6 +20,9 @@ columns:
   - name: matched_at
     type: datetime
     isNullable: true
+  - name: reconciled_at
+    type: datetime
+    isNullable: true
   - name: matched_by_user_id
     type: fk
     isNullable: true
@@ -28,6 +31,14 @@ columns:
       column: id
       onDelete: SET NULL
       onUpdate: CASCADE
+  - name: reconciled_by_user_id
+    type: fk
+    isNullable: true
+    references:
+      table: user
+      column: id
+      onDelete: SET NULL
+      onUpdate: CASCADE
   - type: created_at
   - type: updated_at
 

package/hedhog/table/settlement.yaml

@@ -27,6 +27,10 @@ columns:
   - name: settlement_type
     type: enum
     values: [payable, receivable, transfer, adjustment]
+  - name: entry_type
+    type: enum
+    values: [normal, reversal]
+    default: normal
   - name: status
     type: enum
     values: [pending, confirmed, reversed]
@@ -41,6 +45,14 @@ columns:
     type: varchar
     length: 120
     isNullable: true
+  - name: reverses_settlement_id
+    type: fk
+    isNullable: true
+    references:
+      table: settlement
+      column: id
+      onDelete: RESTRICT
+      onUpdate: CASCADE
   - name: created_by_user_id
     type: fk
     isNullable: true
@@ -55,4 +67,8 @@ columns:
 indices:
   - columns: [status]
   - columns: [settled_at]
-  - columns: [bank_account_id]
+  - columns: [bank_account_id]
+  - columns: [entry_type]
+  - columns: [settlement_type, settled_at]
+  - columns: [reverses_settlement_id]
+    isUnique: true

package/hedhog/table/settlement_allocation.yaml

@@ -16,6 +16,9 @@ columns:
       onUpdate: CASCADE
   - name: allocated_amount_cents
     type: int
+  - name: amount_cents
+    type: int
+    isNullable: true
   - name: discount_cents
     type: int
     default: 0

package/package.json

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

package/src/dto/reverse-settlement.dto.ts

@@ -4,4 +4,8 @@ export class ReverseSettlementDto {
   @IsOptional()
   @IsString()
   reason?: string;
+
+  @IsOptional()
+  @IsString()
+  memo?: string;
 }