@fayz-ai/plugin-financial 0.14.1 → 0.14.2

package/dist/index.js

@@ -1,8 +1,8 @@
-import * as React14 from 'react';
-import React14__default, { useState, useEffect, useMemo, useCallback, useRef } from 'react';
-import { createConnectionStore, connectionSettings, connectionStatus, settingsStatus, connectionRuns, registerTranslations, createSafeDataProvider, registerMessageDefaults, useTranslation, countByTenant, getSupabaseClientOptional, getActiveTenantId, exportCSV } from '@fayz-ai/core';
-import { toast, CurrencyInput, DatePicker, Button, defineKpiWidget, defineChartWidget, defineCustomWidget, defineTableWidget, Modal, ModalContent, ModalHeader, ModalTitle, ModalDescription, ModalBody, DataTable, PageTransition, ModulePage, SubpageHeader, Skeleton, Badge, TooltipProvider, ConfirmDialog, MultiSelect, Tooltip, TooltipTrigger, TooltipContent, Input, Checkbox, ModalFooter, DashboardCanvas, PageHeaderActions, Card, FilterChip, useSaveBar, SearchSelect, ListView, KpiCard, ChartWidget, CardHeader, CardTitle, CardContent, TableWidget, useDashboardNavigate, GoldCard } from '@fayz-ai/ui';
-import { createPluginContext, fayzConnectorOAuth, formatCurrency, RightRailPage, PluginSettingsPanel, dedup, useModuleNavigation, usePermissionOptional, useModuleNavAccess, ModuleActionBar, useTenantPluginSettings, SettingsGroup, ToggleRow, TeachMeLink, parseViewId, EntitlementGate, UpgradePrompt, GetStarted, useAuth, PermissionGate, PersonLink, useLimitGuard, useLookupCreate, OrderFormSkeleton, OrderFormBlock, OrderFormView, OrderFormItemsCard, OrderFormItemRow, OrderFormAddItemStep, OrderDetailSkeleton, PageActions, OrderDetailBlock, OrderDetailView, invalidateLimit, askAI, requestChatUpload, toInlineFile, useChatStore, useAgentSurface, revealPage } from '@fayz-ai/admin';
+import * as React15 from 'react';
+import React15__default, { useState, useEffect, useMemo, useCallback, useRef } from 'react';
+import { createConnectionStore, connectionSettings, connectionStatus, settingsStatus, connectionRuns, registerTranslations, createSafeDataProvider, registerMessageDefaults, useTranslation, createPendingCommand, countByTenant, getSupabaseClientOptional, getActiveTenantId, exportCSV, useDataChanged } from '@fayz-ai/core';
+import { toast, CurrencyInput, DatePicker, Button, defineKpiWidget, defineChartWidget, defineCustomWidget, defineTableWidget, Modal, ModalContent, ModalHeader, ModalTitle, ModalDescription, ModalBody, DataTable, PageTransition, ModulePage, SubpageHeader, Skeleton, Badge, TooltipProvider, ConfirmDialog, MultiSelect, Tooltip, TooltipTrigger, TooltipContent, Input, Checkbox, ModalFooter, DashboardCanvas, PageHeaderActions, Card, FilterChip, useSaveBar, tourAnchor, SearchSelect, ListView, KpiCard, ChartWidget, CardHeader, CardTitle, CardContent, TableWidget, useDashboardNavigate, GoldCard } from '@fayz-ai/ui';
+import { createPluginContext, fayzConnectorOAuth, formatCurrency, RightRailPage, PluginSettingsPanel, dedup, useModuleNavigation, usePermissionOptional, useModuleNavAccess, ModuleActionBar, useTenantPluginSettings, SettingsGroup, ToggleRow, TeachMeLink, useAgentSurface, parseViewId, EntitlementGate, UpgradePrompt, createArchetypeLookup, useChatStore, adminNavigateTo, revealPage, GetStarted, useAuth, resolveEntityRoute, PermissionGate, PersonLink, useLimitGuard, useLookupCreate, OrderFormSkeleton, OrderFormBlock, OrderFormView, OrderFormItemsCard, OrderFormItemRow, OrderFormAddItemStep, OrderDetailSkeleton, PageActions, OrderDetailBlock, OrderDetailView, invalidateLimit, askAI, requestChatUpload, toInlineFile } from '@fayz-ai/admin';
 import { CircleDollarSign, FileText, X, FileCheck, ArrowRightLeft, CreditCard, QrCode, Banknote, Pencil, Check, Wallet, Plus, AlertTriangle, Filter, TrendingUp, Copy, DollarSign, Trash2, Landmark, ChevronDown, Clock, BookOpen, ChevronRight, Info, Calculator, StickyNote, Play, Square, ChevronUp, ClipboardCheck, FileCheck2, ExternalLink, FileX2, RefreshCw, Send, Ban, CalendarClock, Gift, Loader2, BadgeCheck, Target, Settings, ArrowRight, Receipt, Users, ArrowDownCircle, ArrowUpCircle, Sparkles, Link2, Search, Download, Paperclip, CheckCheck, MoreVertical, CircleCheckBig, CircleDashed, Camera, CircleAlert, CircleEllipsis, CalendarDays, LayoutList, Layers, Undo2, Building2, ShoppingCart, Car, Home, Utensils, Zap, Film, HeartPulse, Dumbbell, Music, ShoppingBag, ArrowUpRight, ArrowDownRight, EyeOff, Eye } from 'lucide-react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
@@ -162,6 +162,48 @@ function MobileSummary() {
   ] });
 }
 
+// src/data/tables.ts
+var T = {
+  movements: "plg_financial_movements",
+  cashMovements: "v_financial_cash_movements",
+  accountBalances: "v_financial_account_balances",
+  chartOfAccounts: "plg_financial_chart_of_accounts",
+  bankAccounts: "plg_financial_bank_accounts",
+  cardBrands: "plg_financial_card_brands",
+  costCenters: "plg_financial_cost_centers",
+  cashRegisterSessions: "plg_financial_cash_register_sessions",
+  paymentMethods: "plg_financial_payment_methods",
+  paymentMethodTypes: "plg_financial_payment_method_types",
+  notas: "plg_financial_nfe",
+  // A contabilidade da LINHA. public.items é a linha; o que só o financeiro
+  // sabe dela — plano de contas, centro de custo, imposto, CFOP — mora aqui,
+  // com item_id de chave. Ver 038_the_invoice_gets_a_line.sql.
+  invoiceItems: "plg_financial_invoice_items",
+  // A regra de comissão. O registry apontava para `commission_rules`, sem
+  // prefixo — nome que a 028 aposentou e que não existe em pool nenhum.
+  commissionRules: "plg_financial_commission_rules",
+  commissionRuleCriteria: "plg_financial_commission_rule_criteria",
+  commissionFunctions: "plg_financial_commission_functions",
+  // The legacy `movement_kind='bill'` SHAPE, derived from the instalment
+  // balances (financial 040). Reading it instead of the mirror is what let the
+  // mirror stop being written: the columns are the same, the source is one.
+  // The instalment IS the obligation; the `movement_kind='bill'` shape and
+  // its compat view left in financial 044.
+  bills: "v_financial_installment_balances",
+  /** A fatura com o que já foi pago somado — de onde toda lista de contas lê. */
+  invoiceBalances: "v_financial_invoice_balances",
+  commissions: "v_financial_commissions",
+  commissionGenerations: "plg_financial_commission_generations",
+  periods: "plg_financial_periods",
+  trialBalance: "v_financial_trial_balance",
+  aging: "v_financial_aging",
+  agingSummary: "v_financial_aging_summary",
+  lineMargin: "v_financial_line_margin",
+  marginByMonth: "v_financial_margin_by_month",
+  recurringBills: "plg_financial_recurring_bills",
+  discountsGiven: "v_financial_discounts_given"
+};
+
 // src/lib/accounts.ts
 function postableAccounts(accounts) {
   const parentIds = new Set(accounts.map((a) => a.parentId).filter(Boolean));
@@ -234,8 +276,8 @@ var SCALES = {
   bilhao: 1e9,
   bilhoes: 1e9
 };
-function normalize(text) {
-  return text.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z\s]/g, " ").split(/\s+/).filter(Boolean);
+function normalize(text2) {
+  return text2.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z\s]/g, " ").split(/\s+/).filter(Boolean);
 }
 function sumGroup(words) {
   let total = 0;
@@ -280,6 +322,111 @@ function lastCurrencyIndex(words, before) {
   }
   return before;
 }
+
+// src/views/payable-lines.ts
+function round2(n) {
+  return Math.round(n * 100) / 100;
+}
+function parseLineItems(raw) {
+  if (raw === void 0 || raw === null) return { items: [] };
+  if (!Array.isArray(raw)) return { items: [], error: "`items` must be an array of table rows." };
+  const items = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object") continue;
+    const row = entry;
+    const description = typeof row.description === "string" ? row.description.trim() : "";
+    const unitPrice = parseReceiptAmount(row.unitPrice);
+    if (!description || unitPrice === null) {
+      return {
+        items: [],
+        error: 'Every row needs a `description` and a readable `unitPrice` copied from the paper ("47,90"). Re-read the table and resend all rows.'
+      };
+    }
+    const quantityRaw = typeof row.quantity === "number" ? row.quantity : Number(row.quantity);
+    const quantity = Number.isFinite(quantityRaw) && quantityRaw > 0 ? quantityRaw : 1;
+    items.push({ description, quantity, unitPrice });
+  }
+  return { items };
+}
+function text(value) {
+  const s = typeof value === "string" ? value.trim() : "";
+  return s || void 0;
+}
+function today() {
+  const now2 = /* @__PURE__ */ new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${now2.getFullYear()}-${pad(now2.getMonth() + 1)}-${pad(now2.getDate())}`;
+}
+
+// src/views/document-memory.ts
+var lastDocument = null;
+var DOCUMENT_TTL_MS = 15 * 60 * 1e3;
+var STORAGE_KEY = "fayz:financial:last-document-read";
+function readStored() {
+  try {
+    const raw = globalThis.sessionStorage?.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed.at === "number" && parsed.doc ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function writeStored(entry) {
+  try {
+    if (entry) globalThis.sessionStorage?.setItem(STORAGE_KEY, JSON.stringify(entry));
+    else globalThis.sessionStorage?.removeItem(STORAGE_KEY);
+  } catch {
+  }
+}
+function rememberedDocument() {
+  const entry = lastDocument ?? readStored();
+  if (!entry) return null;
+  if (Date.now() - entry.at > DOCUMENT_TTL_MS) {
+    clearRememberedDocument();
+    return null;
+  }
+  lastDocument = entry;
+  return entry.doc;
+}
+function clearRememberedDocument() {
+  lastDocument = null;
+  writeStored(null);
+}
+function normalizeDocument(args) {
+  const parsed = parseLineItems(args.items);
+  const items = parsed.error ? [] : parsed.items;
+  const shipping = parseReceiptAmount(args.shipping) ?? void 0;
+  const subtotal = parseReceiptAmount(args.subtotal) ?? void 0;
+  const total = parseReceiptAmount(args.total) ?? void 0;
+  const lineSum = items.length ? round2(items.reduce((s, i) => s + i.quantity * i.unitPrice, 0)) : void 0;
+  const computed = lineSum === void 0 ? void 0 : round2(lineSum + (shipping ?? 0));
+  const reconciles = computed === void 0 || total === void 0 ? false : Math.abs(computed - total) <= 0.02;
+  return {
+    items,
+    ...subtotal === void 0 ? {} : { subtotal },
+    ...shipping === void 0 ? {} : { shipping },
+    ...total === void 0 ? {} : { total },
+    ...lineSum === void 0 ? {} : { lineSum },
+    reconciles,
+    ...parseReceiptDate(args.documentDate) ? { documentDate: parseReceiptDate(args.documentDate) } : {},
+    // `null` é uma RESPOSTA: "o papel não diz". Diferente de "ainda não li".
+    dueDate: parseReceiptDate(args.dueDate) ?? null,
+    ...parseReceiptDate(args.paymentDate) ? { paymentDate: parseReceiptDate(args.paymentDate) } : {},
+    ...text(args.orderRef) ? { orderRef: text(args.orderRef) } : {},
+    ...parseReceiptDate(args.deliveryDate) ? { deliveryDate: parseReceiptDate(args.deliveryDate) } : {},
+    ...text(args.paymentMethod) ? { method: text(args.paymentMethod) } : {}
+  };
+}
+function rememberDocument(doc, meta) {
+  lastDocument = {
+    at: Date.now(),
+    doc,
+    ...meta?.source ? { source: meta.source } : {},
+    ...meta?.conversationId ? { conversationId: meta.conversationId } : {}
+  };
+  writeStored(lastDocument);
+}
 var RECEIPT_INTRO = {
   role: "finance",
   persona: "Leitor de recibos",
@@ -356,35 +503,35 @@ var OPEN_DRAFT = {
 function parseReceiptAmount(raw) {
   if (typeof raw === "number") return Number.isFinite(raw) && raw > 0 ? raw : null;
   if (typeof raw !== "string") return null;
-  const text = raw.replace(/[^\d.,-]/g, "").trim();
-  if (!text || !/\d/.test(text)) return null;
-  const lastComma = text.lastIndexOf(",");
-  const lastDot = text.lastIndexOf(".");
+  const text2 = raw.replace(/[^\d.,-]/g, "").trim();
+  if (!text2 || !/\d/.test(text2)) return null;
+  const lastComma = text2.lastIndexOf(",");
+  const lastDot = text2.lastIndexOf(".");
   const cut = Math.max(lastComma, lastDot);
   let normalized;
   if (cut < 0) {
-    normalized = text;
+    normalized = text2;
   } else {
-    const decimals = text.length - cut - 1;
-    normalized = decimals === 3 ? text.replace(/[.,]/g, "") : `${text.slice(0, cut).replace(/[.,]/g, "")}.${text.slice(cut + 1)}`;
+    const decimals = text2.length - cut - 1;
+    normalized = decimals === 3 ? text2.replace(/[.,]/g, "") : `${text2.slice(0, cut).replace(/[.,]/g, "")}.${text2.slice(cut + 1)}`;
   }
   const value = Number(normalized);
   return Number.isFinite(value) && value > 0 ? value : null;
 }
 function parseReceiptDate(raw) {
-  const text = typeof raw === "string" ? raw.trim() : "";
-  if (!text) return void 0;
-  if (/^\d{4}-\d{2}-\d{2}$/.test(text)) return isRealDate(text) ? text : void 0;
-  const br = text.match(/^(\d{1,2})[/.-](\d{1,2})[/.-](\d{2}|\d{4})$/);
+  const text2 = typeof raw === "string" ? raw.trim() : "";
+  if (!text2) return void 0;
+  if (/^\d{4}-\d{2}-\d{2}$/.test(text2)) return isRealDate(text2) ? text2 : void 0;
+  const br = text2.match(/^(\d{1,2})[/.-](\d{1,2})[/.-](\d{2}|\d{4})$/);
   if (!br) return void 0;
   const [, d, m, y] = br;
   const year = y.length === 2 ? `20${y}` : y;
   const iso = `${year}-${m.padStart(2, "0")}-${d.padStart(2, "0")}`;
   return isRealDate(iso) ? iso : void 0;
 }
-function findDateIn(text) {
-  if (typeof text !== "string") return void 0;
-  return text.match(/\b\d{1,2}[/.-]\d{1,2}[/.-](?:\d{4}|\d{2})\b/)?.[0];
+function findDateIn(text2) {
+  if (typeof text2 !== "string") return void 0;
+  return text2.match(/\b\d{1,2}[/.-]\d{1,2}[/.-](?:\d{4}|\d{2})\b/)?.[0];
 }
 function isRealDate(iso) {
   const [y, m, d] = iso.split("-").map(Number);
@@ -409,6 +556,33 @@ function createReceiptTools({ onDraft, getReceiptUrl = lastReceiptPhoto }) {
     {
       tool: OPEN_DRAFT,
       execute: async (args) => {
+        const read = rememberedDocument();
+        if (read && read.total !== void 0) {
+          pending = {
+            amount: read.total,
+            ...read.items.length ? { items: read.items } : {},
+            ...read.shipping === void 0 ? {} : { shipping: read.shipping },
+            supplier: text(args.supplier) ?? void 0,
+            description: text(args.description) ?? void 0,
+            notes: [
+              text(args.notes),
+              read.orderRef ? `Pedido: ${read.orderRef}` : null,
+              read.deliveryDate ? `Entrega: ${read.deliveryDate}` : null
+            ].filter(Boolean).join(" \xB7 ") || void 0,
+            date: read.documentDate ?? parseReceiptDate(args.date),
+            receiptUrl: getReceiptUrl()
+          };
+          onDraft();
+          revealPage();
+          return {
+            ok: true,
+            opened: true,
+            fromDocument: true,
+            items: read.items.length,
+            total: read.total,
+            message: `O cadastro abriu com o que foi LIDO do documento \u2014 ${read.items.length || 1} linha(s), total ${read.total}. Diga isso em UMA frase e pare. N\xE3o repita os valores campo a campo e N\xC3O os recalcule: a pessoa est\xE1 olhando para eles.`
+          };
+        }
         if (typeof args.amount !== "string") {
           return {
             ok: false,
@@ -426,16 +600,16 @@ function createReceiptTools({ onDraft, getReceiptUrl = lastReceiptPhoto }) {
             message: "That is not a readable amount. If the total is illegible on the photo, ask the person."
           };
         }
-        const text = (value) => {
+        const text2 = (value) => {
           const s = typeof value === "string" ? value.trim() : "";
           return s || void 0;
         };
         const isoDate2 = parseReceiptDate(args.date) ?? parseReceiptDate(findDateIn(args.notes));
         pending = {
           amount,
-          supplier: text(args.supplier),
-          description: text(args.description),
-          notes: text(args.notes),
+          supplier: text2(args.supplier),
+          description: text2(args.description),
+          notes: text2(args.notes),
           date: isoDate2,
           receiptUrl: getReceiptUrl()
         };
@@ -477,9 +651,9 @@ function startReceiptCapture(labels) {
   });
 }
 function ReceiptAgentSurface({ onOpenDraft }) {
-  const live = React14.useRef(onOpenDraft);
+  const live = React15.useRef(onOpenDraft);
   live.current = onOpenDraft;
-  const contribution = React14.useMemo(() => ({
+  const contribution = React15.useMemo(() => ({
     id: "financial.payables.receipt",
     pluginId: "financial",
     role: "finance",
@@ -493,6 +667,17 @@ function ReceiptAgentSurface({ onOpenDraft }) {
   useAgentSurface(contribution);
   return null;
 }
+
+// src/lib/idempotency.ts
+function createIdempotencyKey(scope) {
+  let suffix;
+  try {
+    suffix = typeof globalThis.crypto?.randomUUID === "function" ? globalThis.crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  } catch {
+    suffix = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+  }
+  return `${scope}:${suffix}`;
+}
 var STATUS_OPTIONS = [
   { value: "open", labelKey: "financial.invoice.statusOpen", color: "bg-info-soft text-info-soft-foreground", icon: CircleDashed },
   { value: "partial", labelKey: "financial.invoice.statusPartial", color: "bg-warning-soft text-warning-soft-foreground", icon: CircleEllipsis },
@@ -644,6 +829,10 @@ function InvoiceListView({ direction, onNew, onNewReceipt, onEdit }) {
   useEffect(() => {
     fetchInvoices(query);
   }, [query]);
+  useDataChanged({ table: T.invoiceBalances }, () => {
+    void fetchInvoices(query);
+    void fetchSummary();
+  }, [query]);
   const filtered = invoices.filter((inv) => inv.direction === direction);
   const columns = useInvoiceColumns(currency);
   const tags = useMemo(
@@ -664,6 +853,13 @@ function InvoiceListView({ direction, onNew, onNewReceipt, onEdit }) {
   }, [filtered]);
   const [cancelTarget, setCancelTarget] = useState(null);
   const [bulkBusy, setBulkBusy] = useState(false);
+  const [cancelReason, setCancelReason] = useState("");
+  const cancelRequestKey = useRef(createIdempotencyKey("financial:invoice-bulk-cancel"));
+  const closeBulkCancel = useCallback(() => {
+    setCancelTarget(null);
+    setCancelReason("");
+    cancelRequestKey.current = createIdempotencyKey("financial:invoice-bulk-cancel");
+  }, []);
   const confirmBulkCancel = useCallback(async () => {
     const targets = (cancelTarget ?? []).filter((inv) => inv.status !== "cancelled");
     setBulkBusy(true);
@@ -671,7 +867,11 @@ function InvoiceListView({ direction, onNew, onNewReceipt, onEdit }) {
     let failed = 0;
     for (const invoice of targets) {
       try {
-        await provider.cancelInvoice(invoice.id);
+        await provider.cancelInvoice({
+          invoiceId: invoice.id,
+          reason: cancelReason,
+          idempotencyKey: `${cancelRequestKey.current}:${invoice.id}`
+        });
         done++;
       } catch (err) {
         failed++;
@@ -679,11 +879,11 @@ function InvoiceListView({ direction, onNew, onNewReceipt, onEdit }) {
       }
     }
     setBulkBusy(false);
-    setCancelTarget(null);
+    closeBulkCancel();
     await Promise.all([fetchInvoices(query), fetchSummary()]);
     if (done > 0) toast.success(t2("financial.invoice.bulkCancelDone", { count: String(done) }));
     if (failed > 0) toast.error(t2("financial.invoice.bulkCancelFailed", { count: String(failed) }));
-  }, [cancelTarget, provider, fetchInvoices, fetchSummary, query, t2]);
+  }, [cancelTarget, cancelReason, closeBulkCancel, provider, fetchInvoices, fetchSummary, query, t2]);
   const bulkActions = useMemo(() => {
     if (!canEdit) return void 0;
     return [{
@@ -864,21 +1064,1169 @@ function InvoiceListView({ direction, onNew, onNewReceipt, onEdit }) {
         /* @__PURE__ */ jsx("span", { className: "font-semibold text-warning", children: formatCurrency(summary.openAmount, currency) })
       ] })
     ] }),
-    /* @__PURE__ */ jsx(
-      ConfirmDialog,
+    cancelTarget !== null && createPortal(
+      /* @__PURE__ */ jsxs("div", { className: "fixed inset-0 z-[60] flex items-center justify-center", children: [
+        /* @__PURE__ */ jsx("div", { className: "absolute inset-0 bg-black/50 backdrop-blur-[2px]", onClick: closeBulkCancel }),
+        /* @__PURE__ */ jsxs("div", { className: "relative z-10 w-full max-w-sm rounded-modal border bg-card p-6 shadow-lg mx-4", role: "alertdialog", "aria-modal": "true", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-3", children: [
+            /* @__PURE__ */ jsx("div", { className: "flex h-10 w-10 items-center justify-center rounded-full bg-destructive/10 shrink-0", children: /* @__PURE__ */ jsx(Ban, { className: "h-5 w-5 text-destructive" }) }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("h3", { className: "text-sm font-semibold", children: t2("financial.invoice.bulkCancelTitle", { count: String(cancelTarget.length) }) }),
+              /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t2("financial.invoice.cancelDesc") })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx("label", { className: "block text-xs font-medium mb-1", htmlFor: "invoice-bulk-cancel-reason", children: t2("financial.invoice.cancelReason") }),
+          /* @__PURE__ */ jsx(
+            "textarea",
+            {
+              id: "invoice-bulk-cancel-reason",
+              value: cancelReason,
+              onChange: (event) => setCancelReason(event.target.value),
+              placeholder: t2("financial.invoice.cancelReasonPlaceholder"),
+              className: "mb-5 min-h-20 w-full resize-y rounded-md border bg-background px-3 py-2 text-sm",
+              autoFocus: true
+            }
+          ),
+          /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
+            /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: closeBulkCancel, disabled: bulkBusy, children: t2("financial.invoice.keepInvoice") }),
+            /* @__PURE__ */ jsx(Button, { variant: "destructive", size: "sm", onClick: () => void confirmBulkCancel(), disabled: bulkBusy || !cancelReason.trim(), children: t2("financial.invoice.yesCancel") })
+          ] })
+        ] })
+      ] }),
+      document.body
+    )
+  ] });
+}
+var PAYABLE_INSTRUCTIONS = [
+  'Uma "conta a pagar" \xE9 uma DESPESA com um FORNECEDOR \u2014 quem a empresa deve. Para registrar uma,',
+  "chame `createPayable`. NUNCA use `createRecord` em `financial:payment-methods` para isso: aquele",
+  "registro configura como os CLIENTES pagam a empresa (bandeira, taxa, parcelamento), e um",
+  "fornecedor cadastrado l\xE1 n\xE3o vira conta nenhuma \u2014 vira lixo na configura\xE7\xE3o da loja.",
+  "Se a pessoa mandar a FOTO de um recibo ou de uma nota, leia a imagem e use o que est\xE1 escrito",
+  "nela. Uma foto n\xE3o tem colunas: nunca proponha importa\xE7\xE3o para ela.",
+  "Num pedido ou nota com TABELA, leia a tabela LINHA A LINHA e mande todas em `items` \u2014 c\xF3digo,",
+  'descri\xE7\xE3o, quantidade e pre\xE7o unit\xE1rio de cada uma. Uma linha gen\xE9rica de "servi\xE7o prestado" com',
+  "o total dentro perde o pedido inteiro. O FRETE \xE9 campo pr\xF3prio (`shipping`), n\xE3o some ao produto.",
+  "`amount` \xE9 sempre o TOTAL do rodap\xE9 (com frete), nunca o subtotal e nunca o total de uma linha.",
+  'Capture tamb\xE9m "M\xE9todo de pagamento:" quando impresso, o N\xDAMERO DO PEDIDO ("Pedido: #164223") e a',
+  "data de ENTREGA \u2014 pedido e entrega v\xE3o em `notes`, que \xE9 onde a pessoa procura o que o papel dizia.",
+  'Se o texto trouxer uma linha como "[c\xF3digo Pix copia-e-cola \u2014 valor embutido: X]", aquilo \xE9 o',
+  "c\xF3digo do pagamento: X confirma o total, e os d\xEDgitos em volta N\xC3O s\xE3o pre\xE7os.",
+  '"Expira em" de um c\xF3digo Pix \xE9 a validade do C\xD3DIGO, n\xE3o o vencimento da conta. Um pedido pago \xE0',
+  "vista n\xE3o tem vencimento: deixe `dueDate` de fora e o formul\xE1rio pergunta. Data chutada custa uma",
+  "cobran\xE7a; campo vazio custa um toque.",
+  "LEU UM PAPEL? PASSO 0 \xE9 `resolvePayableContext`, ANTES de escrever qualquer coisa. Extraia TUDO o",
+  "que est\xE1 escrito \u2014 fornecedor, CNPJ, o que foi comprado, forma de pagamento, bandeira e final do",
+  "cart\xE3o, datas, valores \u2014 e mande para conferir contra o que este neg\xF3cio j\xE1 tem. Ele responde o",
+  "que existe e o que falta, sem gravar nada. Diga o resultado em uma linha curta por depend\xEAncia e",
+  "resolva as que faltam NA ORDEM que ele devolve: fornecedor, forma de pagamento, depois a conta,",
+  "depois a baixa. Se voltar um candidato parecido, PERGUNTE se \xE9 o mesmo \u2014 n\xE3o cadastre de novo.",
+  'Valor vai COPIADO como est\xE1 escrito ("50,00", "1.234,56"), nunca convertido \u2014 a v\xEDrgula \xE9',
+  "decimal em portugu\xEAs, e convert\xEA-la voc\xEA mesmo j\xE1 transformou cinquenta reais em cinco mil.",
+  "N\xE3o entreviste a pessoa campo a campo. Mande o que ela disse e chame a ferramenta: o que abre",
+  "\xE9 um FORMUL\xC1RIO edit\xE1vel, e o que faltar ela preenche ali \u2014 em um toque, olhando os campos.",
+  "Uma conta a pagar tem TR\xCAS passos, cada um confirmado pela pessoa: (1) o fornecedor, (2) o t\xEDtulo,",
+  "(3) o pagamento \u2014 e o terceiro s\xF3 existe se a conta J\xC1 foi paga. Se o recibo ou a pessoa disser",
+  'que j\xE1 pagou ("pago hoje", "paguei no Pix"), mande `paid: true`; a ferramenta cuida da ordem.',
+  "Quando faltar saber COMO foi pago, a ferramenta PERGUNTA com as op\xE7\xF5es do pr\xF3prio neg\xF3cio na tela.",
+  "N\xE3o repita as op\xE7\xF5es em texto e n\xE3o escolha por ela: espere a resposta e ent\xE3o chame",
+  "`registerPayablePayment` com o id que ela tocou.",
+  "REGRA DE PRECED\xCANCIA: se o cadastro de conta a pagar estiver ABERTO na tela com um rascunho (veja",
+  '"Tela aberta agora"), ele \xE9 a conta em curso. Complete-o com `fillPayableDraft` e salve com',
+  "`submitPayableDraft`. `createPayable` \xE9 s\xF3 para quando N\xC3O h\xE1 rascunho aberto \u2014 cham\xE1-la com o",
+  "formul\xE1rio na tela cria uma segunda conta e deixa a pessoa num rascunho \xF3rf\xE3o.",
+  "Depois de lan\xE7ar, a tela da conta abre sozinha \u2014 \xE9 o normal e n\xE3o precisa ser anunciado. Mande",
+  "`redirect: false` s\xF3 quando levar a pessoa embora atrapalharia: v\xE1rias contas em sequ\xEAncia, ou",
+  "algu\xE9m no meio de outra tarefa que s\xF3 passou a conta de lado.",
+  '"Marca como pago", "paguei", "foi pago" sobre uma conta que VOC\xCA acabou de lan\xE7ar \xE9 sempre',
+  "`registerPayablePayment` com o invoiceId daquela conta \u2014 NUNCA `createPayable` de novo. Lan\xE7ar a",
+  "mesma despesa duas vezes \xE9 dinheiro contado em dobro, e desfazer isso \xE9 trabalho de concilia\xE7\xE3o."
+].join(" ");
+var CREATE_PAYABLE = {
+  id: "financial.create-payable",
+  name: "createPayable",
+  description: 'Records a BILL THE BUSINESS OWES a supplier (conta a pagar, despesa, boleto, invoice from a vendor). This is the tool for "lan\xE7ar/salvar uma conta a pagar", "paguei o fornecedor X", "recibo de despesa". It walks a CHECKLIST, one confirmable step at a time: (1) the supplier \u2014 found by name or created as a supplier contact, (2) the bill itself. Each step opens an EDITABLE FORM pre-filled with what you send and writes nothing until the person confirms it \u2014 so call it as soon as you have an amount and let the forms ask for the rest. If the receipt says it was ALREADY PAID ("pago hoje", "paguei via Pix"), set `paid: true`: step (3) is the payment, and this tool will either ask HOW it was paid or hand you off to `registerPayablePayment`. Send ONLY what you were actually told or could read; omit anything you would be guessing at. When the bill came off a receipt/photo/PDF, call `resolvePayableContext` FIRST and settle the missing dependencies it reports before calling this. A document with a TABLE goes in row by row through `items` (plus `shipping` for frete): the lines are reconciled against `amount`, and a mismatch comes back to be asked about rather than silently trusted. DO NOT use this when a payable form is already open on screen (a draft read from a receipt or PDF): that draft is the bill in progress \u2014 use `fillPayableDraft` and `submitPayableDraft` instead, or this writes a second, duplicate bill and strands the person on a draft that no longer means anything.',
+  icon: "ReceiptText",
+  mode: "persist",
+  execution: { plane: "client" },
+  // O guard é desta ferramenta: ela abre o próprio cartão de confirmação, que é
+  // um formulário. O cartão genérico do loop seria um segundo "tem certeza?"
+  // antes do formulário — duas perguntas para uma decisão.
+  requiresConfirmation: false,
+  category: "Finance",
+  role: "finance",
+  permission: { feature: "financial", action: "create" },
+  limitKey: "movements_month",
+  parameters: {
+    type: "object",
+    properties: {
+      supplier: {
+        type: "string",
+        description: 'Quem RECEBE o dinheiro \u2014 o fornecedor, a empresa, o prestador. \xC9 um NOME de quem foi pago ("Printi", "Padaria do Z\xE9"). N\xE3o \xE9 o que foi comprado nem o valor por extenso.'
+      },
+      amount: {
+        type: "string",
+        description: 'O valor TOTAL da conta \u2014 o que vai ser pago, incluindo frete. Num pedido \xE9 o "Total" do rodap\xE9, nunca o subtotal e nunca o total de uma linha. COPIADO LETRA POR LETRA, com a pontua\xE7\xE3o que estiver escrita: "50,00", "1.234,56", "R$ 89,90". N\xC3O converta para n\xFAmero e n\xE3o tire a v\xEDrgula \u2014 quem l\xEA a pontua\xE7\xE3o \xE9 o aplicativo, que sabe a moeda do pa\xEDs.'
+      },
+      amountInWords: {
+        type: "string",
+        description: 'O valor POR EXTENSO, quando o papel escrever ("CINQUENTA REAIS"). Num recibo manuscrito \xE9 ele que desempata os algarismos. Copie as palavras como est\xE3o.'
+      },
+      dueDate: {
+        type: "string",
+        description: 'O VENCIMENTO, como est\xE1 escrito ("20/01/2026", "2026-01-20"). Omita se ningu\xE9m disse \u2014 o formul\xE1rio pergunta. Uma data de vencimento chutada custa uma confer\xEAncia inteira.'
+      },
+      date: {
+        type: "string",
+        description: 'A data do DOCUMENTO (quando a compra aconteceu), se souber. "hoje" \xE9 hoje.'
+      },
+      description: {
+        type: "string",
+        description: 'O que foi comprado ou pago, em poucas palavras \u2014 \xE9 o nome da linha da conta ("cart\xF5es de visita", "insumos de padaria"). Sem ela a conta nasce sem dizer o que \xE9.'
+      },
+      items: {
+        type: "array",
+        description: 'As LINHAS da nota, uma por linha da tabela \u2014 leia a tabela linha a linha e copie todas. Um pedido de tr\xEAs produtos vira tr\xEAs linhas aqui, n\xE3o uma linha gen\xE9rica de "servi\xE7o prestado": \xE9 assim que a conta diz depois o que foi comprado. Omita quando o papel n\xE3o tem tabela (um recibo de t\xE1xi \xE9 uma linha s\xF3, e a\xED basta `description`).',
+        items: {
+          type: "object",
+          properties: {
+            description: { type: "string", description: "O que \xE9 a linha, como est\xE1 escrito (c\xF3digo + nome)." },
+            quantity: { type: "number", description: "A quantidade da linha. 1 quando a tabela n\xE3o diz." },
+            unitPrice: {
+              type: "string",
+              description: 'O pre\xE7o UNIT\xC1RIO copiado letra por letra ("47,90"), n\xE3o o total da linha e n\xE3o convertido.'
+            }
+          },
+          required: ["description", "unitPrice"]
+        }
+      },
+      shipping: {
+        type: "string",
+        description: 'O FRETE, copiado como est\xE1 escrito ("52,19"), quando o papel o cobra em separado. Vira uma linha pr\xF3pria na conta \u2014 somado a um produto ele desapareceria dentro do pre\xE7o dele.'
+      },
+      notes: {
+        type: "string",
+        description: 'Todo o RESTO que foi dito e n\xE3o coube nos campos acima: N\xDAMERO DO PEDIDO ou do documento ("Pedido: #164223"), data de entrega, condi\xE7\xF5es, para qual projeto. \xC9 onde a pessoa vai procurar o que o papel dizia. N\xC3O repita aqui o que j\xE1 foi para os outros campos.'
+      },
+      paid: {
+        type: "boolean",
+        description: 'true quando a conta J\xC1 FOI PAGA \u2014 "pago hoje", "paguei via Pix", um recibo quitado. Uma conta paga tem um terceiro passo: registrar o pagamento. N\xE3o marque true por um boleto ou uma nota que ainda vai vencer.'
+      },
+      paymentMethod: {
+        type: "string",
+        description: 'COMO foi pago, se a pessoa disse ("Pix", "dinheiro", "cart\xE3o de cr\xE9dito"). N\xE3o chute: sem isto a ferramenta PERGUNTA, oferecendo as formas que este neg\xF3cio aceita.'
+      },
+      paymentDate: {
+        type: "string",
+        description: 'QUANDO foi pago, se disserem. "pago hoje" \xE9 hoje.'
+      },
+      redirect: {
+        type: "boolean",
+        description: "Levar a pessoa at\xE9 a conta rec\xE9m-criada (default: true). Deixe true no caso normal \u2014 quem acabou de lan\xE7ar uma conta quer v\xEA-la. Mande FALSE quando levar embora atrapalharia: ela est\xE1 lan\xE7ando V\xC1RIAS contas em sequ\xEAncia, est\xE1 no meio de outra tarefa (uma tela de cadastro, uma concilia\xE7\xE3o) e s\xF3 passou a conta de lado, ou pediu explicitamente para ficar onde est\xE1. Com false a conta \xE9 criada do mesmo jeito e o link volta na resposta."
+      }
+    },
+    // `amount` deixa de ser obrigatório SÓ porque o passo 0 pode tê-lo lido: sem
+    // leitura guardada a ferramenta recusa do mesmo jeito, com a mesma mensagem.
+    required: []
+  }
+};
+var REGISTER_PAYMENT = {
+  id: "financial.register-payable-payment",
+  name: "registerPayablePayment",
+  description: "Step 3 of the payable checklist: registers that a bill WAS PAID \u2014 the money leaving, with its method and date. Call it with the `invoiceId` a previous `createPayable` returned, and the `method` the person chose (send the option id when they tapped one). Opens an editable confirmation before writing. Use it whenever a bill already recorded turns out to be settled; never to create the bill itself.",
+  icon: "BadgeDollarSign",
+  mode: "persist",
+  execution: { plane: "client" },
+  requiresConfirmation: false,
+  category: "Finance",
+  role: "finance",
+  permission: { feature: "financial", action: "update" },
+  parameters: {
+    type: "object",
+    properties: {
+      invoiceId: { type: "string", description: "Id da conta a pagar, devolvido por createPayable." },
+      method: {
+        type: "string",
+        description: 'A forma de pagamento \u2014 o id da op\xE7\xE3o que a pessoa tocou, ou o nome dela ("Pix", "Dinheiro").'
+      },
+      paymentDate: { type: "string", description: "A data do pagamento. Omita para hoje." }
+    },
+    required: ["invoiceId"]
+  }
+};
+var OPEN_FULL_FORM = {
+  id: "financial.open-payable-form",
+  name: "openPayableForm",
+  description: 'Opens the full "new payable" screen, empty or pre-filled, for a bill that needs more than a one-line entry: several installments, a receipt to attach, a ledger account or cost centre. Writes nothing. Prefer `createPayable` for an ordinary single bill \u2014 this one is the long form.',
+  icon: "FilePlus",
+  mode: "read",
+  execution: { plane: "client" },
+  category: "Finance",
+  role: "finance",
+  permission: { feature: "financial", action: "create" },
+  parameters: { type: "object", properties: {} }
+};
+function supplierRef(id, label) {
+  if (!resolveEntityRoute("person", "supplier")) return {};
+  return { ref: { id, label, archetype: "person:supplier" } };
+}
+async function resolveSupplier(lookup, name) {
+  const wanted = name.trim().toLowerCase();
+  const hits = await lookup.search(name).catch(() => []);
+  const exact = hits.find((r) => r.label.trim().toLowerCase() === wanted);
+  if (exact) return { ok: true, id: exact.id, name: exact.label, created: false };
+  if (!lookup.create) return { ok: true, name, created: false };
+  const decision = await useChatStore.getState().requestConfirmation({
+    id: `supplier-${Date.now()}`,
+    toolName: "createPayable",
+    title: "Novo fornecedor",
+    params: { name },
+    plane: "client",
+    scope: "financial:supplier",
+    scopeLabel: "Cadastrar fornecedor",
+    fields: [
+      { key: "name", label: "Nome", type: "text", required: true },
+      { key: "document_number", label: "CNPJ / CPF", type: "text" },
+      { key: "phone", label: "Telefone", type: "text" },
+      { key: "email", label: "E-mail", type: "text" }
+    ]
+  });
+  if (!decision.approved) return { ok: false, cancelled: true };
+  const draft = { ...{ name }, ...decision.values ?? {} };
+  const finalName = text(draft.name) ?? name;
+  const made = await lookup.create({
+    ...draft,
+    name: finalName
+  });
+  return { ok: true, id: made.id, name: made.label, created: true };
+}
+async function paymentOptions(provider) {
+  const types = await provider.getPaymentMethodTypes().catch(() => []);
+  return types.filter((t2) => t2.isActive !== false).map((t2) => ({
+    id: t2.id,
+    label: t2.name,
+    transactionType: t2.transactionType,
+    allowedAccountTypes: t2.allowedAccountTypes
+  }));
+}
+var ACCOUNT_TYPES_FOR_TX = {
+  cash: ["cash_physical", "cash_session"],
+  credit_card: ["card_receivable_credit"],
+  debit_card: ["card_receivable_debit"],
+  pix: ["bank"],
+  bank_transfer: ["bank"],
+  boleto: ["bank"],
+  check: ["bank"],
+  voucher: ["bank"]
+};
+async function eligibleAccounts(provider, method) {
+  const accounts = (await provider.getBankAccounts().catch(() => [])).filter((a) => a.isActive !== false);
+  const allowed = method.allowedAccountTypes?.length ? method.allowedAccountTypes : ACCOUNT_TYPES_FOR_TX[method.transactionType ?? ""];
+  if (!allowed) return accounts;
+  return accounts.filter((a) => allowed.includes(a.accountType));
+}
+function matchPaymentOption(options, raw) {
+  const wanted = typeof raw === "string" ? raw.trim().toLowerCase() : "";
+  if (!wanted) return null;
+  return options.find((o) => o.id.toLowerCase() === wanted) ?? options.find((o) => o.label.toLowerCase() === wanted) ?? options.find((o) => o.label.toLowerCase().includes(wanted) || wanted.includes(o.label.toLowerCase())) ?? null;
+}
+async function settlePayable(provider, input) {
+  const schedule = await provider.getMovements({
+    invoiceId: input.invoiceId,
+    direction: "debit",
+    status: "pending"
+  });
+  const bill = schedule.data.find((m) => m.movementKind === "bill");
+  if (!bill) {
+    return {
+      ok: false,
+      error: "no_open_bill",
+      message: "That bill has no open installment \u2014 it may already be settled. Say so and stop."
+    };
+  }
+  const invoice = await provider.getInvoiceById(input.invoiceId).catch(() => null);
+  const money3 = (n) => n.toLocaleString("pt-BR", { style: "currency", currency: input.currency ?? "BRL" });
+  const invoiceLabel = [
+    invoice?.fiscalNumber ? `#${invoice.fiscalNumber}` : null,
+    invoice?.contactName ?? null,
+    money3(bill.amount)
+  ].filter(Boolean).join(" \u2014 ") || money3(bill.amount);
+  const needsAccount = input.method.transactionType !== "cash";
+  const accounts = needsAccount ? await eligibleAccounts(provider, input.method) : [];
+  if (needsAccount && !accounts.length) {
+    return {
+      ok: false,
+      error: "no_eligible_account",
+      message: `The bill is recorded but NOT settled: this business has no account that can settle a ${input.method.label} payment. Say that, and that it has to be registered from the payables screen.`
+    };
+  }
+  const onlyAccount = accounts.length === 1 ? accounts[0] : void 0;
+  const paymentDate = parseReceiptDate(input.paymentDate) ?? today();
+  const decision = await useChatStore.getState().requestConfirmation({
+    id: `payment-${bill.id}`,
+    toolName: "registerPayablePayment",
+    title: "Registrar pagamento",
+    params: {
+      invoice: invoiceLabel,
+      method: input.method.label,
+      accountId: onlyAccount?.id,
+      paymentDate,
+      amount: bill.amount
+    },
+    plane: "client",
+    scope: "financial:payment",
+    scopeLabel: "Registrar pagamento",
+    fields: [
+      // Qual conta está sendo quitada, por extenso e primeiro. Só de leitura:
+      // é a identidade do que se assina, não um campo a editar.
+      { key: "invoice", label: "Conta a pagar", type: "text", readOnly: true },
+      { key: "method", label: "Forma de pagamento", type: "text", required: true, readOnly: true },
+      ...needsAccount ? [{
+        key: "accountId",
+        label: "Conta de sa\xEDda",
+        type: "select",
+        required: true,
+        options: accounts.map((a) => ({ value: a.id, label: a.name }))
+      }] : [],
+      { key: "paymentDate", label: "Data do pagamento", type: "date", required: true },
+      { key: "amount", label: "Valor pago", type: "number", required: true, min: 0 }
+    ]
+  });
+  if (!decision.approved) {
+    return {
+      ok: false,
+      cancelled: true,
+      reason: "user_declined",
+      message: "The bill is recorded but NOT settled \u2014 the payment step was declined. Say exactly that."
+    };
+  }
+  const values = { paymentDate, amount: bill.amount, accountId: onlyAccount?.id, ...decision.values ?? {} };
+  const accountId = typeof values.accountId === "string" && values.accountId ? values.accountId : void 0;
+  if (needsAccount && !accountId) {
+    return {
+      ok: false,
+      error: "no_account",
+      message: "NOTHING WAS SETTLED. The form came back with no outgoing account \u2014 do not say it was paid."
+    };
+  }
+  await provider.payMovement({
+    movementId: bill.id,
+    amount: parseReceiptAmount(values.amount) ?? bill.amount,
+    paymentDate: parseReceiptDate(values.paymentDate) ?? paymentDate,
+    paymentMethodTypeId: input.method.id,
+    bankAccountId: accountId
+  });
+  return {
+    ok: true,
+    settled: true,
+    invoiceId: input.invoiceId,
+    movementId: bill.id,
+    method: input.method.label,
+    account: accounts.find((a) => a.id === accountId)?.name,
+    paymentDate: parseReceiptDate(values.paymentDate) ?? paymentDate,
+    // O botão que abre a conta quitada. `path` existe para exatamente isto —
+    // uma tela de plugin que o mapa de rotas por arquétipo não sabe resolver.
+    ref: {
+      id: input.invoiceId,
+      label: invoiceLabel,
+      path: `/financial/payables/${input.invoiceId}`
+    },
+    message: `Pago via ${input.method.label}. Diga em UMA frase que a conta foi lan\xE7ada e quitada, e pare.`
+  };
+}
+var recentPayables = [];
+var RECENT_WINDOW_MS = 10 * 60 * 1e3;
+function rememberPayable(entry) {
+  recentPayables = [...recentPayables.filter((p) => p.invoiceId !== entry.invoiceId), entry].slice(-10);
+}
+function findRecentPayable(supplier, amount) {
+  const now2 = Date.now();
+  recentPayables = recentPayables.filter((p) => now2 - p.at < RECENT_WINDOW_MS);
+  const wanted = supplier.trim().toLowerCase();
+  return recentPayables.find(
+    (p) => p.supplier.trim().toLowerCase() === wanted && Math.abs(p.amount - amount) < 5e-3
+  );
+}
+function asChoiceCards(choices) {
+  const usable = choices.filter((c) => c.options.length >= 2);
+  return usable.length ? { kind: "record_choice", choices: usable } : {};
+}
+function gapChoices(input) {
+  const questions = [];
+  const { supplierName, supplier, method, account } = input;
+  if (supplier.status !== "found" && supplierName) {
+    const candidates = supplier.candidates ?? [];
+    questions.push({
+      id: "supplier",
+      question: candidates.length ? `"${supplierName}" n\xE3o est\xE1 cadastrado. \xC9 algum destes?` : `"${supplierName}" ainda n\xE3o est\xE1 cadastrado. Cadastrar agora?`,
+      options: [
+        // Os parecidos PRIMEIRO: a razão de eles existirem é evitar o
+        // duplicado, então a opção de criar não pode ser a mais fácil de tocar.
+        ...candidates.slice(0, 4).map((c) => ({
+          id: `supplier:${c.id}`,
+          label: c.name,
+          meta: c.why
+        })),
+        { id: "supplier:create", label: `Criar fornecedor "${supplierName}"` },
+        { id: "supplier:cancel", label: "Cancelar" }
+      ]
+    });
+  }
+  if (method.status !== "found") {
+    const available = method.available ?? [];
+    questions.push({
+      id: "method",
+      question: method.spoken ? `O papel diz "${String(method.spoken)}", que n\xE3o est\xE1 cadastrado. Qual forma corresponde?` : "Como esta conta foi (ou vai ser) paga?",
+      options: [
+        ...available.slice(0, 5).map((o) => ({ id: `method:${o.id}`, label: o.label })),
+        { id: "method:none", label: "Deixar em aberto" }
+      ]
+    });
+  }
+  if (account.status === "ambiguous") {
+    const options = account.options ?? [];
+    questions.push({
+      id: "account",
+      question: account.cardLast4 ? `Nenhuma conta cadastrada tem o final ${String(account.cardLast4)}. De qual conta saiu?` : "De qual conta o dinheiro saiu?",
+      options: [
+        ...options.slice(0, 5).map((o) => ({ id: `account:${o.id}`, label: o.name })),
+        { id: "account:skip", label: "Decidir na hora de pagar" }
+      ]
+    });
+  }
+  return questions;
+}
+function askHowItWasPaid(invoiceId, options) {
+  return {
+    kind: "record_choice",
+    choices: [{
+      id: `payment-method-${invoiceId}`,
+      question: "Foi pago como?",
+      options
+    }],
+    invoiceId,
+    nextStep: "registerPayablePayment",
+    message: `The bill is recorded but NOT yet settled. The person is being asked HOW it was paid \u2014 the options are on screen. Do not list them again in prose and do not guess one. When they answer, call registerPayablePayment with invoiceId "${invoiceId}" and the option id they chose.`
+  };
+}
+function createPayableTools({ config, provider }) {
+  const lookup = config.contactLookup ?? createArchetypeLookup({ archetype: "person", kind: "supplier" });
+  return [
+    {
+      tool: RESOLVE_CONTEXT,
+      execute: async (args) => {
+        consumePayableDraft();
+        const supplierName = text(args.supplier);
+        const supplier = supplierName ? await findSupplier(lookup, supplierName, args.supplierDocument) : { status: "missing", candidates: [] };
+        const method = await findMethod(provider, args);
+        const account = await findAccount(provider, method, args.cardLast4);
+        const gaps = [
+          supplier.status !== "found" ? "supplier" : null,
+          method.status !== "found" ? "method" : null,
+          account.status === "ambiguous" || account.status === "missing" ? "account" : null
+        ].filter(Boolean);
+        const choices = gapChoices({ supplierName, supplier, method, account });
+        const document2 = normalizeDocument(args);
+        rememberDocument(document2, {
+          ...text(args.supplier) ? { source: text(args.supplier) } : {},
+          ...useChatStore.getState().conversationId ? { conversationId: useChatStore.getState().conversationId } : {}
+        });
+        return {
+          ok: true,
+          read: {
+            supplier: supplierName,
+            supplierDocument: onlyDigits(args.supplierDocument) || void 0,
+            paymentMethod: text(args.paymentMethod),
+            cardBrand: text(args.cardBrand),
+            cardLast4: lastFour(args.cardLast4) || void 0
+          },
+          supplier,
+          method,
+          account,
+          gaps,
+          document: document2,
+          ...asChoiceCards(choices),
+          message: 'NOTHING WAS WRITTEN \u2014 this was a check. Tell the person the result as ONE short line per dependency, saying which already exist and which are missing (e.g. "Fornecedor Printi: ja existe - Pix: cadastrado - cartao final 4242: nao encontrei"). FIRST say what you READ, in one line, from `document`: how many items, the total, the method, the order ref, and the dates \u2014 and when `document.dueDate` is null say plainly there is no due date on the paper (\xE0 vista) and that the form will ask. If `document.reconciles` is false and there are items and a total, say the numbers do not add up and ask, instead of choosing one. The extraction is SAVED: when you call createPayable next, you may omit items/shipping/total/dates entirely \u2014 it reuses exactly what was read here. Do NOT re-read the document to fill them in again; re-reading from memory is where wrong numbers come from. ' + (choices.length ? "The open questions are ALREADY ON SCREEN as tappable buttons \u2014 do NOT repeat the options in prose and do NOT ask the person to type an answer. End your reply after the checklist and WAIT for the tap. When they answer, the option id says what to do: `supplier:create` means create the supplier under the name in `read.supplier` (call createPayable and its supplier step will confirm it), `supplier:<uuid>` means use that existing one, `method:<id>` is the payment method, `account:<id>` the outgoing account, and anything `:cancel` means stop. " : "Then continue with createPayable for the bill, and the payment. ") + "Never invent a value the paper did not state."
+        };
+      }
+    },
+    {
+      tool: OPEN_FULL_FORM,
+      execute: async () => {
+        adminNavigateTo("/financial/payables/new");
+        return { ok: true, opened: "/financial/payables/new" };
+      }
+    },
+    {
+      tool: CREATE_PAYABLE,
+      execute: async (args) => {
+        if (hasLivePayableDraft()) {
+          return {
+            ok: false,
+            error: "draft_open",
+            message: "NOTHING WAS WRITTEN, and no second bill was created. The payable form is OPEN ON SCREEN with the draft this conversation has been building \u2014 that draft IS this bill. Continue in it: use `fillPayableDraft` for what is missing and `submitPayableDraft` to save. Do not call createPayable again while that form is open."
+          };
+        }
+        const remembered = rememberedDocument();
+        if (args.amount === void 0 && remembered?.total !== void 0) {
+          args = { ...args, amount: String(remembered.total) };
+        }
+        if (typeof args.amount !== "string") {
+          return {
+            ok: false,
+            error: "amount_must_be_literal",
+            message: 'Send `amount` as the TEXT that was written, punctuation included ("50,00", "1.234,56") \u2014 never as a number. A decimal comma is a thousands separator in English, so converting it yourself turns fifty into five thousand. Resend the literal.'
+          };
+        }
+        const figures = parseReceiptAmount(args.amount);
+        const spelled = parseAmountInWords(args.amountInWords);
+        const amount = spelled ?? figures;
+        if (amount === null) {
+          return {
+            ok: false,
+            error: "invalid_amount",
+            message: "That is not a readable amount. If the total is illegible or was never said, ask the person."
+          };
+        }
+        const lines = args.items === void 0 && remembered?.items.length ? { items: remembered.items, error: void 0 } : parseLineItems(args.items);
+        if (lines.error) return { ok: false, error: "invalid_items", message: lines.error };
+        const shipping = args.shipping === void 0 ? remembered?.shipping ?? null : parseReceiptAmount(args.shipping);
+        const lineSum = round2(lines.items.reduce((s, i) => s + i.quantity * i.unitPrice, 0));
+        const computed = round2(lineSum + (shipping ?? 0));
+        const candidates = [
+          { value: amount, from: "argumento" },
+          ...remembered?.total !== void 0 ? [{ value: remembered.total, from: "leitura" }] : []
+        ];
+        const agreed = lines.items.length ? candidates.find((c) => Math.abs(computed - c.value) <= 0.02) : candidates[0];
+        if (lines.items.length && !agreed) {
+          return {
+            ok: false,
+            error: "total_mismatch",
+            lineSum,
+            shipping: shipping ?? void 0,
+            computed,
+            total: amount,
+            ...remembered?.total !== void 0 ? { totalFromDocument: remembered.total } : {},
+            message: `NOTHING WAS WRITTEN. The lines do not add up to the total: the item(s) sum to ${lineSum}${shipping ? ` plus ${shipping} of shipping` : ""} = ${computed}, but the total given is ${amount}. Do NOT pick one of them and do not adjust a line to make it fit. Re-read the document \u2014 a line may have been missed, a quantity misread, or a discount or shipping line not captured. If the paper genuinely disagrees with itself, ask the person which is right.`
+          };
+        }
+        const reconciledTotal = agreed?.value ?? amount;
+        const correctedFromRead = agreed?.from === "leitura" && Math.abs(agreed.value - amount) > 5e-3;
+        const dueDate = parseReceiptDate(args.dueDate) ?? remembered?.dueDate ?? void 0;
+        const issueDate = parseReceiptDate(args.date) ?? remembered?.documentDate ?? parseReceiptDate(findDateIn(args.notes));
+        const params = { amount };
+        const supplierName = text(args.supplier);
+        if (supplierName) params.supplier = supplierName;
+        const description = text(args.description);
+        if (description) params.description = description;
+        if (dueDate) params.dueDate = dueDate;
+        if (issueDate) params.issueDate = issueDate;
+        const carried = [
+          remembered?.orderRef ? `Pedido: ${remembered.orderRef}` : null,
+          remembered?.deliveryDate ? `Entrega: ${remembered.deliveryDate}` : null
+        ].filter(Boolean).join(" \xB7 ");
+        const notes = text(args.notes) ?? (carried || void 0);
+        if (notes) params.notes = notes;
+        if (lines.items.length) {
+          params.items = lines.items.map((i) => `${i.quantity}\xD7 ${i.description} @ ${i.unitPrice}`).join(" \xB7 ");
+          params.amount = computed;
+        }
+        if (shipping) params.shipping = shipping;
+        if (supplierName) {
+          const already = findRecentPayable(supplierName, amount);
+          if (already) {
+            return {
+              ok: false,
+              error: "already_recorded",
+              invoiceId: already.invoiceId,
+              message: `NOTHING WAS WRITTEN and no second bill was created. The bill for ${supplierName} of ${amount} was ALREADY recorded in this conversation \u2014 its invoiceId is "${already.invoiceId}". If the person is saying it was PAID ("marca como pago", "paguei no Pix"), call registerPayablePayment with invoiceId "${already.invoiceId}". Only call createPayable again if this is genuinely a DIFFERENT bill, with a different amount or supplier.`
+            };
+          }
+        }
+        let supplier = null;
+        if (supplierName) {
+          const step = await resolveSupplier(lookup, supplierName);
+          if (!step.ok) {
+            return {
+              ok: false,
+              cancelled: true,
+              reason: "user_declined_supplier",
+              message: "NOTHING WAS WRITTEN. The person declined creating the supplier, so the bill has nobody to point at. Ask which existing supplier it belongs to \u2014 do not retry the same name."
+            };
+          }
+          supplier = { id: step.id, name: step.name, created: step.created };
+          params.supplier = step.name;
+        }
+        const decision = await useChatStore.getState().requestConfirmation({
+          id: `payable-${Date.now()}`,
+          toolName: "createPayable",
+          // Nomeia o que está sendo criado. Era `config.labels.payablesNew`,
+          // que é o rótulo da AÇÃO na sub-navegação ("New") — no topo de um
+          // cartão de confirmação ele dizia só "New" e não nomeava nada.
+          title: "Nova conta a pagar",
+          params,
+          plane: "client",
+          scope: "financial:payable",
+          scopeLabel: "Lan\xE7ar conta a pagar",
+          fields: [
+            { key: "supplier", label: "Fornecedor", type: "text", required: true },
+            { key: "description", label: "Descri\xE7\xE3o", type: "text", required: true },
+            // As linhas lidas da tabela, à vista e só de leitura: é o que a
+            // pessoa confere para saber se a leitura do papel bateu.
+            ...lines.items.length ? [{ key: "items", label: "Itens", type: "text", readOnly: true }] : [],
+            ...shipping ? [{ key: "shipping", label: "Frete", type: "number", readOnly: true }] : [],
+            // Com tabela lida, o valor É a soma conferida — editá-lo aqui o
+            // separaria das linhas, e o banco recusa uma fatura cujas parcelas
+            // não fecham com os itens. Sem tabela, ele continua editável.
+            {
+              key: "amount",
+              label: "Valor total",
+              type: "number",
+              required: true,
+              min: 0,
+              ...lines.items.length ? { readOnly: true } : {}
+            },
+            { key: "dueDate", label: "Vencimento", type: "date", required: true },
+            { key: "issueDate", label: "Data do documento", type: "date", default: today() },
+            { key: "notes", label: "Observa\xE7\xF5es", type: "text" }
+          ]
+        });
+        if (!decision.approved) return { ok: false, cancelled: true, reason: "user_declined" };
+        const values = { ...params, ...decision.values ?? {} };
+        const finalAmount = lines.items.length ? computed : parseReceiptAmount(values.amount) ?? amount;
+        const finalSupplier = text(values.supplier);
+        const finalDescription = text(values.description) ?? finalSupplier ?? "";
+        const finalDue = parseReceiptDate(values.dueDate);
+        const finalIssue = parseReceiptDate(values.issueDate) ?? today();
+        if (!finalSupplier || !finalDue) {
+          return {
+            ok: false,
+            error: "incomplete",
+            message: "NOTHING WAS WRITTEN. The form came back without a supplier or a due date \u2014 do not tell the user it worked."
+          };
+        }
+        let resolvedSupplier = supplier;
+        if (!resolvedSupplier || resolvedSupplier.name !== finalSupplier) {
+          const again = await resolveSupplier(lookup, finalSupplier);
+          if (!again.ok) {
+            return {
+              ok: false,
+              cancelled: true,
+              reason: "user_declined_supplier",
+              message: "NOTHING WAS WRITTEN. The supplier step was declined \u2014 ask which supplier this bill belongs to."
+            };
+          }
+          resolvedSupplier = { id: again.id, name: again.name, created: again.created };
+        }
+        const invoice = await provider.createInvoice({
+          direction: "debit",
+          invoiceDate: finalIssue,
+          contactId: resolvedSupplier.id,
+          contactName: resolvedSupplier.name,
+          observations: text(values.notes),
+          // A nota que o papel descreve, linha por linha. Sem tabela, a conta
+          // nasce com uma linha só — que é o que um recibo de táxi é. O FRETE é
+          // linha PRÓPRIA: somado ao preço de um produto ele sumiria dentro
+          // dele, e a conciliação com a transportadora não teria onde olhar.
+          items: [
+            ...lines.items.length ? lines.items.map((line) => ({
+              itemKind: "other",
+              description: line.description,
+              quantity: line.quantity,
+              unitPrice: line.unitPrice
+            })) : [{
+              itemKind: "other",
+              description: finalDescription,
+              quantity: 1,
+              unitPrice: round2(finalAmount - (shipping ?? 0))
+            }],
+            ...shipping ? [{ itemKind: "other", description: "Frete", quantity: 1, unitPrice: shipping }] : []
+          ],
+          installments: [{
+            direction: "debit",
+            movementKind: "bill",
+            amount: finalAmount,
+            dueDate: finalDue,
+            installmentNumber: 1
+          }]
+        });
+        const id = invoice?.id;
+        if (id) {
+          rememberPayable({ invoiceId: id, supplier: resolvedSupplier.name, amount: finalAmount, at: Date.now() });
+        }
+        consumePayableDraft();
+        const drift = spelled !== null && figures !== null && Math.abs(spelled - figures) > 5e-3 ? { note: `Os algarismos pareciam ${figures} e o extenso diz ${spelled}. Usei o extenso.` } : {};
+        const invoicePath = id ? `/financial/payables/${id}` : null;
+        const redirected = invoicePath !== null && args.redirect !== false;
+        if (redirected) {
+          adminNavigateTo(invoicePath);
+          revealPage();
+        }
+        const invoiceLink = invoicePath ? { ref: { id, label: `${resolvedSupplier.name} \u2014 ${finalDescription}`, path: invoicePath } } : {};
+        if (args.paid === true && id) {
+          const options = await paymentOptions(provider);
+          const chosen = matchPaymentOption(options, args.paymentMethod);
+          if (!chosen) {
+            if (options.length >= 2) {
+              return {
+                ...askHowItWasPaid(id, options),
+                supplier: resolvedSupplier.name,
+                supplierCreated: resolvedSupplier.created,
+                amount: finalAmount,
+                openedInvoice: redirected,
+                ...drift
+              };
+            }
+            return {
+              ok: true,
+              invoiceId: id,
+              settled: false,
+              supplier: resolvedSupplier.name,
+              amount: finalAmount,
+              dueDate: finalDue,
+              openedInvoice: redirected,
+              ...invoiceLink,
+              message: "A conta foi lan\xE7ada, mas o pagamento N\xC3O foi registrado: este neg\xF3cio n\xE3o tem formas de pagamento cadastradas para escolher. Diga isso e ofere\xE7a registrar a baixa pela tela.",
+              ...drift
+            };
+          }
+          const settled = await settlePayable(provider, {
+            invoiceId: id,
+            method: chosen,
+            paymentDate: typeof args.paymentDate === "string" ? args.paymentDate : void 0,
+            currency: config.currency?.code
+          });
+          return {
+            ...settled,
+            invoiceId: id,
+            supplier: resolvedSupplier.name,
+            supplierCreated: resolvedSupplier.created,
+            amount: finalAmount,
+            openedInvoice: redirected,
+            ...drift
+          };
+        }
+        return {
+          ok: true,
+          invoiceId: id,
+          settled: false,
+          supplier: resolvedSupplier.name,
+          supplierCreated: resolvedSupplier.created,
+          amount: finalAmount,
+          dueDate: finalDue,
+          openedInvoice: redirected,
+          ...lines.items.length ? { itemsWritten: lines.items.length } : {},
+          // Dito, nunca silencioso: se o total que veio na chamada perdeu os
+          // centavos e o da leitura fechou com as linhas, quem escreveu foi a
+          // leitura — e quem confere merece saber disso.
+          ...correctedFromRead ? {
+            correctedTotal: {
+              sent: amount,
+              written: reconciledTotal,
+              why: "o total enviado n\xE3o fechava com as linhas; o lido do documento fechou"
+            }
+          } : {},
+          ...shipping ? { shipping } : {},
+          // A CONTA é o destino principal — é o que a pessoa acabou de criar.
+          ...invoiceLink,
+          // O fornecedor vai como segundo botão, e só onde existe tela para ele
+          // (ver supplierRef): `extractRecordLinks` lê `ref` e `record.ref`.
+          ...resolvedSupplier.id ? { record: supplierRef(resolvedSupplier.id, resolvedSupplier.name) } : {},
+          // O que fazer DEPOIS, dito com o id dentro. Sem esta linha, "marca
+          // como pago no pix hoje" na mensagem seguinte virou uma SEGUNDA conta
+          // a pagar: o modelo tinha a ferramenta de baixa e nenhuma frase
+          // ligando-a a esta fatura.
+          message: `A conta a pagar de ${resolvedSupplier.name} foi lan\xE7ada (invoiceId "${id}"), em aberto. ` + (resolvedSupplier.created ? "O fornecedor foi cadastrado agora. " : "") + (redirected ? "A tela da conta J\xC1 foi aberta \u2014 n\xE3o ofere\xE7a abri-la. " : "") + `Diga isso em UMA frase e pare \u2014 n\xE3o repita os campos, a pessoa acabou de conferi-los. IMPORTANTE: se a pessoa disser depois que esta conta foi paga ("marca como pago", "paguei no Pix", "foi pago hoje"), chame registerPayablePayment com invoiceId "${id}". N\xC3O chame createPayable de novo \u2014 isso criaria uma segunda conta para a mesma despesa.`,
+          ...drift
+        };
+      }
+    },
+    {
+      tool: REGISTER_PAYMENT,
+      execute: async (args) => {
+        const invoiceId = typeof args.invoiceId === "string" ? args.invoiceId : "";
+        if (!invoiceId) {
+          return {
+            ok: false,
+            error: "missing_invoice",
+            message: "Which bill? Pass the `invoiceId` that createPayable returned."
+          };
+        }
+        const options = await paymentOptions(provider);
+        const chosen = matchPaymentOption(options, args.method);
+        if (!chosen) {
+          if (options.length < 2) {
+            return {
+              ok: false,
+              error: "no_payment_methods",
+              message: "This business has no payment methods to choose from. Say so instead of guessing one."
+            };
+          }
+          return askHowItWasPaid(invoiceId, options);
+        }
+        return settlePayable(provider, {
+          invoiceId,
+          method: chosen,
+          paymentDate: typeof args.paymentDate === "string" ? args.paymentDate : void 0,
+          currency: config.currency?.code
+        });
+      }
+    }
+  ];
+}
+var liveDraft = null;
+function hasLivePayableDraft() {
+  return liveDraft !== null;
+}
+var COMPANY_NOISE = /* @__PURE__ */ new Set([
+  "ltda",
+  "ltd",
+  "me",
+  "epp",
+  "eireli",
+  "sa",
+  "mei",
+  "cia",
+  "ei",
+  "inc",
+  "comercio",
+  "servicos",
+  "industria",
+  "do",
+  "da",
+  "de",
+  "dos",
+  "das",
+  "e"
+]);
+function normalizeCompanyName(raw) {
+  if (typeof raw !== "string") return "";
+  return raw.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((w) => w && !COMPANY_NOISE.has(w)).join(" ").trim();
+}
+function onlyDigits(raw) {
+  return typeof raw === "string" ? raw.replace(/\D/g, "") : "";
+}
+function lastFour(raw) {
+  const digits = onlyDigits(raw);
+  return digits.length >= 4 ? digits.slice(-4) : "";
+}
+async function findSupplier(lookup, rawName, rawDocument) {
+  const wanted = normalizeCompanyName(rawName);
+  const doc = onlyDigits(rawDocument);
+  if (!wanted) return { status: "missing", candidates: [] };
+  const core = wanted.split(" ")[0] ?? wanted;
+  const seen = /* @__PURE__ */ new Map();
+  for (const query of core === wanted ? [core] : [core, wanted]) {
+    for (const hit of await lookup.search(query).catch(() => [])) {
+      const row = hit.data ?? {};
+      seen.set(hit.id, {
+        id: hit.id,
+        name: hit.label,
+        document: onlyDigits(row.document_number) || void 0,
+        why: ""
+      });
+    }
+  }
+  const all = [...seen.values()];
+  if (doc) {
+    const byDoc = all.find((c) => c.document && c.document === doc);
+    if (byDoc) return { status: "found", match: { ...byDoc, why: "mesmo CNPJ/CPF" }, candidates: [] };
+  }
+  const exact = all.filter((c) => normalizeCompanyName(c.name) === wanted);
+  if (exact.length === 1) {
+    const only = exact[0];
+    if (doc && only.document && only.document !== doc) {
+      return {
+        status: "ambiguous",
+        candidates: [{ ...only, why: "mesmo nome, mas o CNPJ do papel \xE9 outro" }]
+      };
+    }
+    return { status: "found", match: { ...only, why: "nome id\xEAntico" }, candidates: [] };
+  }
+  const near = all.map((c) => {
+    const n = normalizeCompanyName(c.name);
+    if (!n) return null;
+    if (n === wanted) return { ...c, why: "nome id\xEAntico" };
+    if (n.startsWith(wanted) || wanted.startsWith(n)) return { ...c, why: "nome contido" };
+    const shared = n.split(" ").filter((w) => wanted.split(" ").includes(w));
+    return shared.length ? { ...c, why: `parte do nome em comum (${shared.join(" ")})` } : null;
+  }).filter((c) => c !== null).slice(0, 5);
+  return { status: near.length ? "ambiguous" : "missing", candidates: near };
+}
+async function findMethod(provider, args) {
+  const types = await paymentOptions(provider);
+  const spoken = [args.paymentMethod, args.cardBrand].filter((v) => typeof v === "string" && !!v.trim());
+  const card = lastFour(args.cardLast4);
+  const looksLikeCard = !!(card || args.cardBrand);
+  let match = matchPaymentOption(types, args.paymentMethod);
+  if (!match && looksLikeCard) {
+    match = types.find((t2) => t2.transactionType === "credit_card") ?? null;
+  }
+  const configured = (await provider.getPaymentMethods().catch(() => [])).filter((m) => m.isActive !== false);
+  const namedMethod = configured.find((m) => {
+    const n = normalizeCompanyName(m.name);
+    return !!n && spoken.some((s) => {
+      const w = normalizeCompanyName(s);
+      return !!w && (n === w || n.includes(w) || w.includes(n));
+    });
+  });
+  if (!match) {
+    return {
+      status: "missing",
+      spoken: spoken.join(" ") || void 0,
+      cardLast4: card || void 0,
+      available: types.map((t2) => ({ id: t2.id, label: t2.label })),
+      hint: "This business has no payment method matching what the paper says. ASK which of the available ones it maps to, or offer to add it in Settings (createRecord on financial:payment-methods is the right tool for THAT, and only that). Never silently pick one."
+    };
+  }
+  return {
+    status: "found",
+    id: match.id,
+    label: match.label,
+    transactionType: match.transactionType,
+    ...namedMethod ? { configuredMethod: { id: namedMethod.id, name: namedMethod.name } } : {},
+    ...card ? { cardLast4: card } : {}
+  };
+}
+async function findAccount(provider, method, rawLast4) {
+  if (method.status !== "found") {
+    return { status: "blocked", hint: "Resolve the payment method first \u2014 the eligible accounts depend on it." };
+  }
+  if (method.transactionType === "cash") {
+    return {
+      status: "not_applicable",
+      hint: "Cash settles through the open cash session, not an account \u2014 nothing to choose."
+    };
+  }
+  const accounts = await eligibleAccounts(provider, {
+    id: String(method.id),
+    label: String(method.label),
+    transactionType: method.transactionType
+  });
+  const card = lastFour(rawLast4);
+  const byCard = card ? accounts.find((a) => lastFour(a.accountNumber) === card || a.name.includes(card)) : void 0;
+  if (byCard) return { status: "found", id: byCard.id, name: byCard.name, why: `final ${card}` };
+  if (!accounts.length) {
+    return {
+      status: "missing",
+      hint: `No account can settle a ${String(method.label)} payment. Say so \u2014 it has to be created in Settings.`
+    };
+  }
+  if (card) {
+    return {
+      status: "ambiguous",
+      cardLast4: card,
+      note: `o papel diz final ${card} e nenhuma conta cadastrada tem esse final`,
+      options: accounts.map((a) => ({ id: a.id, name: a.name })),
+      hint: `ASK whether the card ending ${card} is one of these accounts, or whether it still has to be registered. Do not assume it is the only eligible one.`
+    };
+  }
+  if (accounts.length === 1) {
+    return { status: "found", id: accounts[0].id, name: accounts[0].name, why: "\xFAnica conta eleg\xEDvel" };
+  }
+  return {
+    status: "ambiguous",
+    ...card ? { cardLast4: card, note: `nenhuma conta bate com o final ${card}` } : {},
+    options: accounts.map((a) => ({ id: a.id, name: a.name })),
+    hint: "Ask which account the money left. Do not pick one."
+  };
+}
+var RESOLVE_CONTEXT = {
+  id: "financial.resolve-payable-context",
+  name: "resolvePayableContext",
+  description: "STEP 0, BEFORE writing anything: checks what a receipt names against what this business actually has. Call it as soon as you have read a receipt/photo/PDF, with EVERYTHING the paper says \u2014 supplier, its CNPJ/CPF if printed, the payment method, the card brand and last 4 digits if printed. Returns, for each dependency, whether it already exists here (fuzzy-matched on name and CNPJ, so the same supplier is never created twice), is ambiguous, or is missing \u2014 plus the candidates to choose from. Writes NOTHING. Report the result as a short checklist and then resolve the gaps IN ORDER: supplier first, then the payment method, then the bill (createPayable), then the payment.",
+  icon: "ListChecks",
+  mode: "read",
+  execution: { plane: "client" },
+  category: "Finance",
+  role: "finance",
+  permission: { feature: "financial", action: "read" },
+  parameters: {
+    type: "object",
+    properties: {
+      supplier: { type: "string", description: "O nome do fornecedor EXATAMENTE como est\xE1 escrito no papel." },
+      supplierDocument: { type: "string", description: "O CNPJ ou CPF impresso, se houver. Copie os d\xEDgitos." },
+      paymentMethod: {
+        type: "string",
+        description: 'Como o papel diz que foi pago ("PIX", "cart\xE3o de cr\xE9dito", "dinheiro", "boleto").'
+      },
+      cardBrand: { type: "string", description: 'A bandeira, se impressa ("Visa", "Mastercard", "Nubank").' },
+      cardLast4: { type: "string", description: 'Os quatro \xFAltimos d\xEDgitos do cart\xE3o, se impressos ("4242").' },
+      // O DOCUMENTO INTEIRO, lido UMA VEZ.
+      //
+      // Não é zelo: é onde a fabricação entrava. Extrair no passo 0 e extrair de
+      // novo no passo da conta são duas leituras do mesmo papel, e a segunda não
+      // tem o papel na frente — ela tem a memória da primeira, que é onde os
+      // números começam a escorregar. Lido aqui, normalizado aqui, conferido
+      // aqui, e as ferramentas seguintes CONSOMEM o que ficou guardado.
+      items: {
+        type: "array",
+        description: "As LINHAS da tabela do documento, uma por linha \u2014 leia linha a linha e copie TODAS.",
+        items: {
+          type: "object",
+          properties: {
+            description: { type: "string", description: "O que \xE9 a linha, como est\xE1 escrito." },
+            quantity: { type: "number", description: "A quantidade. 1 quando a tabela n\xE3o diz." },
+            unitPrice: { type: "string", description: 'Pre\xE7o UNIT\xC1RIO copiado ("47,90").' }
+          },
+          required: ["description", "unitPrice"]
+        }
+      },
+      shipping: { type: "string", description: 'O FRETE cobrado \xE0 parte, copiado ("52,19").' },
+      subtotal: { type: "string", description: 'O subtotal impresso, se houver ("1.437,00").' },
+      total: {
+        type: "string",
+        description: 'O TOTAL do rodap\xE9, copiado letra por letra ("1.489,19"). Com frete, sem converter.'
+      },
+      documentDate: { type: "string", description: 'A data do documento ("09/09/2026").' },
+      dueDate: {
+        type: "string",
+        description: 'O VENCIMENTO, s\xF3 se o papel disser. "Expira em" de um c\xF3digo Pix \xE9 a validade do C\xD3DIGO, n\xE3o vencimento: um pedido pago \xE0 vista n\xE3o tem, e a\xED se omite.'
+      },
+      paymentDate: { type: "string", description: "Quando foi pago, se o papel disser." },
+      orderRef: { type: "string", description: 'O n\xFAmero do pedido ou documento ("#164223").' },
+      deliveryDate: { type: "string", description: 'A data de entrega, se impressa ("11/09/2026").' }
+    }
+  }
+};
+var FILL_DRAFT = {
+  id: "financial.fill-payable-draft",
+  name: "fillPayableDraft",
+  description: "Fills a field of the payable form ALREADY OPEN on screen (the draft the person is looking at). Use this \u2014 not createPayable \u2014 whenever that form is open: it is the bill in progress, and writing a new one instead would leave the person staring at a draft that means nothing. Looks the supplier up by name and offers to create it when it does not exist yet. Saves nothing.",
+  icon: "PenLine",
+  mode: "read",
+  execution: { plane: "client" },
+  category: "Finance",
+  role: "finance",
+  parameters: {
+    type: "object",
+    properties: {
+      supplier: { type: "string", description: "O nome do fornecedor a colocar no rascunho." },
+      dueDate: { type: "string", description: 'O vencimento, como foi dito ("20/01/2026").' }
+    }
+  }
+};
+var SUBMIT_DRAFT = {
+  id: "financial.submit-payable-draft",
+  name: "submitPayableDraft",
+  description: `SAVES the payable form open on screen \u2014 the same thing the screen's save button does. This is how "salva", "pode salvar", "confirma" is answered while that form is open. Never call createPayable for a draft that is already on screen: that writes a second, duplicate bill.`,
+  icon: "Check",
+  mode: "persist",
+  execution: { plane: "client" },
+  requiresConfirmation: false,
+  category: "Finance",
+  role: "finance",
+  permission: { feature: "financial", action: "create" },
+  parameters: { type: "object", properties: {} }
+};
+function PayableDraftSurface({ config, draft }) {
+  const live = React15.useRef(draft);
+  live.current = draft;
+  const lookup = React15.useMemo(
+    () => config.contactLookup ?? createArchetypeLookup({ archetype: "person", kind: "supplier" }),
+    [config.contactLookup]
+  );
+  React15.useEffect(() => {
+    liveDraft = {
+      describe: () => live.current.describe(),
+      setSupplier: (name, id) => live.current.setSupplier(name, id),
+      setDueDate: (iso) => live.current.setDueDate(iso),
+      submit: () => live.current.submit()
+    };
+    return () => {
+      liveDraft = null;
+    };
+  }, []);
+  const contribution = React15.useMemo(() => ({
+    id: "financial.payables.draft",
+    pluginId: "financial",
+    role: "finance",
+    instructions: 'O cadastro de uma CONTA A PAGAR est\xE1 aberto na tela, com um rascunho que a pessoa est\xE1 conferindo. Enquanto ele estiver a\xED, ele \xC9 a conta em curso: use `fillPayableDraft` para completar o que falta e `submitPayableDraft` para salvar. N\xC3O chame `createPayable` \u2014 ela criaria uma segunda conta e deixaria a pessoa num rascunho \xF3rf\xE3o. O estado do rascunho est\xE1 em "Tela aberta agora".',
+    describe: () => {
+      const state = live.current.describe();
+      return {
+        title: "Cadastro \u2014 Conta a pagar (rascunho n\xE3o salvo)",
+        state: { screen: "/financial/payables/new", draft: state }
+      };
+    },
+    tools: [
       {
-        open: cancelTarget !== null,
-        variant: "destructive",
-        title: t2("financial.invoice.bulkCancelTitle", { count: String(cancelTarget?.length ?? 0) }),
-        description: t2("financial.invoice.cancelDesc"),
-        confirmLabel: t2("financial.invoice.yesCancel"),
-        cancelLabel: t2("financial.invoice.keepInvoice"),
-        loading: bulkBusy,
-        onConfirm: () => void confirmBulkCancel(),
-        onCancel: () => setCancelTarget(null)
+        tool: FILL_DRAFT,
+        execute: async (args) => {
+          const filled = [];
+          const dueDate = parseReceiptDate(args.dueDate);
+          if (dueDate) {
+            live.current.setDueDate(dueDate);
+            filled.push("dueDate");
+          }
+          const name = text(args.supplier);
+          if (name) {
+            const step = await resolveSupplier(lookup, name);
+            if (!step.ok) {
+              return {
+                ok: false,
+                cancelled: true,
+                reason: "user_declined_supplier",
+                message: "The supplier was not created, so the draft still has none. Ask which supplier it is."
+              };
+            }
+            live.current.setSupplier(step.name, step.id);
+            filled.push("supplier");
+          }
+          if (!filled.length) {
+            return { ok: false, error: "nothing_to_fill", message: "Send a supplier or a dueDate to fill in." };
+          }
+          return {
+            ok: true,
+            filled,
+            draft: live.current.describe(),
+            message: "O rascunho na tela foi preenchido \u2014 nada foi salvo ainda. Diga em UMA frase o que entrou e que basta confirmar. Quando a pessoa mandar salvar, chame submitPayableDraft."
+          };
+        }
+      },
+      {
+        tool: SUBMIT_DRAFT,
+        execute: async () => {
+          const before = live.current.describe();
+          if (!before.itemCount) {
+            return {
+              ok: false,
+              error: "empty_draft",
+              message: "NOTHING WAS SAVED. The draft has no line to bill. Say what is missing."
+            };
+          }
+          await live.current.submit();
+          return {
+            ok: true,
+            saved: true,
+            supplier: before.supplier,
+            total: before.total,
+            message: "A conta a pagar foi salva a partir do rascunho que estava na tela, e a ficha dela j\xE1 abriu. Diga isso em UMA frase e pare."
+          };
+        }
       }
-    )
-  ] });
+    ]
+  }), [lookup]);
+  useAgentSurface(contribution);
+  return null;
+}
+function createFinancialAgentMount(deps) {
+  const FinancialAgentMount = () => {
+    const contribution = React15.useMemo(() => ({
+      id: "financial.payables.global",
+      pluginId: "financial",
+      role: "finance",
+      instructions: PAYABLE_INSTRUCTIONS,
+      // Sem `describe`: esta superfície não é uma tela. O snapshot responde "o
+      // que está na tela agora", e um mount de shell que dissesse "Contas a
+      // pagar" mentiria em todas as outras rotas do app.
+      tools: createPayableTools(deps)
+    }), []);
+    useAgentSurface(contribution);
+    return null;
+  };
+  FinancialAgentMount.displayName = "FinancialAgentMount";
+  return FinancialAgentMount;
 }
 function useReceiptPicker(onPick) {
   const t2 = useTranslation();
@@ -910,7 +2258,7 @@ function useReceiptPicker(onPick) {
   );
   return { open: () => ref.current?.click(), input };
 }
-var ACCOUNT_TYPES_FOR_TX = {
+var ACCOUNT_TYPES_FOR_TX2 = {
   cash: ["cash_physical", "cash_session"],
   credit_card: ["card_receivable_credit"],
   debit_card: ["card_receivable_debit"],
@@ -966,6 +2314,8 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
   const [cardInstallments, setCardInstallments] = useState(1);
   const [notes, setNotes] = useState("");
   const [saving, setSaving] = useState(false);
+  const command = React15__default.useRef(createPendingCommand(() => createIdempotencyKey("financial:payment"), (input) => input.movementId));
+  const [pending2, setPending] = useState(false);
   const [visible, setVisible] = useState(false);
   const [expandMethodPicker, setExpandMethodPicker] = useState(true);
   useEffect(() => {
@@ -984,16 +2334,16 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
   );
   const needsCard = txType === "credit_card" || txType === "debit_card";
   const needsCardInstallments = txType === "credit_card";
-  const eligibleAccounts = useMemo(() => {
-    const allowed = selectedType?.allowedAccountTypes && selectedType.allowedAccountTypes.length ? selectedType.allowedAccountTypes : ACCOUNT_TYPES_FOR_TX[txType];
+  const eligibleAccounts2 = useMemo(() => {
+    const allowed = selectedType?.allowedAccountTypes && selectedType.allowedAccountTypes.length ? selectedType.allowedAccountTypes : ACCOUNT_TYPES_FOR_TX2[txType];
     if (!allowed || !allowed.length) return bankAccounts;
     return bankAccounts.filter((a) => allowed.includes(a.accountType));
   }, [bankAccounts, selectedType, txType]);
   useEffect(() => {
-    if (selectedTypeId && !bankAccountId && eligibleAccounts.length) {
-      setBankAccountId(eligibleAccounts[0].id);
+    if (selectedTypeId && !bankAccountId && eligibleAccounts2.length) {
+      setBankAccountId(eligibleAccounts2[0].id);
     }
-  }, [selectedTypeId, eligibleAccounts]);
+  }, [selectedTypeId, eligibleAccounts2]);
   function handleSelectType(typeId) {
     setSelectedTypeId(typeId);
     setExpandMethodPicker(false);
@@ -1003,6 +2353,7 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
     setCardInstallments(1);
   }
   function handleClose() {
+    if (command.current.pending || command.current.running) return;
     setVisible(false);
     setTimeout(onClose, 200);
   }
@@ -1012,15 +2363,17 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
     e.preventDefault();
     if (amount > 0 && selectedTypeId && bankAccountId && !saving) void handlePay();
   }
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void fetchCashSessions();
   }, [fetchCashSessions]);
   const needsOpenCashSession = txType === "cash" && !openSession;
   async function handlePay() {
-    if (amount <= 0 || !selectedTypeId || !bankAccountId || needsOpenCashSession) return;
+    if (command.current.running) return;
+    if (!command.current.pending && (amount <= 0 || !selectedTypeId || !bankAccountId || needsOpenCashSession)) return;
     setSaving(true);
+    setPending(true);
     try {
-      await payMovement({
+      await command.current.run({
         // O comprovante viaja com o pagamento — é dele que ele é prova.
         metadata: receiptUrl ? { receiptUrl } : void 0,
         movementId: movement.id,
@@ -1035,12 +2388,13 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
         cardBrand: needsCard ? cardBrand || void 0 : void 0,
         cardInstallments: needsCardInstallments ? cardInstallments : void 0,
         notes: notes.trim() || void 0
-      });
+      }, payMovement);
       setVisible(false);
       setTimeout(onPaid, 200);
     } catch {
     } finally {
       setSaving(false);
+      setPending(command.current.pending);
     }
   }
   const SelectedIcon = selectedType ? TYPE_ICONS[txType] ?? Banknote : null;
@@ -1073,7 +2427,8 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
                 ] }),
                 /* @__PURE__ */ jsx("button", { onClick: handleClose, className: "p-1 text-muted-foreground hover:text-foreground transition-colors", children: /* @__PURE__ */ jsx(X, { className: "h-4 w-4" }) })
               ] }),
-              /* @__PURE__ */ jsxs("div", { className: "px-5 py-4 space-y-4", children: [
+              pending2 && /* @__PURE__ */ jsx("p", { role: "status", className: "px-5 pt-4 text-sm text-warning", children: t2("financial.payment.pendingRetry") }),
+              /* @__PURE__ */ jsxs("fieldset", { disabled: pending2, className: "px-5 py-4 space-y-4", children: [
                 /* @__PURE__ */ jsxs("div", { children: [
                   /* @__PURE__ */ jsx("label", { className: "text-xs font-medium text-muted-foreground", children: t2("financial.payment.method") }),
                   /* @__PURE__ */ jsx(
@@ -1179,7 +2534,7 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
                   ] }),
                   /* @__PURE__ */ jsxs("div", { className: "stagger-field", style: { animationDelay: "100ms" }, children: [
                     /* @__PURE__ */ jsx("label", { className: "text-xs font-medium text-muted-foreground", children: t2("financial.payment.bankAccount") }),
-                    eligibleAccounts.length === 0 ? /* @__PURE__ */ jsxs("div", { className: "mt-1 rounded-lg border border-dashed border-input bg-muted/30 px-3 py-2.5 text-center", children: [
+                    eligibleAccounts2.length === 0 ? /* @__PURE__ */ jsxs("div", { className: "mt-1 rounded-lg border border-dashed border-input bg-muted/30 px-3 py-2.5 text-center", children: [
                       /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: bankAccounts.length > 0 && selectedType ? t2("financial.payment.noAccountForMethod", { method: selectedType.name }) : t2("financial.payment.noAccounts") }),
                       /* @__PURE__ */ jsxs("a", { href: "#/settings/financial/bank-accounts", className: "mt-1 inline-block text-xs font-medium text-primary hover:underline", children: [
                         t2("financial.payment.configureAccounts"),
@@ -1187,7 +2542,7 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
                       ] })
                     ] }) : /* @__PURE__ */ jsxs("select", { value: bankAccountId, onChange: (e) => setBankAccountId(e.target.value), className: "w-full mt-1 rounded-input border border-input  bg-card shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] px-3 py-2 text-sm", children: [
                       /* @__PURE__ */ jsx("option", { value: "", children: t2("financial.payment.selectAccount") }),
-                      eligibleAccounts.map((a) => /* @__PURE__ */ jsx("option", { value: a.id, children: a.name }, a.id))
+                      eligibleAccounts2.map((a) => /* @__PURE__ */ jsx("option", { value: a.id, children: a.name }, a.id))
                     ] })
                   ] }),
                   /* @__PURE__ */ jsxs("div", { className: "stagger-field", style: { animationDelay: "150ms" }, children: [
@@ -1206,14 +2561,14 @@ function PaymentModal({ movement, receiptUrl, onClose, onPaid }) {
           }
         ` }),
               /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2 px-5 py-4 border-t sticky bottom-0 bg-card", children: [
-                /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: handleClose, children: t2("financial.payment.cancel") }),
+                /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: handleClose, disabled: pending2 || saving, children: t2("financial.payment.cancel") }),
                 /* @__PURE__ */ jsxs(
                   Button,
                   {
                     variant: "default",
                     size: "sm",
                     onClick: handlePay,
-                    disabled: amount <= 0 || !selectedTypeId || !bankAccountId || needsOpenCashSession || saving,
+                    disabled: saving || !pending2 && (amount <= 0 || !selectedTypeId || !bankAccountId || needsOpenCashSession),
                     children: [
                       /* @__PURE__ */ jsx(Check, { className: "h-3.5 w-3.5" }),
                       saving ? t2("financial.payment.processing") : t2("financial.payment.payAmount", { amount: formatCurrency(amount, currency) })
@@ -1318,7 +2673,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
   const t2 = useTranslation();
   const config = useFinancialConfig();
   const { currency, itemTypes: itemTypesRaw, locations } = config;
-  const itemTypes = React14__default.useMemo(
+  const itemTypes = React15__default.useMemo(
     () => itemTypesRaw.map((tp) => {
       const traduzido = t2(`financial.itemType.${tp.value}`);
       return traduzido === `financial.itemType.${tp.value}` ? tp : { ...tp, label: traduzido };
@@ -1355,6 +2710,14 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
       cancelled = true;
     };
   }, [provider]);
+  const contactLookup = useMemo(
+    () => config.contactLookup ?? createArchetypeLookup({
+      archetype: "person",
+      kind: direction === "debit" ? "supplier" : "customer",
+      kindLabels: { supplier: "Fornecedor", customer: "Cliente" }
+    }),
+    [config.contactLookup, direction]
+  );
   const [loaded, setLoaded] = useState(!editId);
   const [loading, setLoading] = useState(!!editId);
   const [contactName, setContactName] = useState("");
@@ -1373,7 +2736,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
   const [savedMovements, setSavedMovements] = useState([]);
   const [payingMovement, setPayingMovement] = useState(null);
   const [pendingReceipt, setPendingReceipt] = useState();
-  const contactCreate = useLookupCreate(config.contactLookup, (created) => {
+  const contactCreate = useLookupCreate(contactLookup, (created) => {
     setContactId(created.id);
     setContactName(created.label);
     setPendingContact(null);
@@ -1397,8 +2760,15 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
   const [menuOpen, setMenuOpen] = useState(false);
   const [confirmCancel, setConfirmCancel] = useState(false);
   const [cancelling, setCancelling] = useState(false);
+  const [cancelReason, setCancelReason] = useState("");
+  const cancelRequestKey = useRef(createIdempotencyKey("financial:invoice-cancel"));
   const menuRef = useRef(null);
   const cancelInvoice = useFinancialStore((s) => s.cancelInvoice);
+  function closeCancelDialog() {
+    setConfirmCancel(false);
+    setCancelReason("");
+    cancelRequestKey.current = createIdempotencyKey("financial:invoice-cancel");
+  }
   useEffect(() => {
     if (!menuOpen) return;
     function handleClick(e) {
@@ -1411,7 +2781,11 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
     if (!editId) return;
     setCancelling(true);
     try {
-      await cancelInvoice(editId);
+      await cancelInvoice({
+        invoiceId: editId,
+        reason: cancelReason,
+        idempotencyKey: cancelRequestKey.current
+      });
       onSaved?.();
     } catch {
     } finally {
@@ -1505,13 +2879,13 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
     if (isEdit || totalAmount <= 0 || installments.length > 0) return;
     generateInstallments(1);
   }, [isEdit, totalAmount, installments.length]);
-  const fromCard = React14__default.useMemo(
+  const fromCard = React15__default.useMemo(
     () => fromCardId ? bankAccounts.find((a) => a.id === fromCardId) : void 0,
     [fromCardId, bankAccounts]
   );
   const cardLast4 = (fromCard?.accountNumber ?? "").replace(/\D/g, "").slice(-4);
   const nomeJaTemOsDigitos = !!cardLast4 && (fromCard?.name ?? "").replace(/\D/g, "").endsWith(cardLast4);
-  const cardMethodName = React14__default.useMemo(() => {
+  const cardMethodName = React15__default.useMemo(() => {
     const id = installments[0]?.payMethodTypeId;
     const escolhida = id ? paymentMethodTypes.find((tp) => tp.id === id) : void 0;
     return (escolhida ?? paymentMethodTypes.find((tp) => tp.transactionType === "credit_card"))?.name;
@@ -1535,21 +2909,31 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
     if (draft.supplier) {
       setContactName(draft.supplier);
       void (async () => {
-        const hit = (await config.contactLookup?.search(draft.supplier).catch(() => []))?.find((r) => r.label.trim().toLowerCase() === draft.supplier.trim().toLowerCase());
+        const hit = (await contactLookup.search(draft.supplier).catch(() => []))?.find((r) => r.label.trim().toLowerCase() === draft.supplier.trim().toLowerCase());
         if (hit) {
           setContactId(hit.id);
           setContactName(hit.label);
         } else setPendingContact(draft.supplier);
       })();
     }
-    const itemId = fid();
-    setItems([{
-      _id: itemId,
-      itemKind: "other",
-      description: draft.description ?? draft.supplier ?? "",
-      quantity: 1,
-      unitPrice: draft.amount
-    }]);
+    setItems(
+      draft.items?.length ? [
+        ...draft.items.map((line) => ({
+          _id: fid(),
+          itemKind: "other",
+          description: line.description,
+          quantity: line.quantity,
+          unitPrice: line.unitPrice
+        })),
+        ...draft.shipping ? [{ _id: fid(), itemKind: "other", description: "Frete", quantity: 1, unitPrice: draft.shipping }] : []
+      ] : [{
+        _id: fid(),
+        itemKind: "other",
+        description: draft.description ?? draft.supplier ?? "",
+        quantity: 1,
+        unitPrice: draft.amount - (draft.shipping ?? 0)
+      }]
+    );
     setInstallments([{ _id: fid(), amount: draft.amount, dueDate: draft.date ?? invoiceDate }]);
     if (draft.receiptUrl) setPendingReceipt(draft.receiptUrl);
   }, [isEdit]);
@@ -1651,7 +3035,8 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
               amount: bill.amount,
               paymentDate: inst.dueDate,
               paymentMethodTypeId: inst.payMethodTypeId || void 0,
-              bankAccountId: inst.payAccountId || void 0
+              bankAccountId: inst.payAccountId || void 0,
+              idempotencyKey: `financial:invoice:${invoice.id}:installment:${bill.id}:receipt`
             });
           }
         }
@@ -1712,130 +3097,133 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
   ] }) : null;
   const paidSoFar = savedMovements.reduce((sum, m) => sum + (m.paidAmount ?? 0), 0);
   const hasPayments = paidSoFar > 0;
-  const scheduleSection = /* @__PURE__ */ jsx(OrderFormBlock, { title: t2("financial.invoice.paymentSchedule"), children: /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
-    hasPayments ? /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t2("financial.invoiceForm.scheduleLocked") }) : (
-      // Atalhos de parcelamento — 1x, 2x, 3x, 6x, 12x cobrem quase tudo.
-      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: [1, 2, 3, 6, 12].map((n) => /* @__PURE__ */ jsxs(
-        "button",
-        {
-          type: "button",
-          onClick: () => generateInstallments(n),
-          disabled: totalAmount <= 0,
-          className: `rounded-full px-2.5 py-1 text-[10px] font-medium transition-colors disabled:opacity-30 ${installments.length === n ? "bg-primary text-primary-foreground" : "bg-muted text-muted-foreground hover:bg-muted/80"}`,
-          children: [
-            n,
-            "x"
-          ]
-        },
-        n
-      )) })
-    ),
-    installments.length === 0 ? /* @__PURE__ */ jsx("p", { className: "py-4 text-center text-xs text-muted-foreground", children: totalAmount <= 0 ? t2("financial.invoiceForm.addItemsFirst") : t2("financial.invoiceForm.selectInstallments") }) : /* @__PURE__ */ jsx("div", { className: "divide-y rounded border", children: installments.map((inst, i) => {
-      const patch = (next) => {
-        const updated = [...installments];
-        updated[i] = { ...inst, ...next };
-        setInstallments(updated);
-      };
-      const saved = savedMovements[i];
-      const isPaid = saved?.status === "paid";
-      const isPartial = saved?.status === "partial";
-      const StatusIcon = isPaid ? CircleCheckBig : CircleDashed;
-      const canAttach = isEdit ? !!saved && !isPaid : true;
-      return /* @__PURE__ */ jsxs("div", { children: [
-        /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3 px-3 py-2", children: [
-          /* @__PURE__ */ jsxs("span", { className: "w-6 shrink-0 text-xs font-medium text-muted-foreground", children: [
-            "#",
-            i + 1
-          ] }),
-          /* @__PURE__ */ jsx("span", { className: "shrink-0 text-sm font-semibold tabular-nums", children: money3(inst.amount) }),
-          saved && /* @__PURE__ */ jsxs("span", { className: `inline-flex shrink-0 items-center gap-1 rounded-full px-1.5 py-0.5 text-[10px] font-medium ${isPaid ? "bg-success-soft text-success-soft-foreground" : isPartial ? "bg-warning-soft text-warning-soft-foreground" : "bg-muted text-muted-foreground"}`, children: [
-            /* @__PURE__ */ jsx(StatusIcon, { className: "h-2.5 w-2.5" }),
-            t2(isPaid ? "financial.invoice.statusPaid" : isPartial ? "financial.invoice.statusPartial" : "financial.invoice.statusPending")
+  const scheduleSection = (
+    // Tour anchor: the guided setup points here for the installment schedule.
+    /* @__PURE__ */ jsx("div", { ...tourAnchor("financial.installments"), children: /* @__PURE__ */ jsx(OrderFormBlock, { title: t2("financial.invoice.paymentSchedule"), children: /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+      hasPayments ? /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: t2("financial.invoiceForm.scheduleLocked") }) : (
+        // Atalhos de parcelamento — 1x, 2x, 3x, 6x, 12x cobrem quase tudo.
+        /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: [1, 2, 3, 6, 12].map((n) => /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => generateInstallments(n),
+            disabled: totalAmount <= 0,
+            className: `rounded-full px-2.5 py-1 text-[10px] font-medium transition-colors disabled:opacity-30 ${installments.length === n ? "bg-primary text-primary-foreground" : "bg-muted text-muted-foreground hover:bg-muted/80"}`,
+            children: [
+              n,
+              "x"
+            ]
+          },
+          n
+        )) })
+      ),
+      installments.length === 0 ? /* @__PURE__ */ jsx("p", { className: "py-4 text-center text-xs text-muted-foreground", children: totalAmount <= 0 ? t2("financial.invoiceForm.addItemsFirst") : t2("financial.invoiceForm.selectInstallments") }) : /* @__PURE__ */ jsx("div", { className: "divide-y rounded border", children: installments.map((inst, i) => {
+        const patch = (next) => {
+          const updated = [...installments];
+          updated[i] = { ...inst, ...next };
+          setInstallments(updated);
+        };
+        const saved = savedMovements[i];
+        const isPaid = saved?.status === "paid";
+        const isPartial = saved?.status === "partial";
+        const StatusIcon = isPaid ? CircleCheckBig : CircleDashed;
+        const canAttach = isEdit ? !!saved && !isPaid : true;
+        return /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3 px-3 py-2", children: [
+            /* @__PURE__ */ jsxs("span", { className: "w-6 shrink-0 text-xs font-medium text-muted-foreground", children: [
+              "#",
+              i + 1
+            ] }),
+            /* @__PURE__ */ jsx("span", { className: "shrink-0 text-sm font-semibold tabular-nums", children: money3(inst.amount) }),
+            saved && /* @__PURE__ */ jsxs("span", { className: `inline-flex shrink-0 items-center gap-1 rounded-full px-1.5 py-0.5 text-[10px] font-medium ${isPaid ? "bg-success-soft text-success-soft-foreground" : isPartial ? "bg-warning-soft text-warning-soft-foreground" : "bg-muted text-muted-foreground"}`, children: [
+              /* @__PURE__ */ jsx(StatusIcon, { className: "h-2.5 w-2.5" }),
+              t2(isPaid ? "financial.invoice.statusPaid" : isPartial ? "financial.invoice.statusPartial" : "financial.invoice.statusPending")
+            ] }),
+            /* @__PURE__ */ jsxs("div", { className: "ml-auto flex items-center gap-1.5", children: [
+              !hasPayments ? /* @__PURE__ */ jsx(
+                DatePicker,
+                {
+                  value: inst.dueDate,
+                  variant: "chip",
+                  onChange: (v) => patch({ dueDate: v })
+                }
+              ) : /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: inst.dueDate }),
+              canAttach && /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => {
+                    if (!inst.receiptUrl && pendingReceipt) {
+                      patch({ receiptUrl: pendingReceipt });
+                      setPendingReceipt(void 0);
+                      return;
+                    }
+                    setReceiptTarget(i);
+                    receiptPicker.open();
+                  },
+                  title: !inst.receiptUrl && pendingReceipt ? t2("financial.receipt.attachRead") : t2("financial.quickTx.receiptCapture"),
+                  "aria-label": !inst.receiptUrl && pendingReceipt ? t2("financial.receipt.attachRead") : t2("financial.quickTx.receiptCapture"),
+                  className: `flex h-7 w-7 shrink-0 items-center justify-center rounded-md transition-colors ${inst.receiptUrl ? "text-success hover:bg-success-soft" : pendingReceipt ? "text-primary hover:bg-primary/10" : "text-muted-foreground hover:bg-muted hover:text-foreground"}`,
+                  children: inst.receiptUrl ? /* @__PURE__ */ jsx(Paperclip, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(Camera, { className: "h-3.5 w-3.5" })
+                }
+              ),
+              saved && !isPaid && /* @__PURE__ */ jsxs(Button, { size: "sm", variant: "outline", onClick: () => setPayingMovement(saved), children: [
+                /* @__PURE__ */ jsx(DollarSign, { className: "mr-1 h-3.5 w-3.5" }),
+                t2("financial.invoice.pay")
+              ] })
+            ] })
           ] }),
-          /* @__PURE__ */ jsxs("div", { className: "ml-auto flex items-center gap-1.5", children: [
-            !hasPayments ? /* @__PURE__ */ jsx(
-              DatePicker,
+          !isEdit && inst.receiptUrl && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2 border-t bg-muted/20 px-3 py-2", children: [
+            /* @__PURE__ */ jsx(
+              "img",
+              {
+                src: inst.receiptUrl,
+                alt: t2("financial.quickTx.receipt"),
+                className: "h-8 w-8 shrink-0 rounded border object-cover"
+              }
+            ),
+            /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[10px] font-medium text-success", children: t2("financial.invoiceForm.willBePaid") }),
+            /* @__PURE__ */ jsxs(
+              "select",
+              {
+                value: inst.payMethodTypeId ?? "",
+                onChange: (e) => patch({ payMethodTypeId: e.target.value }),
+                className: "min-w-[8rem] flex-1 rounded-input border border-input bg-card px-2 py-1 text-xs shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring",
+                children: [
+                  /* @__PURE__ */ jsx("option", { value: "", children: t2("financial.invoiceForm.selectMethod") }),
+                  paymentMethodTypes.map((tp) => /* @__PURE__ */ jsx("option", { value: tp.id, children: tp.name }, tp.id))
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsxs(
+              "select",
               {
-                value: inst.dueDate,
-                variant: "chip",
-                onChange: (v) => patch({ dueDate: v })
+                value: inst.payAccountId ?? (bankAccounts.length === 1 ? bankAccounts[0].id : ""),
+                onChange: (e) => patch({ payAccountId: e.target.value }),
+                className: "min-w-[8rem] flex-1 rounded-input border border-input bg-card px-2 py-1 text-xs shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring",
+                children: [
+                  /* @__PURE__ */ jsx("option", { value: "", children: t2("financial.invoiceForm.selectAccount") }),
+                  bankAccounts.map((a) => /* @__PURE__ */ jsx("option", { value: a.id, children: a.name }, a.id))
+                ]
               }
-            ) : /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: inst.dueDate }),
-            canAttach && /* @__PURE__ */ jsx(
+            ),
+            /* @__PURE__ */ jsx(
               "button",
               {
                 type: "button",
-                onClick: () => {
-                  if (!inst.receiptUrl && pendingReceipt) {
-                    patch({ receiptUrl: pendingReceipt });
-                    setPendingReceipt(void 0);
-                    return;
-                  }
-                  setReceiptTarget(i);
-                  receiptPicker.open();
-                },
-                title: !inst.receiptUrl && pendingReceipt ? t2("financial.receipt.attachRead") : t2("financial.quickTx.receiptCapture"),
-                "aria-label": !inst.receiptUrl && pendingReceipt ? t2("financial.receipt.attachRead") : t2("financial.quickTx.receiptCapture"),
-                className: `flex h-7 w-7 shrink-0 items-center justify-center rounded-md transition-colors ${inst.receiptUrl ? "text-success hover:bg-success-soft" : pendingReceipt ? "text-primary hover:bg-primary/10" : "text-muted-foreground hover:bg-muted hover:text-foreground"}`,
-                children: inst.receiptUrl ? /* @__PURE__ */ jsx(Paperclip, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(Camera, { className: "h-3.5 w-3.5" })
+                onClick: () => patch({ receiptUrl: void 0, payMethodTypeId: void 0, payAccountId: void 0 }),
+                "aria-label": t2("financial.quickTx.receiptRemove"),
+                className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground",
+                children: /* @__PURE__ */ jsx(X, { className: "h-3.5 w-3.5" })
               }
-            ),
-            saved && !isPaid && /* @__PURE__ */ jsxs(Button, { size: "sm", variant: "outline", onClick: () => setPayingMovement(saved), children: [
-              /* @__PURE__ */ jsx(DollarSign, { className: "mr-1 h-3.5 w-3.5" }),
-              t2("financial.invoice.pay")
-            ] })
+            )
           ] })
-        ] }),
-        !isEdit && inst.receiptUrl && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2 border-t bg-muted/20 px-3 py-2", children: [
-          /* @__PURE__ */ jsx(
-            "img",
-            {
-              src: inst.receiptUrl,
-              alt: t2("financial.quickTx.receipt"),
-              className: "h-8 w-8 shrink-0 rounded border object-cover"
-            }
-          ),
-          /* @__PURE__ */ jsx("span", { className: "shrink-0 text-[10px] font-medium text-success", children: t2("financial.invoiceForm.willBePaid") }),
-          /* @__PURE__ */ jsxs(
-            "select",
-            {
-              value: inst.payMethodTypeId ?? "",
-              onChange: (e) => patch({ payMethodTypeId: e.target.value }),
-              className: "min-w-[8rem] flex-1 rounded-input border border-input bg-card px-2 py-1 text-xs shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring",
-              children: [
-                /* @__PURE__ */ jsx("option", { value: "", children: t2("financial.invoiceForm.selectMethod") }),
-                paymentMethodTypes.map((tp) => /* @__PURE__ */ jsx("option", { value: tp.id, children: tp.name }, tp.id))
-              ]
-            }
-          ),
-          /* @__PURE__ */ jsxs(
-            "select",
-            {
-              value: inst.payAccountId ?? (bankAccounts.length === 1 ? bankAccounts[0].id : ""),
-              onChange: (e) => patch({ payAccountId: e.target.value }),
-              className: "min-w-[8rem] flex-1 rounded-input border border-input bg-card px-2 py-1 text-xs shadow-[inset_0_1px_0_rgb(0_0_0_/0.06)] focus:outline-none focus:ring-2 focus:ring-ring",
-              children: [
-                /* @__PURE__ */ jsx("option", { value: "", children: t2("financial.invoiceForm.selectAccount") }),
-                bankAccounts.map((a) => /* @__PURE__ */ jsx("option", { value: a.id, children: a.name }, a.id))
-              ]
-            }
-          ),
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              onClick: () => patch({ receiptUrl: void 0, payMethodTypeId: void 0, payAccountId: void 0 }),
-              "aria-label": t2("financial.quickTx.receiptRemove"),
-              className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground",
-              children: /* @__PURE__ */ jsx(X, { className: "h-3.5 w-3.5" })
-            }
-          )
-        ] })
-      ] }, inst._id);
-    }) })
-  ] }) });
+        ] }, inst._id);
+      }) })
+    ] }) }) })
+  );
   const sideSections = /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsxs(OrderFormBlock, { title: direction === "debit" ? t2("financial.invoiceForm.payTo") : t2("financial.invoiceForm.receiveFrom"), children: [
+    /* @__PURE__ */ jsx("div", { ...tourAnchor("financial.contact"), children: /* @__PURE__ */ jsxs(OrderFormBlock, { title: direction === "debit" ? t2("financial.invoiceForm.payTo") : t2("financial.invoiceForm.receiveFrom"), children: [
       /* @__PURE__ */ jsx(
         SearchSelect,
         {
@@ -1848,8 +3236,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
             setPendingContact(null);
           },
           onSearch: async (q) => {
-            if (!config.contactLookup) return [];
-            const results = await config.contactLookup.search(q);
+            const results = await contactLookup.search(q);
             return results.map((r) => ({ id: r.id, label: r.label, subtitle: r.subtitle, group: r.group, data: r }));
           },
           createLabel: t2("financial.invoiceForm.createContact"),
@@ -1878,7 +3265,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
         )
       ] }),
       contactCreate.modal
-    ] }),
+    ] }) }),
     /* @__PURE__ */ jsx(OrderFormBlock, { title: t2("financial.invoice.details"), children: /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
       hasLocations && /* @__PURE__ */ jsx(LocationSelector, { locations, value: unitId, onChange: setUnitId }),
       /* @__PURE__ */ jsxs("div", { children: [
@@ -1911,6 +3298,29 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
     ) })
   ] });
   return /* @__PURE__ */ jsxs(Fragment, { children: [
+    !isEdit && direction === "debit" && /* @__PURE__ */ jsx(
+      PayableDraftSurface,
+      {
+        config,
+        draft: {
+          describe: () => ({
+            supplier: contactName || void 0,
+            supplierResolved: !!contactId,
+            description: items.map((i) => i.description).filter(Boolean).join(", ") || void 0,
+            total: totalAmount,
+            dueDate: installments[0]?.dueDate,
+            itemCount: items.length
+          }),
+          setSupplier: (name, id) => {
+            setContactName(name);
+            setContactId(id);
+            setPendingContact(id ? null : name);
+          },
+          setDueDate: (iso) => setInstallments((prev) => prev.map((inst, i) => i === 0 ? { ...inst, dueDate: iso } : inst)),
+          submit: handleSave
+        }
+      }
+    ),
     fromCard && /* @__PURE__ */ jsxs("div", { className: "mb-4 flex items-center gap-3 rounded-card border bg-card px-4 py-3", children: [
       /* @__PURE__ */ jsx(
         "span",
@@ -1944,6 +3354,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
           /* @__PURE__ */ jsx(
             OrderFormItemsCard,
             {
+              "data-tour": "financial.items",
               label: t2("financial.invoiceForm.items"),
               addLabel: t2("financial.invoiceForm.addItem"),
               onAdd: startAddItem,
@@ -2085,7 +3496,7 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
       }
     ),
     confirmCancel && createPortal(
-      /* @__PURE__ */ jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/50", onClick: () => setConfirmCancel(false), children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-sm rounded-modal border bg-card shadow-lg mx-4 p-5", onClick: (e) => e.stopPropagation(), style: { animation: "field-slide-in 200ms ease-out" }, children: [
+      /* @__PURE__ */ jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/50", onClick: closeCancelDialog, children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-sm rounded-modal border bg-card shadow-lg mx-4 p-5", onClick: (e) => e.stopPropagation(), style: { animation: "field-slide-in 200ms ease-out" }, children: [
         /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-3", children: [
           /* @__PURE__ */ jsx("div", { className: "flex h-10 w-10 items-center justify-center rounded-full bg-destructive/10 shrink-0", children: /* @__PURE__ */ jsx(Ban, { className: "h-5 w-5 text-destructive" }) }),
           /* @__PURE__ */ jsxs("div", { children: [
@@ -2094,9 +3505,21 @@ function InvoiceFormView({ direction, editId, onSaved, focusReceipt = false, fro
           ] })
         ] }),
         /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground mb-4", children: t2("financial.invoiceForm.cancelDesc") }),
+        /* @__PURE__ */ jsx("label", { className: "block text-xs font-medium mb-1", htmlFor: "invoice-form-cancel-reason", children: t2("financial.invoice.cancelReason") }),
+        /* @__PURE__ */ jsx(
+          "textarea",
+          {
+            id: "invoice-form-cancel-reason",
+            value: cancelReason,
+            onChange: (event) => setCancelReason(event.target.value),
+            placeholder: t2("financial.invoice.cancelReasonPlaceholder"),
+            className: "mb-4 min-h-20 w-full resize-y rounded-md border bg-background px-3 py-2 text-sm",
+            autoFocus: true
+          }
+        ),
         /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
-          /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: () => setConfirmCancel(false), children: t2("financial.invoiceForm.keepInvoice") }),
-          /* @__PURE__ */ jsxs(Button, { variant: "destructive", size: "sm", onClick: handleCancelInvoice, disabled: cancelling, children: [
+          /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: closeCancelDialog, children: t2("financial.invoiceForm.keepInvoice") }),
+          /* @__PURE__ */ jsxs(Button, { variant: "destructive", size: "sm", onClick: handleCancelInvoice, disabled: cancelling || !cancelReason.trim(), children: [
             /* @__PURE__ */ jsx(Ban, { className: "h-3.5 w-3.5" }),
             cancelling ? t2("financial.invoiceForm.cancelling") : t2("financial.invoiceForm.yesCancel")
           ] })
@@ -2180,8 +3603,15 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
   const [menuOpen, setMenuOpen] = useState(false);
   const [confirmCancel, setConfirmCancel] = useState(false);
   const [cancelling, setCancelling] = useState(false);
+  const [cancelReason, setCancelReason] = useState("");
+  const cancelRequestKey = useRef(createIdempotencyKey("financial:invoice-cancel"));
   const menuRef = useRef(null);
   const cancelInvoice = useFinancialStore((s) => s.cancelInvoice);
+  function closeCancelDialog() {
+    setConfirmCancel(false);
+    setCancelReason("");
+    cancelRequestKey.current = createIdempotencyKey("financial:invoice-cancel");
+  }
   async function loadData() {
     setLoading(true);
     const [inv, invItems, movResult] = await Promise.all([
@@ -2204,6 +3634,9 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
   useEffect(() => {
     loadData();
   }, [invoiceId]);
+  useDataChanged({ table: T.movements }, () => {
+    void loadData();
+  }, [invoiceId, direction]);
   useEffect(() => {
     if (!menuOpen) return;
     function handleClick(e) {
@@ -2227,9 +3660,13 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
   async function handleCancel() {
     setCancelling(true);
     try {
-      await cancelInvoice(invoiceId);
+      await cancelInvoice({
+        invoiceId,
+        reason: cancelReason,
+        idempotencyKey: cancelRequestKey.current
+      });
       await loadData();
-      setConfirmCancel(false);
+      closeCancelDialog();
       setMenuOpen(false);
     } catch {
     } finally {
@@ -2317,6 +3754,7 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
         badges: [{ label: t2(statusConfig.labelKey), tone: statusConfig.tone }],
         onBack,
         backLabel: parentLabel,
+        meta: invoice,
         actions,
         stats: [
           { id: "total", label: t2("financial.invoice.total"), value: formatCurrency(invoice.totalAmount, currency), icon: DollarSign },
@@ -2577,7 +4015,7 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
       }
     ),
     confirmCancel && createPortal(
-      /* @__PURE__ */ jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/50", onClick: () => setConfirmCancel(false), children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-sm rounded-modal border bg-card shadow-lg mx-4 p-5", onClick: (e) => e.stopPropagation(), style: { animation: "field-slide-in 200ms ease-out" }, children: [
+      /* @__PURE__ */ jsx("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-black/50", onClick: closeCancelDialog, children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-sm rounded-modal border bg-card shadow-lg mx-4 p-5", onClick: (e) => e.stopPropagation(), style: { animation: "field-slide-in 200ms ease-out" }, children: [
         /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-3", children: [
           /* @__PURE__ */ jsx("div", { className: "flex h-10 w-10 items-center justify-center rounded-full bg-destructive/10 shrink-0", children: /* @__PURE__ */ jsx(Ban, { className: "h-5 w-5 text-destructive" }) }),
           /* @__PURE__ */ jsxs("div", { children: [
@@ -2586,9 +4024,21 @@ function InvoiceDetailView({ invoiceId, direction, onBack, onEdit, backLabel })
           ] })
         ] }),
         /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground mb-4", children: t2("financial.invoice.cancelDesc") }),
+        /* @__PURE__ */ jsx("label", { className: "block text-xs font-medium mb-1", htmlFor: "invoice-cancel-reason", children: t2("financial.invoice.cancelReason") }),
+        /* @__PURE__ */ jsx(
+          "textarea",
+          {
+            id: "invoice-cancel-reason",
+            value: cancelReason,
+            onChange: (event) => setCancelReason(event.target.value),
+            placeholder: t2("financial.invoice.cancelReasonPlaceholder"),
+            className: "mb-4 min-h-20 w-full resize-y rounded-md border bg-background px-3 py-2 text-sm",
+            autoFocus: true
+          }
+        ),
         /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
-          /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: () => setConfirmCancel(false), children: t2("financial.invoice.keepInvoice") }),
-          /* @__PURE__ */ jsxs(Button, { variant: "destructive", size: "sm", onClick: handleCancel, disabled: cancelling, children: [
+          /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: closeCancelDialog, children: t2("financial.invoice.keepInvoice") }),
+          /* @__PURE__ */ jsxs(Button, { variant: "destructive", size: "sm", onClick: handleCancel, disabled: cancelling || !cancelReason.trim(), children: [
             /* @__PURE__ */ jsx(Ban, { className: "h-3.5 w-3.5" }),
             cancelling ? t2("financial.invoice.cancelling") : t2("financial.invoice.yesCancel")
           ] })
@@ -2948,6 +4398,7 @@ function CashOpeningPanel({
     /* @__PURE__ */ jsxs(
       "button",
       {
+        "data-tour": "financial.cash-open",
         onClick: () => setConfirming(true),
         disabled: effectiveBalance < 0,
         className: "inline-flex items-center gap-1.5 rounded-button bg-primary border border-primary px-4 py-1.5 text-xs font-medium text-primary-foreground hover:bg-primary/90 shadow-button-primary active:shadow-button-inset transition-colors disabled:opacity-50",
@@ -3094,7 +4545,7 @@ function ReviewQueue({ variant }) {
   const me = user?.id ?? null;
   const [busy, setBusy] = useState(null);
   const [error, setError] = useState(null);
-  const load = React14__default.useCallback(async () => {
+  const load = React15__default.useCallback(async () => {
     try {
       setError(null);
       setRows(await provider.getCashSessionReviews?.() ?? []);
@@ -3252,6 +4703,7 @@ function CashRegistersView({ variant = "page" } = {}) {
         expandedClosing === session.id ? /* @__PURE__ */ jsx(CashClosingPanel, { session, currency, onClose: handleClose }) : /* @__PURE__ */ jsxs(
           "button",
           {
+            "data-tour": "financial.cash-close",
             onClick: () => setExpandedClosing(session.id),
             className: "inline-flex items-center gap-1.5 text-xs text-destructive hover:text-destructive font-medium transition-colors",
             children: [
@@ -3706,7 +5158,7 @@ function StatementsView({ onNavigate }) {
           about: "A movimenta\xE7\xE3o de uma conta por vez: cr\xE9ditos, d\xE9bitos e transfer\xEAncias no per\xEDodo. \xC9 tamb\xE9m de onde sai a transfer\xEAncia entre duas contas."
         }
       ),
-      /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => setShowTransfer(true), disabled: bankAccounts.length < 2, children: [
+      /* @__PURE__ */ jsxs(Button, { size: "sm", onClick: () => setShowTransfer(true), disabled: bankAccounts.length < 2, children: [
         /* @__PURE__ */ jsx(ArrowRightLeft, { className: "h-3.5 w-3.5" }),
         t2("financial.statements.newTransfer")
       ] })
@@ -3797,7 +5249,7 @@ function firstOfMonth() {
   d.setDate(1);
   return d.toISOString().slice(0, 10);
 }
-function today() {
+function today2() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
 function money(v) {
@@ -3817,14 +5269,14 @@ function CommissionsView() {
   const fetchCommissions = useFinancialStore((s) => s.fetchCommissions);
   const generateCommissions = useFinancialStore((s) => s.generateCommissions);
   const provider = useFinancialProvider();
-  const [from, setFrom] = React14__default.useState(firstOfMonth());
-  const [to, setTo] = React14__default.useState(today());
-  const [running, setRunning] = React14__default.useState(false);
-  const [lastRun, setLastRun] = React14__default.useState(null);
-  const [generation, setGeneration] = React14__default.useState(null);
-  const [busy, setBusy] = React14__default.useState(null);
-  const [error, setError] = React14__default.useState(null);
-  const loadGeneration = React14__default.useCallback(async () => {
+  const [from, setFrom] = React15__default.useState(firstOfMonth());
+  const [to, setTo] = React15__default.useState(today2());
+  const [running, setRunning] = React15__default.useState(false);
+  const [lastRun, setLastRun] = React15__default.useState(null);
+  const [generation, setGeneration] = React15__default.useState(null);
+  const [busy, setBusy] = React15__default.useState(null);
+  const [error, setError] = React15__default.useState(null);
+  const loadGeneration = React15__default.useCallback(async () => {
     try {
       const gens = await provider.getCommissionGenerations?.() ?? [];
       const doPeriodo = gens.filter((g) => g.periodStart === from && g.periodEnd === to);
@@ -3832,11 +5284,11 @@ function CommissionsView() {
     } catch {
     }
   }, [provider, from, to]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void fetchCommissions({ periodStart: from, periodEnd: to });
     void loadGeneration();
   }, [fetchCommissions, loadGeneration, from, to]);
-  const byPerson = React14__default.useMemo(() => {
+  const byPerson = React15__default.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
     for (const c of commissions2) {
       const key = c.personId;
@@ -4365,13 +5817,13 @@ function money2(v) {
 function GoalsView() {
   const { labels } = useFinancialConfig();
   const provider = useFinancialProvider();
-  const [units, setUnits] = React14__default.useState([]);
-  const [unitId, setUnitId] = React14__default.useState("");
-  const [year, setYear] = React14__default.useState((/* @__PURE__ */ new Date()).getFullYear());
-  const [rows, setRows] = React14__default.useState(null);
-  const [editing, setEditing] = React14__default.useState(null);
-  const [error, setError] = React14__default.useState(null);
-  React14__default.useEffect(() => {
+  const [units, setUnits] = React15__default.useState([]);
+  const [unitId, setUnitId] = React15__default.useState("");
+  const [year, setYear] = React15__default.useState((/* @__PURE__ */ new Date()).getFullYear());
+  const [rows, setRows] = React15__default.useState(null);
+  const [editing, setEditing] = React15__default.useState(null);
+  const [error, setError] = React15__default.useState(null);
+  React15__default.useEffect(() => {
     void (async () => {
       const cat = await provider.getCommissionCatalogs?.();
       const us = cat?.units ?? [];
@@ -4379,7 +5831,7 @@ function GoalsView() {
       setUnitId((cur) => cur || us[0]?.id || "");
     })();
   }, [provider]);
-  const load = React14__default.useCallback(async () => {
+  const load = React15__default.useCallback(async () => {
     if (!unitId) return;
     setRows(null);
     try {
@@ -4390,7 +5842,7 @@ function GoalsView() {
       setRows([]);
     }
   }, [provider, unitId, year]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void load();
   }, [load]);
   const totalRealizado = (rows ?? []).reduce((s, r) => s + r.achievedAmount, 0);
@@ -4531,11 +5983,11 @@ function GoalDialog({
   onSaved
 }) {
   const provider = useFinancialProvider();
-  const [target, setTarget] = React14__default.useState(String(goal.targetAmount || ""));
-  const [sup, setSup] = React14__default.useState(String(goal.superAmount || ""));
-  const [hyper, setHyper] = React14__default.useState(String(goal.hyperAmount || ""));
-  const [saving, setSaving] = React14__default.useState(false);
-  const [error, setError] = React14__default.useState(null);
+  const [target, setTarget] = React15__default.useState(String(goal.targetAmount || ""));
+  const [sup, setSup] = React15__default.useState(String(goal.superAmount || ""));
+  const [hyper, setHyper] = React15__default.useState(String(goal.hyperAmount || ""));
+  const [saving, setSaving] = React15__default.useState(false);
+  const [error, setError] = React15__default.useState(null);
   const t2 = Number(target) || 0;
   const s = Number(sup) || 0;
   const h = Number(hyper) || 0;
@@ -4625,21 +6077,21 @@ function Dash() {
 function GiftCardsView() {
   const provider = useFinancialProvider();
   const { currency } = useFinancialConfig();
-  const [enabled, setEnabled] = React14__default.useState(null);
-  const [cards, setCards] = React14__default.useState(null);
-  const [error, setError] = React14__default.useState(null);
-  const [issuing, setIssuing] = React14__default.useState(false);
-  const [issued, setIssued] = React14__default.useState(null);
-  const [activating, setActivating] = React14__default.useState(null);
-  const [search, setSearch] = React14__default.useState("");
-  const [state, setState] = React14__default.useState("");
-  const [minValue, setMinValue] = React14__default.useState("");
-  const [maxValue, setMaxValue] = React14__default.useState("");
-  const [from, setFrom] = React14__default.useState("");
-  const [to, setTo] = React14__default.useState("");
-  const money3 = React14__default.useCallback((v) => formatCurrency(v, currency), [currency]);
-  const seq = React14__default.useRef(0);
-  const load = React14__default.useCallback(async () => {
+  const [enabled, setEnabled] = React15__default.useState(null);
+  const [cards, setCards] = React15__default.useState(null);
+  const [error, setError] = React15__default.useState(null);
+  const [issuing, setIssuing] = React15__default.useState(false);
+  const [issued, setIssued] = React15__default.useState(null);
+  const [activating, setActivating] = React15__default.useState(null);
+  const [search, setSearch] = React15__default.useState("");
+  const [state, setState] = React15__default.useState("");
+  const [minValue, setMinValue] = React15__default.useState("");
+  const [maxValue, setMaxValue] = React15__default.useState("");
+  const [from, setFrom] = React15__default.useState("");
+  const [to, setTo] = React15__default.useState("");
+  const money3 = React15__default.useCallback((v) => formatCurrency(v, currency), [currency]);
+  const seq = React15__default.useRef(0);
+  const load = React15__default.useCallback(async () => {
     const mine = ++seq.current;
     setCards(null);
     setError(null);
@@ -4660,7 +6112,7 @@ function GiftCardsView() {
       setCards([]);
     }
   }, [provider, search, state, minValue, maxValue, from, to]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void (async () => {
       try {
         setEnabled(await provider.giftCardsEnabled?.() === true);
@@ -4669,7 +6121,7 @@ function GiftCardsView() {
       }
     })();
   }, [provider]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     if (enabled) void load();
   }, [enabled, load]);
   const outstanding = (cards ?? []).filter((c) => c.state === "active").reduce((s, c) => s + (c.balance ?? 0), 0);
@@ -4884,12 +6336,12 @@ function IssueDialog({
   onIssued
 }) {
   const provider = useFinancialProvider();
-  const [quantity, setQuantity] = React14__default.useState("10");
-  const [amount, setAmount] = React14__default.useState("100");
-  const [expiresAt, setExpiresAt] = React14__default.useState("");
-  const [note, setNote] = React14__default.useState("");
-  const [saving, setSaving] = React14__default.useState(false);
-  const [error, setError] = React14__default.useState(null);
+  const [quantity, setQuantity] = React15__default.useState("10");
+  const [amount, setAmount] = React15__default.useState("100");
+  const [expiresAt, setExpiresAt] = React15__default.useState("");
+  const [note, setNote] = React15__default.useState("");
+  const [saving, setSaving] = React15__default.useState(false);
+  const [error, setError] = React15__default.useState(null);
   const q = Math.trunc(Number(quantity)) || 0;
   const a = Number(amount) || 0;
   const total = q * a;
@@ -5058,25 +6510,19 @@ function ReconciliationView() {
   }
   const selected = lines.find((l) => l.id === selectedId) ?? null;
   return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
-    /* @__PURE__ */ jsxs("div", { className: "flex items-start justify-between gap-3", children: [
-      /* @__PURE__ */ jsxs("div", { children: [
-        /* @__PURE__ */ jsx("h2", { className: "text-lg font-semibold tracking-tight", children: t2("financial.reconciliation.title") }),
-        /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: t2("financial.reconciliation.subtitle") })
-      ] }),
-      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
-        /* @__PURE__ */ jsx(
-          TeachMeLink,
-          {
-            feature: "financial.conciliacao",
-            title: "Concilia\xE7\xE3o Banc\xE1ria",
-            about: "O extrato que vem do BANCO, n\xE3o do sistema, e a compara\xE7\xE3o entre os dois. Pendente aqui n\xE3o \xE9 conta a pagar: \xE9 transa\xE7\xE3o que o banco tem e ainda n\xE3o foi casada com um lan\xE7amento."
-          }
-        ),
-        /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: lines.length > 0 ? t2("financial.reconciliation.pending", { count: lines.length }) : t2("financial.reconciliation.allDone") }),
-        /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", onClick: () => void load(), disabled: loading || busy, children: [
-          /* @__PURE__ */ jsx(RefreshCw, { className: `h-3.5 w-3.5 ${loading ? "animate-spin" : ""}` }),
-          t2("financial.reconciliation.refresh")
-        ] })
+    /* @__PURE__ */ jsxs(PageHeaderActions, { children: [
+      /* @__PURE__ */ jsx(
+        TeachMeLink,
+        {
+          feature: "financial.conciliacao",
+          title: "Concilia\xE7\xE3o Banc\xE1ria",
+          about: "O extrato que vem do BANCO, n\xE3o do sistema, e a compara\xE7\xE3o entre os dois. Pendente aqui n\xE3o \xE9 conta a pagar: \xE9 transa\xE7\xE3o que o banco tem e ainda n\xE3o foi casada com um lan\xE7amento."
+        }
+      ),
+      /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: lines.length > 0 ? t2("financial.reconciliation.pending", { count: lines.length }) : t2("financial.reconciliation.allDone") }),
+      /* @__PURE__ */ jsxs(Button, { variant: "secondary", size: "sm", onClick: () => void load(), disabled: loading || busy, children: [
+        /* @__PURE__ */ jsx(RefreshCw, { className: `h-3.5 w-3.5 ${loading ? "animate-spin" : ""}` }),
+        t2("financial.reconciliation.refresh")
       ] })
     ] }),
     lines.length === 0 && !loading ? /* @__PURE__ */ jsxs("div", { className: "rounded-card border bg-card shadow-sm py-16 text-center", children: [
@@ -5241,7 +6687,7 @@ function NotasFiscaisView() {
   };
   if (!supported) {
     return /* @__PURE__ */ jsxs("div", { className: "p-1", children: [
-      /* @__PURE__ */ jsx(SubpageHeader, { title: "Notas Fiscais", subtitle: "Emiss\xE3o e acompanhamento de NF-e / NFC-e / NFS-e", icon: "FileText" }),
+      /* @__PURE__ */ jsx(SubpageHeader, { title: "Notas Fiscais", subtitle: "Emiss\xE3o e acompanhamento de NF-e / NFC-e / NFS-e" }),
       /* @__PURE__ */ jsx("p", { className: "mt-4 text-sm text-muted-foreground", children: "Este provedor financeiro ainda n\xE3o exp\xF5e notas fiscais." })
     ] });
   }
@@ -5251,7 +6697,6 @@ function NotasFiscaisView() {
       {
         title: "Notas Fiscais",
         subtitle: "Emiss\xE3o e acompanhamento de NF-e / NFC-e / NFS-e",
-        icon: "FileText",
         actions: /* @__PURE__ */ jsxs(Fragment, { children: [
           /* @__PURE__ */ jsx(
             TeachMeLink,
@@ -5262,8 +6707,8 @@ function NotasFiscaisView() {
             }
           ),
           canCreateManually && /* @__PURE__ */ jsx(PermissionGate, { feature: "financial", action: "create", children: /* @__PURE__ */ jsxs(Button, { size: "sm", onClick: () => setCreating(true), children: [
-            /* @__PURE__ */ jsx(Plus, { className: "mr-1.5 h-4 w-4" }),
-            " Nova nota"
+            /* @__PURE__ */ jsx(Plus, { className: "h-3.5 w-3.5" }),
+            "Nova nota"
           ] }) })
         ] })
       }
@@ -5841,10 +7286,10 @@ function RecentTransactions() {
 function useDueLabel() {
   const t2 = useTranslation();
   return (dueDate) => {
-    const today3 = /* @__PURE__ */ new Date();
-    today3.setHours(0, 0, 0, 0);
+    const today4 = /* @__PURE__ */ new Date();
+    today4.setHours(0, 0, 0, 0);
     const due = /* @__PURE__ */ new Date(`${dueDate}T00:00:00`);
-    const days = Math.round((due.getTime() - today3.getTime()) / 864e5);
+    const days = Math.round((due.getTime() - today4.getTime()) / 864e5);
     if (days < 0) return t2("financial.home.overdueDays", { count: String(Math.abs(days)) });
     if (days === 0) return t2("financial.home.dueToday");
     if (days === 1) return t2("financial.home.dueTomorrow");
@@ -5857,7 +7302,7 @@ function BalanceHero() {
   const summary = useFinancialStore((s) => s.summary);
   const navigate = useDashboardNavigate();
   useEnsureSummary();
-  const [hidden, setHidden] = React14__default.useState(false);
+  const [hidden, setHidden] = React15__default.useState(false);
   const money3 = (v) => hidden ? "\u2022\u2022\u2022\u2022\u2022\u2022" : formatCurrency(v ?? 0, currency);
   const inflow = summary?.monthlyInflow ?? 0;
   const outflow = summary?.monthlyOutflow ?? 0;
@@ -5930,7 +7375,7 @@ function categorizeSpend(notes) {
 function SpendByCategoryChart() {
   const t2 = useTranslation();
   const provider = useFinancialProvider();
-  const [rows, setRows] = React14__default.useState([]);
+  const [rows, setRows] = React15__default.useState([]);
   useEffect(() => {
     let alive = true;
     void (async () => {
@@ -5973,7 +7418,7 @@ function UpcomingBills() {
   const { currency } = useFinancialConfig();
   const provider = useFinancialProvider();
   const dueLabel = useDueLabel();
-  const [bills, setBills] = React14__default.useState([]);
+  const [bills, setBills] = React15__default.useState([]);
   useEffect(() => {
     let alive = true;
     void (async () => {
@@ -6074,10 +7519,10 @@ function uid() {
 function now() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-function today2() {
+function today3() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
-function round2(n) {
+function round22(n) {
   return Math.round(n * 100) / 100;
 }
 function matchesDateRange(dateStr, range) {
@@ -6165,7 +7610,7 @@ function createMockFinancialProvider(options) {
       invoice.status = "partial";
     } else {
       const movements = store6.movements.filter((m) => m.invoiceId === invoice.id && m.movementKind === "bill");
-      const hasOverdue = movements.some((m) => m.status === "overdue" || m.status === "pending" && m.dueDate < today2());
+      const hasOverdue = movements.some((m) => m.status === "overdue" || m.status === "pending" && m.dueDate < today3());
       invoice.status = hasOverdue ? "overdue" : "open";
     }
     invoice.updatedAt = now();
@@ -6278,12 +7723,13 @@ function createMockFinancialProvider(options) {
       Object.assign(invoice, data, { updatedAt: now() });
       return invoice;
     },
-    async cancelInvoice(id) {
-      const invoice = store6.invoices.find((i) => i.id === id);
-      if (!invoice) throw new Error(`Invoice ${id} not found`);
+    async cancelInvoice(input) {
+      if (!input.reason.trim()) throw new Error("A cancellation reason is required");
+      const invoice = store6.invoices.find((i) => i.id === input.invoiceId);
+      if (!invoice) throw new Error(`Invoice ${input.invoiceId} not found`);
       invoice.status = "cancelled";
       invoice.updatedAt = now();
-      store6.movements.filter((m) => m.invoiceId === id && m.status === "pending").forEach((m) => {
+      store6.movements.filter((m) => m.invoiceId === input.invoiceId && m.status === "pending").forEach((m) => {
         m.status = "cancelled";
         m.updatedAt = now();
       });
@@ -6319,7 +7765,7 @@ function createMockFinancialProvider(options) {
       if (!bill) throw new Error(`Movement ${input.movementId} not found`);
       const method = input.paymentMethodId ? store6.paymentMethods.find((pm) => pm.id === input.paymentMethodId) : void 0;
       const feePct = bill.direction === "credit" ? method?.discountValue ?? 0 : 0;
-      const thisFee = round2(input.amount * (feePct / 100));
+      const thisFee = round22(input.amount * (feePct / 100));
       const payment = {
         id: uid(),
         invoiceId: bill.invoiceId,
@@ -6346,7 +7792,7 @@ function createMockFinancialProvider(options) {
         updatedAt: now()
       };
       store6.movements.push(payment);
-      bill.paidAmount = round2(bill.paidAmount + input.amount);
+      bill.paidAmount = round22(bill.paidAmount + input.amount);
       bill.status = bill.paidAmount >= bill.amount ? "paid" : "partial";
       bill.paymentDate = void 0;
       bill.bankAccountId = void 0;
@@ -6355,9 +7801,9 @@ function createMockFinancialProvider(options) {
         const account = store6.bankAccounts.find((a) => a.id === input.bankAccountId);
         if (account) {
           if (bill.direction === "credit") {
-            account.currentBalance = round2(account.currentBalance + (input.amount - thisFee));
+            account.currentBalance = round22(account.currentBalance + (input.amount - thisFee));
           } else {
-            account.currentBalance = round2(account.currentBalance - input.amount);
+            account.currentBalance = round22(account.currentBalance - input.amount);
           }
           account.updatedAt = now();
         }
@@ -6417,11 +7863,11 @@ function createMockFinancialProvider(options) {
       const from = store6.bankAccounts.find((a) => a.id === input.fromAccountId);
       const to = store6.bankAccounts.find((a) => a.id === input.toAccountId);
       if (from) {
-        from.currentBalance = round2(from.currentBalance - input.amount);
+        from.currentBalance = round22(from.currentBalance - input.amount);
         from.updatedAt = now();
       }
       if (to) {
-        to.currentBalance = round2(to.currentBalance + input.amount);
+        to.currentBalance = round22(to.currentBalance + input.amount);
         to.updatedAt = now();
       }
       return { transferId, debitMovementId, creditMovementId };
@@ -6535,7 +7981,7 @@ function createMockFinancialProvider(options) {
     },
     // --- Statements (ERP extract: opening balance + realized cash + per-row net/fee) ---
     async getStatement(query) {
-      const todayStr = today2();
+      const todayStr = today3();
       const isRealized = (m) => m.status !== "cancelled" && !!m.paymentDate && affectsCash(m);
       const consolidated = !query.bankAccountId;
       const scopeAccounts = consolidated ? store6.bankAccounts.filter((a) => a.isActive) : store6.bankAccounts.filter((a) => a.id === query.bankAccountId);
@@ -6547,7 +7993,7 @@ function createMockFinancialProvider(options) {
       }
       const netOf = (m) => m.direction === "credit" ? m.paidAmount - (m.feeAmount ?? 0) : -m.paidAmount;
       const inScope = store6.movements.filter((m) => isRealized(m) && (consolidated || m.bankAccountId && accountIds.has(m.bankAccountId)));
-      const openingBalance = round2(initialSum + inScope.filter((m) => (m.paymentDate ?? "") < query.dateRange.from).reduce((s, m) => s + netOf(m), 0));
+      const openingBalance = round22(initialSum + inScope.filter((m) => (m.paymentDate ?? "") < query.dateRange.from).reduce((s, m) => s + netOf(m), 0));
       const rangeMovs = inScope.filter((m) => matchesDateRange(m.paymentDate, query.dateRange)).sort((a, b) => (a.paymentDate ?? "").localeCompare(b.paymentDate ?? "") || a.createdAt.localeCompare(b.createdAt));
       let balance = openingBalance;
       let totalCredits = 0, totalDebits = 0, totalFees = 0;
@@ -6555,16 +8001,16 @@ function createMockFinancialProvider(options) {
         const gross = movement.paidAmount;
         const isCredit = movement.direction === "credit";
         const fee = isCredit ? movement.feeAmount ?? 0 : 0;
-        const net = isCredit ? round2(gross - fee) : gross;
+        const net = isCredit ? round22(gross - fee) : gross;
         const isTransfer = movement.movementKind === "transfer";
         const meta = movement.metadata ?? {};
         const entryKind = isTransfer ? meta.transferRole === "in" ? "transfer-in" : "transfer-out" : "movement";
         const counterAccountId = isTransfer ? meta.counterAccountId : void 0;
-        balance = round2(isCredit ? balance + net : balance - net);
+        balance = round22(isCredit ? balance + net : balance - net);
         if (!(consolidated && isTransfer)) {
-          if (isCredit) totalCredits = round2(totalCredits + net);
-          else totalDebits = round2(totalDebits + net);
-          totalFees = round2(totalFees + fee);
+          if (isCredit) totalCredits = round22(totalCredits + net);
+          else totalDebits = round22(totalDebits + net);
+          totalFees = round22(totalFees + fee);
         }
         return {
           movement,
@@ -6591,7 +8037,7 @@ function createMockFinancialProvider(options) {
           contactName: inv?.contactName
         };
       }
-      const accountCurrentBalance = round2(initialSum + inScope.filter((m) => (m.paymentDate ?? "") <= todayStr).reduce((s, m) => s + netOf(m), 0));
+      const accountCurrentBalance = round22(initialSum + inScope.filter((m) => (m.paymentDate ?? "") <= todayStr).reduce((s, m) => s + netOf(m), 0));
       return {
         entries,
         openingBalance,
@@ -6599,7 +8045,7 @@ function createMockFinancialProvider(options) {
         totalCredits,
         totalDebits,
         totalFees,
-        net: round2(totalCredits - totalDebits),
+        net: round22(totalCredits - totalDebits),
         accountId: query.bankAccountId,
         accountCurrentBalance
       };
@@ -6613,7 +8059,7 @@ function createMockFinancialProvider(options) {
       const pendingPayable = store6.movements.filter(
         (m) => m.direction === "debit" && m.movementKind === "bill" && ["pending", "partial"].includes(m.status)
       );
-      const todayStr = today2();
+      const todayStr = today3();
       const monthAgo = /* @__PURE__ */ new Date();
       monthAgo.setDate(monthAgo.getDate() - 30);
       const monthStart = monthAgo.toISOString().slice(0, 10);
@@ -6675,7 +8121,7 @@ function createMockFinancialProvider(options) {
       const line = store6.movements.find((m) => m.id === bankMovementId);
       if (!line) return [];
       const amount = line.amount;
-      const tol = Math.max(0.01, round2(amount * 0.02));
+      const tol = Math.max(0.01, round22(amount * 0.02));
       const lineDate = line.paymentDate ?? line.dueDate;
       return store6.movements.filter((m) => !m.externalSource && !m.reconciledAt && m.direction === line.direction && m.id !== bankMovementId && Math.abs(m.amount - amount) <= tol).map((m) => {
         const amtScore = amount > 0 ? Math.max(0, 1 - Math.abs(m.amount - amount) / amount) : 0;
@@ -6685,7 +8131,7 @@ function createMockFinancialProvider(options) {
         return {
           movement: m,
           invoice: m.invoiceId ? store6.invoices.find((i) => i.id === m.invoiceId) : void 0,
-          score: round2(0.7 * amtScore + 0.3 * dateScore)
+          score: round22(0.7 * amtScore + 0.3 * dateScore)
         };
       }).sort((a, b) => b.score - a.score).slice(0, 25);
     },
@@ -6789,46 +8235,6 @@ function createMockFinancialProvider(options) {
   return provider;
 }
 
-// src/data/tables.ts
-var T = {
-  movements: "plg_financial_movements",
-  cashMovements: "v_financial_cash_movements",
-  accountBalances: "v_financial_account_balances",
-  chartOfAccounts: "plg_financial_chart_of_accounts",
-  bankAccounts: "plg_financial_bank_accounts",
-  cardBrands: "plg_financial_card_brands",
-  costCenters: "plg_financial_cost_centers",
-  cashRegisterSessions: "plg_financial_cash_register_sessions",
-  paymentMethods: "plg_financial_payment_methods",
-  paymentMethodTypes: "plg_financial_payment_method_types",
-  notas: "plg_financial_nfe",
-  // A contabilidade da LINHA. public.items é a linha; o que só o financeiro
-  // sabe dela — plano de contas, centro de custo, imposto, CFOP — mora aqui,
-  // com item_id de chave. Ver 038_the_invoice_gets_a_line.sql.
-  invoiceItems: "plg_financial_invoice_items",
-  // A regra de comissão. O registry apontava para `commission_rules`, sem
-  // prefixo — nome que a 028 aposentou e que não existe em pool nenhum.
-  commissionRules: "plg_financial_commission_rules",
-  commissionRuleCriteria: "plg_financial_commission_rule_criteria",
-  commissionFunctions: "plg_financial_commission_functions",
-  // The legacy `movement_kind='bill'` SHAPE, derived from the instalment
-  // balances (financial 040). Reading it instead of the mirror is what let the
-  // mirror stop being written: the columns are the same, the source is one.
-  // The instalment IS the obligation; the `movement_kind='bill'` shape and
-  // its compat view left in financial 044.
-  bills: "v_financial_installment_balances",
-  commissions: "v_financial_commissions",
-  commissionGenerations: "plg_financial_commission_generations",
-  periods: "plg_financial_periods",
-  trialBalance: "v_financial_trial_balance",
-  aging: "v_financial_aging",
-  agingSummary: "v_financial_aging_summary",
-  lineMargin: "v_financial_line_margin",
-  marginByMonth: "v_financial_margin_by_month",
-  recurringBills: "plg_financial_recurring_bills",
-  discountsGiven: "v_financial_discounts_given"
-};
-
 // src/data/supabase.ts
 function hasCriteriaValue(v) {
   if (!v) return false;
@@ -6863,8 +8269,8 @@ async function sweepOverdue() {
   _overdueSwept = true;
   try {
     const { core, pub } = getClients();
-    const today3 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const { data: overdueMovs } = await pub.from(T.movements).update({ status: "overdue" }).in("status", ["pending", "partial"]).lt("due_date", today3).select("invoice_id");
+    const today4 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const { data: overdueMovs } = await pub.from(T.movements).update({ status: "overdue" }).in("status", ["pending", "partial"]).lt("due_date", today4).select("invoice_id");
     if (overdueMovs && overdueMovs.length > 0) {
       const invoiceIds = [...new Set(overdueMovs.map((m) => m.invoice_id).filter(Boolean))];
       for (const invId of invoiceIds) {
@@ -6880,7 +8286,7 @@ async function sweepOverdue() {
   } catch {
   }
 }
-function round22(n) {
+function round23(n) {
   return Math.round(n * 100) / 100;
 }
 async function findInvoiceIdsByLineAccounting(core, pub, filters) {
@@ -6954,7 +8360,8 @@ function rowToInvoice(r) {
     metadata: r.metadata ?? void 0,
     tenantId: r.tenant_id,
     createdAt: r.created_at,
-    updatedAt: r.updated_at
+    updatedAt: r.updated_at,
+    createdBy: r.created_by ?? void 0
   };
 }
 async function getMethodFeePct(pub, paymentMethodId) {
@@ -7051,15 +8458,15 @@ function createSupabaseFinancialProvider() {
     async createInvoice(input) {
       const { core, pub } = getClients();
       const tenantId = getTenantId();
-      const lineTotal = (i) => round22(i.quantity * i.unitPrice - (i.discount ?? 0) + (i.surcharge ?? 0));
-      const totalAmount = round22(input.items.reduce((sum, i) => sum + lineTotal(i), 0));
+      const lineTotal = (i) => round23(i.quantity * i.unitPrice - (i.discount ?? 0) + (i.surcharge ?? 0));
+      const totalAmount = round23(input.items.reduce((sum, i) => sum + lineTotal(i), 0));
       const itemsSummary = input.items.map((i) => i.description).filter(Boolean).join(", ");
       const installments = (input.installments.length > 0 ? input.installments : [
         { amount: totalAmount, dueDate: input.invoiceDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10) }
       ]).map((inst, n) => ({
         number: inst.installmentNumber ?? n + 1,
         due_date: inst.dueDate,
-        amount: round22(inst.amount),
+        amount: round23(inst.amount),
         ...inst.metadata ? { metadata: inst.metadata } : {}
       }));
       const { data: res, error } = await pub.rpc("financial_create_invoice", {
@@ -7102,12 +8509,14 @@ function createSupabaseFinancialProvider() {
       if (Object.keys(row).length > 0) await pub.from("plg_financial_invoices").update(row).eq("id", id);
       return await provider.getInvoiceById(id);
     },
-    async cancelInvoice(id) {
+    async cancelInvoice(input) {
       const { pub } = getClients();
+      const reason = input.reason.trim();
+      if (!reason) throw new Error("A cancellation reason is required");
       const { error } = await pub.rpc("financial_cancel_invoice", {
-        p_invoice_id: id,
-        p_reason: null,
-        p_idempotency_key: genId()
+        p_invoice_id: input.invoiceId,
+        p_reason: reason,
+        p_idempotency_key: input.idempotencyKey ?? createIdempotencyKey("financial:invoice-cancel")
       });
       if (error) throw error;
     },
@@ -7264,7 +8673,7 @@ function createSupabaseFinancialProvider() {
         method = type?.transaction_type ?? null;
       }
       const feePct = before.direction === "receivable" ? await getMethodFeePct(pub, input.paymentMethodId) : 0;
-      const fee = round22(input.amount * (feePct / 100));
+      const fee = round23(input.amount * (feePct / 100));
       const { error } = await pub.rpc("financial_receive_payment", {
         p_installment_id: input.movementId,
         p_amount: input.amount,
@@ -7279,11 +8688,16 @@ function createSupabaseFinancialProvider() {
         p_payment_date: input.paymentDate,
         p_fee_amount: fee || null,
         p_notes: input.notes ?? null,
+        p_idempotency_key: input.idempotencyKey ?? createIdempotencyKey("financial:payment"),
         p_metadata: input.metadata ?? {}
       });
       if (error) throw error;
-      const { data: after } = await pub.from(T.bills).select("*").eq("installment_id", input.movementId).maybeSingle();
-      return billRowToMovement(after ?? before);
+      try {
+        const { data: after } = await pub.from(T.bills).select("*").eq("installment_id", input.movementId).maybeSingle();
+        return billRowToMovement(after ?? before);
+      } catch {
+        return billRowToMovement(before);
+      }
     },
     async cancelMovement(id) {
       const { pub } = getClients();
@@ -7532,7 +8946,7 @@ function createSupabaseFinancialProvider() {
     // --- Statements (ERP extract: opening balance + realized cash + per-row net/fee) ---
     async getStatement(query) {
       const { core, pub } = getClients();
-      const today3 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const today4 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const { data: acctRows } = await pub.from("plg_financial_accounts").select("id, name, is_active");
       const allAccounts = acctRows ?? [];
       const consolidated = !query.bankAccountId;
@@ -7547,7 +8961,7 @@ function createSupabaseFinancialProvider() {
       const netOf = (r) => r.direction === "credit" ? (Number(r.paid_amount) || 0) - (Number(r.fee_amount) || 0) : -(Number(r.paid_amount) || 0);
       const { data: priorRows } = await scopeFilter(pub.from(T.cashMovements).select("*").neq("status", "cancelled").lt("payment_date", query.dateRange.from));
       const priorNet = (priorRows ?? []).reduce((s, r) => s + netOf(r), 0);
-      const openingBalance = round22(initialSum + priorNet);
+      const openingBalance = round23(initialSum + priorNet);
       const { data: movs } = await scopeFilter(pub.from(T.cashMovements).select("*").neq("status", "cancelled").gte("payment_date", query.dateRange.from).lte("payment_date", query.dateRange.to).order("payment_date").order("created_at"));
       const invoiceIds = [...new Set((movs ?? []).map((r) => r.invoice_id).filter(Boolean))];
       const invoiceById = /* @__PURE__ */ new Map();
@@ -7564,17 +8978,17 @@ function createSupabaseFinancialProvider() {
         const gross = Number(r.paid_amount) || 0;
         const isCredit = r.direction === "credit";
         const fee = isCredit ? Number(r.fee_amount) || 0 : 0;
-        const net = isCredit ? round22(gross - fee) : gross;
+        const net = isCredit ? round23(gross - fee) : gross;
         const meta = r.metadata ?? {};
         const isTransfer = r.movement_kind === "transfer";
         const entryKind = isTransfer ? meta.transferRole === "in" ? "transfer-in" : "transfer-out" : "movement";
         const counterAccountId = isTransfer ? meta.counterAccountId : void 0;
-        if (isCredit) balance = round22(balance + net);
-        else balance = round22(balance - net);
+        if (isCredit) balance = round23(balance + net);
+        else balance = round23(balance - net);
         if (!(consolidated && isTransfer)) {
-          if (isCredit) totalCredits = round22(totalCredits + net);
-          else totalDebits = round22(totalDebits + net);
-          totalFees = round22(totalFees + fee);
+          if (isCredit) totalCredits = round23(totalCredits + net);
+          else totalDebits = round23(totalDebits + net);
+          totalFees = round23(totalFees + fee);
         }
         return {
           movement,
@@ -7612,8 +9026,8 @@ function createSupabaseFinancialProvider() {
           };
         }
       }
-      const { data: todayRows } = await scopeFilter(pub.from(T.cashMovements).select("*").neq("status", "cancelled").lte("payment_date", today3));
-      const accountCurrentBalance = round22(initialSum + (todayRows ?? []).reduce((s, r) => s + netOf(r), 0));
+      const { data: todayRows } = await scopeFilter(pub.from(T.cashMovements).select("*").neq("status", "cancelled").lte("payment_date", today4));
+      const accountCurrentBalance = round23(initialSum + (todayRows ?? []).reduce((s, r) => s + netOf(r), 0));
       return {
         entries,
         openingBalance,
@@ -7621,7 +9035,7 @@ function createSupabaseFinancialProvider() {
         totalCredits,
         totalDebits,
         totalFees,
-        net: round22(totalCredits - totalDebits),
+        net: round23(totalCredits - totalDebits),
         accountId: query.bankAccountId,
         accountCurrentBalance
       };
@@ -8103,15 +9517,15 @@ function createSupabaseFinancialProvider() {
       const totalBalance = (accounts ?? []).reduce((s, a) => s + (Number(a.balance) || 0), 0);
       const allMovs = movs ?? [];
       const unpaid = allMovs.filter((m) => ["pending", "partial", "overdue"].includes(m.status));
-      const today3 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const today4 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const unpaidCredit = unpaid.filter((m) => m.direction === "credit");
       const unpaidDebit = unpaid.filter((m) => m.direction === "debit");
-      const overdueCredit = unpaidCredit.filter((m) => m.status === "overdue" || m.due_date < today3);
-      const overdueDebit = unpaidDebit.filter((m) => m.status === "overdue" || m.due_date < today3);
+      const overdueCredit = unpaidCredit.filter((m) => m.status === "overdue" || m.due_date < today4);
+      const overdueDebit = unpaidDebit.filter((m) => m.status === "overdue" || m.due_date < today4);
       const monthAgo = /* @__PURE__ */ new Date();
       monthAgo.setDate(monthAgo.getDate() - 30);
       const monthStart = monthAgo.toISOString().slice(0, 10);
-      const period = dateRange ?? { from: monthStart, to: today3 };
+      const period = dateRange ?? { from: monthStart, to: today4 };
       const monthPaid = (cashMovs ?? []).filter((m) => m.movement_kind === "payment" && m.payment_date >= period.from && m.payment_date <= period.to);
       return {
         totalBalance,
@@ -8170,8 +9584,8 @@ function createSupabaseFinancialProvider() {
       if (!line) return [];
       const amount = Number(line.amount) || 0;
       const lineDate = line.payment_date ?? line.due_date;
-      const tol = Math.max(0.01, round22(amount * 0.02));
-      const { data, error } = await pub.from(T.movements).select("*").is("external_source", null).is("reconciled_at", null).eq("direction", line.direction).gte("amount", round22(amount - tol)).lte("amount", round22(amount + tol)).neq("id", bankMovementId).limit(25);
+      const tol = Math.max(0.01, round23(amount * 0.02));
+      const { data, error } = await pub.from(T.movements).select("*").is("external_source", null).is("reconciled_at", null).eq("direction", line.direction).gte("amount", round23(amount - tol)).lte("amount", round23(amount + tol)).neq("id", bankMovementId).limit(25);
       if (error) throw error;
       const candidates = (data ?? []).map((r) => {
         const amtDiff = Math.abs((Number(r.amount) || 0) - amount);
@@ -8181,7 +9595,7 @@ function createSupabaseFinancialProvider() {
         const dateScore = Math.max(0, 1 - days / 30);
         return {
           movement: snakeToCamel(r),
-          score: round22(0.7 * amtScore + 0.3 * dateScore)
+          score: round23(0.7 * amtScore + 0.3 * dateScore)
         };
       }).sort((a, b) => b.score - a.score);
       const invoiceIds = [...new Set(candidates.map((c) => c.movement.invoiceId).filter(Boolean))];
@@ -8536,13 +9950,17 @@ function createFinancialStore(provider) {
     async payMovement(input) {
       try {
         await provider.payMovement(input);
+      } catch (err) {
+        toast.error("Failed to record payment", { description: err?.message });
+        throw err;
+      }
+      try {
         const query = get().invoiceQuery;
         const [result, summary] = await Promise.all([provider.getInvoices(query), provider.getSummary()]);
         set({ invoices: result.data, invoicesTotal: result.total, summary });
         toast.success("Payment recorded");
-      } catch (err) {
-        toast.error("Failed to record payment", { description: err?.message });
-        throw err;
+      } catch {
+        toast.warning("Payment recorded; refresh the list to see the updated balance");
       }
     },
     async reverseMovement(movementId, reason) {
@@ -8573,9 +9991,9 @@ function createFinancialStore(provider) {
         throw err;
       }
     },
-    async cancelInvoice(invoiceId) {
+    async cancelInvoice(input) {
       try {
-        await provider.cancelInvoice(invoiceId);
+        await provider.cancelInvoice(input);
         const query = get().invoiceQuery;
         const [result, summary] = await Promise.all([provider.getInvoices(query), provider.getSummary()]);
         set({ invoices: result.data, invoicesTotal: result.total, summary });
@@ -8794,6 +10212,10 @@ var financialRegistries = [
     entity: paymentMethodEntity,
     icon: "Wallet",
     description: "Configured payment methods with fees and installment rules",
+    // O nome convida ao erro: pedido "salva essa conta a pagar do fornecedor X,
+    // pago hoje", o assistente cadastrou o FORNECEDOR aqui como forma de
+    // pagamento. Isto é configuração de como o CLIENTE paga a empresa.
+    agentHint: "CONFIGURATION of how customers pay this business (card brand, fee, installment rules). NEVER for a supplier, a bill or an expense \u2014 those are payables, see the createPayable tool",
     display: "table"
   },
   {
@@ -8997,15 +10419,25 @@ var payables = {
       check: "existe pelo menos uma conta cadastrada"
     }
   ],
+  // The anchored steps ARE the tour: startFeatureSetup turns each one into a
+  // spotlight stop, in this order, navigating per stop. The unanchored ones
+  // stay prose — briefing for the assistant to say in its own words.
+  // O tour NAVEGA até a tela de cadastro (3 paradas, cada uma com rota, então
+  // reiniciar renavega). Chegando, a `practice` assume: a pessoa preenche os
+  // campos sozinha com os marcadores numerados, para FIXAR o cadastro.
   steps: [
-    { do: "Financeiro \u203A Contas a pagar \u203A Nova.", route: "/financial/payables/new" },
-    { do: "Diga a quem se deve, o valor total e a classifica\xE7\xE3o (plano de contas)." },
-    {
-      do: "Se for parcelado, informe o n\xFAmero de parcelas e confira as datas antes de salvar.",
-      why: "O cronograma nasce aqui. Editar depois recria o parcelamento inteiro."
-    },
+    { do: "O Financeiro mora aqui.", anchor: "nav./financial", route: "/financial" },
+    { do: "Abra Contas a Pagar neste menu.", anchor: "modnav.payables", route: "/financial/payables/list" },
+    { do: "Clique em Cadastrar manualmente para abrir uma conta nova.", anchor: "action.manual", route: "/financial/payables/list" },
+    { do: "Diga a quem se deve, adicione um item com o valor, confira as parcelas e salve." },
     { do: "Ao pagar, d\xEA baixa NA PARCELA, escolhendo a conta de onde o dinheiro saiu." }
   ],
+  practice: [
+    { anchor: "financial.contact", label: "Selecione o fornecedor" },
+    { anchor: "financial.items", label: "Adicione um item com o valor" },
+    { anchor: "financial.installments", label: "Confira as parcelas" },
+    { anchor: "savebar.save", label: "Salve a conta", final: true }
+  ],
   rules: [
     "Uma conta a pagar \xE9 um cabe\xE7alho com parcelas: o que vence, o que se paga e o que aparece no extrato \xE9 sempre a PARCELA.",
     "Baixa exige dizer de qual conta saiu \u2014 \xE9 o que faz o extrato bater."
@@ -9038,15 +10470,18 @@ var receivables = {
       check: "a tela de receber oferece pelo menos uma forma"
     }
   ],
+  // Só as abas de TOPO do módulo viram `modnav.<id>`; os filhos (list/new) são
+  // um SegmentedControl sem âncora, então o tour navega pela aba e pela rota.
   steps: [
-    { do: "Financeiro \u203A Contas a receber \u203A Lista para ver o que est\xE1 em aberto.", route: "/financial/receivables/list" },
+    { do: "O Financeiro mora aqui.", anchor: "nav./financial", route: "/financial" },
+    { do: "Abra Contas a Receber neste menu \u2014 a lista mostra o que est\xE1 em aberto.", anchor: "modnav.receivables", route: "/financial/receivables/list" },
+    { do: "Cadastre uma cobran\xE7a \xE0 m\xE3o s\xF3 para o que n\xE3o nasceu de uma venda.", anchor: "action.manual", route: "/financial/receivables/list" },
     {
-      do: "Receba pela pr\xF3pria linha, escolhendo a forma e \u2014 no cart\xE3o \u2014 o n\xFAmero de parcelas.",
+      do: "O normal \xE9 receber pela pr\xF3pria linha, escolhendo a forma e \u2014 no cart\xE3o \u2014 o n\xFAmero de parcelas.",
       byAssistant: true,
       tool: "markPaymentReceived",
       why: "Eu consigo dar baixa direto quando voc\xEA me disser qual atendimento ou pedido foi pago."
-    },
-    { do: "S\xF3 lance uma cobran\xE7a \xE0 m\xE3o (Nova) para o que n\xE3o nasceu de uma venda." }
+    }
   ],
   rules: [
     "Venda conclu\xEDda vira fatura por gatilho: NENHUMA tela escreve fatura por fora. Se voc\xEA est\xE1 cadastrando \xE0 m\xE3o o que foi vendido, alguma coisa est\xE1 errada antes daqui.",
@@ -9080,9 +10515,11 @@ var cashRegisters = {
     }
   ],
   steps: [
-    { do: "Financeiro \u203A Caixas: abra o caixa dizendo o valor que est\xE1 na gaveta.", route: "/financial/cash/registers" },
+    { do: "O Financeiro mora aqui.", anchor: "nav./financial", route: "/financial" },
+    { do: "Abra Caixas neste menu.", anchor: "modnav.cash-registers", route: "/financial/cash/registers" },
+    { do: "Abra o caixa dizendo o valor que est\xE1 na gaveta agora.", anchor: "financial.cash-open", route: "/financial/cash/registers" },
     { do: "Durante o dia, o movimento entra sozinho pelo que for recebido." },
-    { do: "No fim, feche informando o que foi contado de verdade \u2014 inclusive quando n\xE3o bate." },
+    { do: "No fim, feche informando o que foi CONTADO de verdade \u2014 inclusive quando n\xE3o bate.", anchor: "financial.cash-close", route: "/financial/cash/registers" },
     { do: "Quem tem al\xE7ada confere e aprova a sess\xE3o fechada.", why: "\xC9 a aprova\xE7\xE3o que congela o dia." }
   ],
   rules: [
@@ -9406,11 +10843,11 @@ function buildFinancialOnboarding() {
 function CashSessionHeaderControl({ config, provider, store: store6 }) {
   const sessions = useStore(store6, (s) => s.cashSessions);
   const fetchCashSessions = useStore(store6, (s) => s.fetchCashSessions);
-  const [open, setOpen] = React14__default.useState(false);
-  React14__default.useEffect(() => {
+  const [open, setOpen] = React15__default.useState(false);
+  React15__default.useEffect(() => {
     void fetchCashSessions?.();
   }, [fetchCashSessions]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     if (!open) return;
     const close = () => setOpen(false);
     window.addEventListener("hashchange", close);
@@ -9444,6 +10881,7 @@ function CashSessionHeaderControl({ config, provider, store: store6 }) {
 
 // src/locales/en.ts
 var en = {
+  "financial.payment.pendingRetry": "Confirmation is pending. Do not start another payment. Retry the same details before leaving this screen.",
   "financial.cards.addExpense": "Add expense",
   "financial.cards.expenseOnCard": "Expense on this card",
   "financial.cards.allBillsValue": "All bills value",
@@ -9508,6 +10946,8 @@ var en = {
   "financial.invoice.bulkCancelTitle": "Cancel {{count}} invoice(s)?",
   "financial.invoice.cancelConfirm": "This action cannot be undone.",
   "financial.invoice.cancelDesc": "The invoice will be marked as cancelled. All pending installments will also be cancelled. This invoice will no longer count towards totals.",
+  "financial.invoice.cancelReason": "Reason for cancellation",
+  "financial.invoice.cancelReasonPlaceholder": "Explain why this invoice is being cancelled",
   "financial.invoice.cancelInvoice": "Cancel Invoice",
   "financial.invoice.cancelling": "Cancelling...",
   "financial.invoice.contact": "Contact",
@@ -10011,6 +11451,7 @@ var en = {
 
 // src/locales/pt-BR.ts
 var ptBR = {
+  "financial.payment.pendingRetry": "A confirma\xE7\xE3o ainda est\xE1 pendente. N\xE3o abra outro pagamento. Tente novamente com os mesmos dados antes de sair desta tela.",
   "financial.cards.addExpense": "Adicionar despesa",
   "financial.cards.expenseOnCard": "Despesa neste cart\xE3o",
   "financial.cards.allBillsValue": "Total das faturas",
@@ -10075,6 +11516,8 @@ var ptBR = {
   "financial.invoice.bulkCancelTitle": "Cancelar {{count}} fatura(s)?",
   "financial.invoice.cancelConfirm": "Esta a\xE7\xE3o n\xE3o pode ser desfeita.",
   "financial.invoice.cancelDesc": "A fatura ser\xE1 marcada como cancelada. Todas as parcelas pendentes tamb\xE9m ser\xE3o canceladas. Esta fatura n\xE3o contar\xE1 mais nos totais.",
+  "financial.invoice.cancelReason": "Motivo do cancelamento",
+  "financial.invoice.cancelReasonPlaceholder": "Explique por que esta fatura est\xE1 sendo cancelada",
   "financial.invoice.cancelInvoice": "Cancelar Fatura",
   "financial.invoice.cancelling": "Cancelando...",
   "financial.invoice.contact": "Contato",
@@ -10604,14 +12047,14 @@ function CommissionRuleDialog({
   onClose,
   onSaved
 }) {
-  const [name, setName] = React14__default.useState(rule?.name ?? "");
-  const [description, setDescription] = React14__default.useState(rule?.description ?? "");
-  const [priority, setPriority] = React14__default.useState(String(rule?.priority ?? 1));
-  const [isActive, setIsActive] = React14__default.useState(rule?.isActive ?? true);
-  const [isDefault, setIsDefault] = React14__default.useState(rule?.isDefault ?? !hasDefault);
-  const [saving, setSaving] = React14__default.useState(false);
-  const [error, setError] = React14__default.useState(null);
-  const initial = React14__default.useMemo(() => {
+  const [name, setName] = React15__default.useState(rule?.name ?? "");
+  const [description, setDescription] = React15__default.useState(rule?.description ?? "");
+  const [priority, setPriority] = React15__default.useState(String(rule?.priority ?? 1));
+  const [isActive, setIsActive] = React15__default.useState(rule?.isActive ?? true);
+  const [isDefault, setIsDefault] = React15__default.useState(rule?.isDefault ?? !hasDefault);
+  const [saving, setSaving] = React15__default.useState(false);
+  const [error, setError] = React15__default.useState(null);
+  const initial = React15__default.useMemo(() => {
     const get = (t2, key = "ids") => rule?.criteria.find((c) => c.criteriaType === t2)?.criteriaValue?.[key] ?? [];
     return {
       services: get("service"),
@@ -10622,12 +12065,12 @@ function CommissionRuleDialog({
       ranges: get("time_range", "ranges")
     };
   }, [rule]);
-  const [services, setServices] = React14__default.useState(initial.services);
-  const [categories, setCategories] = React14__default.useState(initial.categories);
-  const [professionals, setProfessionals] = React14__default.useState(initial.professionals);
-  const [units, setUnits] = React14__default.useState(initial.units);
-  const [weekdays, setWeekdays] = React14__default.useState(initial.weekdays);
-  const [ranges, setRanges] = React14__default.useState(initial.ranges);
+  const [services, setServices] = React15__default.useState(initial.services);
+  const [categories, setCategories] = React15__default.useState(initial.categories);
+  const [professionals, setProfessionals] = React15__default.useState(initial.professionals);
+  const [units, setUnits] = React15__default.useState(initial.units);
+  const [weekdays, setWeekdays] = React15__default.useState(initial.weekdays);
+  const [ranges, setRanges] = React15__default.useState(initial.ranges);
   const criteriaCount = [services, categories, professionals, units].filter((a) => a.length > 0).length + (weekdays.length ? 1 : 0) + (ranges.length ? 1 : 0);
   async function handleSave() {
     if (!name.trim()) {
@@ -10870,11 +12313,11 @@ function blankFunction(order) {
   };
 }
 function CommissionFunctionsDialog({ rule, provider, onClose, onSaved }) {
-  const [functions, setFunctions] = React14__default.useState(
+  const [functions, setFunctions] = React15__default.useState(
     rule.functions.length ? rule.functions : [blankFunction(0)]
   );
-  const [saving, setSaving] = React14__default.useState(false);
-  const [error, setError] = React14__default.useState(null);
+  const [saving, setSaving] = React15__default.useState(false);
+  const [error, setError] = React15__default.useState(null);
   function patch(i, changes) {
     setFunctions((fs) => fs.map((f, j) => j === i ? { ...f, ...changes } : f));
   }
@@ -11158,19 +12601,19 @@ function functionChip(fn) {
   return fn.valueType === "percentage" ? `${who}: ${fn.valueAmount}%` : `${who}: R$ ${fn.valueAmount.toFixed(2)}`;
 }
 function CommissionRulesView({ provider }) {
-  const [rules, setRules] = React14__default.useState(null);
-  const [catalogs, setCatalogs] = React14__default.useState({
+  const [rules, setRules] = React15__default.useState(null);
+  const [catalogs, setCatalogs] = React15__default.useState({
     services: [],
     categories: [],
     professionals: [],
     units: []
   });
-  const [error, setError] = React14__default.useState(null);
-  const [funnel, setFunnel] = React14__default.useState({});
-  const [editing, setEditing] = React14__default.useState(null);
-  const [functionsFor, setFunctionsFor] = React14__default.useState(null);
-  const [deleting, setDeleting] = React14__default.useState(null);
-  const load = React14__default.useCallback(async () => {
+  const [error, setError] = React15__default.useState(null);
+  const [funnel, setFunnel] = React15__default.useState({});
+  const [editing, setEditing] = React15__default.useState(null);
+  const [functionsFor, setFunctionsFor] = React15__default.useState(null);
+  const [deleting, setDeleting] = React15__default.useState(null);
+  const load = React15__default.useCallback(async () => {
     try {
       setError(null);
       const [r, c] = await Promise.all([
@@ -11184,17 +12627,17 @@ function CommissionRulesView({ provider }) {
       setRules([]);
     }
   }, [provider]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void load();
   }, [load]);
   const funnelActive = Object.values(funnel).some(Boolean);
-  const visible = React14__default.useMemo(() => {
+  const visible = React15__default.useMemo(() => {
     if (!rules) return [];
     const ranked = rankRules(rules);
     if (!funnelActive) return ranked;
     return ranked.filter((r) => r.isDefault || ruleMatches(r, funnel, catalogs));
   }, [rules, funnel, funnelActive, catalogs]);
-  const winner = React14__default.useMemo(() => {
+  const winner = React15__default.useMemo(() => {
     if (!funnelActive) return null;
     return visible.find((r) => r.isActive && !r.isDefault) ?? visible.find((r) => r.isActive && r.isDefault) ?? null;
   }, [visible, funnelActive]);
@@ -21443,8 +22886,8 @@ function ReceivePaymentModal({
   onClose,
   onPaid
 }) {
-  const provider = React14__default.useMemo(() => createSafeFinancialProvider(), []);
-  const store6 = React14__default.useMemo(() => createFinancialStore(provider), [provider]);
+  const provider = React15__default.useMemo(() => createSafeFinancialProvider(), []);
+  const store6 = React15__default.useMemo(() => createFinancialStore(provider), [provider]);
   return /* @__PURE__ */ jsx(FinancialContextProvider, { config: STANDALONE_CONFIG, provider, store: store6, children: /* @__PURE__ */ jsx(
     PaymentModal,
     {
@@ -21462,7 +22905,7 @@ function createFinancialSettingsPlugin(options) {
     ...financialRegistries.filter((r) => RECEIVING_REGISTRIES.includes(r.id)),
     ...options?.extraRegistries ?? []
   ];
-  const SettingsTab = () => React14__default.createElement(PluginSettingsPanel, {
+  const SettingsTab = () => React15__default.createElement(PluginSettingsPanel, {
     title: "Pagamentos",
     registries,
     hostPluginId: "financial",
@@ -21505,19 +22948,19 @@ function ClientAccountPanel({
   currency = BRL
 }) {
   const provider = useFinancialProvider();
-  const [account, setAccount] = React14__default.useState(null);
-  const [busy, setBusy] = React14__default.useState(false);
-  const [paying, setPaying] = React14__default.useState(null);
+  const [account, setAccount] = React15__default.useState(null);
+  const [busy, setBusy] = React15__default.useState(false);
+  const [paying, setPaying] = React15__default.useState(null);
   async function openPayment(invoiceId) {
     const res = await provider.getMovements({ invoiceId, pageSize: 200 });
     const open = (res.data ?? []).find((m) => m.movementKind === "bill" && m.amount - (m.paidAmount ?? 0) > 5e-3);
     if (open) setPaying(open);
   }
-  const load = React14__default.useCallback(async () => {
+  const load = React15__default.useCallback(async () => {
     if (!personId) return;
     setAccount(await provider.getClientAccount(personId));
   }, [personId, provider]);
-  React14__default.useEffect(() => {
+  React15__default.useEffect(() => {
     void load();
   }, [load]);
   const forThis = account?.invoices.filter((i) => orderId && i.orderId === orderId) ?? [];
@@ -21619,8 +23062,8 @@ function ClientAccountModal({
   onGenerate,
   onClose
 }) {
-  const provider = React14__default.useMemo(() => createSafeFinancialProvider(), []);
-  const store6 = React14__default.useMemo(() => createFinancialStore(provider), [provider]);
+  const provider = React15__default.useMemo(() => createSafeFinancialProvider(), []);
+  const store6 = React15__default.useMemo(() => createFinancialStore(provider), [provider]);
   return /* @__PURE__ */ jsx(RightRailPage, { title: "Conta do cliente", open: true, onClose, width: "max-w-md", children: /* @__PURE__ */ jsx("div", { className: "px-4 py-3", children: /* @__PURE__ */ jsx(FinancialContextProvider, { config: STANDALONE_CONFIG, provider, store: store6, children: /* @__PURE__ */ jsx(
     ClientAccountPanel,
     {
@@ -21729,9 +23172,10 @@ function createFinancialPlugin(options) {
   const store6 = createFinancialStore(provider);
   const dashboardWidgets = createFinancialDashboardWidgets({ config, provider, store: store6 });
   const registries = [...financialRegistries, ...options?.settingsRegistries ?? []];
-  const PersonStatementBound = (props) => React14__default.createElement(PersonStatementWidget, { person: props.item, provider, config });
+  const PersonStatementBound = (props) => React15__default.createElement(PersonStatementWidget, { person: props.item, provider, config });
   PersonStatementBound.displayName = "FinancialPersonStatement";
-  const PageComponent = () => React14__default.createElement(FinancialPage, { config, provider, store: store6, registries });
+  const PageComponent = () => React15__default.createElement(FinancialPage, { config, provider, store: store6, registries });
+  const AgentMount = createFinancialAgentMount({ config, provider });
   return {
     id: "financial",
     defaultAgentRole: "finance",
@@ -21788,7 +23232,7 @@ function createFinancialPlugin(options) {
     // tem — lá é um ícone no cabeçalho, de qualquer tela.
     headerControls: config.modules.cashRegisters ? [{
       id: "financial.cash-session",
-      component: (() => React14__default.createElement(CashSessionHeaderControl, { config, provider, store: store6 })),
+      component: (() => React15__default.createElement(CashSessionHeaderControl, { config, provider, store: store6 })),
       order: 90,
       permission: { feature: "financial", action: "read" }
     }] : [],
@@ -21890,6 +23334,17 @@ function createFinancialPlugin(options) {
         component: PersonStatementBound,
         order: 0,
         permission: { feature: "financial", action: "read" }
+      },
+      {
+        // Headless. Publica ao assistente a porta de lançar uma conta a pagar
+        // em QUALQUER rota — ver payable-agent.tsx. `shell.topbar.end` é a
+        // única zona global do shell que de fato é renderizada e que fica FORA
+        // do switch de rota (mesma leitura do pill do plugin-scribe).
+        id: "financial-agent-mount",
+        zone: "shell.topbar.end",
+        component: AgentMount,
+        order: -20,
+        permission: { feature: "financial", action: "read" }
       }
     ],
     dashboardWidgets,
@@ -21980,9 +23435,9 @@ function createFinancialPlugin(options) {
         // lado, e a corrida de "Plugins" não é partida ao meio.
         group: "Financeiro",
         component: (() => {
-          const FinancialSettingsTab = () => React14__default.createElement(PluginSettingsPanel, {
+          const FinancialSettingsTab = () => React15__default.createElement(PluginSettingsPanel, {
             title: "Financial Settings",
-            generalSettings: React14__default.createElement(FinancialGeneralSettings),
+            generalSettings: React15__default.createElement(FinancialGeneralSettings),
             registries,
             hostPluginId: "financial",
             routeBase: "/settings/financial"
@@ -22007,7 +23462,7 @@ function createFinancialPlugin(options) {
         icon: "HandCoins",
         group: "Financeiro",
         component: (() => {
-          const CommissionRulesTab = () => React14__default.createElement(CommissionRulesView, { provider });
+          const CommissionRulesTab = () => React15__default.createElement(CommissionRulesView, { provider });
           CommissionRulesTab.displayName = "CommissionRulesTab";
           return CommissionRulesTab;
         })(),