@fayz-ai/plugin-fiscal-br 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,10 +1,11 @@
 import { recordRailFields, RECORD_GROUP, activeFacet, getSupabaseClientOptional, connectionSettings, connectionStatus, definePlugin, createConnectionStore, settingsStatus, maskCpfCnpj } from '@fayz-ai/core';
 import React5, { useState, useCallback, useEffect, useMemo, useRef } from 'react';
-import { ModalHeader, ModalTitle, ModalBody, Skeleton, AiActionButton, Card, Button, EmBreve, SearchSelect, Input, DatePicker, Hint, ModalFooter, SubpageHeader, useFilterDraft, PageHeaderActions, FilterPanel, FilterPanelField, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SearchField, DataTable, ListFilterBar, Modal, ModalContent, ComingSoon, CardHeader, CardTitle, CardContent, toast, Badge, CardDescription, Switch } from '@fayz-ai/ui';
+import { ModalHeader, ModalTitle, ModalBody, Skeleton, AiActionButton, Card, Button, EmBreve, SearchSelect, Input, DatePicker, Hint, ModalFooter, SubpageHeader, useFilterDraft, PageHeaderActions, FilterPanel, FilterPanelField, Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SearchField, DataTable, ListFilterBar, Modal, ModalContent, TooltipProvider, Tooltip, TooltipTrigger, TooltipContent, ModalDescription, Badge, SegmentedControl, ComingSoon, toast, CardHeader, CardTitle, CardContent, CardDescription, Switch } from '@fayz-ai/ui';
 export { ComingSoon, EmBreve } from '@fayz-ai/ui';
-import { registerDocumentOpener, getActiveTenantId, useUnitFilter, UNIT_DETAIL_ZONES, adminNavigateTo } from '@fayz-ai/admin';
-import { Gift, RefreshCw, Loader2, FileDown, AlertTriangle, ChevronRight, Check, Trash2, Plus, Inbox, UploadCloud, ShieldCheck, FileText, ExternalLink, X, Info } from 'lucide-react';
+import { registerDocumentOpener, getActiveTenantId, useUnitFilter, usePermissionOptional, UNIT_DETAIL_ZONES, adminNavigateTo } from '@fayz-ai/admin';
+import { Gift, RefreshCw, Loader2, FileDown, AlertTriangle, ChevronRight, Check, Trash2, Plus, Inbox, UploadCloud, ShieldCheck, FileText, ExternalLink, CheckCircle2, FileCheck2, ChevronDown, XCircle, X, Info } from 'lucide-react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { FINANCIAL_INVOICE_ZONES } from '@fayz-ai/plugin-financial';
 
 // src/index.ts
 var PLUGNOTAS_CONNECTOR_ID = "plugnotas";
@@ -3647,6 +3648,129 @@ CREATE POLICY plg_fiscalbr_emitter_settings_authz_write ON public.plg_fiscalbr_e
                  WHERE le.id = plg_fiscalbr_emitter_settings.legal_entity_id
                    AND le.tenant_id = plg_fiscalbr_emitter_settings.tenant_id));
 `;
+var MIGRATION_018_A_NOTA_DO_V1_ALCANCA_A_CONTA = `-- A nota que veio do V1 alcan\xE7a a conta que a gerou.
+--
+-- A conta a receber pergunta "que notas eu tenho?" pelo pedido dela:
+-- plg_financial_invoices.order_id \u2192 plg_fiscalbr_document_orders \u2192 a nota.
+-- A importa\xE7\xE3o s\xF3 preencheu esse v\xEDnculo a partir da tabela N:N do V1
+-- (fiscal_document_invoice_sources). A NFS-e do V1 nunca usou essa tabela: ela
+-- aponta a conta por fiscal_documents.invoice_id, que chegou aqui apenas como
+-- metadata.v1.invoice_ref. Medido em 06-10-2026 no cluster do ChefControl: 488
+-- NFS-e e 122 NFC-e sem caminho at\xE9 a conta.
+--
+-- A conta importada guarda o pr\xF3prio id do V1 em
+-- metadata.migration.source_numeric_id, ent\xE3o o par se resolve sem adivinhar.
+-- Num pool sem dado do V1 isto n\xE3o casa nada. Aditivo e idempotente.
+
+INSERT INTO public.plg_fiscalbr_document_orders (tenant_id, document_id, order_id)
+SELECT DISTINCT f.tenant_id, f.document_id, i.order_id
+  FROM public.plg_fiscalbr_documents f
+  JOIN public.plg_financial_invoices i
+    ON i.tenant_id = f.tenant_id
+   AND i.metadata -> 'migration' ->> 'source_table' = 'invoices'
+   AND i.metadata -> 'migration' ->> 'source_numeric_id' = f.metadata -> 'v1' ->> 'invoice_ref'
+  JOIN public.orders o ON o.id = i.order_id
+ WHERE f.metadata -> 'v1' ->> 'invoice_ref' IS NOT NULL
+ON CONFLICT (document_id, order_id) DO NOTHING;
+`;
+var MIGRATION_019_A_NOTA_EMITIDA_SE_CANCELA_PELO_V2 = `-- A nota emitida se consulta e se cancela pelo V2.
+--
+-- Quem fala com a PlugNotas \xE9 a fun\xE7\xE3o \`fiscalbr-plugnotas\` (a chave s\xF3 existe
+-- no servidor), mas ela roda com o JWT de quem clicou e n\xE3o grava nada direto:
+-- pergunta aqui se a pessoa pode, e devolve o resultado aqui. Uma porta de
+-- leitura, uma de escrita, a permiss\xE3o conferida nas duas.
+--
+--   consultar e baixar o PDF  \u2192 financial.read na unidade da nota
+--   cancelar                  \u2192 financial.edit na unidade da nota
+--
+-- A espelho em \`documents.status\` anda junto: as duas tabelas s\xE3o a mesma nota
+-- vista de dois lugares (005), e um status divergente entre elas \xE9 a nota
+-- dizendo duas coisas. Idempotente.
+
+CREATE OR REPLACE FUNCTION public.fiscalbr_note_for_provider(p_document_id uuid, p_action text)
+RETURNS jsonb
+LANGUAGE plpgsql
+STABLE SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v public.plg_fiscalbr_documents%ROWTYPE;
+BEGIN
+  SELECT * INTO v FROM public.plg_fiscalbr_documents
+   WHERE document_id = p_document_id AND tenant_id = app.current_tenant_id();
+  IF NOT FOUND THEN
+    RAISE EXCEPTION 'fiscal: note not found' USING ERRCODE = 'P0002';
+  END IF;
+  PERFORM public.plg_financial_require_permission(
+    CASE WHEN p_action = 'cancel' THEN 'financial.edit' ELSE 'financial.read' END, v.unit_id);
+  RETURN jsonb_build_object(
+    'document_id', v.document_id, 'model', v.model, 'status', v.status,
+    'environment', v.environment, 'provider_document_id', v.provider_document_id,
+    'cancelled_at', v.cancelled_at, 'access_key', v.access_key, 'number', v.number);
+END $$;
+
+CREATE OR REPLACE FUNCTION public.fiscalbr_note_apply(
+  p_document_id uuid,
+  p_action text,
+  p_patch jsonb,
+  p_event jsonb DEFAULT NULL
+)
+RETURNS void
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v public.plg_fiscalbr_documents%ROWTYPE;
+  v_status text := p_patch ->> 'status';
+BEGIN
+  SELECT * INTO v FROM public.plg_fiscalbr_documents
+   WHERE document_id = p_document_id AND tenant_id = app.current_tenant_id()
+   FOR UPDATE;
+  IF NOT FOUND THEN
+    RAISE EXCEPTION 'fiscal: note not found' USING ERRCODE = 'P0002';
+  END IF;
+  PERFORM public.plg_financial_require_permission(
+    CASE WHEN p_action = 'cancel' THEN 'financial.edit' ELSE 'financial.read' END, v.unit_id);
+  IF v_status IS NOT NULL AND v_status NOT IN ('processing','authorized','rejected','error','cancelled','substituted') THEN
+    RAISE EXCEPTION 'fiscal: unknown status %', v_status USING ERRCODE = '22023';
+  END IF;
+
+  -- Only what the provider answers; identity (model, unit, order) never moves.
+  UPDATE public.plg_fiscalbr_documents SET
+    status            = COALESCE(v_status, status),
+    number            = COALESCE(p_patch ->> 'number', number),
+    series            = COALESCE(p_patch ->> 'series', series),
+    access_key        = COALESCE(p_patch ->> 'access_key', access_key),
+    verification_code = COALESCE(p_patch ->> 'verification_code', verification_code),
+    status_payload    = COALESCE(p_patch -> 'status_payload', status_payload),
+    rejection_payload = CASE WHEN p_patch ? 'rejection_payload' THEN p_patch -> 'rejection_payload' ELSE rejection_payload END,
+    authorized_at     = COALESCE((p_patch ->> 'authorized_at')::timestamptz, authorized_at),
+    last_polled_at    = CASE WHEN p_action = 'poll' THEN now() ELSE last_polled_at END,
+    cancelled_at      = CASE WHEN p_patch ? 'cancelled_at' THEN (p_patch ->> 'cancelled_at')::timestamptz ELSE cancelled_at END,
+    cancel_reason     = CASE WHEN p_patch ? 'cancel_reason' THEN p_patch ->> 'cancel_reason' ELSE cancel_reason END,
+    cancelled_by_user_id = CASE WHEN p_action = 'cancel' THEN auth.uid()
+                                WHEN p_patch ? 'cancelled_at' AND p_patch -> 'cancelled_at' = 'null'::jsonb THEN NULL
+                                ELSE cancelled_by_user_id END
+  WHERE document_id = p_document_id;
+
+  IF v_status IS NOT NULL THEN
+    UPDATE public.documents SET status = v_status WHERE id = p_document_id AND status IS DISTINCT FROM v_status;
+  END IF;
+
+  IF p_event IS NOT NULL THEN
+    INSERT INTO public.plg_fiscalbr_document_events
+      (tenant_id, unit_id, document_id, event_type, status, justification, response_payload, created_by_user_id)
+    VALUES (v.tenant_id, v.unit_id, p_document_id, p_event ->> 'event_type', p_event ->> 'status',
+            p_event ->> 'justification', p_event -> 'response_payload', auth.uid());
+  END IF;
+END $$;
+
+REVOKE ALL ON FUNCTION public.fiscalbr_note_for_provider(uuid, text) FROM PUBLIC, anon;
+REVOKE ALL ON FUNCTION public.fiscalbr_note_apply(uuid, text, jsonb, jsonb) FROM PUBLIC, anon;
+GRANT EXECUTE ON FUNCTION public.fiscalbr_note_for_provider(uuid, text) TO authenticated;
+GRANT EXECUTE ON FUNCTION public.fiscalbr_note_apply(uuid, text, jsonb, jsonb) TO authenticated;
+`;
 var MIGRATIONS = [
   { id: "000_baseline", sql: MIGRATION_000_BASELINE },
   { id: "001_preserve_terminal_results_and_recover_leases", sql: MIGRATION_001_PRESERVE_TERMINAL_RESULTS_AND_RECOVER_LEASES },
@@ -3665,7 +3789,9 @@ var MIGRATIONS = [
   { id: "014_a_descricao_da_nota_tem_lixo_no_meio", sql: MIGRATION_014_A_DESCRICAO_DA_NOTA_TEM_LIXO_NO_MEIO },
   { id: "015_o_movimento_diz_que_veio_da_nota", sql: MIGRATION_015_O_MOVIMENTO_DIZ_QUE_VEIO_DA_NOTA },
   { id: "016_a_nota_guarda_o_proprio_xml", sql: MIGRATION_016_A_NOTA_GUARDA_O_PROPRIO_XML },
-  { id: "017_quem_emite_e_o_cnpj_nao_a_loja", sql: MIGRATION_017_QUEM_EMITE_E_O_CNPJ_NAO_A_LOJA }
+  { id: "017_quem_emite_e_o_cnpj_nao_a_loja", sql: MIGRATION_017_QUEM_EMITE_E_O_CNPJ_NAO_A_LOJA },
+  { id: "018_a_nota_do_v1_alcanca_a_conta", sql: MIGRATION_018_A_NOTA_DO_V1_ALCANCA_A_CONTA },
+  { id: "019_a_nota_emitida_se_cancela_pelo_v2", sql: MIGRATION_019_A_NOTA_EMITIDA_SE_CANCELA_PELO_V2 }
 ];
 var taxGroupEntity = {
   name: "Grupo fiscal",
@@ -6305,6 +6431,499 @@ function UnitFiscalWidget({ item }) {
     ] })
   ] });
 }
+function sb3() {
+  const supabase = getSupabaseClientOptional();
+  if (!supabase) throw new Error("Supabase not initialized");
+  return supabase;
+}
+var NOTE_COLUMNS2 = `document_id, model, status, environment, number, series, access_key,
+  verification_code, provider_integration_id, total_value, recipient_snapshot, rejection_payload,
+  created_at, authorized_at, cancelled_at, cancel_reason`;
+function toNote(r) {
+  return {
+    documentId: r.document_id,
+    model: r.model,
+    status: r.status,
+    environment: r.environment ?? null,
+    number: r.number ?? null,
+    series: r.series ?? null,
+    accessKey: r.access_key ?? null,
+    verificationCode: r.verification_code ?? null,
+    integrationId: r.provider_integration_id ?? null,
+    totalValue: r.total_value == null ? null : Number(r.total_value),
+    recipient: r.recipient_snapshot ?? null,
+    rejection: r.rejection_payload ?? null,
+    createdAt: r.created_at,
+    authorizedAt: r.authorized_at ?? null,
+    cancelledAt: r.cancelled_at ?? null,
+    cancelReason: r.cancel_reason ?? null
+  };
+}
+async function listInvoiceNotes(invoiceId) {
+  const db = sb3();
+  const { data: inv, error: invError } = await db.from("plg_financial_invoices").select("order_id").eq("id", invoiceId).maybeSingle();
+  if (invError) throw invError;
+  const orderId = inv?.order_id ?? null;
+  if (!orderId) return [];
+  const [linked, direct] = await Promise.all([
+    db.from("plg_fiscalbr_document_orders").select("document_id").eq("order_id", orderId),
+    db.from("plg_fiscalbr_documents").select(NOTE_COLUMNS2).eq("order_id", orderId)
+  ]);
+  if (linked.error) throw linked.error;
+  if (direct.error) throw direct.error;
+  const byId = /* @__PURE__ */ new Map();
+  for (const r of direct.data ?? []) byId.set(r.document_id, toNote(r));
+  const missing = (linked.data ?? []).map((r) => r.document_id).filter((id) => !byId.has(id));
+  if (missing.length) {
+    const { data, error } = await db.from("plg_fiscalbr_documents").select(NOTE_COLUMNS2).in("document_id", missing);
+    if (error) throw error;
+    for (const r of data ?? []) byId.set(r.document_id, toNote(r));
+  }
+  return [...byId.values()].sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+async function listNoteEvents(documentId) {
+  const { data, error } = await sb3().from("plg_fiscalbr_document_events").select("id, event_type, status, justification, created_at").eq("document_id", documentId).order("created_at", { ascending: false }).limit(30);
+  if (error) throw error;
+  return (data ?? []).map((e) => ({
+    id: e.id,
+    eventType: e.event_type,
+    status: e.status ?? null,
+    justification: e.justification ?? null,
+    createdAt: e.created_at
+  }));
+}
+async function callIssuer(body) {
+  const { data, error } = await sb3().functions.invoke("fiscalbr-plugnotas", { body: { ...body, tenantId: getActiveTenantId() } });
+  if (error) {
+    const ctx = error?.context;
+    let message = error.message || "Falha ao falar com o emissor fiscal.";
+    if (ctx && typeof ctx.json === "function") {
+      try {
+        const b = await ctx.json();
+        if (b?.error) message = String(b.error);
+      } catch {
+      }
+    }
+    throw new Error(message);
+  }
+  if (data?.error) throw new Error(String(data.error));
+  return data;
+}
+async function refreshNote(documentId) {
+  const r = await callIssuer({ action: "poll_status", document_id: documentId });
+  return String(r?.status ?? "");
+}
+async function cancelNote(documentId, justification, code) {
+  const r = await callIssuer({ action: "cancel", document_id: documentId, justification, code });
+  return String(r?.status ?? "");
+}
+async function fetchNotePdf(documentId) {
+  const data = await callIssuer({ action: "get_pdf", document_id: documentId });
+  if (!(data instanceof Blob)) throw new Error("O emissor n\xE3o devolveu um PDF.");
+  return new Blob([data], { type: "application/pdf" });
+}
+
+// src/lib/issued-note.ts
+var MODEL_LABEL = { nfse: "NFS-e", nfce: "NFC-e", nfe: "NF-e" };
+var STATUS_META = {
+  authorized: { label: "Autorizada", tone: "success" },
+  draft: { label: "Enviando", tone: "warning" },
+  processing: { label: "Processando", tone: "warning" },
+  rejected: { label: "Rejeitada", tone: "danger" },
+  denied: { label: "Denegada", tone: "danger" },
+  error: { label: "Erro", tone: "danger" },
+  cancelled: { label: "Cancelada", tone: "muted" },
+  substituted: { label: "Substitu\xEDda", tone: "muted" }
+};
+var EVENT_LABEL = {
+  emissao: "Emiss\xE3o enviada",
+  consulta: "Consulta de status",
+  cancelamento: "Cancelamento",
+  substituicao: "Substitui\xE7\xE3o",
+  cce: "Carta de corre\xE7\xE3o",
+  inutilizacao: "Inutiliza\xE7\xE3o",
+  webhook: "Notifica\xE7\xE3o do emissor fiscal",
+  erro: "Erro"
+};
+var EVENT_STATUS_LABEL = {
+  CRIADO: "Enviando",
+  PROCESSANDO: "Processando",
+  CONCLUIDO: "Autorizada",
+  REJEITADO: "Rejeitada",
+  DENEGADO: "Denegada",
+  CANCELADO: "Cancelada",
+  SUBSTITUIDO: "Substitu\xEDda",
+  SOLICITADO: "Solicitado",
+  ERRO: "Erro"
+};
+function eventStatusLabel(status) {
+  return status ? EVENT_STATUS_LABEL[status.toUpperCase()] ?? null : null;
+}
+var IN_FLIGHT = ["draft", "processing"];
+var WITHOUT_EFFECT = ["rejected", "denied", "error", "cancelled", "substituted"];
+function isWithoutEffect(status) {
+  return WITHOUT_EFFECT.includes(status);
+}
+function statusLabel(note) {
+  if (IN_FLIGHT.includes(note.status) && note.cancelledAt) return "Cancelamento solicitado";
+  return (STATUS_META[note.status] ?? STATUS_META.error).label;
+}
+function summarizeNotes(notes) {
+  const s = { hasValid: false, withoutEffect: 0, inFlight: 0, validIsTest: false };
+  for (const n of notes) {
+    if (n.status === "authorized") {
+      s.hasValid = true;
+      if (n.environment === "homologacao") s.validIsTest = true;
+    } else if (IN_FLIGHT.includes(n.status)) s.inFlight += 1;
+    else if (WITHOUT_EFFECT.includes(n.status)) s.withoutEffect += 1;
+  }
+  return s;
+}
+function notesButtonState(s) {
+  if (s.hasValid) return "authorized";
+  if (s.inFlight > 0) return "processing";
+  if (s.withoutEffect > 0) return "failed-only";
+  return "none";
+}
+var SEFAZ_HINTS = [
+  ["E0120", "no padr\xE3o nacional a Inscri\xE7\xE3o Municipal \xE9 opcional (a nota identifica pelo CNPJ). Apague a IM na configura\xE7\xE3o fiscal da unidade e emita de novo."],
+  ["E0312", "geralmente falta o C\xD3DIGO DE TRIBUTA\xC7\xC3O DO MUNIC\xCDPIO (3 d\xEDgitos) na configura\xE7\xE3o fiscal da unidade \u2014 n\xE3o o nacional. Cada prefeitura tem a sua tabela; confirme o c\xF3digo com a contabilidade."],
+  ["E0314", "o c\xF3digo de tributa\xE7\xE3o do munic\xEDpio n\xE3o existe na tabela daquela prefeitura. Confirme o valor com a contabilidade da unidade \u2014 ele n\xE3o \xE9 o mesmo em todo munic\xEDpio. Fora do Rio de Janeiro, o normal \xE9 deixar esse campo VAZIO."],
+  ["E0084", "o CNPJ n\xE3o consta como estabelecido nesse munic\xEDpio no cadastro nacional. Isso se resolve FORA do sistema: a empresa precisa ter inscri\xE7\xE3o municipal ativa na prefeitura e o endere\xE7o do CNPJ na Receita Federal apontando para o mesmo munic\xEDpio. Fale com a contabilidade \u2014 n\xE3o h\xE1 o que ajustar aqui."]
+];
+var FIELD_LABELS = {
+  "prestador.cpfCnpj": "CNPJ do emitente",
+  "tomador.cpfCnpj": "CPF/CNPJ do cliente",
+  "tomador.razaoSocial": "Nome do cliente",
+  "tomador.endereco.cep": "CEP do cliente",
+  "tomador.endereco.codigoCidade": "Munic\xEDpio do cliente",
+  "servico.codigo": "C\xF3digo de tributa\xE7\xE3o do servi\xE7o",
+  "servico.iss.aliquota": "Al\xEDquota de ISS",
+  "itens.ncm": "NCM do produto",
+  "itens.cfop": "CFOP do produto",
+  "pagamentos.meio": "Forma de pagamento (tPag)",
+  "emitente.inscricaoMunicipal": "Inscri\xE7\xE3o municipal",
+  "emitente.inscricaoEstadual": "Inscri\xE7\xE3o estadual"
+};
+function explainRejection(rejection) {
+  if (!rejection) return { summary: "Nota rejeitada sem detalhe do motivo.", fields: [] };
+  const r = Array.isArray(rejection) ? rejection[0] : rejection;
+  const err = r?.error ?? r;
+  let message = String(err?.message || r?.mensagem || r?.motivo || "Nota rejeitada.");
+  const embedded = message.match(/\[\s*\{[\s\S]*\}\s*\]/);
+  if (embedded) {
+    try {
+      const arr = JSON.parse(embedded[0]);
+      const parts = (Array.isArray(arr) ? arr : [arr]).map((e) => [e.Codigo ?? e.codigo, e.Descricao ?? e.descricao ?? e.Mensagem ?? e.mensagem].filter(Boolean).join(" \u2014 ")).filter(Boolean);
+      if (parts.length) message = parts.join("; ");
+    } catch {
+    }
+  }
+  const hint = SEFAZ_HINTS.find(([code]) => message.includes(code));
+  if (hint) message = `${message} \u2014 ${hint[1]}`;
+  const fieldsObj = err?.data?.fields ?? {};
+  const fields = Object.entries(fieldsObj).map(([field, msg]) => {
+    const normalized = field.replace(/\[\d+\]/g, "").replace(/\.\d+\./g, ".");
+    return { field, label: FIELD_LABELS[normalized] ?? field, message: String(msg) };
+  });
+  return { summary: message, fields };
+}
+function recipientLabel(recipient) {
+  if (!recipient) return "Consumidor final";
+  if (recipient.consumidor) return "Consumidor final";
+  return String(recipient.razaoSocial ?? recipient.nome ?? recipient.cpfCnpj ?? "Consumidor final");
+}
+var TONE_VARIANT = {
+  success: "success",
+  warning: "warning",
+  danger: "destructive",
+  muted: "default"
+};
+var dateTime = (v) => v ? new Date(v).toLocaleString("pt-BR", { dateStyle: "short", timeStyle: "short" }) : "\u2014";
+var dayOrDateTime = (v) => {
+  if (!v) return "\u2014";
+  const d = new Date(v);
+  return d.getHours() === 0 && d.getMinutes() === 0 && d.getSeconds() === 0 ? d.toLocaleDateString("pt-BR") : dateTime(v);
+};
+var money4 = (v) => v == null ? "\u2014" : v.toLocaleString("pt-BR", { style: "currency", currency: "BRL" });
+function buttonHint(s) {
+  const parts = [s.hasValid ? "Notas fiscais desta conta \u2014 h\xE1 uma nota v\xE1lida" : "Notas fiscais desta conta"];
+  if (s.withoutEffect > 0) parts.push(`${s.withoutEffect} cancelada(s), rejeitada(s) ou com erro`);
+  if (s.validIsTest) parts.push("a nota v\xE1lida \xE9 de TESTE, sem valor fiscal");
+  return parts.join(" \xB7 ");
+}
+function InvoiceNotesButton({ invoiceId, direction, cancelled }) {
+  const [notes, setNotes] = useState(null);
+  const [open, setOpen] = useState(false);
+  const can = usePermissionOptional();
+  const canCancel = can("financial", "edit");
+  const reload = useCallback(async () => {
+    if (!invoiceId || direction !== "credit") return;
+    try {
+      setNotes(await listInvoiceNotes(invoiceId));
+    } catch {
+      setNotes((prev) => prev ?? []);
+    }
+  }, [invoiceId, direction]);
+  useEffect(() => {
+    void reload();
+  }, [reload]);
+  if (!notes || notes.length === 0) return null;
+  const summary = summarizeNotes(notes);
+  const state = notesButtonState(summary);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(TooltipProvider, { delayDuration: 200, children: /* @__PURE__ */ jsxs(Tooltip, { children: [
+      /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(Button, { type: "button", variant: "outline", size: "sm", className: "relative h-9 gap-1.5", "aria-label": "Nota Fiscal", onClick: () => setOpen(true), children: [
+        state === "authorized" ? /* @__PURE__ */ jsx(CheckCircle2, { className: "h-4 w-4 text-success", "aria-hidden": true }) : state === "processing" ? /* @__PURE__ */ jsx(Loader2, { className: "h-4 w-4 animate-spin text-warning", "aria-hidden": true }) : /* @__PURE__ */ jsx(FileCheck2, { className: "h-4 w-4", "aria-hidden": true }),
+        /* @__PURE__ */ jsx("span", { className: "hidden sm:inline", children: "Nota Fiscal" }),
+        summary.withoutEffect > 0 && /* @__PURE__ */ jsx("span", { className: "inline-flex h-4 min-w-4 items-center justify-center rounded-full bg-destructive px-1 text-[10px] font-bold text-destructive-foreground", children: summary.withoutEffect }),
+        summary.validIsTest && /* @__PURE__ */ jsx("span", { className: "rounded border border-destructive px-1 text-[10px] font-semibold text-destructive", children: "TESTE" })
+      ] }) }),
+      /* @__PURE__ */ jsx(TooltipContent, { children: buttonHint(summary) })
+    ] }) }),
+    /* @__PURE__ */ jsx(Modal, { open, onOpenChange: setOpen, children: /* @__PURE__ */ jsxs(ModalContent, { size: "2xl", children: [
+      /* @__PURE__ */ jsxs(ModalHeader, { children: [
+        /* @__PURE__ */ jsx(ModalTitle, { children: "Nota Fiscal" }),
+        /* @__PURE__ */ jsx(ModalDescription, { children: "Notas emitidas para esta conta." })
+      ] }),
+      /* @__PURE__ */ jsxs(ModalBody, { className: "gap-2", children: [
+        notes.map((n) => /* @__PURE__ */ jsx(NoteRow, { note: n, canCancel, onChanged: reload }, n.documentId)),
+        /* @__PURE__ */ jsx("p", { className: "pt-2 text-xs text-muted-foreground", children: "Emitir uma nota nova por aqui chega na pr\xF3xima etapa." })
+      ] })
+    ] }) })
+  ] });
+}
+var POLL_DELAYS = [3e3, 5e3, 8e3, 12e3, 2e4];
+function NoteRow({ note, canCancel, onChanged }) {
+  const [expanded, setExpanded] = useState(false);
+  const [cancelling, setCancelling] = useState(false);
+  const [busy, setBusy] = useState(null);
+  const dimmed = isWithoutEffect(note.status);
+  const tone = (STATUS_META[note.status] ?? STATUS_META.error).tone;
+  const usable = note.status === "authorized" || note.status === "cancelled";
+  const inFlight = note.status === "processing" || note.status === "draft";
+  const cancellable = canCancel && note.status === "authorized" && !note.cancelledAt;
+  const openPdf = async () => {
+    const w = window.open("", "_blank");
+    setBusy("pdf");
+    try {
+      const blob = await fetchNotePdf(note.documentId);
+      const url = URL.createObjectURL(blob);
+      if (w) w.location.href = url;
+      else window.location.assign(url);
+    } catch (e) {
+      w?.close();
+      toast.error("PDF indispon\xEDvel", { description: e instanceof Error ? e.message : String(e) });
+    } finally {
+      setBusy(null);
+    }
+  };
+  const refresh = async () => {
+    setBusy("refresh");
+    try {
+      const status = await refreshNote(note.documentId);
+      await onChanged();
+      toast(status === note.status ? "Ainda em processamento na SEFAZ/prefeitura" : `Nota ${statusLabel({ status, cancelledAt: null }).toLowerCase()}`);
+    } catch (e) {
+      toast.error("N\xE3o foi poss\xEDvel consultar", { description: e instanceof Error ? e.message : String(e) });
+    } finally {
+      setBusy(null);
+    }
+  };
+  return /* @__PURE__ */ jsxs("div", { className: `rounded-lg border ${dimmed ? "bg-muted/30" : ""}`, children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        className: "flex w-full items-center gap-2 p-3 text-left",
+        onClick: () => setExpanded((v) => !v),
+        "aria-expanded": expanded,
+        children: [
+          /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-wrap items-center gap-2", children: [
+            /* @__PURE__ */ jsx(Badge, { variant: "outline", children: MODEL_LABEL[note.model] ?? note.model }),
+            note.number && /* @__PURE__ */ jsxs("span", { className: "font-mono text-sm", children: [
+              "n\xBA ",
+              note.number
+            ] }),
+            /* @__PURE__ */ jsx(Badge, { variant: TONE_VARIANT[tone], children: statusLabel(note) }),
+            note.environment === "homologacao" && /* @__PURE__ */ jsx("span", { className: "rounded border border-destructive px-1 text-[10px] font-semibold text-destructive", children: "TESTE" }),
+            /* @__PURE__ */ jsx("span", { className: "ml-auto text-xs tabular-nums text-muted-foreground", children: dateTime(note.createdAt) })
+          ] }),
+          /* @__PURE__ */ jsx(ChevronDown, { className: `h-4 w-4 shrink-0 text-muted-foreground transition-transform ${expanded ? "rotate-180" : ""}`, "aria-hidden": true })
+        ]
+      }
+    ),
+    note.cancelReason && !expanded && /* @__PURE__ */ jsxs("p", { className: "flex items-start gap-1.5 px-3 pb-2 text-xs text-muted-foreground", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "mt-0.5 h-3.5 w-3.5 shrink-0", "aria-hidden": true }),
+      /* @__PURE__ */ jsxs("span", { className: "break-words", children: [
+        "Motivo: ",
+        note.cancelReason
+      ] })
+    ] }),
+    (usable || inFlight || note.cancelledAt) && !cancelling && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-1.5 px-3 pb-3", children: [
+      usable && /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", className: "h-7 text-xs", disabled: busy === "pdf", onClick: openPdf, children: [
+        busy === "pdf" ? /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin", "aria-hidden": true }) : /* @__PURE__ */ jsx(FileText, { className: "h-3.5 w-3.5", "aria-hidden": true }),
+        "PDF"
+      ] }),
+      (inFlight || note.cancelledAt && note.status === "authorized") && /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", className: "h-7 text-xs", disabled: busy === "refresh", onClick: refresh, children: [
+        busy === "refresh" ? /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin", "aria-hidden": true }) : /* @__PURE__ */ jsx(RefreshCw, { className: "h-3.5 w-3.5", "aria-hidden": true }),
+        "Atualizar"
+      ] }),
+      cancellable && /* @__PURE__ */ jsxs(Button, { variant: "ghost", size: "sm", className: "ml-auto h-7 text-xs text-destructive hover:text-destructive", onClick: () => setCancelling(true), children: [
+        /* @__PURE__ */ jsx(XCircle, { className: "h-3.5 w-3.5", "aria-hidden": true }),
+        " Cancelar nota"
+      ] })
+    ] }),
+    cancelling && /* @__PURE__ */ jsx(CancelNotePanel, { note, onClose: () => setCancelling(false), onDone: async () => {
+      setCancelling(false);
+      await onChanged();
+    } }),
+    expanded && /* @__PURE__ */ jsx(NoteDetails, { note })
+  ] });
+}
+var NFSE_REASONS = [
+  { value: "1", label: "Erro na emiss\xE3o" },
+  { value: "2", label: "Servi\xE7o n\xE3o prestado" },
+  { value: "9", label: "Outros" }
+];
+function CancelNotePanel({ note, onClose, onDone }) {
+  const isNfse = note.model === "nfse";
+  const [code, setCode] = useState("2");
+  const [text, setText] = useState("");
+  const [working, setWorking] = useState(null);
+  const [error, setError] = useState(null);
+  const min = isNfse ? 10 : 15;
+  const missing = Math.max(0, min - text.trim().length);
+  const confirm = async () => {
+    setError(null);
+    setWorking("sending");
+    try {
+      let status = await cancelNote(note.documentId, text.trim(), isNfse ? code : void 0);
+      setWorking("waiting");
+      for (const delay of POLL_DELAYS) {
+        if (status === "cancelled" || status === "authorized") break;
+        await new Promise((r) => setTimeout(r, delay));
+        try {
+          status = await refreshNote(note.documentId);
+        } catch {
+        }
+      }
+      if (status === "cancelled") toast.success(`${MODEL_LABEL[note.model]} n\xBA ${note.number ?? ""} cancelada`);
+      else if (status === "authorized") toast.error("A SEFAZ/prefeitura recusou o cancelamento", { description: "A nota continua v\xE1lida. Veja o hist\xF3rico nos detalhes." });
+      else toast("Cancelamento solicitado", { description: "A SEFAZ/prefeitura ainda est\xE1 processando. Use \xABAtualizar\xBB para conferir." });
+      await onDone();
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+      setWorking(null);
+    }
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3 border-t bg-destructive-soft/40 px-3 py-3", children: [
+    /* @__PURE__ */ jsxs("p", { className: "text-sm font-semibold", children: [
+      "Cancelar ",
+      MODEL_LABEL[note.model],
+      " ",
+      note.number ? `n\xBA ${note.number}` : ""
+    ] }),
+    /* @__PURE__ */ jsxs("p", { className: "text-xs text-muted-foreground", children: [
+      isNfse ? "O prazo de cancelamento da NFS-e \xE9 definido pelo munic\xEDpio." : "O prazo de cancelamento da NFC-e \xE9 curto (em geral ~30 minutos ap\xF3s a autoriza\xE7\xE3o, conforme a UF). Fora do prazo, a SEFAZ recusa.",
+      " ",
+      "Cancelar n\xE3o pode ser desfeito."
+    ] }),
+    isNfse && /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-xs font-medium", children: "Motivo" }),
+      /* @__PURE__ */ jsx(SegmentedControl, { size: "sm", "aria-label": "Motivo do cancelamento", options: NFSE_REASONS, value: code, onChange: setCode })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
+      /* @__PURE__ */ jsx("label", { htmlFor: `cancel-${note.documentId}`, className: "text-xs font-medium", children: "Justificativa" }),
+      /* @__PURE__ */ jsx(
+        "textarea",
+        {
+          id: `cancel-${note.documentId}`,
+          value: text,
+          onChange: (e) => setText(e.target.value),
+          maxLength: 255,
+          rows: 3,
+          disabled: !!working,
+          placeholder: isNfse ? "Descreva o motivo\u2026" : "Ex.: Emiss\xE3o em duplicidade por erro operacional",
+          className: "w-full resize-y rounded-md border bg-background px-3 py-2 text-sm",
+          autoFocus: true
+        }
+      ),
+      /* @__PURE__ */ jsx("p", { className: "text-[11px] text-muted-foreground", children: missing > 0 ? `Faltam ${missing} caractere(s) \u2014 a justificativa vai para a SEFAZ/prefeitura.` : "Vai para a SEFAZ/prefeitura junto do pedido." })
+    ] }),
+    error && /* @__PURE__ */ jsxs("p", { className: "flex items-start gap-1.5 rounded-md border border-destructive/40 bg-destructive-soft p-2 text-xs text-destructive-soft-foreground", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "mt-0.5 h-3.5 w-3.5 shrink-0", "aria-hidden": true }),
+      " ",
+      /* @__PURE__ */ jsx("span", { className: "break-words", children: error })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap justify-end gap-2", children: [
+      /* @__PURE__ */ jsx(Button, { variant: "outline", size: "sm", onClick: onClose, disabled: !!working, children: "Voltar" }),
+      /* @__PURE__ */ jsxs(Button, { variant: "destructive", size: "sm", onClick: confirm, disabled: !!working || missing > 0, children: [
+        working ? /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin", "aria-hidden": true }) : /* @__PURE__ */ jsx(XCircle, { className: "h-3.5 w-3.5", "aria-hidden": true }),
+        working === "waiting" ? "Aguardando a SEFAZ/prefeitura\u2026" : working ? "Enviando\u2026" : "Confirmar cancelamento"
+      ] })
+    ] })
+  ] });
+}
+function NoteDetails({ note }) {
+  const [events, setEvents] = useState(null);
+  useEffect(() => {
+    let alive = true;
+    listNoteEvents(note.documentId).then((e) => {
+      if (alive) setEvents(e);
+    }).catch(() => {
+      if (alive) setEvents([]);
+    });
+    return () => {
+      alive = false;
+    };
+  }, [note.documentId]);
+  const failed = ["rejected", "denied", "error"].includes(note.status);
+  const rejection = failed ? explainRejection(note.rejection) : null;
+  const rows = [
+    ["Refer\xEAncia", note.integrationId && /* @__PURE__ */ jsx("span", { className: "break-all font-mono text-xs", children: note.integrationId })],
+    ["Chave de acesso", note.accessKey && /* @__PURE__ */ jsx("span", { className: "break-all font-mono text-xs", children: note.accessKey })],
+    ["C\xF3digo de verifica\xE7\xE3o", note.verificationCode],
+    ["Valor", money4(note.totalValue)],
+    ["Tomador", recipientLabel(note.recipient)],
+    ["Criada em", dateTime(note.createdAt)],
+    ["Autorizada em", note.authorizedAt && dayOrDateTime(note.authorizedAt)],
+    ["Cancelada em", note.cancelledAt && `${dateTime(note.cancelledAt)}${note.cancelReason ? ` \u2014 ${note.cancelReason}` : ""}`]
+  ];
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-3 border-t px-3 py-3", children: [
+    /* @__PURE__ */ jsx("dl", { className: "text-sm", children: rows.filter(([, v]) => v).map(([label, value]) => /* @__PURE__ */ jsxs("div", { className: "flex gap-3 border-b py-1.5 last:border-0", children: [
+      /* @__PURE__ */ jsx("dt", { className: "w-28 shrink-0 text-muted-foreground sm:w-36", children: label }),
+      /* @__PURE__ */ jsx("dd", { className: "min-w-0 flex-1 break-words font-medium", children: value })
+    ] }, label)) }),
+    rejection && /* @__PURE__ */ jsxs("div", { className: "space-y-1.5 rounded-md border border-destructive/40 bg-destructive-soft p-3", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-sm font-semibold text-destructive-soft-foreground", children: "Por que foi rejeitada?" }),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-foreground", children: rejection.summary }),
+      rejection.fields.length > 0 && /* @__PURE__ */ jsx("ul", { className: "space-y-1 text-xs text-foreground", children: rejection.fields.map((f) => /* @__PURE__ */ jsxs("li", { children: [
+        /* @__PURE__ */ jsxs("span", { className: "font-medium", children: [
+          f.label,
+          ":"
+        ] }),
+        " ",
+        f.message
+      ] }, f.field)) })
+    ] }),
+    events === null ? /* @__PURE__ */ jsxs("div", { className: "space-y-1.5", children: [
+      /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-3/4" }),
+      /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-2/3" })
+    ] }) : events.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx("p", { className: "mb-1.5 text-sm font-semibold", children: "Hist\xF3rico" }),
+      /* @__PURE__ */ jsx("ul", { className: "space-y-1", children: events.map((e) => /* @__PURE__ */ jsxs("li", { className: "flex flex-wrap items-center gap-2 text-xs", children: [
+        /* @__PURE__ */ jsx("span", { className: "whitespace-nowrap tabular-nums text-muted-foreground", children: dateTime(e.createdAt) }),
+        /* @__PURE__ */ jsx(Badge, { variant: "outline", className: "text-[10px]", children: EVENT_LABEL[e.eventType] ?? "Evento" }),
+        eventStatusLabel(e.status) && /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: eventStatusLabel(e.status) }),
+        e.justification && /* @__PURE__ */ jsxs("span", { className: "min-w-0 truncate", children: [
+          "\u2014 ",
+          e.justification
+        ] })
+      ] }, e.id)) })
+    ] })
+  ] });
+}
 
 // src/lib/financial-provider.ts
 function fiscalReader(provider) {
@@ -6578,6 +7197,13 @@ function createPlugNotasPlugin(options = {}) {
         order: 0,
         permission: { feature: "financial", action: "read" }
       },
+      {
+        id: "fiscal-br-invoice-notes",
+        zone: FINANCIAL_INVOICE_ZONES.headerActions,
+        component: InvoiceNotesButton,
+        order: 0,
+        permission: { feature: "financial", action: "read" }
+      },
       {
         id: "fiscal-br-unit-fiscal",
         zone: UNIT_DETAIL_ZONES.fiscal,
@@ -6657,6 +7283,6 @@ function createPlugNotasPlugin(options = {}) {
   });
 }
 
-export { InboundNoteDocumentModal, InboundNotesPage, InboundNotesView, IssuedNotesView, ManifestView, NfeParseError, NoteReconcileView, PLUGNOTAS_CONNECTOR_ID, PLUGNOTAS_FIELDS, PLUGNOTAS_SETTINGS, ReturnedNotesView, STOCK_BEARING_ENTRY_TYPES, TaxGroupsView, acceptNote, createPlugNotasConnector, createPlugNotasFinancialProvider, createPlugNotasPlugin, findInboxNoteByNumber, findInboxNoteByOperation, getInboxNote, getInboxNoteXml, inboundNoteDocumentModal, inboundNotesInventoryView, isStockBearing, isValidCnpj, listChartAccounts, listInboxNotes, listMeasurementUnits, listProductsByIds, listStockLocations, listSupplierMap, markPlugNotasEmitterReady, onlyDigits, parseNfeXml, paymentLabel, paymentTypeFromCode, rejectNote, saveNoteDecision, searchProducts, stageNoteFromXml, suggestNoteItems, toStagePayload };
+export { EVENT_LABEL, InboundNoteDocumentModal, InboundNotesPage, InboundNotesView, InvoiceNotesButton, IssuedNotesView, MODEL_LABEL, ManifestView, NfeParseError, NoteReconcileView, PLUGNOTAS_CONNECTOR_ID, PLUGNOTAS_FIELDS, PLUGNOTAS_SETTINGS, ReturnedNotesView, STATUS_META, STOCK_BEARING_ENTRY_TYPES, TaxGroupsView, acceptNote, cancelNote, createPlugNotasConnector, createPlugNotasFinancialProvider, createPlugNotasPlugin, eventStatusLabel, explainRejection, fetchNotePdf, findInboxNoteByNumber, findInboxNoteByOperation, getInboxNote, getInboxNoteXml, inboundNoteDocumentModal, inboundNotesInventoryView, isStockBearing, isValidCnpj, isWithoutEffect, listChartAccounts, listInboxNotes, listInvoiceNotes, listMeasurementUnits, listNoteEvents, listProductsByIds, listStockLocations, listSupplierMap, markPlugNotasEmitterReady, notesButtonState, onlyDigits, parseNfeXml, paymentLabel, paymentTypeFromCode, recipientLabel, refreshNote, rejectNote, saveNoteDecision, searchProducts, stageNoteFromXml, statusLabel, suggestNoteItems, summarizeNotes, toStagePayload };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map