Index de Transações
Listagem de documentos de compra — Requisições, Cotações, Pré-Pedidos, Pedidos, Contratos, Leilões e Notas Fiscais. Status semânticos e ações dependentes do fluxo.
O ponto de partida: a tela real de Transações no modo padrão (Tabela) — Header global, Subheader com o split “Novo documento”, Sidebar, Filter Bar e a tabela com Tipo e Status sempre legíveis. As seções abaixo detalham cada parte.
Boas Práticas
Transações é a index de maior densidade de uso do ME. Segue o chassi de Estrutura de Index — zonas, subheader, filtros e ecossistema são transversais —, com a particularidade do split "Novo documento" e dos status de fluxo.
Especificação
View mode padrão: Tabela — a densidade de campos de uma transação pede a comparação coluna a coluna. Também há Lista e Preview; não há Card, por serem documentos sem representação visual. Veja os três modos em Contextos → Modos de visualização.
Colunas
O conjunto padrão cobre a varredura mais comum; dezenas de outras ficam ocultas em "Editar colunas" e o usuário exibe conforme a tarefa — ex.: o Nº ERP, para reconciliar com o número do ERP do cliente.
| Coluna | Tipo | Observação | Visibilidade |
|---|---|---|---|
| Número | Link | Prefixo conforme o tipo (REQ-, COT-, PP-, PED-, CTR-). Abre o documento. | Padrão |
| Tipo | Badge | Requisição / Cotação / Pré-Pedido / Pedido / Contrato / Leilão / Nota Fiscal. | Padrão |
| Solicitante | Avatar + nome | Link para o perfil do usuário quando disponível. | Padrão |
| Fornecedor | Texto | «—» se ainda não vinculado (Requisição em rascunho). | Padrão |
| Valor total | Moeda R$ | Alinhado à direita. «—» se sem valor ainda. | Padrão |
| Status | Badge semântico | Nunca truncado. Mapeia na paleta semântica (ver abaixo). | Padrão |
| Data criação | Data | Ordenação padrão: mais recente primeiro. | Padrão |
| Nº ERP | Texto | Reconciliar com o número do ERP do cliente. | Opcional |
| Origem (ME / Integração) | Badge | Distinguir o que veio por integração. | Opcional |
| Aprovador | Avatar + nome | Saber quem responde pela aprovação. | Opcional |
| Prazo de entrega | Data | Triar por urgência de recebimento. | Opcional |
| Condição de pagamento | Texto | Conferir os termos comerciais. | Opcional |
| Qtd. de itens | Número | Dimensionar o tamanho do documento. | Opcional |
| Comprador responsável | Avatar + nome | Filtrar pela carteira do comprador. | Opcional |
Status semânticos
Status é sempre um badge com cor semântica — nunca texto solto. A paleta é fixa: cada tipo de documento mapeia o seu ciclo nestes cinco tons, então a leitura é a mesma em qualquer linha, seja Requisição, Pedido ou Nota Fiscal.
| Status | Significado | Exemplos por tipo de documento |
|---|---|---|
| Concluído | liberado, sem pendências | Aprovado · Vigente · Confirmado · Aceito · Pago |
| Aguardando | requer ação ou atenção | Em aprovação · Aguardando resposta · Parcialmente confirmado · A pagar |
| Em curso | em execução, ainda aberto | Em andamento · Criado · Publicado · Aberto |
| Cancelado | recusado, vencido ou interrompido | Cancelado · Recusado · Vencido · Bloqueado |
| Rascunho | sem efeito no fluxo | Rascunho · Fechado · Finalizado · Encerrado |
Cada tipo de documento (Requisição, Cotação, Pré-Pedido, Pedido, Contrato, FRS, Nota Fiscal, Conta, Leilão) tem o seu próprio ciclo — a árvore completa por status fica na Sidebar. O rótulo de cada status vive na página da entidade.
Filtros
Filtrar a index acontece em camadas que se somam — da busca livre ao recorte estruturado — e todas refletem na listagem na hora, sem recarregar a tela. A mecânica dos critérios (chips, operadores, salvar) vive no padrão Filtrar; aqui está o que cada superfície da tela resolve.
Busca
Campo no subheader. Filtro textual rápido — casa número, título ou solicitante; é o gatilho do Command Palette.
Command Palette (Filter Search)
Overlay que a busca abre: busca direta por registro, aplicar um filtro salvo ou montar um critério (Critério → Operador → Valor). Mecânica em Filtrar.
Critérios (Filter Bar)
Filtros estruturados na barra acima da tabela. Os três primeiros visíveis; o resto recolhe em “Mais filtros”.
Recortes da sidebar
Favoritos, Pendências e atalhos por status aplicam um recorte pronto num clique — sem montar critério.
Filtros salvos
Combinações de critérios salvas e reaplicáveis; ficam em Favoritos, na sidebar.
Critérios da Filter Bar
Os critérios estruturados que recortam a listagem. Status já entra pré-aplicado em "Em aberto" — o recorte mais comum de quem opera.
| Filtro | Controle | Quando ajuda |
|---|---|---|
| Status | Multi-select | Recorta por etapa do fluxo; já vem pré-aplicado em “Em aberto”. |
| Tipo | Multi-select | Requisição, Cotação, Pré-Pedido, Pedido, Contrato, Leilão ou Nota Fiscal. |
| Período | Intervalo de datas | Limita a janela de criação do documento. |
| Solicitante | Typeahead | Encontra os documentos abertos por uma pessoa. |
| Fornecedor | Typeahead | Recorta pela contraparte da transação. |
| Faixa de valor | Range | Prioriza por materialidade (do maior ao menor). |
As ações da index estão detalhadas na aba Ações.
Contextos
As situações reais da index de Transações — o que o usuário faz e como a tela responde.
O CTA primário é um split: o clique cria o tipo padrão; o caret abre a lista de tipos de documento (Requisição, Cotação, Pré-Pedido, Pedido…). Cada tipo abre o seu fluxo de criação.
Quando o filtro ou a busca não retorna nada, a área de conteúdo mostra um empty state contextual (com o termo aplicado) e uma saída clara para limpar os filtros.
Exportar a listagem filtrada (ou a seleção) gera um arquivo respeitando filtros e colunas atuais; um toast com barra de progresso acompanha a geração e some ao concluir.
Cancelar sempre exige motivo. O campo de motivo é obrigatório — o botão de confirmação fica desabilitado enquanto vazio.
Widgets e gráficos nascem de uma coluna ou do Dashboard e ficam numa faixa colapsável («Meus widgets») acima da listagem. O usuário recolhe a faixa ou arrasta um widget para fixar na sidebar — não ficam lá por padrão.
Clicar no número (link) de uma transação abre o documento em um modal sobre a listagem, sem sair da index. No mobile o modal vira um modal-sheet que sobe de baixo, deixando o header da index aparente atrás (overlay); o ícone expandir abre o formato page. O modal traz a navegação entre documentos, as ações do documento e as abas do registro.
Como os documentos aparecem em cada view
A index de Transações oferece três modos (não há Card — documentos não têm imagem). Cada modo abaixo, com a ilustração de como os documentos ficam.
Tabela
PadrãoDensidade máxima — Número, Tipo, Solicitante, Fornecedor, Valor e Status em colunas comparáveis lado a lado (configuráveis em "Editar colunas").
Lista
Linha mais alta com ícone do tipo, Número, Solicitante, Data e Status — troca colunas por reconhecimento rápido do documento.
Requisição
4356776543
Criado em 19/08/2026
Categoria RFI · Responsible Buyer: Marcel Lottito
(11) 98329911 · (12) 24563946
john.doe@me.com.br · www.site.com.br
Cotação
1234567891
Criado por Administrador FAST1
Criado em 24/02/2026
Data Limite para Resposta 12/11/2025 09:39:44
john.doe@me.com.br · www.site.com.br
Pedido
ME_4600068466
Flavio Cabral
(11) 983857412
flavio.cabral@me.com.br
Contrato
14499712
CNPJ: 07.418.787/0001-55
Avenida Engenheiro Alberto Massa, 432 CJ 99 – Centro, São Paulo – SP, CEP 01234-567
(11) 98329911 · (12) 24563946
john.doe@me.com.br · www.site.com.br
Preview
Mestre-detalhe: lista à esquerda e o documento aberto à direita (Informações gerais, Históricos, Itens) — revisa e age sem sair da listagem.
Cotação em andamento
Propostas abertas até o prazo — acompanhe as respostas dos fornecedores.
Cotação
1234567891
Criado por Administrador FAST1
Criado em 24/02/2026
Data Limite para Resposta 12/11/2025 09:39:44
john.doe@me.com.br · www.site.com.br
Entrega
COD_LOCAL_XX — Filial São Paulo
Av. das Indústrias, 1200 — Centro
CEP 04001-000
CNPJ 12.345.678/0001-90
Requisitante
Nº da requisição
4356776543
Centro de custo
Manutenção — 4021
Empresa
Matriz — SP
Data de criação
19/08/2026
Data de entrega
02/09/2026
Anexos
Histórico de aprovações
19/08/2026 09:12 · Marina Lopes
Requisição criada.
20/08/2026 14:38 · Carlos Dias
Enviada para aprovação.
21/08/2026 10:05 · Administrador FAST1
Aprovada — liberada para cotação.
Interação comum às views: ordenar por coluna, selecionar linhas pelo checkbox e abrir as ações por linha no menu ⋮. No Preview, selecionar um item atualiza o detalhe ao lado, sem voltar à index.
Ações
Como os padrões de Ações do usuário se aplicam à index de Transações. Regra de feedback: ações reversíveis usam toast com Desfazer; o cancelamento (irreversível) exige modal de confirmação.
As ações se distribuem em três zonas: ① o Subheader reúne o CTA principal e Mais ações; ② a barra de filtros expõe as ações em massa quando há linhas selecionadas; ③ o menu ⋮ ao fim de cada linha traz as ações por documento.
Ações por linha (menu de mais ações)
Cada documento traz um menu ⋮ no fim da linha, ordenado por frequência. Ver e Duplicar em qualquer status; Enviar p/ aprovação só em Rascunho. A destrutiva (Cancelar, com modal de motivo) fica isolada após um divisor.
Ações em massa
Ao marcar linhas, a filter bar exibe a badge "X selecionados" — um toggle que desabilita os filtros aplicados e expõe Salvar lista e Limpar seleção. O subheader não muda e nenhuma CTA nova aparece. Ver Ações em massa.
Feedback
O retorno é proporcional ao impacto: confirmação com contagem para ações em lote, toast com Desfazer para o reversível e modal para o irreversível (cancelar). O catálogo completo de retornos está em Geral; abaixo, as particularidades de Transações.
Confirmação com contagem
Após uma ação em massa, um toast informa o resultado com a contagem explícita — nunca um "Concluído" genérico.
Desfazer (ações reversíveis)
Ações reversíveis (remover um fornecedor de uma cotação, arquivar) executam na hora e mostram um toast com "Desfazer" por 5s, com barra de progresso — dispensa modal de confirmação.
| Cenário | Mecanismo de feedback |
|---|---|
Critério aplicado | Reflete na Filter Bar na hora, sem recarregar a tela. |
Ação reversível | Toast com Desfazer (remover fornecedor, arquivar). |
Ação em lote | Toast com a contagem ("3 cotações enviadas"). |
Cancelar documento | Modal de confirmação com motivo obrigatório (irreversível). |
Exportar seleção | Indicador de progresso durante a geração. |