diff --git a/.claude/settings.json b/.claude/settings.json
index 8545763..1293cfc 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -151,7 +151,9 @@
       "PowerShell(& \"C:\\\\Users\\\\Depaula\\\\Documents\\\\Portal\\\\.venv\\\\Scripts\\\\python.exe\" manage.py makemigrations portal_api --name contabil_ordering_determinista --dry-run -v 2)",
       "PowerShell(& \"C:\\\\Users\\\\Depaula\\\\Documents\\\\Portal\\\\.venv\\\\Scripts\\\\python.exe\" manage.py makemigrations portal_api --name contabil_ordering_determinista)",
       "PowerShell(& \"C:\\\\Users\\\\Depaula\\\\Documents\\\\Portal\\\\.venv\\\\Scripts\\\\python.exe\" \"C:\\\\Users\\\\Depaula\\\\AppData\\\\Local\\\\Temp\\\\claude\\\\c--Users-Depaula-Documents-Portal\\\\33b72ffc-a7b3-4b7e-8afe-bb65121e9a85\\\\scratchpad\\\\testa_removidos.py\")",
-      "PowerShell(.venv\\\\Scripts\\\\python.exe manage.py migrate portal_api 0080)"
+      "PowerShell(.venv\\\\Scripts\\\\python.exe manage.py migrate portal_api 0080)",
+      "Bash(file *)",
+      "Bash(iconv -f latin1 -t utf-8)"
     ],
     "additionalDirectories": [
       "C:\\Users\\Depaula\\AppData\\Local\\Temp\\claude\\c--Users-Depaula-Documents-Portal\\3ea0ee22-e5fd-4030-98b1-ee2e71c16ce0\\scratchpad\\halloween-design",
diff --git a/CLAUDE.md b/CLAUDE.md
index 4e028a3..2994d45 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -27,6 +27,7 @@ Aplicações com pacote Python próprio (`CLAUDE.md` **carregado automaticamente
 | Simulação de Custo de Contratação | `portal_api/custo_contratacao/` — `CLAUDE.md` (técnico), `README.md`, `CHANGELOG.md` |
 | Não Conformidades | `portal_api/nao_conformidades/` — `CLAUDE.md` (técnico), `README.md`, `CHANGELOG.md` |
 | Relatório Contábil | `portal_api/dashboard_contabil/` — `CLAUDE.md` (técnico), `README.md`, `CHANGELOG.md` |
+| Conciliação de Fornecedores | `portal_api/conciliacao_fornecedores/` — `CLAUDE.md` (técnico), `README.md`, `CHANGELOG.md` |
 
 Aplicações sem pacote Python dedicado (código ainda em `portal_api/models.py`/`views.py`/`serializers.py` — os arquivos em `docs/<app>/` **não** são carregados automaticamente, ler manualmente):
 
@@ -96,7 +97,7 @@ Ver `docs/identidade-visual/identidade-visual.md` para o inventário de cada arq
 
 ### Backend serve o frontend (mesma origem)
 
-`config/urls.py` registra `path("api/", include("portal_api.urls"))` e, para cada uma das **14 páginas HTML** do frontend (`index.html` mais os 13 shells — ver a tabela em "Páginas" abaixo), uma rota `TemplateView` que resolve o arquivo em `templates/`. O 15º template, `dashboard-contabil-relatorio.html`, não tem rota própria: é renderizado por uma view do Relatório Contábil, não navegável pela URL. Os estáticos (`static/css`, `static/js`, `static/img`) são servidos por `django.contrib.staticfiles` automaticamente em `DEBUG` (via `STATICFILES_DIRS`) — não há mais nenhum `re_path`/`static_serve` manual em `urls.py`. Cada template usa `{% load static %}` + `{% static 'css/tokens.css' %}` (nunca um caminho hardcoded tipo `assets/css/...`, que não existe mais). Essa escolha (Django servindo o próprio frontend) existe para evitar CORS/cookie cross-origin: autenticação é por **sessão/cookie do Django**, então frontend e API precisam estar na mesma origem.
+`config/urls.py` registra `path("api/", include("portal_api.urls"))` e, para cada uma das **15 páginas HTML** do frontend (`index.html` mais os 14 shells — ver a tabela em "Páginas" abaixo), uma rota `TemplateView` que resolve o arquivo em `templates/`. O 15º template, `dashboard-contabil-relatorio.html`, não tem rota própria: é renderizado por uma view do Relatório Contábil, não navegável pela URL. Os estáticos (`static/css`, `static/js`, `static/img`) são servidos por `django.contrib.staticfiles` automaticamente em `DEBUG` (via `STATICFILES_DIRS`) — não há mais nenhum `re_path`/`static_serve` manual em `urls.py`. Cada template usa `{% load static %}` + `{% static 'css/tokens.css' %}` (nunca um caminho hardcoded tipo `assets/css/...`, que não existe mais). Essa escolha (Django servindo o próprio frontend) existe para evitar CORS/cookie cross-origin: autenticação é por **sessão/cookie do Django**, então frontend e API precisam estar na mesma origem.
 
 Em produção, rodar `python manage.py collectstatic` (junta tudo em `STATIC_ROOT = BASE_DIR / "staticfiles"`) e servir esse diretório via whitenoise/nginx — `django.contrib.staticfiles` só serve automaticamente quando `DEBUG=True`. Uploads de usuário (ícones de `LinkFerramenta`) são um mecanismo separado: `MEDIA_URL`/`MEDIA_ROOT` em `settings.py`, servidos por `config/urls.py` via `static()` só quando `DEBUG=True` (em produção, servir `media/` também por whitenoise/nginx, igual ao `STATIC_ROOT`).
 
@@ -124,6 +125,7 @@ Pacotes Python puros (sem ORM), um por ferramenta — cada um com seu próprio `
 | `custo_contratacao/` | "Simulação de Custo de Contratação" (Geradoc) — `tabelas.py` (faixas de INSS/IRRF), `calculo.py`, `pdf.py` via `reportlab`. |
 | `indicadores/` | "Indicador de Desempenho" (Geradoc) — `tipos.py`, `leiaute.py` (`openpyxl`), `pipeline.py`, `entregas.py`, `calculo.py`, `recibo.py` (PDF via `reportlab`), `departamentos.py`. |
 | `nao_conformidades/` | "Não Conformidades" (Relatórios > Qualidade) — leiautes dos exports do Sigsistem, `diff.py` (reabertura automática), `classificacao.py`, `pipeline.py`. |
+| `conciliacao_fornecedores/` | "Conciliação de Fornecedores" (Utilitários) — `parser.py` (razão do Questor em XLSX/CSV), `motor.py` (vínculos automáticos débito × crédito), `alertas.py` (situação/alertas recalculados a cada leitura), `exportacao.py` (XLSX). |
 | `dashboard_contabil/` | "Relatório Contábil" (Relatórios > Contabilidade) — `parser.py` (extração do PDF), `regras.py` (motor de auditoria), `formula.py` (avaliador de fórmula por `ast`), `indicadores.py`, `chaves.py` (chave natural de conta/linha, compartilhada por sincronização, observações e relatório), `exportacao.py` (XLSX), `resumo_pdf.py`. |
 
 ### API (sessão + CSRF, não token)
@@ -179,6 +181,7 @@ Pacotes Python puros (sem ORM), um por ferramenta — cada um com seu próprio `
 | `custo-contratacao.html` | Ferramenta de Geradoc: formulário de simulação de custo de contratação (Empregado CLT) + painel colapsável de parâmetros fiscais, gera um PDF (ver `portal_api/custo_contratacao/CLAUDE.md`). |
 | `indicador-desempenho.html` | Ferramenta de Geradoc: histórico de apurações + nova apuração (upload das 2 planilhas) + cadastro de critérios/percentuais + revisão/geração dos recibos em PDF do Indicador de Desempenho do Fiscontábil (ver `portal_api/indicadores/CLAUDE.md`). |
 | `nao-conformidades.html` | Aplicação de Relatórios > Qualidade: gestão contínua das ocorrências/ações do Sigsistem, com dashboard e status interno de tratativa da Qualidade (ver `portal_api/nao_conformidades/CLAUDE.md`). |
+| `conciliacao-fornecedores.html` | Ferramenta de Utilitários: histórico + nova conciliação (código da empresa com nome buscado no Questor + razão de fornecedores .xlsx/.csv) + detalhe com cards de alerta e tabela de fornecedores expansível, vínculo manual, validação e exportação XLSX (ver `portal_api/conciliacao_fornecedores/CLAUDE.md`). |
 | `dashboard-contabil.html` | Aplicação de Relatórios > Contabilidade ("Relatório Contábil" na UI): histórico de análises + nova análise (upload do PDF de Balancete + DRE) + revisão de achados de auditoria (com observações por conta) + botão "Gerar Relatório" (relatório HTML autocontido, ver `portal_api/dashboard_contabil/CLAUDE.md`). |
 
 O item "Calendário De Paula" no menu **não é uma página local** — é um `<a href="#" id="calendario-depaula-btn">` (continua favoritável, já que ainda é um `<a class="nav-item">` — ver `docs/favoritos/favoritos.md`) cujo clique é interceptado em `sidebar.js` (`PID_CALENDARIO_DEPAULA_URL`) pra abrir `https://depaula-tvcorporativa.lovable.app/calendario` num modal com `<iframe>` (`#calendario-depaula-modal`, presente em todo shell) em vez de navegar — mesmo padrão do modal "Novo Chamado" de Ramais (`.ram-chamado-*` em `ramais.css`/`ramais.js`), só que genérico o bastante (`.iframe-modal-*` em `components.css`) pra existir em todo shell, não só em `ramais.html`. Funciona porque esse host (mesmo domínio do "Novo Chamado") não bloqueia ser embutido via `X-Frame-Options`/CSP, ao contrário do Asana (ver `docs/solicitacoes/solicitacoes.md`) — só foi possível confirmar isso testando de fato, não é garantia geral por domínio. Não recriar um `calendario.html` interno sem confirmar com o usuário; o antigo foi removido de propósito.
@@ -338,6 +341,12 @@ Gestão contínua das ocorrências e ações do Sistema de Gestão da Qualidade
 
 Ver `portal_api/nao_conformidades/CLAUDE.md`.
 
+## Conciliação de Fornecedores (Utilitários)
+
+O contador informa o código da empresa (nome buscado no Questor) e anexa o razão contábil de fornecedores exportado do Questor; a ferramenta vincula pagamentos e títulos de cada fornecedor por valor e data (inclusive combinações e parcelas) e aponta o que está pendente: títulos em aberto há mais de 2 meses, pagamentos sem título (divergência), diferenças de juros/desconto e conta transitória com saldo. Vínculo manual, validação por conta, histórico salvo e exportação XLSX. Restrita ao perfil Inovação.
+
+Ver `portal_api/conciliacao_fornecedores/CLAUDE.md`.
+
 ## Relatório Contábil (Relatórios > Contabilidade)
 
 Chamado de "Dashboard Contábil" até uma rodada anterior — renomeado pra "Relatório Contábil" a pedido explícito do usuário, pra soar como um aliado do trabalho do contador em vez de mais um processo/sistema novo (rename só de rótulo visível: menu, título da página, cabeçalhos e o botão que gera o relatório; nomes técnicos internos — pasta do pacote, arquivos, classes de model, rotas — continuam `dashboard_contabil`/`dashboard-contabil.*`/`Contabil*`/`/contabil-*`, sem nenhuma mudança).
@@ -366,6 +375,7 @@ Ver `portal_api/dashboard_contabil/CLAUDE.md`.
 | `custo-contratacao.css` | `.cc-*` — só usado em `custo-contratacao.html`. |
 | `indicador-desempenho.css` | `.ind-*` — só usado em `indicador-desempenho.html`; carrega `perfis-acesso.css` também, pelo mesmo motivo de `importacao-plano-saude.css` (tabela/abas de revisão). |
 | `nao-conformidades.css` | `.ncf-*` — só usado em `nao-conformidades.html`; carrega `perfis-acesso.css` também, pra reaproveitar `.pa-table`/`.pa-tabs`/`.status-pill` (modificadores `--ok`/`--danger`/`--warning`/`--neutral` novos, em cima do `.status-pill` já existente ali). |
+| `conciliacao-fornecedores.css` | `.conc-*` — só usado em `conciliacao-fornecedores.html`; carrega `perfis-acesso.css` também, pra reaproveitar `.pa-table`/`.pa-search`/`.status-pill`. |
 | `dashboard-contabil.css` | `.dc-*` — só usado em `dashboard-contabil.html`; carrega `perfis-acesso.css` também, pra reaproveitar `.pa-table`/`.pa-tabs` na revisão de achados/Balancete/DRE. |
 
 Ao adicionar uma tela nova que precise de modal, reuse `.modal-overlay`/`.modal-card` de `components.css` e só crie estilos de campo próprios se o formulário não for um caso simples de texto/select (que já tem equivalente em `.pa-field` ou `.modal-field`).
diff --git a/README.md b/README.md
index 9c5832b..c528f4d 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,7 @@ Não há suíte de testes, lint ou build configurados neste projeto.
 | Perfis de Acesso / Usuários | Administração | [docs/perfis-usuarios/](docs/perfis-usuarios/README.md) |
 | Importação de Plano de Saúde | Utilitários | [portal_api/planos_saude/](portal_api/planos_saude/README.md) |
 | Importação de Plano de Saúde - De Paula (mesma ferramenta, para o plano dos próprios colaboradores) | Utilitários | [portal_api/planos_saude/](portal_api/planos_saude/README.md) |
+| Conciliação de Fornecedores | Utilitários | [portal_api/conciliacao_fornecedores/](portal_api/conciliacao_fornecedores/README.md) |
 | Simulação de Custo de Contratação | Geradoc | [portal_api/custo_contratacao/](portal_api/custo_contratacao/README.md) |
 | Indicador de Desempenho | Geradoc | [portal_api/indicadores/](portal_api/indicadores/README.md) |
 | Não Conformidades | Relatórios > Qualidade | [portal_api/nao_conformidades/](portal_api/nao_conformidades/README.md) |
diff --git a/config/urls.py b/config/urls.py
index 7dc3a9e..e962dee 100644
--- a/config/urls.py
+++ b/config/urls.py
@@ -23,6 +23,7 @@ PAGINAS_FRONTEND = [
     "ramais.html",
     "importacao-plano-saude.html",
     "importacao-plano-saude-de-paula.html",
+    "conciliacao-fornecedores.html",
     "custo-contratacao.html",
     "indicador-desempenho.html",
     "nao-conformidades.html",
diff --git a/media/conciliacao_fornecedores/Teste_Exportação_-_Fornecedores_-_2017.xlsx b/media/conciliacao_fornecedores/Teste_Exportação_-_Fornecedores_-_2017.xlsx
new file mode 100644
index 0000000..ab34dfb
Binary files /dev/null and b/media/conciliacao_fornecedores/Teste_Exportação_-_Fornecedores_-_2017.xlsx differ
diff --git a/portal_api/admin.py b/portal_api/admin.py
index a799985..11ab154 100644
--- a/portal_api/admin.py
+++ b/portal_api/admin.py
@@ -6,6 +6,10 @@ from .models import (
     AcessoGeralSecao,
     AjudaAplicacao,
     CompromissoAgenda,
+    ConciliacaoFornecedor,
+    ConciliacaoFornecedorConta,
+    ConciliacaoFornecedorLancamento,
+    ConciliacaoFornecedorVinculo,
     ContabilAchado,
     ContabilApuracao,
     ContabilApuracaoReprocessamento,
@@ -308,3 +312,30 @@ class ContabilAchadoAdmin(admin.ModelAdmin):
     list_display = ("apuracao", "regra", "severidade", "status", "titulo")
     list_filter = ("regra", "severidade", "status")
     search_fields = ("titulo", "mensagem")
+
+
+@admin.register(ConciliacaoFornecedor)
+class ConciliacaoFornecedorAdmin(admin.ModelAdmin):
+    list_display = ("codigo_empresa", "nome_empresa", "data_base", "criado_por", "criado_em")
+    search_fields = ("codigo_empresa", "nome_empresa")
+    ordering = ("-criado_em",)
+
+
+@admin.register(ConciliacaoFornecedorConta)
+class ConciliacaoFornecedorContaAdmin(admin.ModelAdmin):
+    list_display = ("conciliacao", "conta_numero", "fornecedor", "saldo_inicial", "saldo_final", "validada")
+    list_filter = ("validada",)
+    search_fields = ("conta_numero", "fornecedor")
+
+
+@admin.register(ConciliacaoFornecedorVinculo)
+class ConciliacaoFornecedorVinculoAdmin(admin.ModelAdmin):
+    list_display = ("conta", "tipo", "diferenca", "criado_por", "criado_em")
+    list_filter = ("tipo",)
+
+
+@admin.register(ConciliacaoFornecedorLancamento)
+class ConciliacaoFornecedorLancamentoAdmin(admin.ModelAdmin):
+    list_display = ("conta", "data", "natureza", "valor", "historico", "vinculo")
+    list_filter = ("natureza", "eh_saldo_anterior")
+    search_fields = ("historico",)
diff --git a/portal_api/catalogo.py b/portal_api/catalogo.py
index 71157a0..f2463a2 100644
--- a/portal_api/catalogo.py
+++ b/portal_api/catalogo.py
@@ -70,6 +70,9 @@ MODULE_APPS = {
     "utilitarios": [
         {"key": "importacao-plano-saude", "label": "Importação de Plano de Saúde"},
         {"key": "importacao-plano-saude-de-paula", "label": "Importação de Plano de Saúde - De Paula"},
+        # Restrita ao perfil "Inovação" por decisão do usuário (override em
+        # seed_portal.py), liberada a outros perfis depois pela tela.
+        {"key": "conciliacao-fornecedores", "label": "Conciliação de Fornecedores"},
     ],
     "integracoes": [
         {"key": "questor", "label": "Questor"},
diff --git a/portal_api/conciliacao_fornecedores/CHANGELOG.md b/portal_api/conciliacao_fornecedores/CHANGELOG.md
new file mode 100644
index 0000000..3e283f6
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/CHANGELOG.md
@@ -0,0 +1,104 @@
+# Changelog — Conciliação de Fornecedores
+
+> Histórico específico desta aplicação.
+>
+> **Formato**: uma entrada por rodada, `### Rodada N — Título`. **A numeração de rodada não é global**: cada aplicação conta as próprias. Ao citar uma rodada, sempre nomear o arquivo. Ver o topo de `plano.md`.
+
+### Rodada 1 — Primeira versão (2026-09-24)
+
+Pedido: facilitar a conciliação contábil, começando pelos fornecedores. O contador exporta o razão do Questor (com saldo residual por fornecedor), informa o código da empresa (nome buscado no Questor, mesma consulta da Importação de Plano de Saúde) e a ferramenta valida débitos e créditos, vincula e devolve o que está pendente. Tela: empresa e cards de alerta no topo, tabela de fornecedores (conta, fornecedor, saldo inicial, saldo residual, validado/divergente) que expande mostrando só o que não foi conciliado.
+
+Decisões confirmadas com o usuário antes de implementar: ferramenta dentro do Portal em Utilitários (não um portal separado); conciliação salva em histórico; ajuste manual (desfazer/criar vínculo, validar conta); tolerância com valor fixo e percentual; "mais de 2 meses a partir da saída"; conta "TRANSFERÊNCIA PARA CUSTOS E DESPESAS" é transitória e não deve ter saldo; adiantamento conta como pagamento; acesso só para o perfil Inovação; exportação do resultado. O usuário salvou a exportação em XLSX e CSV; os dois são aceitos, XLSX recomendado.
+
+O que foi construído: pacote `portal_api/conciliacao_fornecedores/` (`parser`, `motor`, `alertas`, `exportacao`), 4 models (migração `0082`), 3 ViewSets, item no catálogo e no menu dos 13 shells, página nova.
+
+Achado durante o teste com o arquivo real (empresa 2017, 260 contas): parcelamentos são comuns (NF 1.299,00 em 3 × 433,00), e a regra literal "débito sobrando = divergência" marcaria quase toda conta com saldo como divergente. Resolvido com a distribuição dos pagamentos pendentes sobre os títulos em aberto (parcela primeiro, senão o título mais antigo); só o que excede os títulos vira divergência, e pagamento sem título de mesmo valor vira atenção. Também a busca de combinações foi limitada aos 12 candidatos mais próximos em data, porque em contas com centenas de lançamentos pequenos surgiam somas coincidentes.
+
+Resultado no arquivo real: 146 contas conciliadas, 38 pendentes de pagamento, 75 com atenção, 1 divergente (a conta transitória, R$ 20.707,58 devedor); saldo em aberto calculado bate com o saldo final de cada fornecedor. API testada de ponta a ponta dentro de transação desfeita; tela conferida por print em Chrome headless com a API simulada a partir desses dados (não com o servidor real).
+
+Interpretações da implementação, a confirmar com o usuário: "vale o maior" entre tolerância fixa e percentual; "2 meses" contados da data do título até a data-base informada (default hoje).
+
+### Rodada 2 — Data-base e tolerâncias internas (2026-09-24)
+
+Pedido do usuário, ao ver o formulário: data-base e as duas tolerâncias "devem ficar internas no portal", sem alteração pela execução da aplicação. Os três campos saíram da tela; o serializer de criação só aceita `codigo_empresa` + `arquivo`, e o servidor usa a data do processamento e `motor.TOLERANCIA_VALOR_PADRAO`/`TOLERANCIA_PERCENTUAL_PADRAO` (R$ 10,00 / 2%), ignorando qualquer valor enviado (testado enviando outros valores). Os valores usados continuam gravados em cada conciliação e aparecem no cabeçalho do detalhe, só para consulta.
+
+### Rodada 3 — Checkbox de validado na linha do fornecedor (2026-09-24)
+
+Pedido do usuário: um checkbox no final da linha de cada fornecedor para confirmar que a conta foi validada. Coluna "Validado" nova (ordenável) na tabela do detalhe; marcar/desmarcar chama `POST /conciliacoes-fornecedores-contas/{id}/validar/` só com `validada` (a observação existente é preservada) e atualiza a linha e os cards com a resposta. O clique no checkbox não expande a linha; o botão "Marcar como validada" do detalhe continua existindo junto da observação.
+
+### Rodada 4 — Validação separada da situação; conciliadas já validadas (2026-09-24)
+
+Pedido do usuário: marcar como validada não deve mudar a situação do fornecedor, e toda conta já "Conciliada" deve vir validada. A situação exibida passou a ser sempre a calculada (o status "Validada" deixou de existir; `resumo.por_status` perdeu a chave `validada` e ganhou `resumo.validadas`). Conciliadas são validadas automaticamente na criação (`validada_por` nulo = automática); vincular/desfazer reaplica a regra (aplica se ficou conciliada, retira a automática se deixou de estar), sem tocar em validação manual. Chip novo "Não validados", filtro "Validados" pela marcação, coluna "Validada" no XLSX. Aplicado também na conciliação que já existia no banco (id 4, empresa 2017: 146 contas validadas).
+
+### Rodada 5 — Hover só no lançamento sob o mouse (2026-09-24)
+
+Pedido do usuário: com um fornecedor aberto, passar o mouse sobre um lançamento clareava todos. Causa: as sub-tabelas de lançamentos ficam dentro da `.pa-table` de fornecedores, e tanto `.pa-table tr:hover td` (perfis-acesso.css) quanto `.conc-detail-row:hover td` (desta folha, com `!important`) casavam com toda célula descendente da linha de detalhe. A segunda virou `> td` (só a célula externa); a sub-tabela ganhou fundo neutro, hover na linha e seleção próprios, com especificidade maior que a regra de `perfis-acesso.css`. Sem conferência visual do hover neste ambiente (Chrome headless não simula mouse).
+
+### Rodada 6 — Ordem padrão, 3 meses e tolerância fora da tela (2026-09-24)
+
+Pedidos do usuário: (1) tabela de fornecedores ordenada por padrão pela situação, divergentes primeiro (`SORT_PADRAO = "status"` no JS, reaplicado a cada detalhe aberto; o rank de `PID_CONC_STATUS` já punha divergente em 0); (2) alerta de título antigo passa de 2 para 3 meses (`MESES_VENCIDO = 3`, textos de card/coluna/XLSX); (3) a tolerância saiu do cabeçalho do detalhe, aparecendo só como o alerta de diferença no fornecedor em que foi usada. Como aging e situação são recalculados a cada leitura, as conciliações já gravadas passaram a usar 3 meses sozinhas; só o `resumo` gravado foi recalculado (conciliação 8, empresa 2017: atenção 75 → 58, pendentes 38 → 55, em aberto > 3 meses R$ 196.360,20).
+
+### Rodada 7 — Validar recolhe a linha (2026-09-24)
+
+Pedido do usuário: ao marcar a conta como validada, a expansão dela deve recolher. `aplicarRespostaConta()` recolhe a linha quando a conta passa de não validada para validada, qualquer que seja o caminho (checkbox da linha, botão "Marcar como validada" ou validação automática depois de um vínculo que deixou a conta conciliada). Remover a validação não mexe na expansão.
+
+### Rodada 8 — Tela do detalhe mais leve (2026-09-24)
+
+O usuário achou a página carregada. Sugestões apresentadas antes de executar, conferidas num protótipo HTML com os dados reais (`Projetos\Conciliação\prototipo-visualizacao.html`, fora do repositório) e aprovadas:
+- (A) saíram os 4 cards de situação, que repetiam os chips;
+- (B) os cards de valor viraram uma faixa com 3 indicadores e a barra de progresso da validação;
+- (C) os apontamentos menores viraram etiquetas;
+- (D) as validadas ficam escondidas por padrão, com "Mostrar validadas" (o chip "Não validados" saiu, redundante com esse padrão);
+- (E) as linhas ficaram compactas, com reticências e a situação sem ícone (`PID_CONC_ICONES` removido);
+- (F) o cabeçalho da empresa ficou mais baixo;
+- (G) os filtros e o thead ficam fixos ao rolar. Posições conferidas no Chrome headless depois de rolar: topbar 0-64px, filtros 64-116px, thead 116-156px.
+
+### Rodada 9 — Cabeçalho da sub-tabela flutuando no meio dos lançamentos (2026-09-24)
+
+Bug da rodada 8, reportado com print: o `position: sticky` era aplicado por `.conc-table thead th`, seletor descendente que também casava com o thead das sub-tabelas de lançamentos (que ficam dentro da tabela de fornecedores). O thead delas grudava a 116px do topo e aparecia no meio da lista. Trocado por `.conc-table > thead > tr > th`. Conferido medindo no Chrome headless com a conta 8582 expandida e a página rolada: o thead da sub-tabela acompanha a própria tabela, e só o da tabela de fornecedores fica fixo.
+
+### Rodada 10 — Botão "Recolher" no fim da expansão (2026-09-24)
+
+Pedido do usuário: um botão para recolher o fornecedor expandido. Fica à direita da linha de ações da observação (fim da área expandida, onde o contador termina a análise); ao clicar, recolhe e, se a linha do fornecedor ficou acima da área visível (expansão longa), rola a tela de volta até ela.
+
+### Rodada 11 — Distribuição como sugestão e vínculo de pagamento parcial (2026-09-24)
+
+O usuário perguntou de onde vinham as "parcelas". Resposta: de nenhum lugar além do razão; é dedução por valor/data (`_distribui`), e no caso da ROZINI um pagamento virou "parcela" e o outro não só por centavos de arredondamento. Pedido: a ferramenta deve **sugerir**, não apresentar como verdade; se o contador quiser, ele vincula pela ferramenta.
+
+Mudanças:
+- toda situação derivada da distribuição tem `sugestao=True`, com texto de sugestão, etiqueta "Sugestão" (itálico), valor em aberto "≈" e prefixo no XLSX; os alertas de vencido e de pagamento sem título avisam quando o valor é estimado;
+- achado no caminho: vincular à mão uma NF com pagamentos parciais fechava a NF e chamava a diferença de "desconto". Tipo novo `parcial` (migração `0083`, só choices): créditos maiores que débitos além da tolerância. O saldo continua em aberto e aparece num bloco "Pagamentos parciais vinculados", junto dos não conciliados, com "Desfazer". A tela avisa antes de vincular.
+
+Testado com a ROZINI (NF 8.654,22 + 2.163,57 + 2.163,55): vira pagamento parcial com R$ 4.327,10 em aberto (vencido, NF de 28/05); some o alerta de pagamento sem título, e o saldo em aberto da conta segue igual ao saldo final.
+
+### Rodada 12 — Valor em aberto sempre real, sugestão só em texto (2026-09-24)
+
+Pedido do usuário, ao ver a NF de 8.654,22 com "≈ R$ 4.327,10" em aberto: enquanto nada for vinculado, o saldo em aberto deve ser o real, sem abater suposições. A distribuição deixou de alterar qualquer valor: título sem vínculo fica em aberto pelo valor cheio (inclusive no aging e no alerta de mais de 3 meses), pagamento sem vínculo é "Pagamento não vinculado" (categorias `parcela`/`sem_titulo`/`quitado_parcial` foram trocadas por `nao_vinculado`), e a dedução vai para `SituacaoItem.sugestao` (texto), exibida numa linha à parte. O excedente (divergência) continua, por ser fato. O card do topo virou "Títulos em aberto", com o valor em pagamentos a vincular ao lado (`total_nao_vinculado`, novo no payload e no resumo). Resumo da conciliação 8 recalculado: títulos em aberto R$ 942.722,79, mais de 3 meses R$ 514.720,32, pagamentos a vincular R$ 327.333,89; atenção 62, pendentes 51.
+
+### Rodada 13 — Barra de seleção fixa ao rolar (2026-09-24)
+
+Pedido do usuário: com muitos lançamentos, a linha com a soma da seleção e o botão "Vincular selecionados" devem ficar fixos junto do cabeçalho, para acompanhar o cálculo e vincular sem subir a página. A barra (`.conc-selecao-barra`) e o thead da lista de pendentes ficam `sticky`, empilhados abaixo do thead da tabela de fornecedores, dentro da célula de detalhe (somem quando a conta sai da tela). Posições medidas no Chrome headless com a BRASPRESS (72 pendentes) rolada até o meio: topbar 0-64, filtros 64-116, thead 116-157, barra 157-201, thead dos pendentes 201-233.
+
+### Rodada 14 — Clique na linha seleciona o lançamento (2026-09-24)
+
+Pedido do usuário: marcar a seleção clicando na linha do lançamento, não só no checkbox. A linha inteira da lista de pendentes alterna o checkbox (que fica como indicador); o clique no próprio checkbox segue o nativo, e um clique que termina uma seleção de texto (arrastar sobre o histórico para copiar) é ignorado. Só o histórico continua selecionável como texto.
+
+### Rodada 15 — Marcar/desmarcar todos no cabeçalho dos pendentes (2026-09-24)
+
+Pedido do usuário: um controle no cabeçalho da lista de pendentes para marcar todos ou desmarcar os selecionados. Checkbox com três estados (vazio, parcial com `indeterminate`, todos): sem nada marcado, marca todos; com qualquer marcação, desmarca todos (padrão de caixa de e-mail, para "desmarcar os selecionados" funcionar também numa seleção parcial).
+
+### Rodada 16 — Acrescentar lançamentos a um vínculo manual (2026-09-24)
+
+Pedido do usuário: depois de vincular um débito a um crédito, poder incluir outro débito no mesmo vínculo sem desfazê-lo. Endpoint novo `POST /conciliacoes-fornecedores-vinculos/{id}/adicionar/` (só vínculo manual/parcial) e botão "Adicionar selecionados" no cabeçalho de cada vínculo manual, habilitado quando há lançamentos marcados na lista de pendentes, com confirmação mostrando o efeito (quanto resta, se fecha, se fica pago a maior). A regra de tipo virou `_conciliacao_tipo_vinculo_manual()`, compartilhada com a criação. O serializer passou a aceitar 1 lançamento (a criação continua exigindo débito + crédito na view). Testado pela API com a ROZINI: NF + 1 pagamento = parcial restando R$ 6.490,65; acrescentado o 2º = R$ 4.327,10. Vínculo automático e lançamento já vinculado recusados. A tela só foi conferida quanto a erros de JS, porque a página de teste não tem vínculo manual nos dados.
+
+### Rodada 17 — Razão desde a primeira pendência na conta expandida (2026-09-24)
+
+Pedido do usuário: ver todo o período a partir de quando surgiu a pendência, com o que a aplicação já vinculou marcado como "Vinculado", para achar vinculações incorretas, desfazer e vincular de novo. A lista da conta expandida passou a ser o razão a partir da data do lançamento pendente mais antigo (inclusive itens de pagamento parcial), na ordem do arquivo, com a coluna "Saldo" (`saldo_apos`, novo no payload). Linhas vinculadas: sem checkbox, apagadas, "Vinculado #N" (número do vínculo na conta, o mesmo mostrado nos blocos de vínculo) + tipo e origem, destaque do vínculo inteiro no hover e "Desfazer" na linha (confirmação lista os itens do vínculo). Seleção, marcar todos e clique na linha continuam valendo só para as não vinculadas. Conferido com a ROZINI: saldos batem com o razão do Questor enviado pelo usuário.
+
+### Rodada 18 — Colunas Débito e Crédito (testada e revertida, 2026-09-24)
+
+A pedido do usuário, "Natureza" + "Valor" viraram colunas "Débito" + "Crédito" no razão da conta expandida e nos blocos de vínculo. Depois de ver na tela, **o usuário preferiu como estava e pediu para reverter**: voltaram "Natureza" (etiqueta) + "Valor". Não reaplicar colunas separadas de débito/crédito sem confirmar de novo.
+
+### Rodada 19 — Toggle "Ocultar conciliados" no razão da conta expandida (2026-09-25)
+
+Pedido do usuário: um botão para esconder o que já está conciliado no razão desde a primeira pendência, **desmarcado por padrão**. Checkbox "Ocultar conciliados" (estilo `.conc-toggle`, o mesmo de "Mostrar validadas") ao lado do título "Razão desde ... · N não conciliado(s)", com a contagem de linhas vinculadas no período; só aparece quando há alguma. Esconde as `tr.conc-linha--vinculada` pela classe `is-ocultando-conciliados` na tabela; o estado fica por conta (`ocultarConciliados` em `estadoDe`) e é mantido depois de vincular/desfazer. Só frontend (JS/CSS), sem mudança de API.
diff --git a/portal_api/conciliacao_fornecedores/CLAUDE.md b/portal_api/conciliacao_fornecedores/CLAUDE.md
new file mode 100644
index 0000000..d8dd0f0
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/CLAUDE.md
@@ -0,0 +1,104 @@
+# Conciliação de Fornecedores (Utilitários)
+
+> Este arquivo é carregado automaticamente ao trabalhar dentro de `portal_api/conciliacao_fornecedores/`. Ver `CLAUDE.md` na raiz para a arquitetura geral/transversal do Portal. Descreve o **estado atual**; o histórico rodada a rodada está em `CHANGELOG.md` nesta pasta. Ao implementar algo novo aqui, atualizar os dois.
+
+O contador exporta do Questor o razão contábil das contas de fornecedores (que já traz o saldo anterior e cada lançamento), informa o código da empresa e anexa o arquivo. A ferramenta vincula débitos (pagamentos) e créditos (títulos/NFs) de cada fornecedor por valor e data e mostra, por fornecedor, o que ficou pendente, com alertas. O contador pode desfazer ou criar vínculos e marcar a conta como validada. Tudo fica salvo no histórico e pode ser exportado em XLSX.
+
+**Permissão**: toggle único `apps["conciliacao-fornecedores"]` em `permissoes["utilitarios"]`, checado via `PermissaoApp("utilitarios", "conciliacao-fornecedores")` em todas as views. **Restrita ao perfil "Inovação"** por decisão do usuário (override em `seed_portal.py`, que não roda em produção: em produção a liberação é feita pela tela de Perfis de Acesso).
+
+## Decisões de escopo (confirmadas com o usuário)
+
+- **Ferramenta do Portal, em Utilitários**, não um portal à parte (a ideia inicial de "outro site" foi descartada pelo usuário).
+- **v1: só fornecedores.** O leiaute e o motor valem para qualquer razão de conta de passivo com o mesmo formato, mas as regras (crédito = título, débito = pagamento) assumem conta de fornecedor.
+- **Entrada: XLSX ou CSV** da exportação "Questor_Exportacao" (mesmas 13 colunas). O XLSX é o preferido: datas e débito/crédito já vêm tipados. O CSV sai em Latin-1 com tudo em texto; `parser.py` aceita os dois.
+- **Empresa informada pelo usuário**: o arquivo não traz código nem nome. O nome é resolvido no Questor ao digitar o código (`resolve_nome_empresa()`, mesma consulta/cache `EmpresaQuestor` do Cadastro de Regras do Plano de Saúde). Empresa não encontrada não bloqueia: a tela pede confirmação e grava o nome vazio.
+- **Histórico salvo**, sem `unique_together`: a mesma empresa pode ser conciliada várias vezes.
+- **Tolerância de diferença: valor fixo e percentual, vale o maior**: R$ 10,00 / 2% (`TOLERANCIA_VALOR_PADRAO`/`TOLERANCIA_PERCENTUAL_PADRAO` em `motor.py`). **Internos ao Portal, não editáveis pela tela** (decisão do usuário): o formulário não tem esses campos e o servidor ignora qualquer valor enviado. Os valores usados ficam gravados em cada conciliação (`tolerancia_valor`/`tolerancia_percentual`), para uma mudança futura da constante não reescrever o histórico, mas **não aparecem na tela** (pedido do usuário): a tolerância só se manifesta como o alerta `diferenca_vinculo` no fornecedor em que foi usada. O usuário pediu "os dois"; o critério "o maior" foi escolha da implementação, porque o percentual cobre juros proporcionais e o fixo cobre centavos em títulos pequenos.
+- **Título em aberto há mais de 3 meses** (`MESES_VENCIDO` em `alertas.py`; era 2 no pedido original, o usuário mudou para 3). "A partir da saída": contado da data do lançamento do título até a **data-base**, que é sempre o dia do processamento (não editável, mesma decisão das tolerâncias). Interpretação da implementação; confirmar se o usuário disser o contrário.
+- **Conta transitória** ("TRANSFERÊNCIA PARA CUSTOS E DESPESAS" no arquivo real): não deveria ter saldo, qualquer saldo é alerta alto. Detectada por trecho do nome (`TRECHOS_CONTA_TRANSITORIA` em `alertas.py`).
+- **Adiantamento a fornecedor** (contrapartida "ADIANTAMENTOS A FORNECEDORES") conta como pagamento normal (antecipado).
+- **Débito sobrando é divergência, crédito em aberto é só título não pago** (pedido do usuário), com a ressalva da distribuição de parcelas abaixo.
+
+## Leitura do razão (`parser.py`)
+
+Cada conta começa numa linha "Conta: <reduzido> - <classificação>   <fornecedor>" (coluna Histórico), seguida de "Saldo anterior..." (só a coluna Saldo) e dos lançamentos. Não há linha de total nem cabeçalho de empresa/período. Valores com lado "8.214,92D"/"16.429,84C". **Convenção interna: credor positivo** (valor devido ao fornecedor). `saldo_final_calculado` (saldo anterior + créditos − débitos) é comparado com o último saldo impresso (`saldo_final_arquivo`); diferença vira alerta alto (exportação incompleta). No arquivo de referência (`Projetos\Conciliação\Teste Exportação - Fornecedores - 2017.xlsx`, empresa 2017, 260 contas, 2.520 lançamentos, jan-ago/2026) as 260 contas batem.
+
+O cabeçalho é conferido pelas duas primeiras letras de cada coluna (sem acento), para tolerar "Seqüência" com acento corrompido.
+
+## Motor (`motor.py`)
+
+Função pura `concilia(itens, tolerancia) -> list[VinculoSugerido]`, uma conta por vez. O saldo anterior diferente de zero entra como um item a mais (vira `ConciliacaoFornecedorLancamento` com `eh_saldo_anterior=True`). O pagamento não cita a NF, então **todo vínculo é por valor e data**. Etapas:
+
+1. **Segmentação por saldo zerado**: cada ponto em que o saldo corrente (na ordem do arquivo) volta a zero fecha um segmento, e vínculo nunca atravessa segmento. Isso evita casar o frete de janeiro com um pagamento de mesmo valor de julho.
+2. **1:1 por valor exato**, menor distância de datas.
+3. **Combinação exata** (vários débitos = um crédito, ou vários créditos, como NF + juros, = um débito): até 6 itens, janela de 120 dias, **só os 12 candidatos mais próximos em data**, teto de 20 mil nós por busca. O limite de candidatos existe porque, numa conta com centenas de lançamentos pequenos (EBAZAR, 456 no arquivo real), uma soma exata entre itens sem relação é quase certa se todos puderem participar.
+4. **Compensação do segmento fechado**: o que sobrou num segmento que zerou vira um vínculo `saldo_zerado`.
+5. **Tolerância**, só no último segmento (o que está em aberto): 1:1 ou 2 itens com diferença até o limite. Com 3 ou mais itens, combinações "a menos de R$ 10" aparecem por acaso.
+
+Resultado no arquivo real: 532 vínculos exatos, 99 combinações, 20 compensações, 21 com diferença.
+
+## Situação e alertas (`alertas.py`)
+
+**Nunca gravados**: recalculados a cada leitura por `analisa_conta()`, porque o contador pode desfazer ou criar vínculos. Só o `resumo` do cabeçalho (totais para a listagem do histórico) é gravado, e é recalculado a cada ajuste.
+
+**Fato x sugestão: só vínculo muda valor** (pedido do usuário). Um título sem vínculo está em aberto pelo **valor cheio**; um pagamento sem vínculo é "Pagamento não vinculado". O razão não traz parcelamento, vencimento nem NF no pagamento, então qualquer dedução sobre qual título um pagamento paga é **sugestão**: vai em `SituacaoItem.sugestao` (texto à parte), nunca na `descricao` (só fato) nem em `valor_em_aberto`. Na tela, a sugestão aparece numa linha própria abaixo do fato, com a etiqueta "Sugestão", em itálico e cor neutra; no XLSX, depois de "Sugestão:". O contador confirma criando o vínculo manual (inclusive o de pagamento parcial, que aí sim reduz o valor em aberto).
+
+As sugestões saem de uma **distribuição** dos pagamentos não vinculados sobre os títulos em aberto: primeiro o título do qual o pagamento parece ser **parcela** (título ≈ k × pagamento, k de 2 a 24, até 1 centavo por parcela), senão o título mais antigo com saldo. Ela serve só para escrever as sugestões e para achar o **excedente** (pagamentos não vinculados além de todos os títulos em aberto), que é fato e é a divergência. Motivo de existir: o arquivo real tem muitos parcelamentos (NF 1.299,00 em 3 × 433,00; NF 25.325,00 em 5 × 5.065,00), e a sugestão aponta ao contador o título provável.
+
+| Categoria | Significado (fato) | Alerta |
+|---|---|---|
+| `em_aberto` | título sem pagamento vinculado (ou saldo de um pagamento parcial vinculado) | nenhum (conta fica "Pendente de pagamento") |
+| `vencido` | idem, há mais de 3 meses até a data-base | média (`credito_vencido`, valor real) |
+| `nao_vinculado` | pagamento ainda não vinculado a um título | média (`pagamento_sem_titulo`, "N pagamentos ainda não vinculados, somando R$ X") |
+| `excedente` | pagamento além de todos os títulos em aberto | **alta (divergência)** |
+
+Consequência nos totais: `total_em_aberto` (card "Títulos em aberto") é a soma real dos títulos sem baixa e pode passar do saldo contábil da conta quando há pagamentos a vincular. O card mostra os dois (`total_nao_vinculado` = "em pagamentos a vincular"); o saldo contábil continua na coluna "Saldo residual".
+
+Alertas de conta: `saldo_divergente_arquivo`, `conta_transitoria`, `saldo_devedor` (alta); `debito_excedente` (alta); `credito_vencido`, `pagamento_sem_titulo` (média); `diferenca_vinculo` (baixa, vínculo automático por tolerância ou manual com diferença; diferença negativa = pago a maior, possível juros/multa; positiva = pago a menor, possível desconto).
+
+Status: `divergente` (algum alerta alto) > `atencao` (médio/baixo) > `pendente` (só títulos recentes em aberto) > `conciliada`.
+
+**Validação é uma marcação à parte e nunca muda a situação** (pedido do usuário): uma conta em "Atenção" validada continua "Atenção", com o checkbox marcado. Conta "Conciliada" já nasce validada (`_conciliacao_valida_conciliadas()` na criação). A validação automática é a que tem `validada_por` nulo (`validada_automatica` no payload): depois de vincular/desfazer, `_conciliacao_sincroniza_validacao_automatica()` a aplica se a conta ficou conciliada e a retira se deixou de estar; a validação feita por uma pessoa (endpoint `validar/`) nunca é mexida por essa regra.
+
+## Models (`portal_api/models.py`)
+
+`ConciliacaoFornecedor` (cabeçalho: empresa, data-base, período, arquivo, tolerâncias, `resumo` JSON) → `ConciliacaoFornecedorConta` (saldos, `validada`/`validada_por`/`validada_em`, `observacao`) → `ConciliacaoFornecedorVinculo` (`tipo` exato/combinacao/saldo_zerado/tolerancia/manual/**parcial**, `diferenca` = créditos − débitos, `criado_por` só no manual) e `ConciliacaoFornecedorLancamento` (`vinculo` FK `SET_NULL`: excluir o vínculo devolve os lançamentos para pendente).
+
+## API
+
+Todas com `PermissaoApp("utilitarios", "conciliacao-fornecedores")`.
+
+| Endpoint | Método | Uso |
+|---|---|---|
+| `/api/conciliacoes-fornecedores/` | GET/POST | histórico (`?codigo_empresa=` filtra) / criação multipart (só `codigo_empresa` + `arquivo`; data-base e tolerâncias são definidas no servidor) |
+| `/api/conciliacoes-fornecedores/{id}/` | GET/DELETE | detalhe completo (contas + lançamentos + vínculos + análise, ~1 MB para 2.500 lançamentos) / exclusão (apaga o arquivo depois do commit) |
+| `/api/conciliacoes-fornecedores/nome-empresa/?codigo_empresa=` | GET | nome no Questor (`null` se não achou ou Questor fora) |
+| `/api/conciliacoes-fornecedores/{id}/exportar-xlsx/` | GET | planilha com abas Resumo, Pendências e Alertas |
+| `/api/conciliacoes-fornecedores-contas/{id}/vincular/` | POST | `{lancamentos: [ids]}`: vínculo manual; exige itens sem vínculo, da própria conta, com pelo menos um débito e um crédito. Créditos maiores que débitos **além da tolerância** da conciliação viram `tipo="parcial"` (pagamento parcial: a `diferenca` continua em aberto, entra na distribuição como um título com a data do crédito mais antigo do vínculo e conta para o aging); dentro da tolerância, ou pago a maior, `tipo="manual"` (fecha, com alerta de diferença) |
+| `/api/conciliacoes-fornecedores-contas/{id}/validar/` | POST | `{validada, observacao}` |
+| `/api/conciliacoes-fornecedores-vinculos/{id}/` | DELETE | desfaz o vínculo |
+| `/api/conciliacoes-fornecedores-vinculos/{id}/adicionar/` | POST | `{lancamentos: [ids]}` (1 ou mais): acrescenta lançamentos pendentes da mesma conta a um vínculo **manual ou parcial** (automático é 400), sem desfazer. Tipo e diferença recalculados por `_conciliacao_tipo_vinculo_manual()`, a mesma regra da criação (pode continuar parcial, fechar ou virar pago a maior); `criado_por` passa a ser quem acrescentou |
+
+Os três endpoints de ajuste devolvem `{conta, resumo}`: a conta reanalisada e o resumo recalculado, para a tela atualizar só aquela linha e os cards.
+
+## Tela (`conciliacao-fornecedores.html` / `.js` / `.css`)
+
+Duas vistas na mesma página. **Histórico**: formulário de nova conciliação (o código da empresa busca o nome no Questor com debounce; o nome do arquivo com prefixo numérico sugere o código) + tabela do histórico. **Detalhe** (`#conciliacao-<id>` na URL), desenhado para ser leve (pedido do usuário, validado antes num protótipo):
+- cabeçalho da empresa baixo, código e nome na mesma linha;
+- **uma faixa de indicadores**: saldo em aberto, em aberto há mais de 3 meses (clica e filtra), pagamentos sem título (divergência, clica e filtra) e uma **barra de progresso da validação** ("146 de 260");
+- os apontamentos menores (diferença de juros/desconto, pagamento sem título de mesmo valor, conta transitória) como **etiquetas** clicáveis numa linha, só quando existem;
+- **os números por situação ficam só nos chips** (Todos/Divergentes/Atenção/Pendentes/Conciliados/Validados), que também filtram: não duplicar em card;
+- **contas validadas escondidas por padrão** ("Mostrar validadas" ao lado da busca; o chip "Validados" mostra sempre), para a lista mostrar o que falta revisar;
+- filtros e cabeçalho da tabela **fixos ao rolar** (`position: sticky` abaixo da `.topbar`; `.conc-table-wrap` desliga o `overflow:hidden` de `.pa-table-wrap`, que anularia o sticky);
+- linhas compactas, com o fornecedor e o primeiro alerta cortados com reticências e a situação só como etiqueta.
+- na conta expandida, a **barra de seleção** (soma de créditos/débitos, diferença e "Vincular selecionados") e o thead da lista de pendentes também ficam fixos, empilhados abaixo do thead da tabela de fornecedores (`--conc-thead-altura`/`--conc-selecao-altura` no `#conc-detail-view`; se a altura de um deles mudar, ajustar a variável). A `.conc-subtabela--pendentes` desliga o `overflow:hidden` pelo mesmo motivo de `.conc-table-wrap`.
+
+A tabela de fornecedores, **ordenada por padrão pela situação, divergentes primeiro** (depois atenção, pendente, conciliada) (conta, fornecedor, saldo inicial, saldo residual, em aberto há mais de 3 meses, situação com ícone, e um **checkbox "Validado" no fim da linha**, pedido do usuário). O checkbox grava direto pelo mesmo `validar/` do botão "Marcar como validada" do detalhe, sem enviar `observacao` (o servidor mantém a já registrada), e o clique nele não expande a linha. **Quando a conta passa a validada** (por qualquer caminho, inclusive a validação automática), a linha expandida recolhe. Clicar numa linha expande: alertas, o **razão desde a primeira pendência** (todos os lançamentos, na ordem do arquivo e com a coluna de saldo do Questor, a partir da data do lançamento pendente mais antigo, incluindo os itens de pagamento parcial; os já vinculados aparecem apagados como "Vinculado #N" com o tipo, sem seleção, destacando o vínculo inteiro ao passar o mouse e com "Desfazer" na própria linha, para achar vínculo automático errado; um toggle **"Ocultar conciliados"** ao lado do título, **desmarcado por padrão** (pedido do usuário), esconde essas linhas vinculadas só por CSS, e a escolha fica em `estadoDe(conta.id).ocultarConciliados`, sobrevivendo ao re-render depois de vincular/desfazer), os **lançamentos não conciliados** (com checkbox para vínculo manual, valor em aberto e situação de cada um), lançamentos conciliados agrupados por vínculo (ocultos por padrão, com "Desfazer vínculo") e observação/validação da conta.
+
+## Limitações conhecidas
+
+- O vínculo é uma **sugestão**: sem número de NF no pagamento, títulos de mesmo valor podem ser trocados entre si. Os saldos continuam certos.
+- Combinações fora dos limites (mais de 6 itens, mais de 120 dias, fora dos 12 mais próximos) não são encontradas; sobram para a distribuição ou para o vínculo manual.
+- O saldo anterior não tem composição: entra como um bloco único.
+- Não há reprocessamento: para trocar o arquivo, excluir e criar de novo (ajustes manuais se perdem).
+- Exportação só em XLSX (PDF com o logo do escritório ainda não pedido).
diff --git a/portal_api/conciliacao_fornecedores/README.md b/portal_api/conciliacao_fornecedores/README.md
new file mode 100644
index 0000000..cdb5288
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/README.md
@@ -0,0 +1,19 @@
+# Conciliação de Fornecedores (Utilitários)
+
+> Ver `CLAUDE.md` nesta mesma pasta para o detalhamento técnico (motor de conciliação, alertas, API). Ver `CLAUDE.md` na raiz para a arquitetura geral do Portal.
+
+Ferramenta para o contador conciliar as contas de fornecedores de uma empresa. Ele exporta do Questor o razão contábil de fornecedores (.xlsx ou .csv), informa o código da empresa (o nome vem do Questor) e anexa o arquivo. A ferramenta:
+
+- vincula, por valor e data, os pagamentos (débitos) aos títulos (créditos) de cada fornecedor, inclusive vários pagamentos somando um título e parcelas;
+- mostra, por fornecedor, conta, saldo inicial, saldo residual e a situação (conciliada, pendente de pagamento, atenção, divergente, validada);
+- alerta títulos em aberto há mais de 2 meses, pagamentos sem título (divergência), diferenças pequenas (possível juros/desconto) e conta transitória com saldo;
+- deixa o contador desfazer e criar vínculos, registrar observação e validar a conta;
+- guarda o histórico e exporta o resultado em XLSX.
+
+Acesso restrito ao perfil "Inovação", liberado para outros perfis pela tela de Perfis de Acesso.
+
+## Onde mexer
+
+- `portal_api/conciliacao_fornecedores/`: `parser.py` (leitura do razão), `motor.py` (vínculos automáticos), `alertas.py` (situação e alertas), `exportacao.py` (XLSX).
+- `ConciliacaoFornecedor`, `ConciliacaoFornecedorConta`, `ConciliacaoFornecedorVinculo`, `ConciliacaoFornecedorLancamento` (`portal_api/models.py`).
+- `conciliacao-fornecedores.html` / `static/js/conciliacao-fornecedores.js` / `static/css/conciliacao-fornecedores.css`.
diff --git a/portal_api/conciliacao_fornecedores/__init__.py b/portal_api/conciliacao_fornecedores/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/portal_api/conciliacao_fornecedores/alertas.py b/portal_api/conciliacao_fornecedores/alertas.py
new file mode 100644
index 0000000..72f7095
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/alertas.py
@@ -0,0 +1,331 @@
+"""Situação de uma conta de fornecedor a partir dos vínculos atuais
+(automáticos ou manuais) — recalculada a cada exibição, nunca gravada,
+porque o contador pode desfazer ou criar vínculos a qualquer momento.
+
+**Fato x sugestão** (pedido do usuário): valores só mudam por vínculo. Um
+título sem vínculo está em aberto pelo **valor cheio**, e um pagamento sem
+vínculo é "pagamento não vinculado", mesmo que a ferramenta desconfie de
+qual título ele paga. Essa desconfiança sai numa distribuição dos
+pagamentos não vinculados sobre os títulos em aberto (primeiro o título do
+qual o pagamento parece ser parcela, título ≈ k × pagamento com k de 2 a
+`MAX_PARCELAS`; senão o mais antigo com saldo), usada **só** para:
+
+- escrever a sugestão de cada item (`SituacaoItem.sugestao`, texto à parte
+  da `descricao`, que é só fato);
+- achar o pagamento que excede todos os títulos em aberto, que é fato
+  (a soma dos pagamentos não vinculados passa da soma dos títulos) e é a
+  **divergência**.
+
+O saldo de um vínculo manual de pagamento parcial (`TIPO_PARCIAL`) entra
+como um título a mais, com a data do título original: esse sim já é um
+valor confirmado pelo contador.
+
+Python puro, sem ORM.
+"""
+
+from __future__ import annotations
+
+import unicodedata
+from dataclasses import dataclass, field
+from datetime import date
+from decimal import Decimal
+
+from .motor import TIPO_MANUAL, TIPO_PARCIAL, TIPO_TOLERANCIA
+
+MESES_VENCIDO = 3
+MAX_PARCELAS = 24
+
+# Contas que não deveriam carregar saldo (não são fornecedores de fato).
+# Comparado sem acento, por trecho do nome da conta.
+TRECHOS_CONTA_TRANSITORIA = ("TRANSFERENCIA PARA CUSTOS", "TRANSITORI")
+
+SEVERIDADE_ALTA = "alta"
+SEVERIDADE_MEDIA = "media"
+SEVERIDADE_BAIXA = "baixa"
+
+STATUS_CONCILIADA = "conciliada"
+STATUS_PENDENTE = "pendente"
+STATUS_ATENCAO = "atencao"
+STATUS_DIVERGENTE = "divergente"
+
+CATEGORIA_EM_ABERTO = "em_aberto"
+CATEGORIA_VENCIDO = "vencido"
+CATEGORIA_NAO_VINCULADO = "nao_vinculado"  # pagamento sem título vinculado
+CATEGORIA_EXCEDENTE = "excedente"  # pagamento que passa de todos os títulos em aberto
+
+
+@dataclass
+class ItemAnalise:
+    id: int
+    data: date
+    natureza: str  # "C" ou "D"
+    valor: Decimal
+    vinculo_id: int | None
+    descricao: str  # histórico, para citar o título abatido
+
+
+@dataclass
+class VinculoAnalise:
+    id: int
+    tipo: str
+    diferenca: Decimal
+    # data do título (crédito) mais antigo do vínculo: é a data que conta
+    # para o aging do saldo de um pagamento parcial
+    data_titulo: date | None = None
+
+
+@dataclass
+class AlertaConta:
+    tipo: str
+    severidade: str
+    mensagem: str
+
+
+@dataclass
+class SituacaoItem:
+    categoria: str
+    # Crédito: valor real em aberto (cheio, ou o saldo de um pagamento
+    # parcial vinculado). Débito: parte excedente (só na divergência).
+    valor_em_aberto: Decimal
+    descricao: str  # só fato
+    sugestao: str = ""  # dedução da ferramenta, a confirmar com um vínculo
+    relacionados: list[int] = field(default_factory=list)  # ids do outro lado na sugestão
+
+
+@dataclass
+class AnaliseConta:
+    status: str
+    alertas: list[AlertaConta]
+    situacoes: dict[int, SituacaoItem]
+    total_em_aberto: Decimal  # títulos em aberto, valor real
+    total_vencido: Decimal  # títulos em aberto há mais de MESES_VENCIDO meses, valor real
+    total_nao_vinculado: Decimal  # pagamentos ainda não vinculados (sem o excedente)
+    total_excedente: Decimal  # pagamentos além de todos os títulos em aberto
+
+
+def _moeda(valor: Decimal) -> str:
+    texto = f"{abs(valor):,.2f}".replace(",", "X").replace(".", ",").replace("X", ".")
+    return f"R$ {texto}"
+
+
+def _sem_acento(texto: str) -> str:
+    normalizado = unicodedata.normalize("NFKD", texto)
+    return "".join(c for c in normalizado if not unicodedata.combining(c)).upper()
+
+
+def eh_conta_transitoria(nome_conta: str) -> bool:
+    nome = _sem_acento(nome_conta)
+    return any(trecho in nome for trecho in TRECHOS_CONTA_TRANSITORIA)
+
+
+def _soma_meses(data: date, meses: int) -> date:
+    mes = data.month - 1 + meses
+    ano = data.year + mes // 12
+    mes = mes % 12 + 1
+    dias_no_mes = [31, 29 if ano % 4 == 0 and (ano % 100 != 0 or ano % 400 == 0) else 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+    return date(ano, mes, min(data.day, dias_no_mes[mes - 1]))
+
+
+def _eh_parcela(valor_titulo: Decimal, valor_pagamento: Decimal) -> bool:
+    if valor_pagamento <= 0 or valor_pagamento >= valor_titulo:
+        return False
+    k = round(valor_titulo / valor_pagamento)
+    if k < 2 or k > MAX_PARCELAS:
+        return False
+    # arredondamento de parcela: até 1 centavo por parcela
+    return abs(valor_titulo - valor_pagamento * k) <= Decimal("0.01") * k
+
+
+def _rotulo_titulo(credito: ItemAnalise) -> str:
+    return f"{credito.data:%d/%m/%Y} ({_moeda(credito.valor)})"
+
+
+def _analisa_pendentes(
+    itens: list[ItemAnalise], data_base: date
+) -> tuple[dict[int, SituacaoItem], Decimal, Decimal, Decimal, Decimal]:
+    creditos = sorted((i for i in itens if i.natureza == "C"), key=lambda i: (i.data, i.id))
+    debitos = sorted((i for i in itens if i.natureza == "D"), key=lambda i: (i.data, i.id))
+
+    # Distribuição sugerida: não altera nenhum valor exibido, só alimenta os
+    # textos de sugestão e a detecção do excedente.
+    saldo_sugerido = {c.id: c.valor for c in creditos}
+    pagos_sugeridos: dict[int, list[int]] = {c.id: [] for c in creditos}
+    situacoes: dict[int, SituacaoItem] = {}
+    total_nao_vinculado = Decimal("0")
+    total_excedente = Decimal("0")
+
+    for debito in debitos:
+        restante = debito.valor
+        usados: list[int] = []
+        parcela_de = next(
+            (c for c in creditos if saldo_sugerido[c.id] >= debito.valor and _eh_parcela(c.valor, debito.valor)),
+            None,
+        )
+        ordem = ([parcela_de] if parcela_de else []) + [c for c in creditos if c is not parcela_de]
+        for credito in ordem:
+            if restante <= 0:
+                break
+            if saldo_sugerido[credito.id] <= 0:
+                continue
+            abatido = min(restante, saldo_sugerido[credito.id])
+            saldo_sugerido[credito.id] -= abatido
+            restante -= abatido
+            usados.append(credito.id)
+            pagos_sugeridos[credito.id].append(debito.id)
+
+        titulos = [c for c in creditos if c.id in usados]
+        if parcela_de and usados == [parcela_de.id]:
+            sugestao = f"Possível parcela do título de {_rotulo_titulo(parcela_de)}. Vincule para confirmar."
+        elif titulos:
+            sugestao = f"Pode ser pagamento do(s) título(s) de {', '.join(_rotulo_titulo(c) for c in titulos)}."
+        else:
+            sugestao = ""
+
+        if restante > 0:
+            total_excedente += restante
+            total_nao_vinculado += debito.valor - restante
+            situacoes[debito.id] = SituacaoItem(
+                CATEGORIA_EXCEDENTE,
+                restante,
+                f"Pagamento sem título em aberto: {_moeda(restante)} excedente.",
+                sugestao,
+                usados,
+            )
+        else:
+            total_nao_vinculado += debito.valor
+            situacoes[debito.id] = SituacaoItem(CATEGORIA_NAO_VINCULADO, Decimal("0"), "Pagamento não vinculado.", sugestao, usados)
+
+    total_aberto = Decimal("0")
+    total_vencido = Decimal("0")
+    for credito in creditos:
+        pagos = pagos_sugeridos[credito.id]
+        coberto = credito.valor - saldo_sugerido[credito.id]
+        if not pagos:
+            sugestao = ""
+        elif saldo_sugerido[credito.id] <= 0:
+            sugestao = f"Pode ter sido quitado por {len(pagos)} pagamento(s) não vinculado(s). Vincule para confirmar."
+        else:
+            sugestao = f"Pode ter sido pago parcialmente ({_moeda(coberto)}) por pagamento(s) não vinculado(s)."
+        total_aberto += credito.valor
+        if _soma_meses(credito.data, MESES_VENCIDO) < data_base:
+            total_vencido += credito.valor
+            situacoes[credito.id] = SituacaoItem(
+                CATEGORIA_VENCIDO, credito.valor, f"Em aberto há mais de {MESES_VENCIDO} meses.", sugestao, pagos
+            )
+        else:
+            situacoes[credito.id] = SituacaoItem(CATEGORIA_EM_ABERTO, credito.valor, "Em aberto.", sugestao, pagos)
+
+    return situacoes, total_aberto, total_vencido, total_nao_vinculado, total_excedente
+
+
+def analisa_conta(
+    itens: list[ItemAnalise],
+    vinculos: list[VinculoAnalise],
+    *,
+    nome_conta: str,
+    saldo_final: Decimal,
+    saldo_final_arquivo: Decimal,
+    data_base: date,
+) -> AnaliseConta:
+    """`saldo_final` é o recalculado (saldo anterior + créditos - débitos);
+    `saldo_final_arquivo` o último impresso pelo Questor. Credor positivo."""
+    pendentes = [i for i in itens if i.vinculo_id is None]
+    # O saldo de cada pagamento parcial vinculado à mão continua em aberto:
+    # entra como um título a mais (id negativo = -id do vínculo), com a data
+    # do título original para o aging.
+    for vinculo in vinculos:
+        if vinculo.tipo == TIPO_PARCIAL and vinculo.diferenca > 0 and vinculo.data_titulo:
+            pendentes.append(
+                ItemAnalise(
+                    id=-vinculo.id,
+                    data=vinculo.data_titulo,
+                    natureza="C",
+                    valor=vinculo.diferenca,
+                    vinculo_id=None,
+                    descricao="Saldo do pagamento parcial",
+                )
+            )
+    situacoes, total_aberto, total_vencido, total_nao_vinculado, total_excedente = _analisa_pendentes(
+        pendentes, data_base
+    )
+    alertas: list[AlertaConta] = []
+
+    if saldo_final != saldo_final_arquivo:
+        alertas.append(
+            AlertaConta(
+                "saldo_divergente_arquivo",
+                SEVERIDADE_ALTA,
+                f"O saldo recalculado ({_moeda(saldo_final)}) difere do último saldo do arquivo "
+                f"({_moeda(saldo_final_arquivo)}). Confira se a exportação veio completa.",
+            )
+        )
+    if eh_conta_transitoria(nome_conta) and saldo_final != 0:
+        alertas.append(
+            AlertaConta(
+                "conta_transitoria",
+                SEVERIDADE_ALTA,
+                f"Conta transitória com saldo de {_moeda(saldo_final)} "
+                f"{'devedor' if saldo_final < 0 else 'credor'}; deveria estar zerada.",
+            )
+        )
+    elif saldo_final < 0:
+        alertas.append(
+            AlertaConta("saldo_devedor", SEVERIDADE_ALTA, f"Saldo devedor de {_moeda(saldo_final)} no fornecedor.")
+        )
+    if total_excedente > 0:
+        quantidade = sum(1 for s in situacoes.values() if s.categoria == CATEGORIA_EXCEDENTE)
+        alertas.append(
+            AlertaConta(
+                "debito_excedente",
+                SEVERIDADE_ALTA,
+                f"{quantidade} pagamento(s) sem título em aberto correspondente, somando {_moeda(total_excedente)}.",
+            )
+        )
+    if total_vencido > 0:
+        quantidade = sum(1 for s in situacoes.values() if s.categoria == CATEGORIA_VENCIDO)
+        alertas.append(
+            AlertaConta(
+                "credito_vencido",
+                SEVERIDADE_MEDIA,
+                f"{quantidade} título(s) em aberto há mais de {MESES_VENCIDO} meses, somando {_moeda(total_vencido)}.",
+            )
+        )
+    if total_nao_vinculado > 0:
+        quantidade = sum(1 for s in situacoes.values() if s.categoria == CATEGORIA_NAO_VINCULADO)
+        alertas.append(
+            AlertaConta(
+                "pagamento_sem_titulo",
+                SEVERIDADE_MEDIA,
+                f"{quantidade} pagamento(s) ainda não vinculado(s) a um título, somando {_moeda(total_nao_vinculado)}. "
+                "Veja as sugestões na lista.",
+            )
+        )
+    for vinculo in vinculos:
+        if vinculo.diferenca == 0 or vinculo.tipo not in (TIPO_TOLERANCIA, TIPO_MANUAL):
+            continue
+        # diferença = créditos - débitos: negativa é pago a maior
+        natureza = "pago a maior (possível juros/multa)" if vinculo.diferenca < 0 else "pago a menor (possível desconto)"
+        origem = "Vínculo manual" if vinculo.tipo == TIPO_MANUAL else "Vínculo"
+        alertas.append(
+            AlertaConta("diferenca_vinculo", SEVERIDADE_BAIXA, f"{origem} com diferença de {_moeda(vinculo.diferenca)}: {natureza}.")
+        )
+
+    severidades = {a.severidade for a in alertas}
+    if SEVERIDADE_ALTA in severidades:
+        status = STATUS_DIVERGENTE
+    elif severidades:
+        status = STATUS_ATENCAO
+    elif total_aberto > 0:
+        status = STATUS_PENDENTE
+    else:
+        status = STATUS_CONCILIADA
+
+    return AnaliseConta(
+        status=status,
+        alertas=alertas,
+        situacoes=situacoes,
+        total_em_aberto=total_aberto,
+        total_vencido=total_vencido,
+        total_nao_vinculado=total_nao_vinculado,
+        total_excedente=total_excedente,
+    )
diff --git a/portal_api/conciliacao_fornecedores/exportacao.py b/portal_api/conciliacao_fornecedores/exportacao.py
new file mode 100644
index 0000000..8cd45e7
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/exportacao.py
@@ -0,0 +1,177 @@
+"""Exportação em XLSX do resultado de uma conciliação de fornecedores —
+funções puras (openpyxl), recebem os dados já resolvidos pela view, nunca
+tocam no ORM (mesmo espírito de `dashboard_contabil/exportacao.py`).
+
+Três abas: Resumo (uma linha por conta), Pendências (cada lançamento sem
+vínculo, com o valor em aberto e a situação) e Alertas.
+"""
+
+from __future__ import annotations
+
+import io
+from dataclasses import dataclass
+from datetime import date
+from decimal import Decimal
+
+from openpyxl import Workbook
+from openpyxl.styles import Alignment, Font, PatternFill
+from openpyxl.utils import get_column_letter
+from openpyxl.worksheet.worksheet import Worksheet
+
+# Mesma paleta roxo/dourado dos outros documentos gerados pelo escritório.
+COR_ROXO_ESCURO = "FF3D2178"
+COR_BRANCO = "FFFFFFFF"
+FORMATO_MOEDA = '"R$" #,##0.00;[Red]-"R$" #,##0.00'
+FORMATO_DATA = "DD/MM/YYYY"
+
+
+@dataclass
+class ContaXlsx:
+    conta_numero: str
+    classificacao: str
+    fornecedor: str
+    saldo_inicial: Decimal
+    saldo_final: Decimal
+    total_em_aberto: Decimal
+    total_vencido: Decimal
+    total_excedente: Decimal
+    situacao: str
+    validada: bool
+    observacao: str
+
+
+@dataclass
+class PendenciaXlsx:
+    conta_numero: str
+    fornecedor: str
+    data: date
+    sequencia: str
+    historico: str
+    natureza: str  # "Crédito"/"Débito"
+    valor: Decimal
+    valor_em_aberto: Decimal
+    situacao: str
+
+
+@dataclass
+class AlertaXlsx:
+    conta_numero: str
+    fornecedor: str
+    severidade: str
+    mensagem: str
+
+
+def _cabecalho(ws: Worksheet, titulo: str, empresa: str, subtitulo: str, colunas: list[str]) -> int:
+    ultima = get_column_letter(len(colunas))
+    ws.merge_cells(f"A1:{ultima}1")
+    ws["A1"] = titulo
+    ws["A1"].font = Font(size=14, bold=True, color=COR_ROXO_ESCURO)
+    ws.merge_cells(f"A2:{ultima}2")
+    ws["A2"] = empresa
+    ws["A2"].font = Font(size=11, bold=True)
+    ws.merge_cells(f"A3:{ultima}3")
+    ws["A3"] = subtitulo
+    ws["A3"].font = Font(size=9, italic=True)
+
+    linha = 5
+    for coluna, texto in enumerate(colunas, start=1):
+        celula = ws.cell(row=linha, column=coluna, value=texto)
+        celula.font = Font(bold=True, color=COR_BRANCO)
+        celula.fill = PatternFill("solid", fgColor=COR_ROXO_ESCURO)
+        celula.alignment = Alignment(vertical="center", wrap_text=True)
+    ws.freeze_panes = ws.cell(row=linha + 1, column=1)
+    return linha + 1
+
+
+def _larguras(ws: Worksheet, larguras: list[int]) -> None:
+    for coluna, largura in enumerate(larguras, start=1):
+        ws.column_dimensions[get_column_letter(coluna)].width = largura
+
+
+def gera_xlsx(
+    *,
+    empresa: str,
+    data_base: date,
+    periodo: str,
+    contas: list[ContaXlsx],
+    pendencias: list[PendenciaXlsx],
+    alertas: list[AlertaXlsx],
+) -> bytes:
+    subtitulo = f"Data-base {data_base:%d/%m/%Y} · Período {periodo}"
+    wb = Workbook()
+
+    ws = wb.active
+    ws.title = "Resumo"
+    colunas = [
+        "Conta",
+        "Classificação",
+        "Fornecedor",
+        "Saldo inicial",
+        "Saldo final",
+        "Em aberto",
+        "Em aberto há mais de 3 meses",
+        "Pagamento excedente",
+        "Situação",
+        "Validada",
+        "Observação",
+    ]
+    linha = _cabecalho(ws, "Conciliação de Fornecedores - Resumo", empresa, subtitulo, colunas)
+    for conta in contas:
+        valores = [
+            conta.conta_numero,
+            conta.classificacao,
+            conta.fornecedor,
+            conta.saldo_inicial,
+            conta.saldo_final,
+            conta.total_em_aberto,
+            conta.total_vencido,
+            conta.total_excedente,
+            conta.situacao,
+            "Sim" if conta.validada else "Não",
+            conta.observacao,
+        ]
+        for coluna, valor in enumerate(valores, start=1):
+            celula = ws.cell(row=linha, column=coluna, value=valor)
+            if 4 <= coluna <= 8:
+                celula.number_format = FORMATO_MOEDA
+        linha += 1
+    _larguras(ws, [12, 18, 45, 16, 16, 16, 18, 18, 20, 10, 50])
+
+    ws = wb.create_sheet("Pendências")
+    colunas = ["Conta", "Fornecedor", "Data", "Seqüência", "Histórico", "Natureza", "Valor", "Valor em aberto", "Situação"]
+    linha = _cabecalho(ws, "Conciliação de Fornecedores - Pendências", empresa, subtitulo, colunas)
+    for item in pendencias:
+        valores = [
+            item.conta_numero,
+            item.fornecedor,
+            item.data,
+            item.sequencia,
+            item.historico,
+            item.natureza,
+            item.valor,
+            item.valor_em_aberto,
+            item.situacao,
+        ]
+        for coluna, valor in enumerate(valores, start=1):
+            celula = ws.cell(row=linha, column=coluna, value=valor)
+            if coluna == 3:
+                celula.number_format = FORMATO_DATA
+            elif coluna in (7, 8):
+                celula.number_format = FORMATO_MOEDA
+        linha += 1
+    _larguras(ws, [12, 40, 12, 12, 50, 10, 16, 16, 60])
+
+    ws = wb.create_sheet("Alertas")
+    colunas = ["Conta", "Fornecedor", "Severidade", "Alerta"]
+    linha = _cabecalho(ws, "Conciliação de Fornecedores - Alertas", empresa, subtitulo, colunas)
+    for alerta in alertas:
+        for coluna, valor in enumerate(
+            [alerta.conta_numero, alerta.fornecedor, alerta.severidade, alerta.mensagem], start=1
+        ):
+            ws.cell(row=linha, column=coluna, value=valor)
+        linha += 1
+    _larguras(ws, [12, 45, 12, 90])
+
+    saida = io.BytesIO()
+    wb.save(saida)
+    return saida.getvalue()
diff --git a/portal_api/conciliacao_fornecedores/motor.py b/portal_api/conciliacao_fornecedores/motor.py
new file mode 100644
index 0000000..a846443
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/motor.py
@@ -0,0 +1,273 @@
+"""Motor de conciliação automática de uma conta de fornecedor.
+
+Recebe os itens da conta (o saldo anterior, quando diferente de zero, entra
+como um item a mais, datado do dia do saldo) e devolve os vínculos
+sugeridos. Python puro, sem ORM: a view persiste o resultado.
+
+O histórico do pagamento não traz o número da NF (só "PAGAMENTO
+<FORNECEDOR>"), então todo vínculo é por **valor e data**. As etapas, na
+ordem:
+
+1. **Segmentação por saldo zerado.** Todo ponto em que o saldo corrente da
+   conta volta a zero fecha um segmento: tudo antes dele se compensa
+   exatamente, e nenhum vínculo precisa atravessar esse ponto. O vínculo é
+   procurado só dentro de cada segmento, o que evita casar um frete de
+   janeiro com o pagamento de um frete de mesmo valor de julho.
+2. **1:1 por valor exato**, escolhendo a menor distância de datas.
+3. **Combinação exata**: vários débitos somando um crédito (ou vários
+   créditos, como NF + juros, somando um débito), limitada a
+   `MAX_ITENS_COMBINACAO` itens numa janela de `JANELA_DIAS_COMBINACAO`
+   dias, com teto de nós visitados por busca (subset-sum é exponencial).
+4. **Compensação do segmento fechado**: o que sobrou num segmento que zerou
+   o saldo se compensa por definição; vira um único vínculo.
+5. **Tolerância** (só no último segmento, o que ficou em aberto): 1:1 ou
+   combinação pequena com diferença até o limite configurado (valor fixo
+   **ou** percentual sobre o valor do título, o que for maior), sinalizada
+   como possível juros/desconto.
+
+O que sobrar fica pendente, sem vínculo gravado. `alertas.py` distribui os
+débitos pendentes sobre os créditos pendentes (parcelas, pagamento parcial)
+a cada exibição, e só o que exceder os títulos em aberto vira divergência.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import date
+from decimal import Decimal
+
+MAX_ITENS_COMBINACAO = 6
+JANELA_DIAS_COMBINACAO = 120
+# Só os N candidatos mais próximos em data entram na busca de combinação:
+# numa conta com centenas de lançamentos pequenos (marketplace, frete), uma
+# soma exata entre itens sem relação nenhuma é quase certa se todos
+# puderem participar.
+MAX_CANDIDATOS_COMBINACAO = 12
+# Com tolerância, uma combinação de 3 ou mais itens "a menos de R$ 10" do
+# alvo aparece por acaso com muita facilidade; fica em 1:1 ou 2 itens
+# (título + juros, ou dois pagamentos).
+MAX_ITENS_TOLERANCIA = 2
+MAX_NOS_BUSCA = 20000
+# Tolerância de diferença (possível juros/desconto): fixa no Portal, não
+# editável pela tela (decisão do usuário). Vale o maior dos dois limites.
+TOLERANCIA_VALOR_PADRAO = Decimal("10.00")
+TOLERANCIA_PERCENTUAL_PADRAO = Decimal("2.00")
+
+TIPO_EXATO = "exato"
+TIPO_COMBINACAO = "combinacao"
+TIPO_SALDO_ZERADO = "saldo_zerado"
+TIPO_TOLERANCIA = "tolerancia"
+TIPO_MANUAL = "manual"
+# Só manual: débitos menores que os créditos além da tolerância. O saldo
+# (`diferenca`) continua em aberto (ver `alertas.analisa_conta`).
+TIPO_PARCIAL = "parcial"
+
+
+@dataclass
+class ItemConciliacao:
+    indice: int  # posição na lista de entrada, devolvida nos vínculos
+    data: date
+    natureza: str  # "C" (título/obrigação) ou "D" (pagamento)
+    valor: Decimal  # sempre positivo
+
+    @property
+    def centavos(self) -> int:
+        return int((self.valor * 100).to_integral_value())
+
+    @property
+    def assinado(self) -> int:
+        return self.centavos if self.natureza == "C" else -self.centavos
+
+
+@dataclass
+class VinculoSugerido:
+    tipo: str
+    indices: list[int]
+    diferenca: Decimal  # soma dos créditos - soma dos débitos
+
+
+@dataclass
+class Tolerancia:
+    valor: Decimal
+    percentual: Decimal  # 2 = 2%
+
+    def limite_centavos(self, centavos_titulo: int) -> int:
+        fixo = int((self.valor * 100).to_integral_value())
+        proporcional = int(Decimal(centavos_titulo) * self.percentual / Decimal(100))
+        return max(fixo, proporcional)
+
+
+def _diferenca(itens: list[ItemConciliacao]) -> Decimal:
+    return Decimal(sum(i.assinado for i in itens)) / Decimal(100)
+
+
+def _vinculo(tipo: str, itens: list[ItemConciliacao]) -> VinculoSugerido:
+    return VinculoSugerido(tipo=tipo, indices=sorted(i.indice for i in itens), diferenca=_diferenca(itens))
+
+
+def _segmentos(itens: list[ItemConciliacao]) -> list[list[ItemConciliacao]]:
+    """Corta a lista (na ordem do arquivo) a cada ponto de saldo zero. O
+    último segmento é o que ficou em aberto (pode ser vazio)."""
+    segmentos: list[list[ItemConciliacao]] = []
+    atual: list[ItemConciliacao] = []
+    saldo = 0
+    for item in itens:
+        atual.append(item)
+        saldo += item.assinado
+        if saldo == 0:
+            segmentos.append(atual)
+            atual = []
+    segmentos.append(atual)
+    return segmentos
+
+
+def _distancia(a: ItemConciliacao, b: ItemConciliacao) -> int:
+    return abs((a.data - b.data).days)
+
+
+def _pareia_exato(pendentes: list[ItemConciliacao]) -> list[VinculoSugerido]:
+    creditos = [i for i in pendentes if i.natureza == "C"]
+    debitos = [i for i in pendentes if i.natureza == "D"]
+    por_valor: dict[int, list[ItemConciliacao]] = {}
+    for debito in debitos:
+        por_valor.setdefault(debito.centavos, []).append(debito)
+
+    candidatos: list[tuple[int, int, int, ItemConciliacao, ItemConciliacao]] = []
+    for credito in creditos:
+        for debito in por_valor.get(credito.centavos, []):
+            # Desempate: pagamento depois do título antes de pagamento
+            # adiantado, depois ordem de leitura.
+            antes = 1 if debito.data < credito.data else 0
+            candidatos.append((_distancia(credito, debito), antes, credito.indice, credito, debito))
+    candidatos.sort(key=lambda c: (c[0], c[1], c[2], c[4].indice))
+
+    usados: set[int] = set()
+    vinculos: list[VinculoSugerido] = []
+    for _, _, _, credito, debito in candidatos:
+        if credito.indice in usados or debito.indice in usados:
+            continue
+        usados.update((credito.indice, debito.indice))
+        vinculos.append(_vinculo(TIPO_EXATO, [credito, debito]))
+    return vinculos
+
+
+def _busca_combinacao(
+    alvo: int,
+    candidatos: list[ItemConciliacao],
+    max_itens: int,
+    tolerancia: int = 0,
+) -> list[ItemConciliacao] | None:
+    """Subconjunto de `candidatos` (2 a `max_itens` itens) cuja soma fica a
+    até `tolerancia` centavos de `alvo`. Com tolerância, devolve o de menor
+    diferença encontrado dentro do teto de nós; sem, o primeiro exato.
+    `candidatos` já vem na ordem de preferência (mais próximos primeiro)."""
+    valores = [c.centavos for c in candidatos]
+    # soma dos maiores restantes a partir de cada posição, para podar ramos
+    # que não alcançam o alvo nem somando tudo o que resta
+    restante = [0] * (len(valores) + 1)
+    for pos in range(len(valores) - 1, -1, -1):
+        restante[pos] = restante[pos + 1] + valores[pos]
+
+    melhor: list[int] | None = None
+    melhor_dif = tolerancia + 1
+    nos = 0
+    caminho: list[int] = []
+
+    def dfs(inicio: int, soma: int) -> bool:
+        nonlocal melhor, melhor_dif, nos
+        nos += 1
+        if nos > MAX_NOS_BUSCA:
+            return True
+        if len(caminho) >= 2:
+            dif = abs(alvo - soma)
+            if dif < melhor_dif:
+                melhor, melhor_dif = list(caminho), dif
+                if dif == 0:
+                    return True
+        if len(caminho) == max_itens:
+            return False
+        for pos in range(inicio, len(valores)):
+            nova = soma + valores[pos]
+            if nova > alvo + tolerancia:
+                continue
+            if soma + restante[pos] < alvo - tolerancia:
+                break
+            caminho.append(pos)
+            if dfs(pos + 1, nova):
+                return True
+            caminho.pop()
+        return False
+
+    dfs(0, 0)
+    if melhor is None:
+        return None
+    return [candidatos[pos] for pos in melhor]
+
+
+def _combina(
+    pendentes: list[ItemConciliacao],
+    tipo: str,
+    max_itens: int,
+    tolerancia: Tolerancia | None,
+) -> list[VinculoSugerido]:
+    """Para cada item ainda pendente (créditos primeiro, na ordem de
+    leitura), procura uma combinação de itens da natureza oposta."""
+    vinculos: list[VinculoSugerido] = []
+    usados: set[int] = set()
+    ordenados = sorted(pendentes, key=lambda i: (i.natureza != "C", i.indice))
+    for alvo in ordenados:
+        if alvo.indice in usados:
+            continue
+        limite = tolerancia.limite_centavos(alvo.centavos) if tolerancia else 0
+        candidatos = [
+            i
+            for i in pendentes
+            if i.natureza != alvo.natureza
+            and i.indice not in usados
+            and i.centavos <= alvo.centavos + limite
+            and _distancia(i, alvo) <= JANELA_DIAS_COMBINACAO
+        ]
+        if not candidatos:
+            continue
+        candidatos.sort(key=lambda i: (_distancia(i, alvo), i.indice))
+        candidatos = candidatos[:MAX_CANDIDATOS_COMBINACAO]
+        # 1:1 com tolerância também conta (a busca exige 2 itens ou mais)
+        escolhido: list[ItemConciliacao] | None = None
+        if tolerancia:
+            proximos = [c for c in candidatos if abs(c.centavos - alvo.centavos) <= limite]
+            if proximos:
+                escolhido = [min(proximos, key=lambda c: (abs(c.centavos - alvo.centavos), _distancia(c, alvo)))]
+        if escolhido is None and len(candidatos) >= 2:
+            escolhido = _busca_combinacao(alvo.centavos, candidatos, max_itens, limite)
+        if not escolhido:
+            continue
+        grupo = [alvo, *escolhido]
+        usados.update(i.indice for i in grupo)
+        vinculos.append(_vinculo(tipo, grupo))
+    return vinculos
+
+
+def _sem_vinculo(itens: list[ItemConciliacao], vinculos: list[VinculoSugerido]) -> list[ItemConciliacao]:
+    usados = {indice for v in vinculos for indice in v.indices}
+    return [i for i in itens if i.indice not in usados]
+
+
+def concilia(itens: list[ItemConciliacao], tolerancia: Tolerancia) -> list[VinculoSugerido]:
+    """Roda as etapas descritas no topo do módulo para uma conta. `itens`
+    precisa estar na ordem do arquivo (é ela que define o saldo corrente)."""
+    vinculos: list[VinculoSugerido] = []
+    segmentos = _segmentos(itens)
+    for posicao, segmento in enumerate(segmentos):
+        if not segmento:
+            continue
+        aberto = posicao == len(segmentos) - 1
+        locais = _pareia_exato(segmento)
+        locais += _combina(_sem_vinculo(segmento, locais), TIPO_COMBINACAO, MAX_ITENS_COMBINACAO, None)
+        restantes = _sem_vinculo(segmento, locais)
+        if not aberto:
+            if restantes:
+                locais.append(_vinculo(TIPO_SALDO_ZERADO, restantes))
+        else:
+            locais += _combina(restantes, TIPO_TOLERANCIA, MAX_ITENS_TOLERANCIA, tolerancia)
+        vinculos += locais
+    return vinculos
diff --git a/portal_api/conciliacao_fornecedores/parser.py b/portal_api/conciliacao_fornecedores/parser.py
new file mode 100644
index 0000000..077b63c
--- /dev/null
+++ b/portal_api/conciliacao_fornecedores/parser.py
@@ -0,0 +1,272 @@
+"""Leitura do razão contábil de fornecedores exportado do Questor
+("Questor_Exportacao"), em XLSX ou CSV — as duas exportações trazem as
+mesmas 13 colunas, na mesma ordem:
+
+    Data, Seqüência, Histórico, Contrapartida, Descrição, Valor, Débito,
+    Crédito, Participante, Saldo, Filial, Usuário, Origem
+
+Cada conta começa numa linha só com "Conta: <reduzido> - <classificação>
+<fornecedor>" na coluna Histórico, seguida de "Saldo anterior..." (data do
+dia anterior ao período, só a coluna Saldo preenchida) e dos lançamentos.
+Não há linha de total por conta nem cabeçalho com empresa/período — a
+empresa é informada pelo usuário e o período sai das datas dos lançamentos.
+
+Python puro, sem ORM (mesmo espírito de `dashboard_contabil/parser.py`):
+recebe o conteúdo do arquivo em bytes e devolve dataclasses.
+
+Convenção de sinal: saldo **credor é positivo** (valor devido ao
+fornecedor), devedor é negativo. O Questor imprime "16.429,84C"/"10,00D".
+"""
+
+from __future__ import annotations
+
+import csv
+import io
+import re
+import unicodedata
+from dataclasses import dataclass, field
+from datetime import date, datetime
+from decimal import Decimal, InvalidOperation
+
+from openpyxl import load_workbook
+
+COLUNAS_ESPERADAS = [
+    "DATA",
+    "SEQUENCIA",
+    "HISTORICO",
+    "CONTRAPARTIDA",
+    "DESCRICAO",
+    "VALOR",
+    "DEBITO",
+    "CREDITO",
+    "PARTICIPANTE",
+    "SALDO",
+    "FILIAL",
+    "USUARIO",
+    "ORIGEM",
+]
+
+_RE_CONTA = re.compile(r"^Conta:\s*(\d+)\s*-\s*([\d.]+)\s+(.*)$")
+_RE_VALOR_DC = re.compile(r"^(-?[\d.]+,\d{2})\s*([DC])$")
+
+
+class ArquivoRazaoInvalidoError(ValueError):
+    """Arquivo que não segue o leiaute esperado da exportação do Questor."""
+
+
+@dataclass
+class LancamentoExtraido:
+    ordem: int
+    data: date
+    sequencia: str
+    historico: str
+    contrapartida_codigo: str
+    contrapartida_descricao: str
+    natureza: str  # "D" ou "C"
+    valor: Decimal  # sempre positivo
+    saldo_apos: Decimal | None  # saldo impresso após o lançamento, credor positivo
+    filial: str
+    usuario: str
+    origem: str
+
+
+@dataclass
+class ContaExtraida:
+    ordem: int
+    conta_numero: str
+    classificacao: str
+    fornecedor: str
+    saldo_inicial: Decimal = Decimal("0")
+    data_saldo_inicial: date | None = None
+    lancamentos: list[LancamentoExtraido] = field(default_factory=list)
+
+    @property
+    def saldo_final_calculado(self) -> Decimal:
+        total = self.saldo_inicial
+        for lanc in self.lancamentos:
+            total += lanc.valor if lanc.natureza == "C" else -lanc.valor
+        return total
+
+    @property
+    def saldo_final_arquivo(self) -> Decimal:
+        """Último saldo impresso pelo Questor (o do saldo anterior, se a
+        conta não teve movimento)."""
+        for lanc in reversed(self.lancamentos):
+            if lanc.saldo_apos is not None:
+                return lanc.saldo_apos
+        return self.saldo_inicial
+
+
+@dataclass
+class RazaoExtraido:
+    contas: list[ContaExtraida]
+    periodo_inicio: date | None
+    periodo_fim: date | None
+
+
+def _sem_acento(texto: str) -> str:
+    normalizado = unicodedata.normalize("NFKD", texto)
+    return "".join(c for c in normalizado if not unicodedata.combining(c)).upper().strip()
+
+
+def _texto(valor: object) -> str:
+    if valor is None:
+        return ""
+    if isinstance(valor, float) and valor.is_integer():
+        return str(int(valor))
+    return str(valor).strip()
+
+
+def _decimal_br(texto: str) -> Decimal:
+    try:
+        return Decimal(texto.replace(".", "").replace(",", "."))
+    except InvalidOperation as exc:
+        raise ArquivoRazaoInvalidoError(f"Valor numérico inválido: {texto!r}") from exc
+
+
+def _valor_dc(valor: object) -> tuple[Decimal, str] | None:
+    """"8.214,92D" -> (Decimal("8214.92"), "D"). `None` para célula vazia."""
+    texto = _texto(valor)
+    if not texto:
+        return None
+    casamento = _RE_VALOR_DC.match(texto)
+    if not casamento:
+        raise ArquivoRazaoInvalidoError(f"Valor sem indicação de débito/crédito: {texto!r}")
+    return abs(_decimal_br(casamento.group(1))), casamento.group(2)
+
+
+def _saldo_assinado(valor: object) -> Decimal | None:
+    lido = _valor_dc(valor)
+    if lido is None:
+        return None
+    numero, natureza = lido
+    return numero if natureza == "C" else -numero
+
+
+def _data(valor: object) -> date | None:
+    if valor is None or valor == "":
+        return None
+    if isinstance(valor, datetime):
+        return valor.date()
+    if isinstance(valor, date):
+        return valor
+    texto = _texto(valor)
+    try:
+        return datetime.strptime(texto, "%d/%m/%Y").date()
+    except ValueError as exc:
+        raise ArquivoRazaoInvalidoError(f"Data inválida: {texto!r}") from exc
+
+
+def _linhas_xlsx(conteudo: bytes) -> list[list[object]]:
+    wb = load_workbook(io.BytesIO(conteudo), read_only=True, data_only=True)
+    try:
+        ws = wb.worksheets[0]
+        return [list(linha) for linha in ws.iter_rows(values_only=True)]
+    finally:
+        wb.close()
+
+
+def _linhas_csv(conteudo: bytes) -> list[list[object]]:
+    # A exportação do Questor sai em Latin-1; UTF-8 fica como tentativa
+    # primeiro para o caso de o arquivo ter sido salvo de novo por outro
+    # programa.
+    try:
+        texto = conteudo.decode("utf-8-sig")
+    except UnicodeDecodeError:
+        texto = conteudo.decode("latin-1")
+    amostra = texto[:2000]
+    delimitador = ";" if amostra.count(";") > amostra.count(",") else ","
+    return [list(linha) for linha in csv.reader(io.StringIO(texto), delimiter=delimitador)]
+
+
+def _confere_cabecalho(cabecalho: list[object]) -> None:
+    # Compara só as letras ASCII, sem acento: o "Seqüência" do Questor pode
+    # chegar com o acento corrompido dependendo de como o arquivo foi salvo.
+    def chave(valor: object) -> str:
+        return re.sub(r"[^A-Z]", "", _sem_acento(_texto(valor)))
+
+    lidas = [chave(c) for c in cabecalho[: len(COLUNAS_ESPERADAS)]]
+    esperadas = [re.sub(r"[^A-Z]", "", c) for c in COLUNAS_ESPERADAS]
+    divergentes = [esperada for esperada, lida in zip(esperadas, lidas) if lida[:2] != esperada[:2]]
+    if len(lidas) < len(esperadas) or divergentes:
+        raise ArquivoRazaoInvalidoError(
+            "O arquivo não parece ser a exportação do razão de fornecedores do Questor "
+            "(colunas esperadas: Data, Seqüência, Histórico, Contrapartida, Descrição, Valor, "
+            "Débito, Crédito, Participante, Saldo, Filial, Usuário, Origem)."
+        )
+
+
+def extrai_razao(conteudo: bytes, nome_arquivo: str) -> RazaoExtraido:
+    """Lê o razão a partir do conteúdo do arquivo (.xlsx ou .csv)."""
+    extensao = nome_arquivo.lower().rsplit(".", 1)[-1] if "." in nome_arquivo else ""
+    if extensao == "xlsx":
+        linhas = _linhas_xlsx(conteudo)
+    elif extensao == "csv":
+        linhas = _linhas_csv(conteudo)
+    else:
+        raise ArquivoRazaoInvalidoError("Formato não suportado. Anexe a exportação em .xlsx ou .csv.")
+
+    if not linhas:
+        raise ArquivoRazaoInvalidoError("O arquivo está vazio.")
+    _confere_cabecalho(linhas[0])
+
+    contas: list[ContaExtraida] = []
+    atual: ContaExtraida | None = None
+    ordem_lancamento = 0
+    for numero_linha, bruta in enumerate(linhas[1:], start=2):
+        celulas = (bruta + [None] * len(COLUNAS_ESPERADAS))[: len(COLUNAS_ESPERADAS)]
+        historico = _texto(celulas[2])
+        if not any(_texto(c) for c in celulas):
+            continue
+
+        casamento_conta = _RE_CONTA.match(historico)
+        if casamento_conta:
+            atual = ContaExtraida(
+                ordem=len(contas),
+                conta_numero=casamento_conta.group(1),
+                classificacao=casamento_conta.group(2),
+                fornecedor=casamento_conta.group(3).strip(),
+            )
+            contas.append(atual)
+            continue
+
+        if atual is None:
+            raise ArquivoRazaoInvalidoError(f"Linha {numero_linha}: lançamento antes da primeira linha \"Conta:\".")
+
+        if _sem_acento(historico).startswith("SALDO ANTERIOR"):
+            atual.saldo_inicial = _saldo_assinado(celulas[9]) or Decimal("0")
+            atual.data_saldo_inicial = _data(celulas[0])
+            continue
+
+        data_lanc = _data(celulas[0])
+        valor = _valor_dc(celulas[5])
+        if data_lanc is None or valor is None:
+            raise ArquivoRazaoInvalidoError(f"Linha {numero_linha}: lançamento sem data ou sem valor.")
+        numero, natureza = valor
+        atual.lancamentos.append(
+            LancamentoExtraido(
+                ordem=ordem_lancamento,
+                data=data_lanc,
+                sequencia=_texto(celulas[1]),
+                historico=historico,
+                contrapartida_codigo=_texto(celulas[3]),
+                contrapartida_descricao=_texto(celulas[4]),
+                natureza=natureza,
+                valor=numero,
+                saldo_apos=_saldo_assinado(celulas[9]),
+                filial=_texto(celulas[10]),
+                usuario=_texto(celulas[11]),
+                origem=_texto(celulas[12]),
+            )
+        )
+        ordem_lancamento += 1
+
+    if not contas:
+        raise ArquivoRazaoInvalidoError("Nenhuma conta encontrada no arquivo (linhas \"Conta: ...\").")
+
+    datas = [lanc.data for conta in contas for lanc in conta.lancamentos]
+    return RazaoExtraido(
+        contas=contas,
+        periodo_inicio=min(datas) if datas else None,
+        periodo_fim=max(datas) if datas else None,
+    )
diff --git a/portal_api/management/commands/seed_portal.py b/portal_api/management/commands/seed_portal.py
index e8d120b..e926e98 100644
--- a/portal_api/management/commands/seed_portal.py
+++ b/portal_api/management/commands/seed_portal.py
@@ -192,6 +192,10 @@ class Command(BaseCommand):
                 # Contratação, Indicador de Desempenho), que continuam com a
                 # visibilidade ampla de sempre.
                 permissoes["utilitarios"]["apps"]["importacao-plano-saude-de-paula"] = False
+                # "Conciliação de Fornecedores" nasce restrita a Inovação por
+                # decisão explícita do usuário (dado de cliente, mas ferramenta
+                # ainda em validação), liberada depois pela tela.
+                permissoes["utilitarios"]["apps"]["conciliacao-fornecedores"] = False
             # `nome` só é gravado na criação — reexecuções não devem reverter uma
             # renomeação feita depois pela própria tela de Perfis de Acesso (mesmo
             # espírito de "só inicializa na primeira criação" já usado pra
diff --git a/portal_api/migrations/0082_conciliacao_fornecedores.py b/portal_api/migrations/0082_conciliacao_fornecedores.py
new file mode 100644
index 0000000..fc875b1
--- /dev/null
+++ b/portal_api/migrations/0082_conciliacao_fornecedores.py
@@ -0,0 +1,103 @@
+# Generated by Django 6.0.7 on 2026-09-24 13:57
+
+import django.db.models.deletion
+import portal_api.models
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('portal_api', '0081_contabil_titulo_variacao_analise_vertical'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='ConciliacaoFornecedor',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('codigo_empresa', models.CharField(max_length=20, verbose_name='Código da empresa')),
+                ('nome_empresa', models.CharField(blank=True, max_length=255, verbose_name='Nome da empresa')),
+                ('data_base', models.DateField(verbose_name='Data-base da análise')),
+                ('periodo_inicio', models.DateField(blank=True, null=True, verbose_name='Início do período')),
+                ('periodo_fim', models.DateField(blank=True, null=True, verbose_name='Fim do período')),
+                ('arquivo', models.FileField(max_length=255, upload_to='conciliacao_fornecedores/', validators=[portal_api.models.validar_tamanho_arquivo_conciliacao], verbose_name='Arquivo do razão')),
+                ('nome_arquivo', models.CharField(blank=True, max_length=255, verbose_name='Nome do arquivo original')),
+                ('tolerancia_valor', models.DecimalField(decimal_places=2, max_digits=12, verbose_name='Tolerância (R$)')),
+                ('tolerancia_percentual', models.DecimalField(decimal_places=2, max_digits=5, verbose_name='Tolerância (%)')),
+                ('resumo', models.JSONField(blank=True, default=dict, verbose_name='Resumo')),
+                ('criado_em', models.DateTimeField(auto_now_add=True)),
+                ('criado_por', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='conciliacoes_fornecedores', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'Conciliação de fornecedores',
+                'verbose_name_plural': 'Conciliações de fornecedores',
+                'ordering': ['-criado_em', '-id'],
+            },
+        ),
+        migrations.CreateModel(
+            name='ConciliacaoFornecedorConta',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('ordem', models.PositiveIntegerField(verbose_name='Ordem no arquivo')),
+                ('conta_numero', models.CharField(max_length=20, verbose_name='Conta (reduzido)')),
+                ('classificacao', models.CharField(max_length=40, verbose_name='Classificação')),
+                ('fornecedor', models.CharField(max_length=255, verbose_name='Fornecedor')),
+                ('saldo_inicial', models.DecimalField(decimal_places=2, max_digits=16, verbose_name='Saldo inicial')),
+                ('saldo_final', models.DecimalField(decimal_places=2, max_digits=16, verbose_name='Saldo final (recalculado)')),
+                ('saldo_final_arquivo', models.DecimalField(decimal_places=2, max_digits=16, verbose_name='Saldo final (arquivo)')),
+                ('validada', models.BooleanField(default=False, verbose_name='Validada pelo contador')),
+                ('validada_em', models.DateTimeField(blank=True, null=True, verbose_name='Validada em')),
+                ('observacao', models.TextField(blank=True, verbose_name='Observação do contador')),
+                ('conciliacao', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='contas', to='portal_api.conciliacaofornecedor')),
+                ('validada_por', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'Conta (Conciliação de fornecedores)',
+                'verbose_name_plural': 'Contas (Conciliação de fornecedores)',
+                'ordering': ['ordem', 'id'],
+            },
+        ),
+        migrations.CreateModel(
+            name='ConciliacaoFornecedorVinculo',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('tipo', models.CharField(choices=[('exato', 'Valor exato'), ('combinacao', 'Combinação de valores'), ('saldo_zerado', 'Compensação até saldo zerado'), ('tolerancia', 'Com diferença (juros/desconto)'), ('manual', 'Manual')], max_length=20, verbose_name='Tipo')),
+                ('diferenca', models.DecimalField(decimal_places=2, default=0, max_digits=16, verbose_name='Diferença')),
+                ('criado_em', models.DateTimeField(auto_now_add=True)),
+                ('conta', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='vinculos', to='portal_api.conciliacaofornecedorconta')),
+                ('criado_por', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'Vínculo (Conciliação de fornecedores)',
+                'verbose_name_plural': 'Vínculos (Conciliação de fornecedores)',
+                'ordering': ['id'],
+            },
+        ),
+        migrations.CreateModel(
+            name='ConciliacaoFornecedorLancamento',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('ordem', models.PositiveIntegerField(verbose_name='Ordem na conta')),
+                ('eh_saldo_anterior', models.BooleanField(default=False, verbose_name='Saldo anterior')),
+                ('data', models.DateField(verbose_name='Data')),
+                ('sequencia', models.CharField(blank=True, max_length=20, verbose_name='Seqüência')),
+                ('historico', models.CharField(blank=True, max_length=500, verbose_name='Histórico')),
+                ('contrapartida_codigo', models.CharField(blank=True, max_length=20, verbose_name='Contrapartida')),
+                ('contrapartida_descricao', models.CharField(blank=True, max_length=255, verbose_name='Descrição da contrapartida')),
+                ('natureza', models.CharField(choices=[('D', 'Débito'), ('C', 'Crédito')], max_length=1, verbose_name='Natureza')),
+                ('valor', models.DecimalField(decimal_places=2, max_digits=16, verbose_name='Valor')),
+                ('saldo_apos', models.DecimalField(blank=True, decimal_places=2, max_digits=16, null=True, verbose_name='Saldo após o lançamento')),
+                ('usuario', models.CharField(blank=True, max_length=100, verbose_name='Usuário (Questor)')),
+                ('origem', models.CharField(blank=True, max_length=10, verbose_name='Origem')),
+                ('conta', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lancamentos', to='portal_api.conciliacaofornecedorconta')),
+                ('vinculo', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='lancamentos', to='portal_api.conciliacaofornecedorvinculo')),
+            ],
+            options={
+                'verbose_name': 'Lançamento (Conciliação de fornecedores)',
+                'verbose_name_plural': 'Lançamentos (Conciliação de fornecedores)',
+                'ordering': ['ordem', 'id'],
+            },
+        ),
+    ]
diff --git a/portal_api/migrations/0083_conciliacao_vinculo_parcial.py b/portal_api/migrations/0083_conciliacao_vinculo_parcial.py
new file mode 100644
index 0000000..dae78eb
--- /dev/null
+++ b/portal_api/migrations/0083_conciliacao_vinculo_parcial.py
@@ -0,0 +1,18 @@
+# Generated by Django 6.0.7 on 2026-09-24 18:18
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('portal_api', '0082_conciliacao_fornecedores'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='conciliacaofornecedorvinculo',
+            name='tipo',
+            field=models.CharField(choices=[('exato', 'Valor exato'), ('combinacao', 'Combinação de valores'), ('saldo_zerado', 'Compensação até saldo zerado'), ('tolerancia', 'Com diferença (juros/desconto)'), ('manual', 'Manual'), ('parcial', 'Pagamento parcial')], max_length=20, verbose_name='Tipo'),
+        ),
+    ]
diff --git a/portal_api/models.py b/portal_api/models.py
index 80cc050..96dfdee 100644
--- a/portal_api/models.py
+++ b/portal_api/models.py
@@ -2677,3 +2677,148 @@ class IndicadorContabilComponente(models.Model):
 
     def __str__(self) -> str:
         return f"{self.chave} ({self.get_tipo_display()})"
+
+
+# --- Conciliação de Fornecedores (Utilitários) -----------------------------
+# Ver portal_api/conciliacao_fornecedores/CLAUDE.md. Cabeçalho → contas →
+# lançamentos, com os vínculos (automáticos ou manuais) como registro
+# próprio. Status/alertas de cada conta não são gravados: são recalculados a
+# cada exibição (`conciliacao_fornecedores.alertas`), já que dependem dos
+# vínculos atuais, que o contador pode desfazer ou criar.
+
+CONCILIACAO_ARQUIVO_MAX_BYTES = 15 * 1024 * 1024
+
+
+def validar_tamanho_arquivo_conciliacao(arquivo: File) -> None:
+    if arquivo.size > CONCILIACAO_ARQUIVO_MAX_BYTES:
+        raise ValidationError("O arquivo deve ter no máximo 15MB.")
+
+
+class ConciliacaoFornecedor(models.Model):
+    """Uma conciliação do razão de fornecedores de uma empresa: o contador
+    informa o código da empresa (nome resolvido no Questor) e anexa a
+    exportação do razão (.xlsx ou .csv). Sem `unique_together`: a mesma
+    empresa pode ser conciliada várias vezes (meses diferentes, ou de novo
+    depois de corrigir lançamentos no Questor)."""
+
+    codigo_empresa = models.CharField("Código da empresa", max_length=20)
+    nome_empresa = models.CharField("Nome da empresa", max_length=255, blank=True)
+    data_base = models.DateField("Data-base da análise")
+    periodo_inicio = models.DateField("Início do período", null=True, blank=True)
+    periodo_fim = models.DateField("Fim do período", null=True, blank=True)
+    arquivo = models.FileField(
+        "Arquivo do razão",
+        upload_to="conciliacao_fornecedores/",
+        max_length=255,
+        validators=[validar_tamanho_arquivo_conciliacao],
+    )
+    nome_arquivo = models.CharField("Nome do arquivo original", max_length=255, blank=True)
+    tolerancia_valor = models.DecimalField("Tolerância (R$)", max_digits=12, decimal_places=2)
+    tolerancia_percentual = models.DecimalField("Tolerância (%)", max_digits=5, decimal_places=2)
+    # Totais por status/valores, recalculados a cada criação e a cada ajuste
+    # manual (`_conciliacao_atualiza_resumo()` em views.py). Só existe para a
+    # listagem do histórico não precisar reanalisar todas as contas de
+    # todas as conciliações; a tela de detalhe usa a análise fresca.
+    resumo = models.JSONField("Resumo", default=dict, blank=True)
+    criado_por = models.ForeignKey(
+        Usuario, on_delete=models.SET_NULL, null=True, related_name="conciliacoes_fornecedores"
+    )
+    criado_em = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        verbose_name = "Conciliação de fornecedores"
+        verbose_name_plural = "Conciliações de fornecedores"
+        ordering = ["-criado_em", "-id"]
+
+    def __str__(self) -> str:
+        return f"{self.codigo_empresa} - {self.nome_empresa} ({self.data_base:%d/%m/%Y})"
+
+
+class ConciliacaoFornecedorConta(models.Model):
+    """Uma conta de fornecedor do razão. `saldo_inicial`/`saldo_final`
+    seguem a convenção credor positivo (valor devido ao fornecedor)."""
+
+    conciliacao = models.ForeignKey(ConciliacaoFornecedor, on_delete=models.CASCADE, related_name="contas")
+    ordem = models.PositiveIntegerField("Ordem no arquivo")
+    conta_numero = models.CharField("Conta (reduzido)", max_length=20)
+    classificacao = models.CharField("Classificação", max_length=40)
+    fornecedor = models.CharField("Fornecedor", max_length=255)
+    saldo_inicial = models.DecimalField("Saldo inicial", max_digits=16, decimal_places=2)
+    saldo_final = models.DecimalField("Saldo final (recalculado)", max_digits=16, decimal_places=2)
+    saldo_final_arquivo = models.DecimalField("Saldo final (arquivo)", max_digits=16, decimal_places=2)
+    validada = models.BooleanField("Validada pelo contador", default=False)
+    validada_por = models.ForeignKey(Usuario, on_delete=models.SET_NULL, null=True, blank=True, related_name="+")
+    validada_em = models.DateTimeField("Validada em", null=True, blank=True)
+    observacao = models.TextField("Observação do contador", blank=True)
+
+    class Meta:
+        verbose_name = "Conta (Conciliação de fornecedores)"
+        verbose_name_plural = "Contas (Conciliação de fornecedores)"
+        ordering = ["ordem", "id"]
+
+    def __str__(self) -> str:
+        return f"{self.conta_numero} - {self.fornecedor}"
+
+
+class ConciliacaoFornecedorVinculo(models.Model):
+    """Um conjunto de lançamentos da mesma conta que se compensam.
+    `diferenca` = soma dos créditos - soma dos débitos (zero nos vínculos
+    exatos). Excluir um vínculo devolve os lançamentos para pendente
+    (`SET_NULL` em `ConciliacaoFornecedorLancamento.vinculo`)."""
+
+    TIPO_CHOICES = [
+        ("exato", "Valor exato"),
+        ("combinacao", "Combinação de valores"),
+        ("saldo_zerado", "Compensação até saldo zerado"),
+        ("tolerancia", "Com diferença (juros/desconto)"),
+        ("manual", "Manual"),
+        ("parcial", "Pagamento parcial"),
+    ]
+
+    conta = models.ForeignKey(ConciliacaoFornecedorConta, on_delete=models.CASCADE, related_name="vinculos")
+    tipo = models.CharField("Tipo", max_length=20, choices=TIPO_CHOICES)
+    diferenca = models.DecimalField("Diferença", max_digits=16, decimal_places=2, default=0)
+    criado_por = models.ForeignKey(Usuario, on_delete=models.SET_NULL, null=True, blank=True, related_name="+")
+    criado_em = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        verbose_name = "Vínculo (Conciliação de fornecedores)"
+        verbose_name_plural = "Vínculos (Conciliação de fornecedores)"
+        ordering = ["id"]
+
+    def __str__(self) -> str:
+        return f"{self.get_tipo_display()} #{self.pk}"
+
+
+class ConciliacaoFornecedorLancamento(models.Model):
+    """Um lançamento do razão, ou o saldo anterior da conta
+    (`eh_saldo_anterior`, só quando diferente de zero — entra na
+    conciliação como um título/pagamento a mais, sem detalhe de
+    composição). `valor` sempre positivo; `natureza` diz o lado."""
+
+    NATUREZA_CHOICES = [("D", "Débito"), ("C", "Crédito")]
+
+    conta = models.ForeignKey(ConciliacaoFornecedorConta, on_delete=models.CASCADE, related_name="lancamentos")
+    ordem = models.PositiveIntegerField("Ordem na conta")
+    eh_saldo_anterior = models.BooleanField("Saldo anterior", default=False)
+    data = models.DateField("Data")
+    sequencia = models.CharField("Seqüência", max_length=20, blank=True)
+    historico = models.CharField("Histórico", max_length=500, blank=True)
+    contrapartida_codigo = models.CharField("Contrapartida", max_length=20, blank=True)
+    contrapartida_descricao = models.CharField("Descrição da contrapartida", max_length=255, blank=True)
+    natureza = models.CharField("Natureza", max_length=1, choices=NATUREZA_CHOICES)
+    valor = models.DecimalField("Valor", max_digits=16, decimal_places=2)
+    saldo_apos = models.DecimalField("Saldo após o lançamento", max_digits=16, decimal_places=2, null=True, blank=True)
+    usuario = models.CharField("Usuário (Questor)", max_length=100, blank=True)
+    origem = models.CharField("Origem", max_length=10, blank=True)
+    vinculo = models.ForeignKey(
+        ConciliacaoFornecedorVinculo, on_delete=models.SET_NULL, null=True, blank=True, related_name="lancamentos"
+    )
+
+    class Meta:
+        verbose_name = "Lançamento (Conciliação de fornecedores)"
+        verbose_name_plural = "Lançamentos (Conciliação de fornecedores)"
+        ordering = ["ordem", "id"]
+
+    def __str__(self) -> str:
+        return f"{self.data:%d/%m/%Y} {self.natureza} {self.valor}"
diff --git a/portal_api/serializers.py b/portal_api/serializers.py
index 18b0f96..8b2db49 100644
--- a/portal_api/serializers.py
+++ b/portal_api/serializers.py
@@ -11,11 +11,13 @@ from .empresas_questor import normalizar_codigo_empresa, resolve_nome_empresa
 from .indicadores import calculo as indicadores_calculo
 from .nao_conformidades import classificacao as nc_classificacao
 from .models import (
+    CONCILIACAO_ARQUIVO_MAX_BYTES,
     AcessoGeral,
     AcessoGeralSecao,
     AjudaAplicacao,
     CategoriaEvento,
     CompromissoAgenda,
+    ConciliacaoFornecedor,
     ContabilAchado,
     ContabilApuracao,
     ContabilApuracaoReprocessamento,
@@ -2782,3 +2784,62 @@ class ContabilApuracaoDetailSerializer(serializers.ModelSerializer):
             "linhas_analise_vertical",
             "achados",
         ]
+
+
+# --- Conciliação de Fornecedores (Utilitários) -----------------------------
+# O detalhe (contas + lançamentos + análise recalculada) é montado em
+# `_conciliacao_detalhe()` em views.py, porque depende da análise de
+# `conciliacao_fornecedores.alertas` (não é campo de model).
+
+
+class ConciliacaoFornecedorListSerializer(serializers.ModelSerializer):
+    criado_por_nome = serializers.CharField(source="criado_por.nome", read_only=True, default=None)
+
+    class Meta:
+        model = ConciliacaoFornecedor
+        fields = [
+            "id",
+            "codigo_empresa",
+            "nome_empresa",
+            "data_base",
+            "periodo_inicio",
+            "periodo_fim",
+            "nome_arquivo",
+            "tolerancia_valor",
+            "tolerancia_percentual",
+            "resumo",
+            "criado_por_nome",
+            "criado_em",
+        ]
+
+
+class ConciliacaoFornecedorCreateSerializer(serializers.Serializer):
+    # Data-base (dia do processamento) e tolerâncias (motor.TOLERANCIA_*)
+    # são definidas no servidor, nunca aceitas da tela (decisão do usuário).
+    codigo_empresa = serializers.CharField(max_length=20)
+    arquivo = serializers.FileField()
+
+    def validate_codigo_empresa(self, valor: str) -> str:
+        codigo = normalizar_codigo_empresa(valor)
+        if not codigo.isdigit():
+            raise serializers.ValidationError("Informe o código numérico da empresa.")
+        return codigo
+
+    def validate_arquivo(self, arquivo: Any) -> Any:
+        nome = (arquivo.name or "").lower()
+        if not (nome.endswith(".xlsx") or nome.endswith(".csv")):
+            raise serializers.ValidationError("Anexe a exportação do razão em .xlsx ou .csv.")
+        if arquivo.size > CONCILIACAO_ARQUIVO_MAX_BYTES:
+            raise serializers.ValidationError("O arquivo deve ter no máximo 15MB.")
+        return arquivo
+
+
+class ConciliacaoFornecedorVincularSerializer(serializers.Serializer):
+    # 2+ para criar um vínculo; 1 já basta para acrescentar a um existente
+    # (a exigência de débito + crédito da criação fica na view).
+    lancamentos = serializers.ListField(child=serializers.IntegerField(), min_length=1)
+
+
+class ConciliacaoFornecedorValidarSerializer(serializers.Serializer):
+    validada = serializers.BooleanField()
+    observacao = serializers.CharField(required=False, allow_blank=True, max_length=5000)
diff --git a/portal_api/urls.py b/portal_api/urls.py
index 8fac25a..2bcfd29 100644
--- a/portal_api/urls.py
+++ b/portal_api/urls.py
@@ -111,6 +111,20 @@ router.register(
     basename="contabil-indicador-definicao",
 )
 
+router.register(
+    "conciliacoes-fornecedores", views.ConciliacaoFornecedorViewSet, basename="conciliacao-fornecedor"
+)
+router.register(
+    "conciliacoes-fornecedores-contas",
+    views.ConciliacaoFornecedorContaViewSet,
+    basename="conciliacao-fornecedor-conta",
+)
+router.register(
+    "conciliacoes-fornecedores-vinculos",
+    views.ConciliacaoFornecedorVinculoViewSet,
+    basename="conciliacao-fornecedor-vinculo",
+)
+
 urlpatterns = [
     path("auth/csrf/", views.csrf_view, name="auth-csrf"),
     path("auth/login/", views.login_view, name="auth-login"),
diff --git a/portal_api/views.py b/portal_api/views.py
index a558ece..b531af3 100644
--- a/portal_api/views.py
+++ b/portal_api/views.py
@@ -36,6 +36,10 @@ from rest_framework.response import Response
 from rest_framework.serializers import ModelSerializer
 
 from . import catalogo
+from .conciliacao_fornecedores import alertas as conciliacao_alertas
+from .conciliacao_fornecedores import exportacao as conciliacao_exportacao
+from .conciliacao_fornecedores import motor as conciliacao_motor
+from .conciliacao_fornecedores import parser as conciliacao_parser
 from .custo_contratacao.calculo import calcula_custo_empregado
 from .custo_contratacao.pdf import gera_pdf_simulacao
 from .dashboard_contabil import chaves as dashboard_contabil_chaves
@@ -57,6 +61,10 @@ from .models import (
     AjudaAplicacao,
     CategoriaEvento,
     CompromissoAgenda,
+    ConciliacaoFornecedor,
+    ConciliacaoFornecedorConta,
+    ConciliacaoFornecedorLancamento,
+    ConciliacaoFornecedorVinculo,
     ContabilAchado,
     ContabilApuracao,
     ContabilApuracaoReprocessamento,
@@ -132,6 +140,10 @@ from .serializers import (
     AjudaAplicacaoSerializer,
     CategoriaEventoSerializer,
     CompromissoAgendaSerializer,
+    ConciliacaoFornecedorCreateSerializer,
+    ConciliacaoFornecedorListSerializer,
+    ConciliacaoFornecedorValidarSerializer,
+    ConciliacaoFornecedorVincularSerializer,
     ContabilAchadoAjusteSerializer,
     ContabilAchadoOcultoSerializer,
     ContabilAchadoValidarSerializer,
@@ -5229,3 +5241,607 @@ class IndicadorContabilDefinicaoViewSet(viewsets.ModelViewSet):
                 campos_alterados.append("indicadores_ocultos")
             if campos_alterados:
                 apuracao.save(update_fields=campos_alterados)
+
+
+# --- Conciliação de Fornecedores (Utilitários) -----------------------------
+# Ver portal_api/conciliacao_fornecedores/CLAUDE.md. Os vínculos
+# (automáticos na criação, manuais depois) são gravados; status/alertas de
+# cada conta são recalculados a cada leitura por
+# `conciliacao_fornecedores.alertas.analisa_conta()`.
+
+_CONCILIACAO_PERMISSAO = ("utilitarios", "conciliacao-fornecedores")
+_CONCILIACAO_ROTULO_STATUS = {
+    conciliacao_alertas.STATUS_CONCILIADA: "Conciliada",
+    conciliacao_alertas.STATUS_PENDENTE: "Pendente de pagamento",
+    conciliacao_alertas.STATUS_ATENCAO: "Atenção",
+    conciliacao_alertas.STATUS_DIVERGENTE: "Divergente",
+}
+_CONCILIACAO_ROTULO_SEVERIDADE = {"alta": "Alta", "media": "Média", "baixa": "Baixa"}
+
+_ConciliacaoContaCarregada = tuple[
+    ConciliacaoFornecedorConta,
+    list[ConciliacaoFornecedorLancamento],
+    list[ConciliacaoFornecedorVinculo],
+    conciliacao_alertas.AnaliseConta,
+]
+
+
+def _conciliacao_rotulo_contrapartida(lanc: ConciliacaoFornecedorLancamento) -> str:
+    return " - ".join(p for p in (lanc.contrapartida_codigo, lanc.contrapartida_descricao.strip()) if p)
+
+
+def _conciliacao_analisa(
+    conciliacao: ConciliacaoFornecedor,
+    conta: ConciliacaoFornecedorConta,
+    lancamentos: list[ConciliacaoFornecedorLancamento],
+    vinculos: list[ConciliacaoFornecedorVinculo],
+) -> conciliacao_alertas.AnaliseConta:
+    return conciliacao_alertas.analisa_conta(
+        [
+            conciliacao_alertas.ItemAnalise(
+                id=lanc.id,
+                data=lanc.data,
+                natureza=lanc.natureza,
+                valor=lanc.valor,
+                vinculo_id=lanc.vinculo_id,
+                descricao=lanc.historico,
+            )
+            for lanc in lancamentos
+        ],
+        [
+            conciliacao_alertas.VinculoAnalise(
+                id=v.id,
+                tipo=v.tipo,
+                diferenca=v.diferenca,
+                data_titulo=min((lanc.data for lanc in lancamentos if lanc.vinculo_id == v.id and lanc.natureza == "C"), default=None),
+            )
+            for v in vinculos
+        ],
+        nome_conta=conta.fornecedor,
+        saldo_final=conta.saldo_final,
+        saldo_final_arquivo=conta.saldo_final_arquivo,
+        data_base=conciliacao.data_base,
+    )
+
+
+def _conciliacao_sincroniza_validacao_automatica(
+    conta: ConciliacaoFornecedorConta, analise: conciliacao_alertas.AnaliseConta
+) -> bool:
+    """Conta com situação "Conciliada" já nasce validada (pedido do usuário).
+    A validação automática é a que tem `validada_por` nulo: se a conta deixa
+    de estar conciliada (ex.: um vínculo desfeito), ela é retirada; a
+    validação feita por uma pessoa nunca é mexida aqui. Devolve se mudou
+    (sem salvar)."""
+    conciliada = analise.status == conciliacao_alertas.STATUS_CONCILIADA
+    if conciliada and not conta.validada:
+        conta.validada, conta.validada_por, conta.validada_em = True, None, timezone.now()
+        return True
+    if not conciliada and conta.validada and conta.validada_por_id is None:
+        conta.validada, conta.validada_em = False, None
+        return True
+    return False
+
+
+def _conciliacao_conta_payload(
+    conta: ConciliacaoFornecedorConta,
+    lancamentos: list[ConciliacaoFornecedorLancamento],
+    vinculos: list[ConciliacaoFornecedorVinculo],
+    analise: conciliacao_alertas.AnaliseConta,
+) -> dict[str, Any]:
+    def _situacao_saldo_parcial(vinculo: ConciliacaoFornecedorVinculo) -> dict[str, Any] | None:
+        item = analise.situacoes.get(-vinculo.id)
+        if vinculo.tipo != conciliacao_motor.TIPO_PARCIAL or item is None:
+            return None
+        return {
+            "categoria": item.categoria,
+            "valor_em_aberto": str(item.valor_em_aberto),
+            "descricao": item.descricao,
+            "sugestao": item.sugestao,
+        }
+
+    def situacao(lanc: ConciliacaoFornecedorLancamento) -> dict[str, Any] | None:
+        item = analise.situacoes.get(lanc.id)
+        if item is None:
+            return None
+        return {
+            "categoria": item.categoria,
+            "valor_em_aberto": str(item.valor_em_aberto),
+            "descricao": item.descricao,
+            "sugestao": item.sugestao,
+        }
+
+    return {
+        "id": conta.id,
+        "conta_numero": conta.conta_numero,
+        "classificacao": conta.classificacao,
+        "fornecedor": conta.fornecedor,
+        "saldo_inicial": str(conta.saldo_inicial),
+        "saldo_final": str(conta.saldo_final),
+        "validada": conta.validada,
+        "validada_por_nome": conta.validada_por.nome if conta.validada_por else None,
+        "validada_automatica": conta.validada and conta.validada_por_id is None,
+        "validada_em": conta.validada_em.isoformat() if conta.validada_em else None,
+        "observacao": conta.observacao,
+        "status": analise.status,
+        "status_rotulo": _CONCILIACAO_ROTULO_STATUS[analise.status],
+        "transitoria": conciliacao_alertas.eh_conta_transitoria(conta.fornecedor),
+        "alertas": [dataclasses.asdict(a) for a in analise.alertas],
+        "total_em_aberto": str(analise.total_em_aberto),
+        "total_vencido": str(analise.total_vencido),
+        "total_excedente": str(analise.total_excedente),
+        "total_nao_vinculado": str(analise.total_nao_vinculado),
+        "qtd_pendentes": sum(1 for lanc in lancamentos if lanc.vinculo_id is None),
+        "vinculos": [
+            {
+                "id": v.id,
+                "tipo": v.tipo,
+                "tipo_rotulo": v.get_tipo_display(),
+                "diferenca": str(v.diferenca),
+                "criado_por_nome": v.criado_por.nome if v.criado_por else None,
+                # pagamento parcial: saldo que continua em aberto
+                "situacao": _situacao_saldo_parcial(v),
+            }
+            for v in vinculos
+        ],
+        "lancamentos": [
+            {
+                "id": lanc.id,
+                "data": lanc.data.isoformat(),
+                "eh_saldo_anterior": lanc.eh_saldo_anterior,
+                "sequencia": lanc.sequencia,
+                "historico": lanc.historico,
+                "contrapartida": _conciliacao_rotulo_contrapartida(lanc),
+                "natureza": lanc.natureza,
+                "valor": str(lanc.valor),
+                "saldo_apos": str(lanc.saldo_apos) if lanc.saldo_apos is not None else None,
+                "origem": lanc.origem,
+                "usuario": lanc.usuario,
+                "vinculo_id": lanc.vinculo_id,
+                "situacao": situacao(lanc),
+            }
+            for lanc in lancamentos
+        ],
+    }
+
+
+def _conciliacao_carrega(
+    conciliacao: ConciliacaoFornecedor, contas: list[ConciliacaoFornecedorConta] | None = None
+) -> list[_ConciliacaoContaCarregada]:
+    """Contas + lançamentos + vínculos + análise, com 3 consultas no total
+    (não uma por conta)."""
+    if contas is None:
+        contas = list(conciliacao.contas.select_related("validada_por").order_by("ordem", "id"))
+    ids = [c.id for c in contas]
+    lancs_por_conta: dict[int, list[ConciliacaoFornecedorLancamento]] = {i: [] for i in ids}
+    for lanc in ConciliacaoFornecedorLancamento.objects.filter(conta_id__in=ids).order_by("ordem", "id"):
+        lancs_por_conta[lanc.conta_id].append(lanc)
+    vinc_por_conta: dict[int, list[ConciliacaoFornecedorVinculo]] = {i: [] for i in ids}
+    for vinc in ConciliacaoFornecedorVinculo.objects.filter(conta_id__in=ids).select_related("criado_por"):
+        vinc_por_conta[vinc.conta_id].append(vinc)
+    return [
+        (
+            conta,
+            lancs_por_conta[conta.id],
+            vinc_por_conta[conta.id],
+            _conciliacao_analisa(conciliacao, conta, lancs_por_conta[conta.id], vinc_por_conta[conta.id]),
+        )
+        for conta in contas
+    ]
+
+
+def _conciliacao_calcula_resumo(carregado: list[_ConciliacaoContaCarregada]) -> dict[str, Any]:
+    por_status = {chave: 0 for chave in _CONCILIACAO_ROTULO_STATUS}
+    total_aberto = total_vencido = total_excedente = total_nao_vinculado = Decimal("0")
+    validadas = 0
+    contas_por_alerta = {"credito_vencido": 0, "diferenca_vinculo": 0, "pagamento_sem_titulo": 0, "conta_transitoria": 0}
+    for conta, _, _, analise in carregado:
+        por_status[analise.status] += 1
+        validadas += conta.validada
+        total_aberto += analise.total_em_aberto
+        total_vencido += analise.total_vencido
+        total_excedente += analise.total_excedente
+        total_nao_vinculado += analise.total_nao_vinculado
+        for tipo in {a.tipo for a in analise.alertas}:
+            if tipo in contas_por_alerta:
+                contas_por_alerta[tipo] += 1
+    return {
+        "total_contas": len(carregado),
+        "por_status": por_status,
+        "validadas": validadas,
+        "total_em_aberto": str(total_aberto),
+        "total_vencido": str(total_vencido),
+        "total_excedente": str(total_excedente),
+        "total_nao_vinculado": str(total_nao_vinculado),
+        "contas_vencidas": contas_por_alerta["credito_vencido"],
+        "contas_com_diferenca": contas_por_alerta["diferenca_vinculo"],
+        "contas_pagamento_sem_titulo": contas_por_alerta["pagamento_sem_titulo"],
+        "contas_transitorias": contas_por_alerta["conta_transitoria"],
+    }
+
+
+def _conciliacao_valida_conciliadas(conciliacao: ConciliacaoFornecedor) -> int:
+    """Aplica a validação automática em todas as contas (criação da
+    conciliação). Devolve quantas mudaram."""
+    alteradas = [
+        conta
+        for conta, _, _, analise in _conciliacao_carrega(conciliacao)
+        if _conciliacao_sincroniza_validacao_automatica(conta, analise)
+    ]
+    ConciliacaoFornecedorConta.objects.bulk_update(alteradas, ["validada", "validada_por", "validada_em"])
+    return len(alteradas)
+
+
+def _conciliacao_atualiza_resumo(conciliacao: ConciliacaoFornecedor) -> dict[str, Any]:
+    resumo = _conciliacao_calcula_resumo(_conciliacao_carrega(conciliacao))
+    conciliacao.resumo = resumo
+    conciliacao.save(update_fields=["resumo"])
+    return resumo
+
+
+def _conciliacao_resposta_conta(conta: ConciliacaoFornecedorConta, sincroniza_validacao: bool = True) -> Response:
+    """Depois de um ajuste manual: devolve a conta reanalisada e o resumo
+    atualizado da conciliação (os cards do topo dependem dele). Depois de
+    vincular/desfazer, reaplica a validação automática; depois de o
+    contador marcar/desmarcar à mão (`sincroniza_validacao=False`), não."""
+    conciliacao = conta.conciliacao
+    conta = ConciliacaoFornecedorConta.objects.select_related("validada_por").get(pk=conta.pk)
+    [carregada] = _conciliacao_carrega(conciliacao, [conta])
+    if sincroniza_validacao and _conciliacao_sincroniza_validacao_automatica(conta, carregada[3]):
+        conta.save(update_fields=["validada", "validada_por", "validada_em"])
+    resumo = _conciliacao_atualiza_resumo(conciliacao)
+    return Response({"conta": _conciliacao_conta_payload(*carregada), "resumo": resumo})
+
+
+def _conciliacao_grava_contas(
+    conciliacao: ConciliacaoFornecedor,
+    razao: conciliacao_parser.RazaoExtraido,
+    tolerancia: conciliacao_motor.Tolerancia,
+) -> None:
+    """Grava contas, vínculos sugeridos pelo motor e lançamentos. O saldo
+    anterior diferente de zero vira um lançamento `eh_saldo_anterior`,
+    primeiro da conta, para participar da conciliação."""
+    contas = ConciliacaoFornecedorConta.objects.bulk_create(
+        [
+            ConciliacaoFornecedorConta(
+                conciliacao=conciliacao,
+                ordem=extraida.ordem,
+                conta_numero=extraida.conta_numero,
+                classificacao=extraida.classificacao,
+                fornecedor=extraida.fornecedor[:255],
+                saldo_inicial=extraida.saldo_inicial,
+                saldo_final=extraida.saldo_final_calculado,
+                saldo_final_arquivo=extraida.saldo_final_arquivo,
+            )
+            for extraida in razao.contas
+        ]
+    )
+
+    lancamentos: list[ConciliacaoFornecedorLancamento] = []
+    for conta, extraida in zip(contas, razao.contas):
+        linhas: list[ConciliacaoFornecedorLancamento] = []
+        if extraida.saldo_inicial:
+            linhas.append(
+                ConciliacaoFornecedorLancamento(
+                    conta=conta,
+                    ordem=0,
+                    eh_saldo_anterior=True,
+                    data=extraida.data_saldo_inicial or razao.periodo_inicio or conciliacao.data_base,
+                    historico="Saldo anterior",
+                    natureza="C" if extraida.saldo_inicial > 0 else "D",
+                    valor=abs(extraida.saldo_inicial),
+                    saldo_apos=extraida.saldo_inicial,
+                )
+            )
+        for lanc in extraida.lancamentos:
+            linhas.append(
+                ConciliacaoFornecedorLancamento(
+                    conta=conta,
+                    ordem=len(linhas),
+                    data=lanc.data,
+                    sequencia=lanc.sequencia[:20],
+                    historico=lanc.historico[:500],
+                    contrapartida_codigo=lanc.contrapartida_codigo[:20],
+                    contrapartida_descricao=lanc.contrapartida_descricao[:255],
+                    natureza=lanc.natureza,
+                    valor=lanc.valor,
+                    saldo_apos=lanc.saldo_apos,
+                    usuario=lanc.usuario[:100],
+                    origem=lanc.origem[:10],
+                )
+            )
+
+        sugeridos = conciliacao_motor.concilia(
+            [
+                conciliacao_motor.ItemConciliacao(indice=pos, data=linha.data, natureza=linha.natureza, valor=linha.valor)
+                for pos, linha in enumerate(linhas)
+            ],
+            tolerancia,
+        )
+        vinculos = ConciliacaoFornecedorVinculo.objects.bulk_create(
+            [ConciliacaoFornecedorVinculo(conta=conta, tipo=s.tipo, diferenca=s.diferenca) for s in sugeridos]
+        )
+        for vinculo, sugerido in zip(vinculos, sugeridos):
+            for pos in sugerido.indices:
+                linhas[pos].vinculo = vinculo
+        lancamentos += linhas
+
+    ConciliacaoFornecedorLancamento.objects.bulk_create(lancamentos, batch_size=2000)
+
+
+def _conciliacao_gera_xlsx(conciliacao: ConciliacaoFornecedor) -> bytes:
+    contas_xlsx: list[conciliacao_exportacao.ContaXlsx] = []
+    pendencias: list[conciliacao_exportacao.PendenciaXlsx] = []
+    alertas_xlsx: list[conciliacao_exportacao.AlertaXlsx] = []
+    for conta, lancs, vincs, analise in _conciliacao_carrega(conciliacao):
+        contas_xlsx.append(
+            conciliacao_exportacao.ContaXlsx(
+                conta_numero=conta.conta_numero,
+                classificacao=conta.classificacao,
+                fornecedor=conta.fornecedor,
+                saldo_inicial=conta.saldo_inicial,
+                saldo_final=conta.saldo_final,
+                total_em_aberto=analise.total_em_aberto,
+                total_vencido=analise.total_vencido,
+                total_excedente=analise.total_excedente,
+                situacao=_CONCILIACAO_ROTULO_STATUS[analise.status],
+                validada=conta.validada,
+                observacao=conta.observacao,
+            )
+        )
+        for vinc in vincs:
+            saldo = analise.situacoes.get(-vinc.id)
+            if vinc.tipo != conciliacao_motor.TIPO_PARCIAL or saldo is None or not saldo.valor_em_aberto:
+                continue
+            titulo = min((l for l in lancs if l.vinculo_id == vinc.id and l.natureza == "C"), key=lambda l: l.data)
+            pendencias.append(
+                conciliacao_exportacao.PendenciaXlsx(
+                    conta_numero=conta.conta_numero,
+                    fornecedor=conta.fornecedor,
+                    data=titulo.data,
+                    sequencia=titulo.sequencia,
+                    historico=f"{titulo.historico} (pagamento parcial vinculado)",
+                    natureza="Crédito",
+                    valor=titulo.valor,
+                    valor_em_aberto=saldo.valor_em_aberto,
+                    situacao=saldo.descricao,
+                )
+            )
+        for lanc in lancs:
+            situacao = analise.situacoes.get(lanc.id)
+            if situacao is None:
+                continue
+            pendencias.append(
+                conciliacao_exportacao.PendenciaXlsx(
+                    conta_numero=conta.conta_numero,
+                    fornecedor=conta.fornecedor,
+                    data=lanc.data,
+                    sequencia=lanc.sequencia,
+                    historico=lanc.historico,
+                    natureza="Crédito" if lanc.natureza == "C" else "Débito",
+                    valor=lanc.valor,
+                    valor_em_aberto=situacao.valor_em_aberto,
+                    situacao=f"{situacao.descricao} Sugestão: {situacao.sugestao}" if situacao.sugestao else situacao.descricao,
+                )
+            )
+        for alerta in analise.alertas:
+            alertas_xlsx.append(
+                conciliacao_exportacao.AlertaXlsx(
+                    conta_numero=conta.conta_numero,
+                    fornecedor=conta.fornecedor,
+                    severidade=_CONCILIACAO_ROTULO_SEVERIDADE[alerta.severidade],
+                    mensagem=alerta.mensagem,
+                )
+            )
+    periodo = (
+        f"{conciliacao.periodo_inicio:%d/%m/%Y} a {conciliacao.periodo_fim:%d/%m/%Y}"
+        if conciliacao.periodo_inicio and conciliacao.periodo_fim
+        else "sem lançamentos"
+    )
+    return conciliacao_exportacao.gera_xlsx(
+        empresa=f"{conciliacao.codigo_empresa} - {conciliacao.nome_empresa or 'Empresa não encontrada no Questor'}",
+        data_base=conciliacao.data_base,
+        periodo=periodo,
+        contas=contas_xlsx,
+        pendencias=pendencias,
+        alertas=alertas_xlsx,
+    )
+
+
+class ConciliacaoFornecedorViewSet(viewsets.ModelViewSet):
+    """Histórico (GET lista, filtrável por `?codigo_empresa=`), criação
+    (multipart: só `codigo_empresa` + `arquivo`; data-base e tolerâncias
+    são internas), detalhe completo e exclusão."""
+
+    http_method_names = ["get", "post", "delete", "head", "options"]
+    serializer_class = ConciliacaoFornecedorListSerializer
+
+    def get_permissions(self) -> list[BasePermission]:
+        return [PermissaoApp(*_CONCILIACAO_PERMISSAO)]
+
+    def get_queryset(self) -> QuerySet[ConciliacaoFornecedor]:
+        queryset = ConciliacaoFornecedor.objects.select_related("criado_por")
+        codigo = normalizar_codigo_empresa(self.request.query_params.get("codigo_empresa") or "")
+        if codigo:
+            queryset = queryset.filter(codigo_empresa=codigo)
+        return queryset
+
+    def retrieve(self, request: Request, *args: Any, **kwargs: Any) -> Response:
+        conciliacao = self.get_object()
+        carregado = _conciliacao_carrega(conciliacao)
+        dados = dict(ConciliacaoFornecedorListSerializer(conciliacao).data)
+        dados["resumo"] = _conciliacao_calcula_resumo(carregado)
+        dados["contas"] = [_conciliacao_conta_payload(*item) for item in carregado]
+        return Response(dados)
+
+    def create(self, request: Request, *args: Any, **kwargs: Any) -> Response:
+        entrada = ConciliacaoFornecedorCreateSerializer(data=request.data)
+        entrada.is_valid(raise_exception=True)
+        dados = entrada.validated_data
+        arquivo = dados["arquivo"]
+        conteudo = arquivo.read()
+        try:
+            razao = conciliacao_parser.extrai_razao(conteudo, arquivo.name)
+        except conciliacao_parser.ArquivoRazaoInvalidoError as exc:
+            raise ValidationError({"arquivo": str(exc)})
+
+        tolerancia = conciliacao_motor.Tolerancia(
+            conciliacao_motor.TOLERANCIA_VALOR_PADRAO, conciliacao_motor.TOLERANCIA_PERCENTUAL_PADRAO
+        )
+        # Nome resolvido antes da transação: é uma consulta a banco externo.
+        nome_empresa = resolve_nome_empresa(dados["codigo_empresa"]) or ""
+        conciliacao: ConciliacaoFornecedor | None = None
+        try:
+            with transaction.atomic():
+                conciliacao = ConciliacaoFornecedor(
+                    codigo_empresa=dados["codigo_empresa"],
+                    nome_empresa=nome_empresa,
+                    data_base=timezone.localdate(),
+                    periodo_inicio=razao.periodo_inicio,
+                    periodo_fim=razao.periodo_fim,
+                    nome_arquivo=arquivo.name[:255],
+                    tolerancia_valor=tolerancia.valor,
+                    tolerancia_percentual=tolerancia.percentual,
+                    criado_por=request.user,
+                )
+                conciliacao.arquivo.save(arquivo.name, ContentFile(conteudo), save=False)
+                conciliacao.save()
+                _conciliacao_grava_contas(conciliacao, razao, tolerancia)
+                _conciliacao_valida_conciliadas(conciliacao)
+                _conciliacao_atualiza_resumo(conciliacao)
+        except Exception:
+            # upload de FileField não é transacional
+            if conciliacao is not None and conciliacao.arquivo:
+                conciliacao.arquivo.delete(save=False)
+            raise
+        return Response(ConciliacaoFornecedorListSerializer(conciliacao).data, status=status.HTTP_201_CREATED)
+
+    def perform_destroy(self, instance: ConciliacaoFornecedor) -> None:
+        arquivo = instance.arquivo
+        with transaction.atomic():
+            instance.delete()
+        if arquivo:
+            arquivo.delete(save=False)
+
+    @action(detail=False, methods=["get"], url_path="nome-empresa")
+    def nome_empresa(self, request: Request) -> Response:
+        """Nome da empresa no Questor pelo código digitado (mesma consulta e
+        cache de "Cadastro de Regras" do Plano de Saúde). `nome_empresa: null`
+        tanto para código inexistente quanto para Questor inacessível."""
+        codigo = normalizar_codigo_empresa(request.query_params.get("codigo_empresa") or "")
+        if not codigo:
+            return Response({"detail": "Informe codigo_empresa."}, status=status.HTTP_400_BAD_REQUEST)
+        return Response({"codigo_empresa": codigo, "nome_empresa": resolve_nome_empresa(codigo)})
+
+    @action(detail=True, methods=["get"], url_path="exportar-xlsx")
+    def exportar_xlsx(self, request: Request, pk: str | None = None) -> HttpResponse:
+        conciliacao = self.get_object()
+        nome = f"conciliacao_fornecedores_{conciliacao.codigo_empresa}_{conciliacao.data_base:%Y%m%d}.xlsx"
+        resposta = HttpResponse(
+            _conciliacao_gera_xlsx(conciliacao),
+            content_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        )
+        resposta["Content-Disposition"] = f'attachment; filename="{nome}"'
+        return resposta
+
+
+def _conciliacao_tipo_vinculo_manual(
+    conciliacao: ConciliacaoFornecedor, lancs: list[ConciliacaoFornecedorLancamento]
+) -> tuple[str, Decimal]:
+    """Tipo e diferença de um vínculo manual. Créditos maiores que os débitos
+    além da tolerância: pagamento parcial, o saldo continua em aberto. Dentro
+    da tolerância (ou pago a maior), fecha como vínculo com diferença
+    (juros/desconto). Usado ao criar e ao acrescentar lançamentos."""
+    diferenca = sum((lanc.valor if lanc.natureza == "C" else -lanc.valor for lanc in lancs), Decimal("0"))
+    tolerancia = conciliacao_motor.Tolerancia(conciliacao.tolerancia_valor, conciliacao.tolerancia_percentual)
+    total_creditos = sum((lanc.valor for lanc in lancs if lanc.natureza == "C"), Decimal("0"))
+    limite = Decimal(tolerancia.limite_centavos(int(total_creditos * 100))) / 100
+    tipo = conciliacao_motor.TIPO_PARCIAL if diferenca > limite else conciliacao_motor.TIPO_MANUAL
+    return tipo, diferenca
+
+
+class ConciliacaoFornecedorContaViewSet(viewsets.GenericViewSet):
+    """Ajustes manuais numa conta: vincular lançamentos pendentes e marcar
+    a conta como validada (com observação)."""
+
+    queryset = ConciliacaoFornecedorConta.objects.select_related("conciliacao", "validada_por")
+
+    def get_permissions(self) -> list[BasePermission]:
+        return [PermissaoApp(*_CONCILIACAO_PERMISSAO)]
+
+    @action(detail=True, methods=["post"])
+    def vincular(self, request: Request, pk: str | None = None) -> Response:
+        conta = self.get_object()
+        entrada = ConciliacaoFornecedorVincularSerializer(data=request.data)
+        entrada.is_valid(raise_exception=True)
+        ids = set(entrada.validated_data["lancamentos"])
+        with transaction.atomic():
+            lancs = list(ConciliacaoFornecedorLancamento.objects.select_for_update().filter(conta=conta, id__in=ids))
+            if len(lancs) != len(ids):
+                raise ValidationError({"lancamentos": "Há lançamentos que não pertencem a esta conta."})
+            if any(lanc.vinculo_id is not None for lanc in lancs):
+                raise ValidationError({"lancamentos": "Há lançamentos que já estão vinculados. Desfaça o vínculo antes."})
+            if len(lancs) < 2 or {lanc.natureza for lanc in lancs} != {"C", "D"}:
+                raise ValidationError({"lancamentos": "Selecione pelo menos um débito e um crédito."})
+            tipo, diferenca = _conciliacao_tipo_vinculo_manual(conta.conciliacao, lancs)
+            vinculo = ConciliacaoFornecedorVinculo.objects.create(
+                conta=conta, tipo=tipo, diferenca=diferenca, criado_por=request.user
+            )
+            ConciliacaoFornecedorLancamento.objects.filter(id__in=ids).update(vinculo=vinculo)
+        return _conciliacao_resposta_conta(conta)
+
+    @action(detail=True, methods=["post"])
+    def validar(self, request: Request, pk: str | None = None) -> Response:
+        conta = self.get_object()
+        entrada = ConciliacaoFornecedorValidarSerializer(data=request.data)
+        entrada.is_valid(raise_exception=True)
+        dados = entrada.validated_data
+        conta.validada = dados["validada"]
+        conta.validada_por = request.user if conta.validada else None
+        conta.validada_em = timezone.now() if conta.validada else None
+        if "observacao" in dados:
+            conta.observacao = dados["observacao"].strip()
+        conta.save(update_fields=["validada", "validada_por", "validada_em", "observacao"])
+        return _conciliacao_resposta_conta(conta, sincroniza_validacao=False)
+
+
+class ConciliacaoFornecedorVinculoViewSet(viewsets.GenericViewSet):
+    """`DELETE` desfaz o vínculo: os lançamentos voltam a pendente.
+    `adicionar/` acrescenta lançamentos pendentes a um vínculo manual."""
+
+    queryset = ConciliacaoFornecedorVinculo.objects.select_related("conta__conciliacao")
+
+    def get_permissions(self) -> list[BasePermission]:
+        return [PermissaoApp(*_CONCILIACAO_PERMISSAO)]
+
+    def destroy(self, request: Request, pk: str | None = None) -> Response:
+        vinculo = self.get_object()
+        conta = vinculo.conta
+        with transaction.atomic():
+            vinculo.delete()
+        return _conciliacao_resposta_conta(conta)
+
+    @action(detail=True, methods=["post"])
+    def adicionar(self, request: Request, pk: str | None = None) -> Response:
+        """Acrescenta lançamentos pendentes da mesma conta a um vínculo manual
+        (ex.: um segundo pagamento de um título já vinculado como pagamento
+        parcial), sem desfazer o vínculo. Tipo e diferença são recalculados
+        com a mesma regra da criação; o vínculo passa a ser do usuário atual."""
+        vinculo = self.get_object()
+        if vinculo.tipo not in (conciliacao_motor.TIPO_MANUAL, conciliacao_motor.TIPO_PARCIAL):
+            raise ValidationError({"detail": "Só é possível acrescentar lançamentos a um vínculo manual."})
+        entrada = ConciliacaoFornecedorVincularSerializer(data=request.data)
+        entrada.is_valid(raise_exception=True)
+        ids = set(entrada.validated_data["lancamentos"])
+        conta = vinculo.conta
+        with transaction.atomic():
+            novos = list(ConciliacaoFornecedorLancamento.objects.select_for_update().filter(conta=conta, id__in=ids))
+            if len(novos) != len(ids):
+                raise ValidationError({"lancamentos": "Há lançamentos que não pertencem a esta conta."})
+            if any(lanc.vinculo_id is not None for lanc in novos):
+                raise ValidationError({"lancamentos": "Há lançamentos que já estão vinculados. Desfaça o vínculo antes."})
+            ConciliacaoFornecedorLancamento.objects.filter(id__in=ids).update(vinculo=vinculo)
+            todos = list(ConciliacaoFornecedorLancamento.objects.filter(vinculo=vinculo))
+            vinculo.tipo, vinculo.diferenca = _conciliacao_tipo_vinculo_manual(conta.conciliacao, todos)
+            vinculo.criado_por = request.user
+            vinculo.save(update_fields=["tipo", "diferenca", "criado_por"])
+        return _conciliacao_resposta_conta(conta)
diff --git a/static/css/conciliacao-fornecedores.css b/static/css/conciliacao-fornecedores.css
new file mode 100644
index 0000000..84468f1
--- /dev/null
+++ b/static/css/conciliacao-fornecedores.css
@@ -0,0 +1,1054 @@
+/* "Conciliação de Fornecedores" (Utilitários) — .conc-* — só usado em
+   conciliacao-fornecedores.html. Carrega perfis-acesso.css também, pra
+   reaproveitar .pa-table/.pa-table-wrap/.pa-search/.status-pill (mesmo
+   padrão de nao-conformidades.css/dashboard-contabil.css). */
+
+.conc-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: var(--space-4);
+  margin-bottom: var(--space-5);
+}
+
+.conc-header h2 {
+  margin: 0 0 var(--space-1);
+}
+
+.conc-subtitle {
+  color: var(--text-secondary);
+  font-size: 0.9rem;
+  margin: 0;
+  max-width: 760px;
+}
+
+.conc-empty {
+  color: var(--text-muted);
+  font-style: italic;
+  padding: var(--space-4);
+  text-align: center;
+}
+
+.conc-num {
+  text-align: right !important;
+  white-space: nowrap;
+}
+
+/* .pa-table td:last-child (perfis-acesso.css) alinha a última coluna à
+   direita; na tabela de fornecedores ela é a Situação, e numa célula de
+   aviso com colspan ela é a única. */
+.conc-table td:last-child,
+.pa-table td.conc-empty {
+  text-align: left;
+}
+
+.pa-table td.conc-empty {
+  text-align: center;
+}
+
+.conc-toolbar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+  margin-bottom: var(--space-3);
+}
+
+.conc-toolbar .pa-search {
+  margin-left: auto;
+}
+
+/* ---------------- Formulário de nova conciliação ---------------- */
+
+.conc-form {
+  background: var(--bg-surface);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-md);
+  padding: var(--space-5);
+  margin-bottom: var(--space-5);
+  animation: pidFadeSlideUp 160ms ease-out;
+}
+
+.conc-form__grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: var(--space-3) var(--space-4);
+}
+
+.conc-form__empresa {
+  margin: var(--space-1) 0 0;
+  font-size: 0.82rem;
+  font-weight: 600;
+  color: var(--accent);
+  min-height: 1.2em;
+}
+
+.conc-form__empresa.is-erro {
+  color: var(--danger);
+}
+
+.conc-form__empresa.is-carregando {
+  color: var(--text-muted);
+  font-weight: 400;
+}
+
+.conc-form__hint {
+  margin: var(--space-1) 0 0;
+  font-size: 0.75rem;
+  color: var(--text-muted);
+}
+
+.conc-file-field {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+
+.conc-file-field__btn {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-2);
+  cursor: pointer;
+}
+
+.conc-file-field__input {
+  display: none;
+}
+
+.conc-file-field__name {
+  font-size: 0.85rem;
+  color: var(--text-secondary);
+}
+
+/* ---------------- Cabeçalho da empresa ---------------- */
+
+.conc-voltar-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-1);
+  margin-bottom: var(--space-3);
+}
+
+.conc-empresa {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: var(--space-4);
+  background: var(--bg-surface);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-md);
+  padding: var(--space-3) var(--space-4);
+  margin-bottom: var(--space-4);
+}
+
+.conc-empresa .btn-outline {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--space-2);
+  white-space: nowrap;
+}
+
+.conc-empresa__codigo {
+  margin-right: var(--space-2);
+  font-size: 0.75rem;
+  font-weight: 700;
+  color: var(--accent);
+  letter-spacing: 0.04em;
+}
+
+.conc-empresa__nome {
+  display: inline;
+  margin: 0;
+  font-size: 1.05rem;
+}
+
+.conc-empresa__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-1) var(--space-5);
+  margin-top: 4px;
+  font-size: 0.78rem;
+  color: var(--text-secondary);
+}
+
+.conc-empresa__meta strong {
+  color: var(--text-primary);
+  font-weight: 600;
+}
+
+.conc-alertas-gerais {
+  margin-bottom: var(--space-4);
+}
+
+.conc-filtro-alerta {
+  font-size: 0.82rem;
+  color: var(--text-secondary);
+  margin: 0 0 var(--space-3);
+}
+
+.conc-filtro-alerta button {
+  color: var(--accent);
+  font-weight: 600;
+  margin-left: var(--space-2);
+}
+
+/* ---------------- Faixa de indicadores ---------------- */
+
+.conc-cards {
+  margin-bottom: var(--space-3);
+}
+
+.conc-kpis {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr)) minmax(0, 1.4fr);
+  background: var(--bg-surface);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-md);
+  overflow: hidden;
+}
+
+.conc-kpi,
+.conc-progresso {
+  padding: var(--space-3) var(--space-4);
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  text-align: left;
+  font: inherit;
+  color: inherit;
+  background: none;
+  border: 0;
+  border-right: 1px solid var(--border-subtle);
+}
+
+.conc-progresso {
+  border-right: 0;
+  justify-content: center;
+  gap: 6px;
+}
+
+button.conc-kpi {
+  cursor: pointer;
+  transition: background var(--transition-fast);
+}
+
+button.conc-kpi:hover {
+  background: var(--card-bg-hover);
+}
+
+button.conc-kpi.is-active {
+  box-shadow: inset 0 -2px 0 var(--accent);
+}
+
+.conc-kpi__rotulo {
+  font-size: 0.72rem;
+  color: var(--text-secondary);
+}
+
+.conc-kpi__valor {
+  font-size: 1.35rem;
+  font-weight: 700;
+  line-height: 1.2;
+  color: var(--text-primary);
+}
+
+.conc-kpi__detalhe {
+  font-size: 0.72rem;
+  color: var(--text-muted);
+}
+
+.conc-kpi--warning .conc-kpi__valor {
+  color: var(--gold);
+}
+
+.conc-kpi--danger .conc-kpi__valor {
+  color: var(--danger);
+}
+
+.conc-progresso__topo {
+  display: flex;
+  justify-content: space-between;
+  font-size: 0.82rem;
+  color: var(--text-secondary);
+}
+
+.conc-progresso__topo strong {
+  color: var(--text-primary);
+}
+
+.conc-progresso__barra {
+  height: 8px;
+  border-radius: var(--radius-pill);
+  background: var(--bg-surface-raised);
+  overflow: hidden;
+}
+
+.conc-progresso__barra span {
+  display: block;
+  height: 100%;
+  background: #2f9e6e;
+  border-radius: var(--radius-pill);
+  transition: width 0.3s ease;
+}
+
+/* Apontamentos menores em etiquetas clicáveis (filtram a tabela). */
+.conc-tags {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--space-2);
+  margin-top: var(--space-3);
+}
+
+.conc-tags__rotulo {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+}
+
+.conc-tag {
+  font-size: 0.75rem;
+  padding: 3px 10px;
+  border-radius: var(--radius-pill);
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-surface);
+  color: var(--text-secondary);
+  transition: border-color var(--transition-fast), background var(--transition-fast);
+}
+
+.conc-tag strong {
+  color: var(--text-primary);
+}
+
+.conc-tag--warning strong {
+  color: var(--gold);
+}
+
+.conc-tag--danger strong {
+  color: var(--danger);
+}
+
+.conc-tag--info strong {
+  color: var(--accent);
+}
+
+.conc-tag:hover,
+.conc-tag.is-active {
+  border-color: var(--accent);
+}
+
+.conc-tag.is-active {
+  background: rgba(var(--accent-rgb), 0.12);
+}
+
+/* ---------------- Chips de filtro ---------------- */
+
+.conc-chip-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-2);
+}
+
+.conc-chip {
+  padding: 4px 12px;
+  border-radius: var(--radius-pill);
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-surface);
+  color: var(--text-secondary);
+  font-size: 0.8rem;
+  font-weight: 600;
+  transition: border-color var(--transition-fast), color var(--transition-fast), background var(--transition-fast);
+}
+
+.conc-chip:hover {
+  color: var(--text-primary);
+}
+
+.conc-chip.is-active {
+  border-color: var(--accent);
+  color: var(--accent);
+  background: rgba(var(--accent-rgb), 0.12);
+}
+
+.conc-chip__count {
+  margin-left: 4px;
+  font-weight: 700;
+  opacity: 0.8;
+}
+
+/* ---------------- Tabela de fornecedores ---------------- */
+
+.conc-table th[data-sort] {
+  cursor: pointer;
+  user-select: none;
+  white-space: nowrap;
+}
+
+.conc-sort-icon {
+  color: var(--text-muted);
+  font-size: 0.75rem;
+}
+
+.conc-table th.is-sort-asc .conc-sort-icon,
+.conc-table th.is-sort-desc .conc-sort-icon {
+  color: var(--accent);
+}
+
+.conc-expand-col {
+  width: 32px;
+}
+
+.conc-row {
+  cursor: pointer;
+}
+
+.conc-row.is-aberta td {
+  background: var(--bg-surface-raised);
+}
+
+.conc-expand-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  border-radius: var(--radius-sm);
+  color: var(--text-secondary);
+}
+
+.conc-expand-chevron {
+  transition: transform var(--transition-fast);
+}
+
+.conc-row.is-aberta .conc-expand-chevron {
+  transform: rotate(90deg);
+}
+
+.conc-conta-numero {
+  font-variant-numeric: tabular-nums;
+  color: var(--text-secondary);
+  white-space: nowrap;
+}
+
+.conc-fornecedor__nome {
+  font-weight: 600;
+}
+
+.conc-fornecedor__alerta {
+  display: block;
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  margin-top: 2px;
+}
+
+.conc-valor {
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+}
+
+.conc-valor--devedor {
+  color: var(--danger);
+}
+
+.conc-valor--zero {
+  color: var(--text-muted);
+}
+
+.conc-valor--vencido {
+  color: var(--gold);
+  font-weight: 600;
+}
+
+.conc-status {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  white-space: nowrap;
+}
+
+.conc-status svg {
+  flex-shrink: 0;
+}
+
+.status-pill--ok {
+  color: #2f9e6e;
+  background: rgba(47, 158, 110, 0.14);
+}
+
+.status-pill--danger {
+  color: var(--danger);
+  background: rgba(var(--danger-rgb), 0.14);
+}
+
+.status-pill--warning {
+  color: var(--gold);
+  background: rgba(var(--gold-rgb), 0.18);
+}
+
+.status-pill--neutral {
+  color: var(--text-secondary);
+  background: var(--bg-surface-raised);
+}
+
+.status-pill--validada {
+  color: var(--accent);
+  background: rgba(var(--accent-rgb), 0.14);
+}
+
+/* ---------------- Detalhe expandido ---------------- */
+
+.pa-table td.conc-detail-cell {
+  background: var(--bg-surface-raised);
+  padding: var(--space-4) var(--space-5);
+  text-align: left;
+  cursor: default;
+}
+
+/* Só a célula externa da linha de detalhe (`>`): sem isso a regra pegava
+   também todas as células das sub-tabelas de lançamentos. */
+.conc-detail-row:hover > td {
+  background: var(--bg-surface-raised);
+}
+
+.conc-detail {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-4);
+  animation: pidFadeIn 140ms ease-out;
+}
+
+.conc-alertas {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.conc-alerta {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--space-2);
+  font-size: 0.85rem;
+  padding: var(--space-2) var(--space-3);
+  border-radius: var(--radius-sm);
+  background: var(--bg-surface);
+  border-left: 3px solid var(--border-subtle);
+  color: var(--text-primary);
+}
+
+.conc-alerta--alta {
+  border-left-color: var(--danger);
+}
+
+.conc-alerta--media {
+  border-left-color: var(--gold);
+}
+
+.conc-alerta--baixa {
+  border-left-color: var(--accent);
+}
+
+.conc-alerta__severidade {
+  font-size: 0.68rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  padding-top: 2px;
+  min-width: 44px;
+}
+
+.conc-alerta--alta .conc-alerta__severidade {
+  color: var(--danger);
+}
+
+.conc-alerta--media .conc-alerta__severidade {
+  color: var(--gold);
+}
+
+.conc-alerta--baixa .conc-alerta__severidade {
+  color: var(--accent);
+}
+
+.conc-detail__secao-titulo {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+  margin: 0 0 var(--space-2);
+}
+
+.conc-detail__secao-titulo h4 {
+  margin: 0;
+  font-size: 0.9rem;
+}
+
+.conc-detail__titulo-grupo {
+  display: flex;
+  align-items: center;
+  gap: var(--space-4);
+  flex-wrap: wrap;
+}
+
+.conc-detail__acoes {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+  flex-wrap: wrap;
+}
+
+.conc-selecao-resumo {
+  font-size: 0.8rem;
+  color: var(--text-secondary);
+}
+
+.conc-selecao-resumo strong {
+  color: var(--text-primary);
+}
+
+.conc-subtabela {
+  width: 100%;
+  border-collapse: collapse;
+  background: var(--bg-surface);
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-sm);
+  overflow: hidden;
+}
+
+.conc-subtabela th {
+  text-align: left;
+  font-size: 0.68rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--text-muted);
+  padding: var(--space-2) var(--space-3);
+  border-bottom: 1px solid var(--border-subtle);
+}
+
+.conc-subtabela td {
+  padding: var(--space-2) var(--space-3);
+  border-bottom: 1px solid var(--border-subtle);
+  font-size: 0.82rem;
+  color: var(--text-primary);
+  vertical-align: top;
+}
+
+.conc-subtabela tr:last-child td {
+  border-bottom: none;
+}
+
+/* As sub-tabelas ficam dentro da .pa-table de fornecedores, então
+   `.pa-table tr:hover td` (perfis-acesso.css) casava com toda célula delas
+   sempre que o mouse estava em qualquer ponto da linha de detalhe, clareando
+   todos os lançamentos de uma vez. Estas três regras têm especificidade
+   maior que aquela: fundo neutro por padrão, destaque só na linha sob o
+   mouse, e seleção por último para vencer o hover. */
+.pa-table .conc-subtabela tr td {
+  background: transparent;
+}
+
+.pa-table .conc-subtabela tbody tr:hover td {
+  background: var(--card-bg-hover);
+}
+
+.pa-table .conc-subtabela tr.is-selecionado td {
+  background: rgba(var(--accent-rgb), 0.12);
+}
+
+.conc-subtabela__check {
+  width: 28px;
+}
+
+.conc-historico {
+  max-width: 380px;
+}
+
+.conc-historico__contrapartida {
+  display: block;
+  font-size: 0.72rem;
+  color: var(--text-muted);
+}
+
+.conc-natureza {
+  font-size: 0.7rem;
+  font-weight: 700;
+  padding: 1px 6px;
+  border-radius: var(--radius-pill);
+}
+
+.conc-natureza--C {
+  color: var(--accent);
+  background: rgba(var(--accent-rgb), 0.12);
+}
+
+.conc-natureza--D {
+  color: var(--coral);
+  background: rgba(var(--coral-rgb), 0.14);
+}
+
+.conc-situacao {
+  font-size: 0.78rem;
+  color: var(--text-secondary);
+}
+
+.conc-situacao--vencido,
+.conc-situacao--nao_vinculado {
+  color: var(--gold);
+}
+
+.conc-situacao--excedente {
+  color: var(--danger);
+  font-weight: 600;
+}
+
+.conc-vinculo {
+  border: 1px solid var(--border-subtle);
+  border-radius: var(--radius-sm);
+  background: var(--bg-surface);
+  margin-bottom: var(--space-2);
+}
+
+.conc-vinculo__header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: var(--space-3);
+  padding: var(--space-2) var(--space-3);
+  border-bottom: 1px solid var(--border-subtle);
+  font-size: 0.8rem;
+  color: var(--text-secondary);
+}
+
+.conc-vinculo__header strong {
+  color: var(--text-primary);
+}
+
+.conc-vinculo .conc-subtabela {
+  border: none;
+  border-radius: 0;
+}
+
+.conc-vinculos-lista {
+  max-height: 420px;
+  overflow-y: auto;
+}
+
+.conc-validacao {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+  border-top: 1px solid var(--border-subtle);
+  padding-top: var(--space-4);
+}
+
+.conc-validacao textarea {
+  width: 100%;
+  min-height: 64px;
+  resize: vertical;
+  padding: var(--space-2) var(--space-3);
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--border-subtle);
+  background: var(--bg-surface);
+  color: var(--text-primary);
+  font: inherit;
+  font-size: 0.85rem;
+}
+
+.conc-validacao textarea:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+
+.conc-validacao__info {
+  font-size: 0.78rem;
+  color: var(--text-muted);
+}
+
+.conc-btn-sm {
+  padding: 4px 12px;
+  font-size: 0.8rem;
+}
+
+.conc-sem-pendencias {
+  font-size: 0.85rem;
+  color: var(--text-muted);
+  font-style: italic;
+  margin: 0;
+}
+
+.conc-detail button:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+/* Checkbox de "validado" no fim de cada linha de fornecedor (atalho do
+   botão "Marcar como validada" do detalhe, mesmo endpoint). */
+.conc-table th.conc-validado-col,
+.conc-table td.conc-validado-col {
+  width: 90px;
+  text-align: center !important;
+}
+
+.conc-validado-check {
+  width: 18px;
+  height: 18px;
+  cursor: pointer;
+  accent-color: var(--accent);
+}
+
+/* ---------------- Toggle de validadas ---------------- */
+
+.conc-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 0.8rem;
+  color: var(--text-secondary);
+  white-space: nowrap;
+  flex-shrink: 0;
+  margin-left: auto;
+  cursor: pointer;
+}
+
+.conc-toggle input {
+  accent-color: var(--accent);
+}
+
+.conc-toggle .conc-chip__count {
+  margin-left: 0;
+}
+
+/* ---------------- Filtros e cabeçalho fixos ao rolar ---------------- */
+/* Sempre com `>`: as sub-tabelas de lançamentos ficam dentro desta tabela,
+   e um seletor descendente fixava o thead delas no meio da lista. */
+/* A página rola pela janela e a .topbar (layout.css) já é sticky com
+   --topbar-height; os filtros ficam logo abaixo dela e o cabeçalho da
+   tabela logo abaixo dos filtros (altura fixa de --conc-toolbar-altura
+   para o cálculo bater). .pa-table-wrap tem overflow:hidden, que anularia
+   o sticky do thead: esta tabela abre mão dele. */
+
+.conc-detail-view,
+#conc-detail-view {
+  --conc-toolbar-altura: 52px;
+  --conc-thead-altura: 41px;
+  --conc-selecao-altura: 44px;
+}
+
+.conc-toolbar--fixa {
+  position: sticky;
+  top: var(--topbar-height);
+  z-index: 15;
+  flex-wrap: nowrap;
+  height: var(--conc-toolbar-altura);
+  margin-bottom: 0;
+  background: var(--bg-canvas);
+}
+
+.conc-toolbar--fixa .pa-search {
+  margin-left: 0;
+  width: 210px;
+  flex-shrink: 0;
+}
+
+.conc-table-wrap {
+  overflow: visible;
+}
+
+.conc-table > thead > tr > th {
+  position: sticky;
+  top: calc(var(--topbar-height) + var(--conc-toolbar-altura));
+  z-index: 10;
+}
+
+.conc-table > thead > tr > th:first-child {
+  border-top-left-radius: var(--radius-md);
+}
+
+.conc-table > thead > tr > th:last-child {
+  border-top-right-radius: var(--radius-md);
+}
+
+/* ---------------- Linhas compactas ---------------- */
+
+.conc-table tbody tr.conc-row > td {
+  padding-top: 7px;
+  padding-bottom: 7px;
+}
+
+.conc-fornecedor__nome {
+  font-size: 0.86rem;
+}
+
+.conc-fornecedor__alerta {
+  font-size: 0.72rem;
+}
+
+/* Coluna do fornecedor flexível e cortada com reticências (max-width:0 +
+   largura em % faz a célula ceder espaço em vez de alargar a tabela). */
+.conc-table tbody tr.conc-row > td:nth-child(3) {
+  max-width: 0;
+  width: 40%;
+}
+
+.conc-table tbody tr.conc-row > td:nth-child(3) span {
+  display: block;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* "Recolher" no fim da área expandida, à direita das ações da observação. */
+.conc-recolher-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  margin-left: auto;
+}
+
+/* ---------------- Sugestões (dedução da ferramenta, não fato) ---------------- */
+
+.conc-sugestao-tag {
+  display: inline-block;
+  margin-right: 6px;
+  padding: 0 6px;
+  border-radius: var(--radius-pill);
+  border: 1px dashed var(--text-muted);
+  font-size: 0.64rem;
+  font-weight: 700;
+  font-style: normal;
+  letter-spacing: 0.03em;
+  text-transform: uppercase;
+  color: var(--text-secondary);
+  vertical-align: 1px;
+}
+
+/* Sugestão numa linha própria, abaixo do fato, em tom neutro: não herda a
+   cor de alerta da situação (dourado/vermelho), que é do fato. */
+.conc-sugestao {
+  display: block;
+  margin-top: 3px;
+  font-style: italic;
+  font-weight: 400;
+  color: var(--text-muted);
+}
+
+.conc-vinculo--parcial {
+  border-left: 3px solid var(--gold);
+}
+
+/* ---------------- Barra de seleção fixa na conta expandida ---------------- */
+/* Com muitos lançamentos, a soma da seleção e o "Vincular selecionados"
+   ficam fixos logo abaixo do thead da tabela de fornecedores (pedido do
+   usuário), e o thead da lista de pendentes logo abaixo da barra. O sticky
+   vale dentro da célula de detalhe: some quando a conta sai da tela. */
+.conc-selecao-barra {
+  position: sticky;
+  top: calc(var(--topbar-height) + var(--conc-toolbar-altura) + var(--conc-thead-altura));
+  z-index: 9;
+  min-height: var(--conc-selecao-altura);
+  margin: 0 calc(-1 * var(--space-5)) 0;
+  padding: var(--space-2) var(--space-5);
+  background: var(--bg-surface-raised);
+  border-bottom: 1px solid var(--border-subtle);
+}
+
+/* overflow:hidden (do raio da borda) faria a tabela virar o contêiner de
+   rolagem do próprio thead e anularia o sticky */
+.conc-subtabela--pendentes {
+  overflow: visible;
+}
+
+.conc-subtabela--pendentes > thead > tr > th {
+  position: sticky;
+  top: calc(var(--topbar-height) + var(--conc-toolbar-altura) + var(--conc-thead-altura) + var(--conc-selecao-altura));
+  z-index: 8;
+  background: var(--bg-surface);
+}
+
+/* Linha do lançamento pendente é clicável (marca/desmarca a seleção). */
+.conc-subtabela--pendentes tbody tr {
+  cursor: pointer;
+  user-select: none;
+}
+
+.conc-subtabela--pendentes tbody tr .conc-historico {
+  user-select: text;
+}
+
+.conc-subtabela__check input {
+  cursor: pointer;
+  accent-color: var(--accent);
+}
+
+.conc-vinculo__acoes {
+  display: inline-flex;
+  gap: var(--space-2);
+  flex-shrink: 0;
+}
+
+.conc-vinculo__acoes button:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+/* ---------------- Razão desde a primeira pendência ---------------- */
+/* Linhas já vinculadas aparecem apagadas, sem seleção; passando o mouse,
+   o vínculo inteiro (as outras linhas dele) acende. */
+.pa-table .conc-subtabela--pendentes tbody tr.conc-linha--vinculada {
+  cursor: default;
+}
+
+/* Toggle "Ocultar conciliados" ao lado do título do razão. */
+.pa-table .conc-subtabela--pendentes.is-ocultando-conciliados tbody tr.conc-linha--vinculada {
+  display: none;
+}
+
+.pa-table .conc-subtabela--pendentes tbody tr.conc-linha--vinculada td {
+  color: var(--text-muted);
+}
+
+.pa-table .conc-subtabela--pendentes tbody tr.conc-linha--vinculada.is-grupo td {
+  background: rgba(47, 158, 110, 0.1);
+  color: var(--text-primary);
+}
+
+.conc-valor--saldo {
+  color: var(--text-secondary);
+}
+
+.conc-vinculado {
+  display: inline-flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+.conc-vinculado-tag {
+  font-size: 0.68rem;
+  font-weight: 700;
+  padding: 1px 7px;
+  border-radius: var(--radius-pill);
+  color: #2f9e6e;
+  background: rgba(47, 158, 110, 0.14);
+}
+
+.conc-vinculado__tipo {
+  font-size: 0.76rem;
+}
+
+.conc-link-btn {
+  font-size: 0.76rem;
+  font-weight: 600;
+  color: var(--accent);
+  background: none;
+  border: 0;
+  padding: 0;
+  cursor: pointer;
+}
+
+.conc-link-btn:hover {
+  text-decoration: underline;
+}
diff --git a/static/js/conciliacao-fornecedores.js b/static/js/conciliacao-fornecedores.js
new file mode 100644
index 0000000..2b85e21
--- /dev/null
+++ b/static/js/conciliacao-fornecedores.js
@@ -0,0 +1,1038 @@
+/**
+ * Controlador de "Conciliação de Fornecedores" (Utilitários), ver CLAUDE.md
+ * do pacote `portal_api/conciliacao_fornecedores/`. Guarda de página no
+ * mesmo padrão de `nao-conformidades.js`: retorna cedo se o elemento raiz da
+ * tela não existir e some atrás de `#conc-no-access` sem
+ * `permissoes_efetivas.utilitarios.apps["conciliacao-fornecedores"]`.
+ *
+ * Duas vistas na mesma página: histórico (+ formulário de nova conciliação)
+ * e detalhe de uma conciliação (cards de alerta + tabela de fornecedores
+ * expansível). O detalhe abre por `#conciliacao-<id>` na URL, para um
+ * recarregamento voltar à mesma conciliação.
+ */
+
+const PID_CONC_MOEDA = new Intl.NumberFormat("pt-BR", { style: "currency", currency: "BRL" });
+
+const PID_CONC_STATUS = {
+  divergente: { rotulo: "Divergente", pill: "status-pill--danger", rank: 0 },
+  atencao: { rotulo: "Atenção", pill: "status-pill--warning", rank: 1 },
+  pendente: { rotulo: "Pendente de pagamento", pill: "status-pill--neutral", rank: 2 },
+  conciliada: { rotulo: "Conciliada", pill: "status-pill--ok", rank: 3 },
+};
+
+const PID_CONC_ROTULO_ALERTA = {
+  credito_vencido: "Títulos em aberto há mais de 3 meses",
+  debito_excedente: "Pagamentos sem título em aberto",
+  pagamento_sem_titulo: "Pagamentos sem título de mesmo valor",
+  diferenca_vinculo: "Diferenças de juros/desconto",
+  conta_transitoria: "Conta transitória com saldo",
+  saldo_devedor: "Saldo devedor",
+  saldo_divergente_arquivo: "Saldo diferente do arquivo",
+};
+
+const PID_CONC_SEVERIDADE = { alta: "Alta", media: "Média", baixa: "Baixa" };
+
+function pidConcEscape(texto) {
+  if (texto == null) return "";
+  const div = document.createElement("div");
+  div.textContent = String(texto);
+  return div.innerHTML;
+}
+
+function pidConcMoeda(valor) {
+  return PID_CONC_MOEDA.format(Number(valor) || 0);
+}
+
+/** Saldo com o lado ("C" credor positivo, "D" devedor negativo), como o Questor imprime. */
+function pidConcSaldo(valor) {
+  const numero = Number(valor) || 0;
+  if (numero === 0) return pidConcMoeda(0);
+  return `${pidConcMoeda(Math.abs(numero))} ${numero > 0 ? "C" : "D"}`;
+}
+
+function pidConcData(iso) {
+  if (!iso) return "—";
+  const [ano, mes, dia] = iso.slice(0, 10).split("-");
+  return `${dia}/${mes}/${ano}`;
+}
+
+function pidConcDataHora(iso) {
+  if (!iso) return "—";
+  const data = new Date(iso);
+  if (Number.isNaN(data.getTime())) return "—";
+  return data.toLocaleString("pt-BR", { day: "2-digit", month: "2-digit", year: "numeric", hour: "2-digit", minute: "2-digit" });
+}
+
+function pidConcCompara(a, b) {
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  return String(a ?? "").localeCompare(String(b ?? ""), "pt-BR", { sensitivity: "base", numeric: true });
+}
+
+/** Valor em aberto de um item: sempre o real (só vínculo muda valor). */
+function pidConcValorAbertoHtml(situacao) {
+  if (!situacao || !Number(situacao.valor_em_aberto)) return "—";
+  return pidConcMoeda(situacao.valor_em_aberto);
+}
+
+/** Célula de situação: o fato primeiro; a dedução da ferramenta, se houver,
+ * numa linha à parte marcada como sugestão (nunca misturada ao fato). */
+function pidConcSituacaoHtml(situacao) {
+  if (!situacao) return '<td class="conc-situacao"></td>';
+  const sugestao = situacao.sugestao
+    ? `<span class="conc-sugestao"><span class="conc-sugestao-tag">Sugestão</span>${pidConcEscape(situacao.sugestao)}</span>`
+    : "";
+  return `<td class="conc-situacao conc-situacao--${situacao.categoria}">${pidConcEscape(situacao.descricao)}${sugestao}</td>`;
+}
+
+function pidConcTextoValidacao(conta) {
+  if (!conta.validada) return "";
+  if (conta.validada_automatica) return `Validada automaticamente (conta conciliada) em ${pidConcDataHora(conta.validada_em)}`;
+  return `Validada por ${conta.validada_por_nome || "—"} em ${pidConcDataHora(conta.validada_em)}`;
+}
+
+function pidConcStatusHtml(status) {
+  const info = PID_CONC_STATUS[status] || PID_CONC_STATUS.pendente;
+  return `<span class="status-pill ${info.pill}">${info.rotulo}</span>`;
+}
+
+document.addEventListener("DOMContentLoaded", async () => {
+  const contentEl = document.getElementById("conc-content");
+  if (!contentEl) return;
+
+  const me = await pidGetMe();
+  if (!me) return;
+
+  const utilitarios = (me.permissoes_efetivas && me.permissoes_efetivas["utilitarios"]) || {};
+  const podeUsar = !!(utilitarios.apps && utilitarios.apps["conciliacao-fornecedores"]);
+  document.getElementById("conc-no-access").hidden = podeUsar;
+  contentEl.hidden = !podeUsar;
+  if (!podeUsar) return;
+
+  const listView = document.getElementById("conc-list-view");
+  const detailView = document.getElementById("conc-detail-view");
+
+  // ======================================================================
+  // Histórico + nova conciliação
+  // ======================================================================
+  const formEl = document.getElementById("conc-form");
+  const novaBtn = document.getElementById("conc-nova-btn");
+  const codigoInput = document.getElementById("conc-form-codigo");
+  const empresaEl = document.getElementById("conc-form-empresa");
+  const arquivoInput = document.getElementById("conc-form-arquivo");
+  const arquivoNomeEl = document.getElementById("conc-form-arquivo-nome");
+  const formErroEl = document.getElementById("conc-form-erro");
+  const processarBtn = document.getElementById("conc-form-processar-btn");
+  const listaBody = document.getElementById("conc-lista-body");
+  const listaVazia = document.getElementById("conc-lista-vazia");
+  const listaBusca = document.getElementById("conc-lista-busca");
+
+  let historico = [];
+  let nomeEmpresaResolvido = null; // null = não consultado/não encontrado
+  let timerNomeEmpresa = null;
+  let consultaNomeAtual = 0;
+
+  function limparFormulario() {
+    codigoInput.value = "";
+    empresaEl.textContent = "";
+    empresaEl.className = "conc-form__empresa";
+    arquivoInput.value = "";
+    arquivoNomeEl.textContent = "Nenhum arquivo selecionado";
+    formErroEl.textContent = "";
+    nomeEmpresaResolvido = null;
+  }
+
+  novaBtn.addEventListener("click", () => {
+    const abrir = formEl.hidden;
+    formEl.hidden = !abrir;
+    if (abrir) {
+      limparFormulario();
+      codigoInput.focus();
+    }
+  });
+  document.getElementById("conc-form-cancelar-btn").addEventListener("click", () => {
+    formEl.hidden = true;
+  });
+
+  arquivoInput.addEventListener("change", () => {
+    const arquivo = arquivoInput.files[0];
+    arquivoNomeEl.textContent = arquivo ? arquivo.name : "Nenhum arquivo selecionado";
+    // O nome do arquivo costuma começar pelo código da empresa ("2017 - ..."):
+    // sugere, sem sobrescrever o que já foi digitado.
+    const prefixo = arquivo && arquivo.name.match(/^(\d+)\s*[-_ ]/);
+    if (prefixo && !codigoInput.value.trim()) {
+      codigoInput.value = prefixo[1];
+      buscarNomeEmpresa();
+    }
+  });
+
+  async function buscarNomeEmpresa() {
+    const codigo = codigoInput.value.trim();
+    nomeEmpresaResolvido = null;
+    if (!codigo) {
+      empresaEl.textContent = "";
+      empresaEl.className = "conc-form__empresa";
+      return;
+    }
+    if (!/^\d+$/.test(codigo)) {
+      empresaEl.textContent = "Informe apenas números.";
+      empresaEl.className = "conc-form__empresa is-erro";
+      return;
+    }
+    const consulta = ++consultaNomeAtual;
+    empresaEl.textContent = "Buscando no Questor...";
+    empresaEl.className = "conc-form__empresa is-carregando";
+    try {
+      const dados = await pidApiRequest(`/conciliacoes-fornecedores/nome-empresa/?codigo_empresa=${encodeURIComponent(codigo)}`);
+      if (consulta !== consultaNomeAtual) return;
+      nomeEmpresaResolvido = dados.nome_empresa;
+      empresaEl.textContent = dados.nome_empresa || "Empresa não encontrada no Questor.";
+      empresaEl.className = `conc-form__empresa${dados.nome_empresa ? "" : " is-erro"}`;
+    } catch (erro) {
+      if (consulta !== consultaNomeAtual) return;
+      empresaEl.textContent = erro.message;
+      empresaEl.className = "conc-form__empresa is-erro";
+    }
+  }
+
+  codigoInput.addEventListener("input", () => {
+    clearTimeout(timerNomeEmpresa);
+    timerNomeEmpresa = setTimeout(buscarNomeEmpresa, 450);
+  });
+
+  processarBtn.addEventListener("click", async () => {
+    formErroEl.textContent = "";
+    const codigo = codigoInput.value.trim();
+    const arquivo = arquivoInput.files[0];
+    if (!codigo) {
+      formErroEl.textContent = "Informe o código da empresa.";
+      return;
+    }
+    if (!arquivo) {
+      formErroEl.textContent = "Selecione o arquivo do razão.";
+      return;
+    }
+    clearTimeout(timerNomeEmpresa);
+    if (nomeEmpresaResolvido === null) await buscarNomeEmpresa();
+    if (!nomeEmpresaResolvido) {
+      const seguir = await pidConfirm(
+        `A empresa ${codigo} não foi encontrada no Questor (ou o Questor está inacessível agora). Processar assim mesmo?`,
+        { titulo: "Empresa não encontrada", textoConfirmar: "Processar" }
+      );
+      if (!seguir) return;
+    }
+
+    const dados = new FormData();
+    dados.append("codigo_empresa", codigo);
+    dados.append("arquivo", arquivo);
+
+    processarBtn.disabled = true;
+    processarBtn.textContent = "Processando...";
+    try {
+      const criada = await pidApiRequest("/conciliacoes-fornecedores/", { method: "POST", body: dados });
+      formEl.hidden = true;
+      await carregarHistorico();
+      abrirDetalhe(criada.id);
+    } catch (erro) {
+      formErroEl.textContent = erro.message;
+    } finally {
+      processarBtn.disabled = false;
+      processarBtn.textContent = "Processar";
+    }
+  });
+
+  function renderHistorico() {
+    const termo = listaBusca.value.trim().toLowerCase();
+    const itens = historico.filter(
+      (item) => !termo || `${item.codigo_empresa} ${item.nome_empresa}`.toLowerCase().includes(termo)
+    );
+    listaBody.innerHTML = "";
+    listaVazia.hidden = itens.length > 0;
+    listaVazia.textContent = historico.length ? "Nenhuma conciliação para esta busca." : "Nenhuma conciliação realizada ainda.";
+    itens.forEach((item) => {
+      const resumo = item.resumo || {};
+      const porStatus = resumo.por_status || {};
+      const conciliados = porStatus.conciliada || 0;
+      const periodo = item.periodo_inicio ? `${pidConcData(item.periodo_inicio)} a ${pidConcData(item.periodo_fim)}` : "—";
+      const tr = document.createElement("tr");
+      tr.className = "conc-row";
+      tr.innerHTML = `
+        <td><span class="pa-name-link">${pidConcEscape(item.codigo_empresa)} - ${pidConcEscape(item.nome_empresa || "Empresa não encontrada no Questor")}</span></td>
+        <td>${pidConcData(item.data_base)}</td>
+        <td>${periodo}</td>
+        <td class="conc-num">${resumo.total_contas ?? "—"}</td>
+        <td class="conc-num">${conciliados}</td>
+        <td class="conc-num">${porStatus.divergente ? `<span class="conc-valor--devedor">${porStatus.divergente}</span>` : 0}</td>
+        <td class="conc-num conc-valor">${pidConcMoeda(resumo.total_em_aberto)}</td>
+        <td>${pidConcEscape(item.criado_por_nome || "—")}<span class="conc-fornecedor__alerta">${pidConcDataHora(item.criado_em)}</span></td>
+        <td class="conc-num"><button type="button" class="btn-danger-outline conc-btn-sm" data-excluir>Excluir</button></td>`;
+      tr.addEventListener("click", (evento) => {
+        if (evento.target.closest("[data-excluir]")) return;
+        abrirDetalhe(item.id);
+      });
+      tr.querySelector("[data-excluir]").addEventListener("click", async () => {
+        const confirmado = await pidConfirm(
+          `Excluir a conciliação de ${item.codigo_empresa} - ${item.nome_empresa || ""} (data-base ${pidConcData(item.data_base)})? Os vínculos manuais e validações feitos nela também serão excluídos.`,
+          { titulo: "Excluir conciliação", textoConfirmar: "Excluir", perigoso: true }
+        );
+        if (!confirmado) return;
+        try {
+          await pidApiRequest(`/conciliacoes-fornecedores/${item.id}/`, { method: "DELETE" });
+          await carregarHistorico();
+        } catch (erro) {
+          pidAlert(erro.message, { titulo: "Não foi possível excluir" });
+        }
+      });
+      listaBody.appendChild(tr);
+    });
+  }
+
+  listaBusca.addEventListener("input", renderHistorico);
+
+  async function carregarHistorico() {
+    try {
+      historico = await pidApiRequest("/conciliacoes-fornecedores/");
+    } catch (erro) {
+      historico = [];
+      listaVazia.hidden = false;
+      listaVazia.textContent = erro.message;
+      return;
+    }
+    renderHistorico();
+  }
+
+  // ======================================================================
+  // Detalhe
+  // ======================================================================
+  const cardsEl = document.getElementById("conc-cards");
+  const contasBody = document.getElementById("conc-contas-body");
+  const contasVazia = document.getElementById("conc-contas-vazia");
+  const contasBusca = document.getElementById("conc-contas-busca");
+  const filtroStatusBtns = Array.from(document.querySelectorAll("[data-conc-status]"));
+  const filtroAlertaEl = document.getElementById("conc-filtro-alerta");
+  const sortHeaders = Array.from(document.querySelectorAll("#conc-contas-table th[data-sort]"));
+  const mostrarValidadasInput = document.getElementById("conc-mostrar-validadas");
+  const mostrarValidadasQtd = document.getElementById("conc-mostrar-validadas-qtd");
+
+  let detalhe = null;
+  let filtroStatus = "";
+  let filtroAlerta = "";
+  // Padrão: por situação, divergentes primeiro (pedido do usuário).
+  const SORT_PADRAO = "status";
+  let sortKey = SORT_PADRAO;
+  let sortDir = 1;
+  const abertas = new Set();
+  // estado de cada conta expandida: lançamentos selecionados e se mostra os já vinculados
+  const estadoConta = new Map();
+
+  function estadoDe(contaId) {
+    if (!estadoConta.has(contaId)) estadoConta.set(contaId, { selecionados: new Set(), mostrarVinculados: false, ocultarConciliados: false });
+    return estadoConta.get(contaId);
+  }
+
+  document.getElementById("conc-voltar-btn").addEventListener("click", () => {
+    history.replaceState(null, "", window.location.pathname);
+    mostrarLista();
+  });
+
+  function mostrarLista() {
+    detalhe = null;
+    detailView.hidden = true;
+    listView.hidden = false;
+    carregarHistorico();
+  }
+
+  async function abrirDetalhe(id) {
+    listView.hidden = true;
+    detailView.hidden = false;
+    cardsEl.innerHTML = "";
+    contasBody.innerHTML = '<tr><td colspan="8" class="conc-empty">Carregando...</td></tr>';
+    history.replaceState(null, "", `#conciliacao-${id}`);
+    abertas.clear();
+    estadoConta.clear();
+    filtroStatus = "";
+    filtroAlerta = "";
+    contasBusca.value = "";
+    mostrarValidadasInput.checked = false;
+    sortKey = SORT_PADRAO;
+    sortDir = 1;
+    atualizarSortHeaders();
+    try {
+      detalhe = await pidApiRequest(`/conciliacoes-fornecedores/${id}/`);
+    } catch (erro) {
+      contasBody.innerHTML = `<tr><td colspan="8" class="conc-empty">${pidConcEscape(erro.message)}</td></tr>`;
+      return;
+    }
+    renderCabecalho();
+    renderCards();
+    renderContas();
+  }
+
+  function renderCabecalho() {
+    document.getElementById("conc-det-codigo").textContent = `EMPRESA ${detalhe.codigo_empresa}`;
+    document.getElementById("conc-det-nome").textContent = detalhe.nome_empresa || "Empresa não encontrada no Questor";
+    const periodo = detalhe.periodo_inicio ? `${pidConcData(detalhe.periodo_inicio)} a ${pidConcData(detalhe.periodo_fim)}` : "sem lançamentos";
+    document.getElementById("conc-det-meta").innerHTML = `
+      <span>Data-base <strong>${pidConcData(detalhe.data_base)}</strong></span>
+      <span>Período do razão <strong>${periodo}</strong></span>
+      <span>Arquivo <strong>${pidConcEscape(detalhe.nome_arquivo || "—")}</strong></span>
+      <span>Processado por <strong>${pidConcEscape(detalhe.criado_por_nome || "—")}</strong> em ${pidConcDataHora(detalhe.criado_em)}</span>`;
+    document.getElementById("conc-exportar-btn").href = `${PID_API_BASE}/conciliacoes-fornecedores/${detalhe.id}/exportar-xlsx/`;
+  }
+
+  function contasComAlerta(tipo) {
+    return detalhe.contas.filter((c) => c.alertas.some((a) => a.tipo === tipo));
+  }
+
+  /** Faixa de indicadores (3 valores + progresso da validação) e etiquetas
+   * dos apontamentos menores. Os números por situação ficam só nos chips,
+   * que já filtram (não duplicar em card). */
+  function renderCards() {
+    const contas = detalhe.contas;
+    const porStatus = {};
+    contas.forEach((c) => {
+      porStatus[c.status] = (porStatus[c.status] || 0) + 1;
+    });
+    const soma = (lista, campo) => lista.reduce((total, c) => total + (Number(c[campo]) || 0), 0);
+    const vencidas = contasComAlerta("credito_vencido");
+    const excedentes = contas.filter((c) => Number(c.total_excedente) > 0);
+    const validados = contas.filter((c) => c.validada).length;
+    const pct = contas.length ? Math.round((validados / contas.length) * 100) : 0;
+
+    const kpi = (rotulo, valor, detalheTxt, classe, alerta) => {
+      const tag = alerta ? "button" : "div";
+      const ativo = alerta && filtroAlerta === alerta ? " is-active" : "";
+      const atributos = alerta ? ` type="button" data-conc-alerta="${alerta}"` : "";
+      return `<${tag} class="conc-kpi ${classe}${ativo}"${atributos}>
+        <span class="conc-kpi__rotulo">${rotulo}</span>
+        <span class="conc-kpi__valor">${valor}</span>
+        <span class="conc-kpi__detalhe">${detalheTxt}</span>
+      </${tag}>`;
+    };
+
+    const apontamentos = [
+      ["diferenca_vinculo", "com diferença de juros/desconto", "info"],
+      ["pagamento_sem_titulo", "com pagamento não vinculado", "warning"],
+      ["conta_transitoria", "conta transitória com saldo", "danger"],
+    ]
+      .map(([tipo, texto, classe]) => [tipo, contasComAlerta(tipo).length, texto, classe])
+      .filter(([, quantidade]) => quantidade > 0)
+      .map(
+        ([tipo, quantidade, texto, classe]) =>
+          `<button type="button" class="conc-tag conc-tag--${classe}${filtroAlerta === tipo ? " is-active" : ""}" data-conc-alerta="${tipo}"><strong>${quantidade}</strong> ${texto}</button>`
+      )
+      .join("");
+
+    cardsEl.innerHTML = `
+      <div class="conc-kpis">
+        ${kpi(
+          "Títulos em aberto",
+          pidConcMoeda(soma(contas, "total_em_aberto")),
+          soma(contas, "total_nao_vinculado")
+            ? `sem pagamento vinculado · ${pidConcMoeda(soma(contas, "total_nao_vinculado"))} em pagamentos a vincular`
+            : "sem pagamento vinculado",
+          "",
+          ""
+        )}
+        ${kpi("Em aberto há mais de 3 meses", pidConcMoeda(soma(vencidas, "total_vencido")), `${vencidas.length} fornecedor(es)`, "conc-kpi--warning", "credito_vencido")}
+        ${kpi("Pagamentos sem título", pidConcMoeda(soma(excedentes, "total_excedente")), `${excedentes.length} fornecedor(es) · divergência`, "conc-kpi--danger", "debito_excedente")}
+        <div class="conc-progresso">
+          <div class="conc-progresso__topo"><span class="conc-kpi__rotulo">Validação</span><span><strong>${validados}</strong> de ${contas.length} fornecedores</span></div>
+          <div class="conc-progresso__barra"><span style="width:${pct}%"></span></div>
+          <span class="conc-kpi__detalhe">${contas.length - validados} ainda para revisar · ${pct}% concluído</span>
+        </div>
+      </div>
+      ${apontamentos ? `<div class="conc-tags"><span class="conc-tags__rotulo">Apontamentos:</span>${apontamentos}</div>` : ""}`;
+
+    cardsEl.querySelectorAll("[data-conc-alerta]").forEach((el) => {
+      el.addEventListener("click", () => {
+        const alerta = el.dataset.concAlerta;
+        filtroAlerta = filtroAlerta === alerta ? "" : alerta;
+        filtroStatus = "";
+        renderCards();
+        renderContas();
+      });
+    });
+
+    filtroStatusBtns.forEach((btn) => {
+      const status = btn.dataset.concStatus;
+      const quantidade = status === "validada" ? validados : status ? porStatus[status] || 0 : contas.length;
+      btn.innerHTML = `${btn.textContent.replace(/\s*\d+$/, "")} <span class="conc-chip__count">${quantidade}</span>`;
+      btn.classList.toggle("is-active", !filtroAlerta && filtroStatus === status);
+    });
+    mostrarValidadasQtd.textContent = validados;
+  }
+
+  filtroStatusBtns.forEach((btn) => {
+    btn.addEventListener("click", () => {
+      filtroStatus = btn.dataset.concStatus;
+      filtroAlerta = "";
+      renderCards();
+      renderContas();
+    });
+  });
+  contasBusca.addEventListener("input", renderContas);
+  mostrarValidadasInput.addEventListener("change", renderContas);
+
+  const sortValor = {
+    conta_numero: (c) => Number(c.conta_numero),
+    fornecedor: (c) => c.fornecedor,
+    saldo_inicial: (c) => Number(c.saldo_inicial),
+    saldo_final: (c) => Number(c.saldo_final),
+    total_vencido: (c) => Number(c.total_vencido),
+    status: (c) => PID_CONC_STATUS[c.status].rank,
+    validada: (c) => (c.validada ? 1 : 0),
+  };
+  sortHeaders.forEach((th) => {
+    th.addEventListener("click", () => {
+      const chave = th.dataset.sort;
+      sortDir = sortKey === chave ? sortDir * -1 : 1;
+      sortKey = chave;
+      atualizarSortHeaders();
+      renderContas();
+    });
+  });
+
+  function atualizarSortHeaders() {
+    sortHeaders.forEach((h) => {
+      h.classList.toggle("is-sort-asc", h.dataset.sort === sortKey && sortDir === 1);
+      h.classList.toggle("is-sort-desc", h.dataset.sort === sortKey && sortDir === -1);
+    });
+  }
+
+  function contasFiltradas() {
+    const termo = contasBusca.value.trim().toLowerCase();
+    let lista = detalhe.contas.filter((c) => {
+      // Validadas ficam fora por padrão (pedido do usuário): a lista mostra
+      // o que ainda falta revisar. O chip "Validados" as mostra sempre.
+      if (c.validada && !mostrarValidadasInput.checked && filtroStatus !== "validada") return false;
+      if (filtroAlerta) {
+        const temAlerta =
+          filtroAlerta === "debito_excedente" ? Number(c.total_excedente) > 0 : c.alertas.some((a) => a.tipo === filtroAlerta);
+        if (!temAlerta) return false;
+      } else if (filtroStatus === "validada") {
+        // validação é uma marcação à parte da situação calculada
+        if (!c.validada) return false;
+      } else if (filtroStatus && c.status !== filtroStatus) {
+        return false;
+      }
+      return !termo || `${c.conta_numero} ${c.fornecedor}`.toLowerCase().includes(termo);
+    });
+    if (sortKey) {
+      const extrator = sortValor[sortKey];
+      lista = lista.slice().sort((a, b) => pidConcCompara(extrator(a), extrator(b)) * sortDir);
+    }
+    return lista;
+  }
+
+  function renderContas() {
+    filtroAlertaEl.hidden = !filtroAlerta;
+    if (filtroAlerta) {
+      filtroAlertaEl.innerHTML = `Filtrando por: <strong>${PID_CONC_ROTULO_ALERTA[filtroAlerta]}</strong><button type="button">Limpar filtro</button>`;
+      filtroAlertaEl.querySelector("button").addEventListener("click", () => {
+        filtroAlerta = "";
+        renderCards();
+        renderContas();
+      });
+    }
+    const lista = contasFiltradas();
+    contasBody.innerHTML = "";
+    contasVazia.hidden = lista.length > 0;
+    contasVazia.textContent =
+      !mostrarValidadasInput.checked && !filtroAlerta && !filtroStatus && !contasBusca.value.trim()
+        ? "Todos os fornecedores estão validados. Marque \"Mostrar validadas\" para vê-los."
+        : "Nenhum fornecedor para este filtro.";
+    const fragmento = document.createDocumentFragment();
+    lista.forEach((conta) => montarLinhasConta(conta).forEach((tr) => fragmento.appendChild(tr)));
+    contasBody.appendChild(fragmento);
+  }
+
+  function resumoAlertas(conta) {
+    if (!conta.alertas.length) return conta.qtd_pendentes ? `${conta.qtd_pendentes} lançamento(s) pendente(s)` : "";
+    // só o primeiro alerta, cortado com reticências: o resto está na expansão
+    return conta.alertas[0].mensagem;
+  }
+
+  function montarLinhasConta(conta) {
+    const aberta = abertas.has(conta.id);
+    const tr = document.createElement("tr");
+    tr.className = `conc-row${aberta ? " is-aberta" : ""}`;
+    tr.dataset.contaId = conta.id;
+    const saldoFinal = Number(conta.saldo_final);
+    const vencido = Number(conta.total_vencido);
+    tr.innerHTML = `
+      <td><span class="conc-expand-btn"><svg class="conc-expand-chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg></span></td>
+      <td class="conc-conta-numero">${pidConcEscape(conta.conta_numero)}</td>
+      <td><span class="conc-fornecedor__nome">${pidConcEscape(conta.fornecedor)}</span><span class="conc-fornecedor__alerta">${pidConcEscape(resumoAlertas(conta))}</span></td>
+      <td class="conc-num conc-valor${Number(conta.saldo_inicial) === 0 ? " conc-valor--zero" : Number(conta.saldo_inicial) < 0 ? " conc-valor--devedor" : ""}">${pidConcSaldo(conta.saldo_inicial)}</td>
+      <td class="conc-num conc-valor${saldoFinal === 0 ? " conc-valor--zero" : saldoFinal < 0 ? " conc-valor--devedor" : ""}">${pidConcSaldo(conta.saldo_final)}</td>
+      <td class="conc-num conc-valor${vencido ? " conc-valor--vencido" : " conc-valor--zero"}">${vencido ? pidConcMoeda(vencido) : "—"}</td>
+      <td>${pidConcStatusHtml(conta.status)}</td>
+      <td class="conc-validado-col"><input type="checkbox" class="conc-validado-check" data-validado-check ${conta.validada ? "checked" : ""} aria-label="Confirmar que a conta foi validada" title="${pidConcEscape(pidConcTextoValidacao(conta) || "Marcar como validada")}" /></td>`;
+    const check = tr.querySelector("[data-validado-check]");
+    // o clique no checkbox não expande/recolhe a linha
+    check.addEventListener("click", (evento) => evento.stopPropagation());
+    check.addEventListener("change", async () => {
+      check.disabled = true;
+      try {
+        // sem `observacao` no corpo: o servidor mantém a já registrada
+        const resposta = await pidApiRequest(`/conciliacoes-fornecedores-contas/${conta.id}/validar/`, {
+          method: "POST",
+          body: { validada: check.checked },
+        });
+        aplicarRespostaConta(resposta);
+      } catch (erro) {
+        check.checked = !check.checked;
+        check.disabled = false;
+        pidAlert(erro.message, { titulo: "Não foi possível salvar" });
+      }
+    });
+    tr.addEventListener("click", () => {
+      if (abertas.has(conta.id)) abertas.delete(conta.id);
+      else abertas.add(conta.id);
+      substituirConta(conta);
+    });
+    if (!aberta) return [tr];
+
+    const trDetalhe = document.createElement("tr");
+    trDetalhe.className = "conc-detail-row";
+    trDetalhe.dataset.contaDetalheId = conta.id;
+    const td = document.createElement("td");
+    td.colSpan = 8;
+    td.className = "conc-detail-cell";
+    td.appendChild(montarDetalheConta(conta));
+    trDetalhe.appendChild(td);
+    return [tr, trDetalhe];
+  }
+
+  /** Re-renderiza só as linhas de uma conta (a principal e o detalhe), no lugar. */
+  function substituirConta(conta) {
+    const antiga = contasBody.querySelector(`tr[data-conta-id="${conta.id}"]`);
+    if (!antiga) return;
+    const detalheAntigo = contasBody.querySelector(`tr[data-conta-detalhe-id="${conta.id}"]`);
+    const novas = montarLinhasConta(conta);
+    antiga.replaceWith(...novas);
+    if (detalheAntigo) detalheAntigo.remove();
+  }
+
+  function aplicarRespostaConta(resposta) {
+    const indice = detalhe.contas.findIndex((c) => c.id === resposta.conta.id);
+    const eraValidada = indice >= 0 && detalhe.contas[indice].validada;
+    if (indice >= 0) detalhe.contas[indice] = resposta.conta;
+    // Conta que acabou de ser validada (checkbox, botão ou validação
+    // automática ao ficar conciliada) recolhe a expansão: o trabalho nela
+    // terminou (pedido do usuário).
+    if (!eraValidada && resposta.conta.validada) abertas.delete(resposta.conta.id);
+    detalhe.resumo = resposta.resumo;
+    const estado = estadoDe(resposta.conta.id);
+    estado.selecionados.clear();
+    renderCards();
+    substituirConta(resposta.conta);
+  }
+
+  function linhaLancamentoHtml(lanc, comCheckbox, selecionado) {
+    const situacao = lanc.situacao;
+    const valorAberto = pidConcValorAbertoHtml(situacao);
+    const historico = lanc.eh_saldo_anterior ? "<em>Saldo anterior</em>" : pidConcEscape(lanc.historico);
+    return `
+      <tr class="${selecionado ? "is-selecionado" : ""}" data-lanc-id="${lanc.id}">
+        ${comCheckbox ? `<td class="conc-subtabela__check"><input type="checkbox" data-lanc-check="${lanc.id}" ${selecionado ? "checked" : ""} aria-label="Selecionar lançamento" /></td>` : ""}
+        <td>${pidConcData(lanc.data)}</td>
+        <td>${pidConcEscape(lanc.sequencia || "—")}</td>
+        <td class="conc-historico">${historico}${lanc.contrapartida ? `<span class="conc-historico__contrapartida">${pidConcEscape(lanc.contrapartida)}</span>` : ""}</td>
+        <td><span class="conc-natureza conc-natureza--${lanc.natureza}">${lanc.natureza === "C" ? "Crédito" : "Débito"}</span></td>
+        <td class="conc-num conc-valor">${pidConcMoeda(lanc.valor)}</td>
+        ${comCheckbox ? `<td class="conc-num conc-valor">${valorAberto}</td>${pidConcSituacaoHtml(situacao)}` : ""}
+      </tr>`;
+  }
+
+  function montarDetalheConta(conta) {
+    const estado = estadoDe(conta.id);
+    const painel = document.createElement("div");
+    painel.className = "conc-detail";
+
+    if (conta.alertas.length) {
+      const lista = document.createElement("ul");
+      lista.className = "conc-alertas";
+      lista.innerHTML = conta.alertas
+        .map(
+          (a) =>
+            `<li class="conc-alerta conc-alerta--${a.severidade}"><span class="conc-alerta__severidade">${PID_CONC_SEVERIDADE[a.severidade]}</span><span>${pidConcEscape(a.mensagem)}</span></li>`
+        )
+        .join("");
+      painel.appendChild(lista);
+    }
+
+    // ---- Razão desde a primeira pendência ----
+    // Pedido do usuário: mostrar o razão inteiro a partir do lançamento
+    // pendente mais antigo (inclusive o que já foi vinculado nesse período),
+    // para enxergar vínculos automáticos errados e desfazê-los ali mesmo.
+    // "Pendente" inclui os itens de um pagamento parcial, cujo título segue
+    // em aberto.
+    const pendentes = conta.lancamentos.filter((l) => l.vinculo_id === null);
+    const numeroVinculo = new Map(conta.vinculos.map((v, i) => [v.id, i + 1]));
+    const vinculoPorId = new Map(conta.vinculos.map((v) => [v.id, v]));
+    const idsParciais = new Set(conta.vinculos.filter((v) => v.tipo === "parcial").map((v) => v.id));
+    const datasPendencia = conta.lancamentos
+      .filter((l) => l.vinculo_id === null || idsParciais.has(l.vinculo_id))
+      .map((l) => l.data);
+    const inicioPendencia = datasPendencia.length ? datasPendencia.reduce((a, b) => (a < b ? a : b)) : null;
+    const razao = inicioPendencia ? conta.lancamentos.filter((l) => l.data >= inicioPendencia) : [];
+    const qtdVinculadosRazao = razao.filter((l) => l.vinculo_id !== null).length;
+    const secaoPend = document.createElement("div");
+    secaoPend.innerHTML = `
+      <div class="conc-detail__secao-titulo conc-selecao-barra">
+        <div class="conc-detail__titulo-grupo">
+          <h4>Razão desde ${inicioPendencia ? pidConcData(inicioPendencia) : "—"} · ${pendentes.length} não conciliado(s)</h4>
+          ${qtdVinculadosRazao ? `<label class="conc-toggle"><input type="checkbox" data-ocultar-conciliados ${estado.ocultarConciliados ? "checked" : ""} /> Ocultar conciliados <span class="conc-chip__count">${qtdVinculadosRazao}</span></label>` : ""}
+        </div>
+        <div class="conc-detail__acoes">
+          <span class="conc-selecao-resumo" data-selecao-resumo></span>
+          <button type="button" class="btn-solid conc-btn-sm" data-vincular disabled>Vincular selecionados</button>
+        </div>
+      </div>`;
+    if (razao.length) {
+      const tabela = document.createElement("table");
+      tabela.className = "conc-subtabela conc-subtabela--pendentes";
+      tabela.classList.toggle("is-ocultando-conciliados", Boolean(estado.ocultarConciliados));
+      tabela.innerHTML = `
+        <thead><tr><th class="conc-subtabela__check"><input type="checkbox" data-lanc-todos aria-label="Marcar ou desmarcar todos os não conciliados" title="Marcar todos" /></th><th>Data</th><th>Seq.</th><th>Histórico</th><th>Natureza</th><th class="conc-num">Valor</th><th class="conc-num">Saldo</th><th class="conc-num">Em aberto</th><th>Situação</th></tr></thead>
+        <tbody>${razao.map((l) => linhaRazaoHtml(l)).join("")}</tbody>`;
+      secaoPend.appendChild(tabela);
+    } else {
+      secaoPend.insertAdjacentHTML("beforeend", '<p class="conc-sem-pendencias">Todos os lançamentos desta conta estão vinculados.</p>');
+    }
+    painel.appendChild(secaoPend);
+
+    function linhaRazaoHtml(lanc) {
+      const historico = lanc.eh_saldo_anterior ? "<em>Saldo anterior</em>" : pidConcEscape(lanc.historico);
+      const contrapartida = lanc.contrapartida ? `<span class="conc-historico__contrapartida">${pidConcEscape(lanc.contrapartida)}</span>` : "";
+      const comum = `
+        <td>${pidConcData(lanc.data)}</td>
+        <td>${pidConcEscape(lanc.sequencia || "—")}</td>
+        <td class="conc-historico">${historico}${contrapartida}</td>
+        <td><span class="conc-natureza conc-natureza--${lanc.natureza}">${lanc.natureza === "C" ? "Crédito" : "Débito"}</span></td>
+        <td class="conc-num conc-valor">${pidConcMoeda(lanc.valor)}</td>
+        <td class="conc-num conc-valor conc-valor--saldo">${lanc.saldo_apos === null ? "—" : pidConcSaldo(lanc.saldo_apos)}</td>`;
+      if (lanc.vinculo_id === null) {
+        const selecionado = estado.selecionados.has(lanc.id);
+        return `
+          <tr class="${selecionado ? "is-selecionado" : ""}" data-lanc-id="${lanc.id}">
+            <td class="conc-subtabela__check"><input type="checkbox" data-lanc-check="${lanc.id}" ${selecionado ? "checked" : ""} aria-label="Selecionar lançamento" /></td>
+            ${comum}
+            <td class="conc-num conc-valor">${pidConcValorAbertoHtml(lanc.situacao)}</td>
+            ${pidConcSituacaoHtml(lanc.situacao)}
+          </tr>`;
+      }
+      const vinculo = vinculoPorId.get(lanc.vinculo_id);
+      const origem = vinculo && (vinculo.tipo === "manual" || vinculo.tipo === "parcial") ? "manual" : "automático";
+      return `
+        <tr class="conc-linha--vinculada" data-lanc-id="${lanc.id}" data-vinculo-id="${lanc.vinculo_id}">
+          <td class="conc-subtabela__check"></td>
+          ${comum}
+          <td class="conc-num conc-valor">—</td>
+          <td class="conc-situacao">
+            <span class="conc-vinculado">
+              <span class="conc-vinculado-tag">Vinculado #${numeroVinculo.get(lanc.vinculo_id) || "?"}</span>
+              <span class="conc-vinculado__tipo">${pidConcEscape(vinculo ? vinculo.tipo_rotulo : "")} · ${origem}</span>
+              <button type="button" class="conc-link-btn" data-desfazer-vinculo="${lanc.vinculo_id}">Desfazer</button>
+            </span>
+          </td>
+        </tr>`;
+    }
+
+    async function desfazerVinculo(vinculoId) {
+      const itens = conta.lancamentos.filter((l) => l.vinculo_id === vinculoId);
+      const lista = itens
+        .map((l) => `${pidConcData(l.data)} ${l.natureza === "C" ? "crédito" : "débito"} ${pidConcMoeda(l.valor)}`)
+        .join("; ");
+      const confirmado = await pidConfirm(
+        `Desfazer o vínculo #${numeroVinculo.get(vinculoId) || ""} (${lista})? Os lançamentos voltam para não conciliados.`,
+        { titulo: "Desfazer vínculo", textoConfirmar: "Desfazer" }
+      );
+      if (!confirmado) return;
+      try {
+        const resposta = await pidApiRequest(`/conciliacoes-fornecedores-vinculos/${vinculoId}/`, { method: "DELETE" });
+        aplicarRespostaConta(resposta);
+      } catch (erro) {
+        pidAlert(erro.message, { titulo: "Não foi possível desfazer" });
+      }
+    }
+
+    // Linhas vinculadas: destacar os outros itens do mesmo vínculo ao passar
+    // o mouse, e "Desfazer" direto na linha.
+    secaoPend.querySelectorAll("tr[data-vinculo-id]").forEach((tr) => {
+      const grupo = () => secaoPend.querySelectorAll(`tr[data-vinculo-id="${tr.dataset.vinculoId}"]`);
+      tr.addEventListener("mouseenter", () => grupo().forEach((g) => g.classList.add("is-grupo")));
+      tr.addEventListener("mouseleave", () => grupo().forEach((g) => g.classList.remove("is-grupo")));
+    });
+    // "Ocultar conciliados": desmarcado por padrão (pedido do usuário); a
+    // escolha fica no estado da conta e sobrevive ao re-render após um vínculo.
+    const ocultarCheck = secaoPend.querySelector("[data-ocultar-conciliados]");
+    if (ocultarCheck) {
+      ocultarCheck.addEventListener("click", (evento) => evento.stopPropagation());
+      ocultarCheck.addEventListener("change", () => {
+        estado.ocultarConciliados = ocultarCheck.checked;
+        const tabelaRazao = secaoPend.querySelector(".conc-subtabela--pendentes");
+        if (tabelaRazao) tabelaRazao.classList.toggle("is-ocultando-conciliados", ocultarCheck.checked);
+      });
+    }
+
+    secaoPend.querySelectorAll("[data-desfazer-vinculo]").forEach((btn) => {
+      btn.addEventListener("click", (evento) => {
+        evento.stopPropagation();
+        desfazerVinculo(Number(btn.dataset.desfazerVinculo));
+      });
+    });
+
+    const resumoSelecaoEl = secaoPend.querySelector("[data-selecao-resumo]");
+    const todosCheck = secaoPend.querySelector("[data-lanc-todos]");
+    const vincularBtn = secaoPend.querySelector("[data-vincular]");
+    const porId = new Map(conta.lancamentos.map((l) => [l.id, l]));
+
+    function atualizarSelecao() {
+      const selecionados = Array.from(estado.selecionados).map((id) => porId.get(id)).filter(Boolean);
+      const creditos = selecionados.filter((l) => l.natureza === "C").reduce((t, l) => t + Number(l.valor), 0);
+      const debitos = selecionados.filter((l) => l.natureza === "D").reduce((t, l) => t + Number(l.valor), 0);
+      const temAmbos = selecionados.some((l) => l.natureza === "C") && selecionados.some((l) => l.natureza === "D");
+      vincularBtn.disabled = !temAmbos;
+      painel.querySelectorAll("[data-adicionar]").forEach((btn) => {
+        btn.disabled = selecionados.length === 0;
+      });
+      if (todosCheck) {
+        todosCheck.checked = selecionados.length > 0 && selecionados.length === pendentes.length;
+        todosCheck.indeterminate = selecionados.length > 0 && selecionados.length < pendentes.length;
+        todosCheck.title = selecionados.length ? "Desmarcar todos" : "Marcar todos";
+      }
+      resumoSelecaoEl.innerHTML = selecionados.length
+        ? `Créditos <strong>${pidConcMoeda(creditos)}</strong> · Débitos <strong>${pidConcMoeda(debitos)}</strong> · Diferença <strong>${pidConcMoeda(creditos - debitos)}</strong>`
+        : "Selecione débitos e créditos para vincular manualmente.";
+      return { selecionados, diferenca: Math.round((creditos - debitos) * 100) / 100 };
+    }
+    atualizarSelecao();
+
+    // Cabeçalho: sem nada marcado, marca todos; com algum marcado (parcial ou
+    // todos), desmarca todos.
+    if (todosCheck) {
+      todosCheck.addEventListener("change", () => {
+        const marcar = estado.selecionados.size === 0;
+        secaoPend.querySelectorAll("[data-lanc-check]").forEach((check) => {
+          check.checked = marcar;
+          check.closest("tr").classList.toggle("is-selecionado", marcar);
+          const id = Number(check.dataset.lancCheck);
+          if (marcar) estado.selecionados.add(id);
+          else estado.selecionados.delete(id);
+        });
+        atualizarSelecao();
+      });
+    }
+
+    // A linha inteira marca/desmarca (pedido do usuário); o checkbox fica
+    // como indicador. Clique no próprio checkbox segue o comportamento
+    // nativo, e arrastar para selecionar texto não conta como clique.
+    secaoPend.querySelectorAll(".conc-subtabela--pendentes tbody tr[data-lanc-id]:not([data-vinculo-id])").forEach((tr) => {
+      tr.addEventListener("click", (evento) => {
+        if (evento.target.closest("[data-lanc-check]")) return;
+        if (String(window.getSelection ? window.getSelection() : "").trim()) return;
+        const check = tr.querySelector("[data-lanc-check]");
+        check.checked = !check.checked;
+        check.dispatchEvent(new Event("change"));
+      });
+    });
+
+    secaoPend.querySelectorAll("[data-lanc-check]").forEach((check) => {
+      check.addEventListener("change", () => {
+        const id = Number(check.dataset.lancCheck);
+        if (check.checked) estado.selecionados.add(id);
+        else estado.selecionados.delete(id);
+        check.closest("tr").classList.toggle("is-selecionado", check.checked);
+        atualizarSelecao();
+      });
+    });
+
+    vincularBtn.addEventListener("click", async () => {
+      const { selecionados, diferenca } = atualizarSelecao();
+      // Mesmo critério do servidor (vincular/): créditos maiores que os
+      // débitos além da tolerância = pagamento parcial, o título continua em
+      // aberto pelo saldo.
+      const totalCreditos = selecionados.filter((l) => l.natureza === "C").reduce((t, l) => t + Number(l.valor), 0);
+      const limite = Math.max(Number(detalhe.tolerancia_valor), (totalCreditos * Number(detalhe.tolerancia_percentual)) / 100);
+      if (diferenca > limite) {
+        const seguir = await pidConfirm(
+          `Os débitos selecionados pagam ${pidConcMoeda(totalCreditos - diferenca)} de ${pidConcMoeda(totalCreditos)}. Vincular como pagamento parcial? O título continua em aberto com ${pidConcMoeda(diferenca)}.`,
+          { titulo: "Pagamento parcial", textoConfirmar: "Vincular" }
+        );
+        if (!seguir) return;
+      } else if (diferenca !== 0) {
+        const natureza = diferenca < 0 ? "pago a maior (possível juros/multa)" : "pago a menor (possível desconto)";
+        const seguir = await pidConfirm(
+          `Os lançamentos selecionados têm diferença de ${pidConcMoeda(Math.abs(diferenca))} (${natureza}). Vincular mesmo assim? O vínculo fica sinalizado nos alertas da conta.`,
+          { titulo: "Vínculo com diferença", textoConfirmar: "Vincular" }
+        );
+        if (!seguir) return;
+      }
+      vincularBtn.disabled = true;
+      try {
+        const resposta = await pidApiRequest(`/conciliacoes-fornecedores-contas/${conta.id}/vincular/`, {
+          method: "POST",
+          body: { lancamentos: selecionados.map((l) => l.id) },
+        });
+        aplicarRespostaConta(resposta);
+      } catch (erro) {
+        vincularBtn.disabled = false;
+        pidAlert(erro.message, { titulo: "Não foi possível vincular" });
+      }
+    });
+
+    // ---- Vinculados ----
+    function montarBlocoVinculo(vinculo) {
+      const itens = conta.lancamentos.filter((l) => l.vinculo_id === vinculo.id);
+      const manual = vinculo.tipo === "manual" || vinculo.tipo === "parcial";
+      const origem = manual ? `manual, por ${pidConcEscape(vinculo.criado_por_nome || "—")}` : "automático";
+      const diferenca = Number(vinculo.diferenca);
+      let detalheDiferenca = "";
+      if (vinculo.tipo === "parcial") {
+        const saldo = vinculo.situacao;
+        detalheDiferenca = ` · restam <strong>${saldo ? pidConcValorAbertoHtml(saldo) : pidConcMoeda(diferenca)}</strong> em aberto${saldo ? ` · ${pidConcEscape(saldo.descricao)}` : ""}`;
+      } else if (diferenca) {
+        detalheDiferenca = ` · diferença ${pidConcMoeda(Math.abs(diferenca))} ${diferenca < 0 ? "(pago a maior)" : "(pago a menor)"}`;
+      }
+      const bloco = document.createElement("div");
+      bloco.className = `conc-vinculo${vinculo.tipo === "parcial" ? " conc-vinculo--parcial" : ""}`;
+      bloco.innerHTML = `
+        <div class="conc-vinculo__header">
+          <span><strong>#${numeroVinculo.get(vinculo.id)} ${pidConcEscape(vinculo.tipo_rotulo)}</strong> · ${origem}${detalheDiferenca}</span>
+          <span class="conc-vinculo__acoes">
+            ${manual ? '<button type="button" class="btn-outline conc-btn-sm" data-adicionar disabled title="Marque lançamentos na lista de não conciliados">Adicionar selecionados</button>' : ""}
+            <button type="button" class="btn-outline conc-btn-sm" data-desfazer>Desfazer vínculo</button>
+          </span>
+        </div>
+        <table class="conc-subtabela">
+          <thead><tr><th>Data</th><th>Seq.</th><th>Histórico</th><th>Natureza</th><th class="conc-num">Valor</th></tr></thead>
+          <tbody>${itens.map((l) => linhaLancamentoHtml(l, false, false)).join("")}</tbody>
+        </table>`;
+      const adicionarBtn = bloco.querySelector("[data-adicionar]");
+      if (adicionarBtn) {
+        adicionarBtn.addEventListener("click", async () => {
+          const novos = Array.from(estado.selecionados).map((id) => porId.get(id)).filter(Boolean);
+          if (!novos.length) return;
+          const assinado = (l) => (l.natureza === "C" ? Number(l.valor) : -Number(l.valor));
+          const novaDiferenca = [...itens, ...novos].reduce((t, l) => t + assinado(l), 0);
+          const arredondada = Math.round(novaDiferenca * 100) / 100;
+          const efeito =
+            arredondada > 0
+              ? `restarão ${pidConcMoeda(arredondada)} de diferença (em aberto, se passar da tolerância)`
+              : arredondada < 0
+                ? `ficará pago a maior em ${pidConcMoeda(-arredondada)} (possível juros/multa)`
+                : "o vínculo fecha sem diferença";
+          const seguir = await pidConfirm(
+            `Adicionar ${novos.length} lançamento(s) a este vínculo? Com eles, ${efeito}.`,
+            { titulo: "Adicionar ao vínculo", textoConfirmar: "Adicionar" }
+          );
+          if (!seguir) return;
+          adicionarBtn.disabled = true;
+          try {
+            const resposta = await pidApiRequest(`/conciliacoes-fornecedores-vinculos/${vinculo.id}/adicionar/`, {
+              method: "POST",
+              body: { lancamentos: novos.map((l) => l.id) },
+            });
+            aplicarRespostaConta(resposta);
+          } catch (erro) {
+            adicionarBtn.disabled = false;
+            pidAlert(erro.message, { titulo: "Não foi possível adicionar" });
+          }
+        });
+      }
+
+      bloco.querySelector("[data-desfazer]").addEventListener("click", () => desfazerVinculo(vinculo.id));
+      return bloco;
+    }
+
+    // Pagamento parcial não é conciliação fechada: fica junto dos não
+    // conciliados, sempre visível, com o saldo que continua em aberto.
+    const parciais = conta.vinculos.filter((v) => v.tipo === "parcial");
+    if (parciais.length) {
+      const secaoParcial = document.createElement("div");
+      secaoParcial.innerHTML = `<div class="conc-detail__secao-titulo"><h4>Pagamentos parciais vinculados (${parciais.length})</h4></div>`;
+      parciais.forEach((v) => secaoParcial.appendChild(montarBlocoVinculo(v)));
+      secaoPend.after(secaoParcial);
+    }
+
+    const fechados = conta.vinculos.filter((v) => v.tipo !== "parcial");
+    if (fechados.length) {
+      const secaoVinc = document.createElement("div");
+      secaoVinc.innerHTML = `
+        <div class="conc-detail__secao-titulo">
+          <h4>Lançamentos conciliados (${fechados.length} vínculo(s))</h4>
+          <button type="button" class="btn-outline conc-btn-sm" data-toggle-vinculados>${estado.mostrarVinculados ? "Ocultar" : "Mostrar"}</button>
+        </div>`;
+      secaoVinc.querySelector("[data-toggle-vinculados]").addEventListener("click", () => {
+        estado.mostrarVinculados = !estado.mostrarVinculados;
+        substituirConta(conta);
+      });
+      if (estado.mostrarVinculados) {
+        const lista = document.createElement("div");
+        lista.className = "conc-vinculos-lista";
+        fechados
+          .slice()
+          .reverse()
+          .forEach((vinculo) => lista.appendChild(montarBlocoVinculo(vinculo)));
+        secaoVinc.appendChild(lista);
+      }
+      painel.appendChild(secaoVinc);
+    }
+
+    // os botões "Adicionar selecionados" dos vínculos nascem depois da
+    // primeira atualização da seleção
+    atualizarSelecao();
+
+    // ---- Validação ----
+    const validacao = document.createElement("div");
+    validacao.className = "conc-validacao";
+    validacao.innerHTML = `
+      <label class="conc-detail__secao-titulo"><h4>Observação do contador</h4></label>
+      <textarea data-observacao placeholder="Registre a análise desta conta (ex.: título já pago em outubro, aguardando baixa).">${pidConcEscape(conta.observacao)}</textarea>
+      <div class="conc-detail__acoes">
+        <button type="button" class="btn-outline conc-btn-sm" data-salvar-obs>Salvar observação</button>
+        <button type="button" class="${conta.validada ? "btn-outline" : "btn-solid"} conc-btn-sm" data-validar>${conta.validada ? "Remover validação" : "Marcar como validada"}</button>
+        ${conta.validada ? `<span class="conc-validacao__info">${pidConcEscape(pidConcTextoValidacao(conta))}</span>` : ""}
+        <button type="button" class="btn-outline conc-btn-sm conc-recolher-btn" data-recolher>
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 15l6-6 6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+          Recolher
+        </button>
+      </div>`;
+    const observacaoEl = validacao.querySelector("[data-observacao]");
+    async function salvarValidacao(validada) {
+      try {
+        const resposta = await pidApiRequest(`/conciliacoes-fornecedores-contas/${conta.id}/validar/`, {
+          method: "POST",
+          body: { validada, observacao: observacaoEl.value },
+        });
+        aplicarRespostaConta(resposta);
+      } catch (erro) {
+        pidAlert(erro.message, { titulo: "Não foi possível salvar" });
+      }
+    }
+    validacao.querySelector("[data-salvar-obs]").addEventListener("click", () => salvarValidacao(conta.validada));
+    validacao.querySelector("[data-validar]").addEventListener("click", () => salvarValidacao(!conta.validada));
+    validacao.querySelector("[data-recolher]").addEventListener("click", () => {
+      abertas.delete(conta.id);
+      substituirConta(conta);
+      // a expansão pode ser longa: volta a tela para a linha do fornecedor
+      const linha = contasBody.querySelector(`tr[data-conta-id="${conta.id}"]`);
+      if (linha && linha.getBoundingClientRect().top < 120) linha.scrollIntoView({ block: "center" });
+    });
+    painel.appendChild(validacao);
+
+    return painel;
+  }
+
+  // ======================================================================
+  // Início
+  // ======================================================================
+  const hash = window.location.hash.match(/^#conciliacao-(\d+)$/);
+  if (hash) {
+    abrirDetalhe(Number(hash[1]));
+  } else {
+    carregarHistorico();
+  }
+});
diff --git a/templates/acessos-gerais.html b/templates/acessos-gerais.html
index d6a2f1b..dab8a93 100644
--- a/templates/acessos-gerais.html
+++ b/templates/acessos-gerais.html
@@ -165,6 +165,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/calendario-individual.html b/templates/calendario-individual.html
index b906d44..9457c3c 100644
--- a/templates/calendario-individual.html
+++ b/templates/calendario-individual.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/conciliacao-fornecedores.html b/templates/conciliacao-fornecedores.html
new file mode 100644
index 0000000..112a8a1
--- /dev/null
+++ b/templates/conciliacao-fornecedores.html
@@ -0,0 +1,595 @@
+{% load static %}
+<!DOCTYPE html>
+<html lang="pt-BR" data-theme="dark">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>P.I.D. — Conciliação de Fornecedores</title>
+  <link rel="icon" type="image/svg+xml" href="{% static 'img/pid-icone-escuro.svg' %}" />
+  <link rel="stylesheet" href="{% static 'css/tokens.css' %}" />
+  <link rel="stylesheet" href="{% static 'css/base.css' %}" />
+  <link rel="stylesheet" href="{% static 'css/layout.css' %}" />
+  <link rel="stylesheet" href="{% static 'css/components.css' %}" />
+  <link rel="stylesheet" href="{% static 'css/perfis-acesso.css' %}" />
+  <link rel="stylesheet" href="{% static 'css/conciliacao-fornecedores.css' %}" />
+  <script src="{% static 'js/theme.js' %}" defer></script>
+</head>
+<body>
+  <div class="app-shell" id="app-shell">
+    <aside class="sidebar">
+      <a class="sidebar__brand" href="portal.html" id="sidebar-brand-link" aria-label="Ir para a tela Principal">
+        <svg class="sidebar__logo sidebar__logo--full" viewBox="0 0 300 80" aria-hidden="true" focusable="false">
+          <g transform="translate(8,8) scale(1)">
+            <path d="M10 4 h34 l14 14 v40 a2 2 0 0 1 -2 2 H8 a2 2 0 0 1 -2 -2 V6 a2 2 0 0 1 2 -2 z" fill="#7B5BA8"></path>
+            <rect x="22" y="4" width="20" height="16" fill="#C6A24A"></rect>
+            <rect x="34" y="7" width="5" height="10" fill="#7B5BA8"></rect>
+            <rect x="12" y="26" width="40" height="30" rx="2" fill="#241C33"></rect>
+            <g class="pid-icon-eye">
+              <circle cx="24" cy="38" r="5" fill="#F2EDE3"></circle>
+              <circle cx="26" cy="36.2" r="1.6" fill="#241C33"></circle>
+            </g>
+            <g class="pid-icon-eye">
+              <circle cx="40" cy="38" r="5" fill="#F2EDE3"></circle>
+              <circle cx="42" cy="36.2" r="1.6" fill="#241C33"></circle>
+            </g>
+            <path d="M25 47 q7 6 14 0" stroke="#C6A24A" stroke-width="3" fill="none" stroke-linecap="round"></path>
+          </g>
+          <text x="86" y="42" font-family="'Space Grotesk',Helvetica,Arial,sans-serif" font-size="34" font-weight="700" letter-spacing="1.4" fill="#F2EDE3">P.I.D.</text>
+          <text x="88" y="61" font-family="'DM Mono',ui-monospace,monospace" font-size="9.5" letter-spacing="2.6" fill="#C6A24A">PORTAL INTERNO DA DE PAULA</text>
+        </svg>
+        <svg class="sidebar__logo sidebar__logo--icon" viewBox="0 0 64 64" aria-hidden="true" focusable="false">
+          <path d="M10 4 h34 l14 14 v40 a2 2 0 0 1 -2 2 H8 a2 2 0 0 1 -2 -2 V6 a2 2 0 0 1 2 -2 z" fill="#7B5BA8"></path>
+          <rect x="22" y="4" width="20" height="16" fill="#C6A24A"></rect>
+          <rect x="34" y="7" width="5" height="10" fill="#7B5BA8"></rect>
+          <rect x="12" y="26" width="40" height="30" rx="2" fill="#241C33"></rect>
+          <g class="pid-icon-eye">
+            <circle cx="24" cy="38" r="5" fill="#F2EDE3"></circle>
+            <circle cx="26" cy="36.2" r="1.6" fill="#241C33"></circle>
+          </g>
+          <g class="pid-icon-eye">
+            <circle cx="40" cy="38" r="5" fill="#F2EDE3"></circle>
+            <circle cx="42" cy="36.2" r="1.6" fill="#241C33"></circle>
+          </g>
+          <path d="M25 47 q7 6 14 0" stroke="#C6A24A" stroke-width="3" fill="none" stroke-linecap="round"></path>
+        </svg>
+      </a>
+
+      <nav class="sidebar__nav">
+        <ul class="nav-list">
+          <li data-section="principal">
+            <a href="portal.html" class="nav-item">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 11l9-7 9 7v9a1 1 0 0 1-1 1h-5v-6H9v6H4a1 1 0 0 1-1-1z" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Principal</span>
+            </a>
+          </li>
+          <li data-section="ramais">
+            <a href="ramais.html" class="nav-item">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 4c0 9 7 16 16 16l3-4-6-3-2 2c-3-1.5-5-3.5-6-6l2-2-3-6z" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Ramais</span>
+            </a>
+          </li>
+          <li data-section="calendario">
+            <a href="#" class="nav-item" id="calendario-depaula-btn">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="5" width="18" height="16" rx="2"/><path d="M3 9h18M8 3v4M16 3v4" stroke-linecap="round"/></svg>
+              <span class="nav-item__label">Calendário De Paula</span>
+            </a>
+          </li>
+          <li data-section="calendario-individual">
+            <a href="calendario-individual.html" class="nav-item">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="5" width="18" height="16" rx="2"/><path d="M3 9h18M8 3v4M16 3v4" stroke-linecap="round"/><path d="M9 15l2 2 4-4" stroke-linecap="round" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Calendário Individual</span>
+            </a>
+          </li>
+
+          <li data-section="portais" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="7" height="7" rx="1"/><rect x="14" y="3" width="7" height="7" rx="1"/><rect x="3" y="14" width="7" height="7" rx="1"/><rect x="14" y="14" width="7" height="7" rx="1"/></svg>
+              <span class="nav-item__label">Portais</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="portal-do-cliente"><a href="#" class="nav-subitem">Portal do Cliente</a></li>
+              <li data-app="portal-fiscal"><a href="#" class="nav-subitem">Portal Fiscal</a></li>
+            </ul>
+          </li>
+
+          <li data-section="geradoc" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 3h9l3 3v15a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1z"/><path d="M14 3v4h4" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Geradoc</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="simulacao-custo-contratacao"><a href="custo-contratacao.html" class="nav-subitem">Simulação de Custo de Contratação</a></li>
+              <li data-app="indicador-desempenho"><a href="indicador-desempenho.html" class="nav-subitem">Indicador de Desempenho</a></li>
+            </ul>
+          </li>
+
+          <li data-section="relatorios" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 20V10M12 20V4M20 20v-7" stroke-linecap="round"/></svg>
+              <span class="nav-item__label">Relatórios</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="indicadores"><a href="#" class="nav-subitem">Indicadores</a></li>
+              <li class="nav-subgroup" data-subgroup="qualidade">
+                <button type="button" class="nav-subitem nav-subgroup__toggle" data-subgroup-toggle>
+                  <span>Qualidade</span>
+                  <svg class="nav-item__chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </button>
+                <ul class="nav-subgroup__list">
+                  <li data-app="nao-conformidades">
+                    <a href="nao-conformidades.html" class="nav-subitem nav-subitem--tool">
+                      <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 2h9l3 3v15a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z"/><path d="M14 2v4h4" stroke-linejoin="round"/></svg>
+                      Não Conformidades
+                    </a>
+                  </li>
+                </ul>
+              </li>
+              <li class="nav-subgroup" data-subgroup="contabilidade">
+                <button type="button" class="nav-subitem nav-subgroup__toggle" data-subgroup-toggle>
+                  <span>Contabilidade</span>
+                  <svg class="nav-item__chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </button>
+                <ul class="nav-subgroup__list">
+                  <li data-app="dashboard-contabil">
+                    <a href="dashboard-contabil.html" class="nav-subitem nav-subitem--tool">
+                      <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 2h9l3 3v15a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z"/><path d="M14 2v4h4" stroke-linejoin="round"/></svg>
+                      Relatório Contábil
+                    </a>
+                  </li>
+                </ul>
+              </li>
+            </ul>
+          </li>
+
+          <li data-section="relatorios-gerenciais" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 3v18h18M7 15l4-5 3 3 5-7" stroke-linecap="round" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Relatórios Gerenciais</span>
+              <span class="badge-restricted" data-restricted-badge hidden>Restrito</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="visao-diretoria"><a href="#" class="nav-subitem">Visão Diretoria</a></li>
+              <li data-app="visao-gerencial"><a href="#" class="nav-subitem">Visão Gerencial</a></li>
+            </ul>
+          </li>
+
+          <li data-section="utilitarios" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M14 7l3 3-8 8-4 1 1-4z" stroke-linejoin="round"/><path d="M12 9l3 3" stroke-linecap="round"/></svg>
+              <span class="nav-item__label">Utilitários</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
+              <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem is-active">Conciliação de Fornecedores</a></li>
+            </ul>
+          </li>
+
+          <li data-section="integracoes" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="6" cy="12" r="3"/><circle cx="18" cy="6" r="3"/><circle cx="18" cy="18" r="3"/><path d="M8.6 10.6L15.4 7.4M8.6 13.4l6.8 3.2" stroke-linecap="round"/></svg>
+              <span class="nav-item__label">Integrações</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="questor"><a href="#" class="nav-subitem">Questor</a></li>
+            </ul>
+          </li>
+
+          <li data-section="auditorias" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3l7 4v5c0 5-3.5 8-7 9-3.5-1-7-4-7-9V7z" stroke-linejoin="round"/><path d="M9 12l2 2 4-4" stroke-linecap="round" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Auditorias</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li class="nav-subgroup" data-subgroup="consultoria-tributaria">
+                <button type="button" class="nav-subitem nav-subgroup__toggle" data-subgroup-toggle>
+                  <span>Consultoria Tributária</span>
+                  <svg class="nav-item__chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </button>
+                <ul class="nav-subgroup__list">
+                  <li data-app="controle-simples-nacional">
+                    <a href="#" class="nav-subitem nav-subitem--tool">
+                      <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 2h9l3 3v15a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z"/><path d="M14 2v4h4" stroke-linejoin="round"/></svg>
+                      Controle Simples Nacional
+                    </a>
+                  </li>
+                </ul>
+              </li>
+              <li class="nav-subgroup" data-subgroup="fisco-contabil">
+                <button type="button" class="nav-subitem nav-subgroup__toggle" data-subgroup-toggle>
+                  <span>Fisco/Contábil</span>
+                  <svg class="nav-item__chevron" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </button>
+                <ul class="nav-subgroup__list">
+                  <li data-app="auditoria-de-balancetes">
+                    <a href="#" class="nav-subitem nav-subitem--tool">
+                      <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 2h9l3 3v15a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z"/><path d="M14 2v4h4" stroke-linejoin="round"/></svg>
+                      Auditoria de Balancetes
+                    </a>
+                  </li>
+                </ul>
+              </li>
+            </ul>
+          </li>
+
+          <li data-section="links-ferramentas" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10 14a4 4 0 0 0 5.7 0l3-3a4 4 0 0 0-5.7-5.7l-1 1"/><path d="M14 10a4 4 0 0 0-5.7 0l-3 3a4 4 0 0 0 5.7 5.7l1-1"/></svg>
+              <span class="nav-item__label">Links &amp; Ferramentas</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="links-ferramentas-visualizar"><a href="links-ferramentas.html" class="nav-subitem">Links &amp; Ferramentas</a></li>
+              <li data-app="acessos-gerais-visualizar"><a href="acessos-gerais.html" class="nav-subitem">Acessos Gerais</a></li>
+            </ul>
+          </li>
+
+          <li data-section="solicitacoes" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M8 10h.01M12 10h.01M16 10h.01M21 12a9 9 0 1 1-4.4-7.7L21 3l-1.2 4.5A8.96 8.96 0 0 1 21 12z"/></svg>
+              <span class="nav-item__label">Solicitações</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-app="controle-notificacoes"><a href="https://form.asana.com/?k=PcELrDLzN969CwpiRBLtFA&amp;d=1207308016523218" target="_blank" rel="noopener noreferrer" class="nav-subitem">Controle de Notificações</a></li>
+              <li data-app="ordem-servico"><a href="#" class="nav-subitem">Ordem de Serviço</a></li>
+              <li data-app="pimi"><a href="https://form.asana.com/?k=XfBww25lGUyPVrInNcLyuQ&amp;d=1207308016523218" target="_blank" rel="noopener noreferrer" class="nav-subitem">P.I.M.I.</a></li>
+              <li data-app="programa-indicacoes"><a href="https://form.asana.com/?k=y0mTeaRTOAoC0r0XP8ee0Q&amp;d=1207308016523218" target="_blank" rel="noopener noreferrer" class="nav-subitem">Programa de Indicações</a></li>
+              <li data-app="pos-vendas"><a href="https://form.asana.com/?k=jRAztLip-_BknWPsGmEcZA&amp;d=1207308016523218" target="_blank" rel="noopener noreferrer" class="nav-subitem">Pós-Vendas</a></li>
+              <li data-app="sugestao-inovacao"><a href="https://form.asana.com/?k=Zn8cLeT97R7FTUrsNB8Yaw&amp;d=1207308016523218" target="_blank" rel="noopener noreferrer" class="nav-subitem">Sugestão de Inovação</a></li>
+            </ul>
+          </li>
+
+          <li data-section="administracao" class="nav-group">
+            <button type="button" class="nav-item nav-group__toggle" data-group-toggle>
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6z"/><path d="M19.4 15a1.7 1.7 0 0 0 .3 1.9l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.9-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1a1.7 1.7 0 0 0-1-1.6 1.7 1.7 0 0 0-1.9.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.9 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1a1.7 1.7 0 0 0 1.5-1 1.7 1.7 0 0 0-.3-1.9l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.9.3H9a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.9-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.9V9a1.7 1.7 0 0 0 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1z" stroke-linejoin="round"/></svg>
+              <span class="nav-item__label">Administração</span>
+              <svg class="nav-item__chevron" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 6l6 6-6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+            </button>
+            <ul class="nav-group__list">
+              <li data-section="perfis-acesso"><a href="perfis-acesso.html" class="nav-subitem">Perfis de Acesso</a></li>
+              <li data-section="usuarios"><a href="usuarios.html" class="nav-subitem">Usuários</a></li>
+            </ul>
+          </li>
+        </ul>
+      </nav>
+
+    </aside>
+
+    <div class="main-content">
+      <header class="topbar">
+        <button type="button" class="icon-btn" id="sidebar-toggle" aria-label="Alternar menu">
+          <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 6h16M4 12h16M4 18h16" stroke-linecap="round"/></svg>
+        </button>
+        <h1 class="topbar__title">Conciliação de Fornecedores</h1>
+
+        <div class="topbar__actions">
+          <button type="button" class="icon-btn" id="theme-toggle" aria-label="Ativar modo claro">
+            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4" stroke-linecap="round"/></svg>
+          </button>
+
+          <div class="notifications">
+            <button type="button" class="icon-btn" id="notif-bell" aria-label="Notificações">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 8a6 6 0 0 1 12 0c0 5 2 6 2 6H4s2-1 2-6" stroke-linejoin="round"/><path d="M9.5 20a2.5 2.5 0 0 0 5 0"/></svg>
+              <span class="notif-badge" id="notif-badge" hidden>0</span>
+            </button>
+            <div class="notif-dropdown" id="notif-dropdown" hidden>
+              <div class="notif-dropdown__header">
+                <span>Notificações</span>
+                <div class="notif-dropdown__header-actions">
+                  <button type="button" id="notif-history-btn">Histórico</button>
+                  <button type="button" id="notif-clear-all">Limpar tudo</button>
+                </div>
+              </div>
+              <ul class="notif-list" id="notif-list"></ul>
+            </div>
+          </div>
+
+          <div class="account-menu">
+            <button type="button" class="persona-chip" id="persona-chip">
+              <span class="persona-chip__icon">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 20v-1a6 6 0 0 1 6-6h4a6 6 0 0 1 6 6v1" stroke-linecap="round" stroke-linejoin="round"/><circle cx="12" cy="7" r="4"/></svg>
+              </span>
+              <span id="persona-chip-label">Usuário</span>
+            </button>
+            <div class="account-dropdown" id="account-dropdown" hidden>
+              <div class="account-dropdown__header">
+                <p class="account-dropdown__name" id="account-name"></p>
+                <p class="account-dropdown__profile" id="account-profile"></p>
+              </div>
+              <button type="button" class="account-dropdown__item" id="account-manage-account-btn">Gerenciar Usuário</button>
+              <a href="perfis-acesso.html" class="account-dropdown__item" id="account-manage-link" hidden>Gerenciar Perfis de Acesso</a>
+              <div class="account-dropdown__section">
+                <p class="account-dropdown__section-title">Tema de cores</p>
+                <div class="theme-swatches" id="theme-swatches"></div>
+              </div>
+              <div class="account-dropdown__section">
+                <p class="account-dropdown__section-title">Temas sazonais</p>
+                <button type="button" class="seasonal-theme-toggle" id="seasonal-theme-toggle" aria-pressed="true">
+                  <span class="seasonal-theme-toggle__dot"></span>
+                  <span id="seasonal-theme-toggle-label">Ativo</span>
+                </button>
+              </div>
+              <button type="button" class="account-dropdown__item account-dropdown__logout" data-logout>Sair</button>
+            </div>
+          </div>
+        </div>
+      </header>
+
+      <main class="page-content page-content--wide">
+        <div id="conc-no-access" class="no-access" hidden>
+          <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6"><rect x="4" y="10" width="16" height="10" rx="2"/><path d="M8 10V7a4 4 0 0 1 8 0v3" stroke-linecap="round" stroke-linejoin="round"/></svg>
+          <h2>Sem acesso a Conciliação de Fornecedores</h2>
+          <p>Seu perfil de acesso não tem permissão para visualizar esta tela. Solicite à Inovação a liberação em Perfis de Acesso.</p>
+        </div>
+
+        <div id="conc-content" hidden>
+          <!-- Histórico + nova conciliação -->
+          <section id="conc-list-view">
+            <div class="conc-header">
+              <div>
+                <h2>Conciliação de Fornecedores</h2>
+                <p class="conc-subtitle">Anexe a exportação do razão contábil de fornecedores do Questor: a ferramenta vincula débitos e créditos de cada fornecedor por valor e data e aponta o que ficou pendente.</p>
+              </div>
+              <button type="button" class="btn-solid" id="conc-nova-btn">Nova Conciliação</button>
+            </div>
+
+            <div class="conc-form" id="conc-form" hidden>
+              <div class="conc-form__grid">
+                <div class="modal-field">
+                  <label for="conc-form-codigo">Código da empresa</label>
+                  <input type="text" id="conc-form-codigo" inputmode="numeric" autocomplete="off" placeholder="Ex.: 2017" />
+                  <p class="conc-form__empresa" id="conc-form-empresa"></p>
+                </div>
+              </div>
+              <div class="modal-field">
+                <label>Razão de fornecedores (.xlsx ou .csv)</label>
+                <div class="conc-file-field">
+                  <label class="btn-outline conc-file-field__btn" for="conc-form-arquivo">
+                    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 16V4M12 4l4 4M12 4L8 8" stroke-linecap="round" stroke-linejoin="round"/><path d="M4 16v3a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-3" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                    Selecionar arquivo
+                  </label>
+                  <input type="file" id="conc-form-arquivo" accept=".xlsx,.csv" class="conc-file-field__input" />
+                  <span class="conc-file-field__name" id="conc-form-arquivo-nome">Nenhum arquivo selecionado</span>
+                </div>
+              </div>
+              <p class="modal-error" id="conc-form-erro"></p>
+              <div class="modal-actions">
+                <button type="button" class="btn-outline" id="conc-form-cancelar-btn">Cancelar</button>
+                <button type="button" class="btn-solid" id="conc-form-processar-btn">Processar</button>
+              </div>
+            </div>
+
+            <div class="conc-toolbar">
+              <div class="pa-search">
+                <input type="search" id="conc-lista-busca" placeholder="Buscar por código ou empresa..." autocomplete="off" />
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"/><path d="M20 20l-3.5-3.5" stroke-linecap="round"/></svg>
+              </div>
+            </div>
+            <div class="pa-table-wrap">
+              <table class="pa-table">
+                <thead>
+                  <tr>
+                    <th>Empresa</th>
+                    <th>Data-base</th>
+                    <th>Período</th>
+                    <th class="conc-num">Fornecedores</th>
+                    <th class="conc-num">Conciliados</th>
+                    <th class="conc-num">Divergentes</th>
+                    <th class="conc-num">Em aberto</th>
+                    <th>Criado por</th>
+                    <th></th>
+                  </tr>
+                </thead>
+                <tbody id="conc-lista-body"></tbody>
+              </table>
+            </div>
+            <p class="conc-empty" id="conc-lista-vazia" hidden>Nenhuma conciliação realizada ainda.</p>
+          </section>
+
+          <!-- Detalhe de uma conciliação -->
+          <section id="conc-detail-view" hidden>
+            <button type="button" class="btn-ghost conc-voltar-btn" id="conc-voltar-btn">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M15 6l-6 6 6 6" stroke-linecap="round" stroke-linejoin="round"/></svg>
+              Voltar ao histórico
+            </button>
+
+            <div class="conc-empresa">
+              <div class="conc-empresa__principal">
+                <span class="conc-empresa__codigo" id="conc-det-codigo"></span>
+                <h2 class="conc-empresa__nome" id="conc-det-nome"></h2>
+                <div class="conc-empresa__meta" id="conc-det-meta"></div>
+              </div>
+              <a class="btn-outline" id="conc-exportar-btn" href="#">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 4v12M12 16l4-4M12 16l-4-4" stroke-linecap="round" stroke-linejoin="round"/><path d="M4 18v1a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-1" stroke-linecap="round"/></svg>
+                Exportar XLSX
+              </a>
+            </div>
+
+            <div class="conc-cards" id="conc-cards"></div>
+            <div class="conc-alertas-gerais" id="conc-alertas-gerais"></div>
+
+            <div class="conc-toolbar conc-toolbar--fixa">
+              <div class="conc-chip-row" id="conc-filtro-status">
+                <button type="button" class="conc-chip is-active" data-conc-status="">Todos</button>
+                <button type="button" class="conc-chip" data-conc-status="divergente">Divergentes</button>
+                <button type="button" class="conc-chip" data-conc-status="atencao">Atenção</button>
+                <button type="button" class="conc-chip" data-conc-status="pendente">Pendentes de pagamento</button>
+                <button type="button" class="conc-chip" data-conc-status="conciliada">Conciliados</button>
+                <button type="button" class="conc-chip" data-conc-status="validada">Validados</button>
+              </div>
+              <label class="conc-toggle"><input type="checkbox" id="conc-mostrar-validadas" /> Mostrar validadas <span class="conc-chip__count" id="conc-mostrar-validadas-qtd">0</span></label>
+              <div class="pa-search">
+                <input type="search" id="conc-contas-busca" placeholder="Buscar fornecedor ou conta..." autocomplete="off" />
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"/><path d="M20 20l-3.5-3.5" stroke-linecap="round"/></svg>
+              </div>
+            </div>
+            <p class="conc-filtro-alerta" id="conc-filtro-alerta" hidden></p>
+
+            <div class="pa-table-wrap conc-table-wrap">
+              <table class="pa-table conc-table" id="conc-contas-table">
+                <thead>
+                  <tr>
+                    <th class="conc-expand-col"></th>
+                    <th data-sort="conta_numero">Conta <span class="conc-sort-icon">↕</span></th>
+                    <th data-sort="fornecedor">Fornecedor <span class="conc-sort-icon">↕</span></th>
+                    <th class="conc-num" data-sort="saldo_inicial">Saldo inicial <span class="conc-sort-icon">↕</span></th>
+                    <th class="conc-num" data-sort="saldo_final">Saldo residual <span class="conc-sort-icon">↕</span></th>
+                    <th class="conc-num" data-sort="total_vencido">Em aberto &gt; 3 meses <span class="conc-sort-icon">↕</span></th>
+                    <th data-sort="status">Situação <span class="conc-sort-icon">↕</span></th>
+                    <th class="conc-validado-col" data-sort="validada">Validado <span class="conc-sort-icon">↕</span></th>
+                  </tr>
+                </thead>
+                <tbody id="conc-contas-body"></tbody>
+              </table>
+            </div>
+            <p class="conc-empty" id="conc-contas-vazia" hidden>Nenhum fornecedor para este filtro.</p>
+          </section>
+        </div>
+      </main>
+    </div>
+  </div>
+
+  <div class="modal-overlay" id="manage-account-modal" hidden>
+    <div class="modal-card" id="manage-account-modal-card">
+      <h2 class="modal-card__title">Gerenciar Usuário</h2>
+      <div class="modal-field">
+        <button type="button" class="btn-outline" id="manage-account-change-password-btn">Alterar senha</button>
+      </div>
+      <div class="modal-field" id="manage-account-liderados-field" hidden>
+        <label>Usuários sob sua liderança</label>
+        <div class="dual-select">
+          <div class="dual-select__panel">
+            <div class="dual-select__panel-header">
+              <button type="button" class="btn-solid" id="manage-account-liderados-available-link-btn" disabled>Vincular</button>
+            </div>
+            <div class="dual-select__table-wrap">
+              <table class="dual-select__table">
+                <thead>
+                  <tr>
+                    <th><input type="checkbox" id="manage-account-liderados-available-select-all" aria-label="Selecionar todos" /></th>
+                    <th class="dual-select__sort" id="manage-account-liderados-available-sort-nome">Nome <span class="dual-select__sort-icon">↕</span></th>
+                    <th>Departamento</th>
+                  </tr>
+                  <tr class="dual-select__filters">
+                    <th></th>
+                    <th><input type="text" id="manage-account-liderados-available-search-nome" placeholder="Buscar por nome..." autocomplete="off" /></th>
+                    <th><input type="text" id="manage-account-liderados-available-search-departamento" placeholder="Buscar por departamento..." autocomplete="off" /></th>
+                  </tr>
+                </thead>
+                <tbody id="manage-account-liderados-available-body"></tbody>
+              </table>
+            </div>
+            <div class="dual-select__footer" id="manage-account-liderados-available-footer"></div>
+          </div>
+
+          <div class="dual-select__panel">
+            <div class="dual-select__panel-header">
+              <button type="button" class="btn-danger-outline" id="manage-account-liderados-linked-unlink-btn" disabled>Desvincular</button>
+            </div>
+            <div class="dual-select__table-wrap">
+              <table class="dual-select__table">
+                <thead>
+                  <tr>
+                    <th><input type="checkbox" id="manage-account-liderados-linked-select-all" aria-label="Selecionar todos" /></th>
+                    <th class="dual-select__sort" id="manage-account-liderados-linked-sort-nome">Nome <span class="dual-select__sort-icon">↕</span></th>
+                    <th>Departamento</th>
+                  </tr>
+                  <tr class="dual-select__filters">
+                    <th></th>
+                    <th><input type="text" id="manage-account-liderados-linked-search-nome" placeholder="Buscar por nome..." autocomplete="off" /></th>
+                    <th><input type="text" id="manage-account-liderados-linked-search-departamento" placeholder="Buscar por departamento..." autocomplete="off" /></th>
+                  </tr>
+                </thead>
+                <tbody id="manage-account-liderados-linked-body"></tbody>
+              </table>
+            </div>
+            <div class="dual-select__footer" id="manage-account-liderados-linked-footer"></div>
+          </div>
+        </div>
+        <p class="modal-error" id="manage-account-liderados-error"></p>
+      </div>
+      <div class="modal-actions">
+        <button type="button" class="btn-outline" id="manage-account-close-btn">Fechar</button>
+        <button type="button" class="btn-solid" id="manage-account-save-btn" hidden>Salvar liderados</button>
+      </div>
+    </div>
+  </div>
+
+  <div class="modal-overlay" id="password-modal" hidden>
+    <div class="modal-card">
+      <h2 class="modal-card__title">Alterar senha</h2>
+      <div class="modal-field">
+        <label for="pwd-current">Senha atual</label>
+        <div class="password-field">
+          <input type="password" id="pwd-current" autocomplete="current-password" />
+          <button type="button" class="password-field__toggle" id="pwd-current-toggle" aria-label="Mostrar senha"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M1 12s4-7 11-7 11 7 11 7-4 7-11 7-11-7-11-7Z" stroke-linecap="round" stroke-linejoin="round"/><circle cx="12" cy="12" r="3"/></svg></button>
+        </div>
+      </div>
+      <div class="modal-field">
+        <label for="pwd-new">Nova senha</label>
+        <div class="password-field">
+          <input type="password" id="pwd-new" autocomplete="new-password" />
+          <button type="button" class="password-field__toggle" id="pwd-new-toggle" aria-label="Mostrar senha"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M1 12s4-7 11-7 11 7 11 7-4 7-11 7-11-7-11-7Z" stroke-linecap="round" stroke-linejoin="round"/><circle cx="12" cy="12" r="3"/></svg></button>
+        </div>
+      </div>
+      <div class="modal-field">
+        <label for="pwd-confirm">Confirmar nova senha</label>
+        <div class="password-field">
+          <input type="password" id="pwd-confirm" autocomplete="new-password" />
+          <button type="button" class="password-field__toggle" id="pwd-confirm-toggle" aria-label="Mostrar senha"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M1 12s4-7 11-7 11 7 11 7-4 7-11 7-11-7-11-7Z" stroke-linecap="round" stroke-linejoin="round"/><circle cx="12" cy="12" r="3"/></svg></button>
+        </div>
+      </div>
+      <p class="modal-error" id="pwd-error"></p>
+      <div class="modal-actions">
+        <button type="button" class="btn-outline" id="pwd-cancel-btn">Cancelar</button>
+        <button type="button" class="btn-solid" id="pwd-save-btn">Salvar</button>
+      </div>
+    </div>
+  </div>
+
+  <div class="modal-overlay" id="notif-history-modal" hidden>
+    <div class="modal-card">
+      <h2 class="modal-card__title">Histórico de Notificações</h2>
+      <ul class="notif-list" id="notif-history-list"></ul>
+      <div class="modal-actions">
+        <button type="button" class="btn-outline" id="notif-history-close-btn">Fechar</button>
+      </div>
+    </div>
+  </div>
+
+  <div class="modal-overlay" id="calendario-depaula-modal" hidden>
+    <div class="modal-card iframe-modal-card">
+      <div class="iframe-modal-header">
+        <h2 class="modal-card__title">Calendário De Paula</h2>
+        <button type="button" class="icon-btn" id="calendario-depaula-close-btn" aria-label="Fechar">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 6L6 18M6 6l12 12" stroke-linecap="round"/></svg>
+        </button>
+      </div>
+      <iframe id="calendario-depaula-iframe" class="iframe-modal-iframe" title="Calendário De Paula"></iframe>
+    </div>
+  </div>
+
+  <script src="{% static 'js/api.js' %}"></script>
+  <script src="{% static 'js/confirm-modal.js' %}"></script>
+  <script src="{% static 'js/seasonal-theme.js' %}"></script>
+  <script src="{% static 'js/sidebar-brand.js' %}"></script>
+  <script src="{% static 'js/dual-select.js' %}"></script>
+  <script src="{% static 'js/profiles.js' %}"></script>
+  <script src="{% static 'js/auth.js' %}"></script>
+  <script src="{% static 'js/access.js' %}"></script>
+  <script src="{% static 'js/account.js' %}"></script>
+  <script src="{% static 'js/favorites.js' %}"></script>
+  <script src="{% static 'js/events.js' %}"></script>
+  <script src="{% static 'js/sidebar.js' %}"></script>
+  <script src="{% static 'js/notifications.js' %}"></script>
+  <script src="{% static 'js/conciliacao-fornecedores.js' %}"></script>
+</body>
+</html>
diff --git a/templates/custo-contratacao.html b/templates/custo-contratacao.html
index 42e8dd7..ffc4bee 100644
--- a/templates/custo-contratacao.html
+++ b/templates/custo-contratacao.html
@@ -165,6 +165,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/dashboard-contabil.html b/templates/dashboard-contabil.html
index 0f12286..35a6395 100644
--- a/templates/dashboard-contabil.html
+++ b/templates/dashboard-contabil.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/importacao-plano-saude-de-paula.html b/templates/importacao-plano-saude-de-paula.html
index 5a2c9ee..598151a 100644
--- a/templates/importacao-plano-saude-de-paula.html
+++ b/templates/importacao-plano-saude-de-paula.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem is-active">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/importacao-plano-saude.html b/templates/importacao-plano-saude.html
index ea5807d..0b16d1e 100644
--- a/templates/importacao-plano-saude.html
+++ b/templates/importacao-plano-saude.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem is-active">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/indicador-desempenho.html b/templates/indicador-desempenho.html
index ca73ac0..677385a 100644
--- a/templates/indicador-desempenho.html
+++ b/templates/indicador-desempenho.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/links-ferramentas.html b/templates/links-ferramentas.html
index a0bce92..25313fa 100644
--- a/templates/links-ferramentas.html
+++ b/templates/links-ferramentas.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/nao-conformidades.html b/templates/nao-conformidades.html
index 03bd175..64ba7ef 100644
--- a/templates/nao-conformidades.html
+++ b/templates/nao-conformidades.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/perfis-acesso.html b/templates/perfis-acesso.html
index 47185cb..67ac410 100644
--- a/templates/perfis-acesso.html
+++ b/templates/perfis-acesso.html
@@ -165,6 +165,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/portal.html b/templates/portal.html
index 43bdbb0..623844b 100644
--- a/templates/portal.html
+++ b/templates/portal.html
@@ -169,6 +169,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/ramais.html b/templates/ramais.html
index 1beaebf..6ff4284 100644
--- a/templates/ramais.html
+++ b/templates/ramais.html
@@ -166,6 +166,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>
 
diff --git a/templates/usuarios.html b/templates/usuarios.html
index 3ad8383..563f63a 100644
--- a/templates/usuarios.html
+++ b/templates/usuarios.html
@@ -165,6 +165,7 @@
             <ul class="nav-group__list">
               <li data-app="importacao-plano-saude"><a href="importacao-plano-saude.html" class="nav-subitem">Importação de Plano de Saúde</a></li>
               <li data-app="importacao-plano-saude-de-paula"><a href="importacao-plano-saude-de-paula.html" class="nav-subitem">Importação de Plano de Saúde - De Paula</a></li>
+              <li data-app="conciliacao-fornecedores"><a href="conciliacao-fornecedores.html" class="nav-subitem">Conciliação de Fornecedores</a></li>
             </ul>
           </li>