Aguardando Documentação¶
O que é¶
Tela — /credito/propostas/aguardando-documentacao — que lista as propostas/operações da
Mesa que já têm CCB cadastrada na bancarizadora FIDEM e aguardam o envio dos documentos do
contato para efetivar a operação. É o passo entre "Cadastrar CCB" e "Aguardando Assinatura" no
pipe Mesa F2 (ver pipe-e-etapa), resolvendo o problema de dar visibilidade de fila para
quem precisa mandar/efetivar documentação de bancarização.
Como funciona¶
Lista em tabela uma linha por operação pendente: contato (linkado para ficha-do-contato), CPF, código da operação na FIDEM, valor liberado, parcelas, bancarizadora, data, contagem de documentos do contato, e as ações:
- Enviar Docs — abre o dialog
DocumentosDialog: escolhe, entre os documentos já cadastrados no contato, quais enviar e com qual tipo de documento (lookupuseTiposDocumento), e envia (useEnviarDocumentos) um a um para a FIDEM — mostra sucesso/erro por documento e permite reenviar os que falharam. Desabilitado se o contato não tem nenhum documento cadastrado (aponta para cadastrar em ficha-do-contato, aba Documentos). - Efetivar — confirma a efetivação da proposta na bancarizadora (
useEfetivarProposta); em caso de sucesso, dispara o eventoproposta.efetivada(ver mapa de eventos em kanban-comercial), que move o negócio de volta pro Comercial/Aguardando Assinatura. - Cancelar proposta (
BotaoCancelarProposta) — cancela a operação de bancarização.
Onde a Mesa chega nesta funcionalidade a partir do Kanban¶
O card na etapa Mesa F2 · Enviar Documentos do kanban-comercial tem os mesmos botões
Enviar Docs e Efetivar (EnviarDocumentosAcoes.tsx), mas eles não navegam para esta
rota — abrem o mesmo DocumentosDialog (e a mesma mutation de efetivar) embutido no
próprio card, resolvendo a operação pelo contatoId do card contra a mesma lista
(useOperacoesAguardando). Ou seja: mesmo dialog e mesma lógica de negócio, dois pontos de
entrada — a lista dedicada desta tela (para quem trabalha a fila inteira) e o atalho no card
do board (para quem já está olhando aquele negócio específico).
⚠️ Se o card chegou em Mesa F2 sem ter passado pelo fluxo
/bancarizar(ex.: movido manualmente via "Mover para…"), não há operação FIDEM correspondente — o card mostra "Sem operação — cadastre a CCB" no lugar dos botões.
Regras de negócio¶
⚠️ A documentar. Esta tela ainda não tem as regras de negócio levantadas do código.
O que entra aqui: invariante (o que nunca pode acontecer), permissão (quem pode fazer o quê), bloqueio (o que impede a ação e a mensagem que o usuário vê), cálculo (fórmula e arredondamento) e efeito colateral (o que mais muda quando isso acontece).
Regra só entra aqui com origem no código — arquivo e linha. Regra que alguém "acha que é assim" é pior que seção vazia, porque vira decisão de produto baseada em memória.
Onde vive no código¶
- CRM (tela dedicada):
apps/crm-menos-juros/client/src/pages/credito/propostas/aguardando-documentacao.tsx - CRM (atalho no card do board):
apps/crm-menos-juros/client/src/pages/comercial/kanban/components/EnviarDocumentosAcoes.tsx - Domínio compartilhado:
apps/crm-menos-juros/client/src/domains/credito/documentos-bancarizacao/ components/DocumentosDialog.tsxhooks/use-operacoes-aguardando.ts,use-enviar-documentos.ts,use-efetivar-proposta.ts,use-tipos-documento.ts,use-cancelar-proposta.ts- Rota:
/credito/propostas/aguardando-documentacao,apps/crm-menos-juros/client/src/routes/AppRoutes.tsx
Relacionado¶
kanban-comercial · ficha-do-contato · pipe-e-etapa · proposta · comercial · mesa
Histórico¶
- 2026-07-10: primeira ingestão desta funcionalidade no wiki, a partir do mapeamento das telas alcançadas por clique a partir do Kanban Comercial.