Aprovar pagamentos
Aprovar pagamentos (/payables/approvals) é o portão de entrada das contas a pagar: um título novo — criado por formulário, CSV ou API — não entra na lista oficial até que alguém aprove.
É a trava contra lançamento indevido — nada que uma pessoa (ou a API) crie como obrigação nova vira dinheiro a sair sem um segundo par de olhos. Vem ligada por padrão e pode ser desligada por espaço de trabalho (ver Ligar ou desligar).
Onde fica
Menu Financeiro → Aprovar pagamentos, logo abaixo de Contas a pagar.
O item mostra um badge com o número de títulos aguardando — só os aguardando, não os já aprovados ou recusados. O número respeita a empresa selecionada no cabeçalho.
Ligar ou desligar
A aprovação é uma configuração do espaço de trabalho, e vem ligada por padrão. O controle fica no canto superior direito desta tela — o botão "Exigir aprovação", com um ícone de informação ao lado que abre a explicação dos dois estados.
| Estado | O que acontece ao criar um título |
|---|---|
| Ligada (padrão) | Entra na fila e só vira oficial depois que alguém aprova — vale tudo o que esta página descreve. |
| Desligada | Entra direto na lista oficial de contas a pagar, sem passar por aqui. |
O interruptor governa só títulos novos. Desligar não libera o que já está aguardando, e ligar não puxa para a fila o que já é oficial; títulos recusados continuam bloqueados.
O que o portão bloqueia
Enquanto aguarda aprovação, o título existe mas fica fora de tudo:
- Não aparece na lista de Contas a pagar
- Não conta em totais, em vencidos, no fluxo de caixa, nos relatórios nem na Visão geral
- Não pode ser enviado ao banco
- Não aceita baixa manual — "Marcar como pago" não aparece
Ou seja: para o resto do sistema, ele ainda não é uma obrigação.
Quem passa pelo portão
| Origem | Passa? |
|---|---|
Formulário (/payables/new) | Sim |
| Importação de CSV | Sim |
| API | Sim |
| Publicar um rascunho | Sim — salvar como rascunho não é um atalho para escapar |
| Parcelas de recorrência geradas automaticamente | Não |
| Títulos importados do Fintera | Não |
| Títulos anteriores à criação do portão | Não |
A regra em uma frase: tudo que alguém cria como obrigação nova passa; tudo que é derivado, sincronizado ou legado já nasce oficial.
A tela
Três abas, cada uma com seu contador:
| Aba | Lista |
|---|---|
| Aguardando | A fila que precisa do seu ok, ordenada por vencimento |
| Aprovados | Histórico, do mais recente |
| Recusados | Histórico, do mais recente, com o motivo |
Colunas: Descrição (com o fornecedor abaixo, e o motivo da recusa na aba Recusados), Origem, Vencimento, Status e Valor. Em "todas as empresas" entra também a coluna Empresa.
A busca cobre descrição e nome do fornecedor.
Origem
Diz de onde o título veio, e é o campo que sustenta a decisão:
- Manual — criado no formulário ou pela API
- Importação CSV — veio de um arquivo
Aprovar
Só na aba Aguardando, por três caminhos:
- Botão Aprovar na própria linha
- Menu de ações da linha
- Em lote — marque as linhas e use Aprovar selecionados (até 25 por vez)
O diálogo Aprovar pagamento? confirma: "1 pagamento será aprovado e entra na lista de contas a pagar."
Aprovar não envia ao banco. O título passa a ser oficial e entra na lista — o envio é um passo separado, feito em Contas a pagar. Ver Envio ao banco.
Numa aprovação em lote, uma falha isolada não derruba as demais.
Recusar
Pelo menu de ações da linha — não há recusa inline nem em lote.
O diálogo Recusar pagamento? avisa: "O título fica bloqueado para sempre e nunca entra na lista de contas a pagar. Registre o motivo (opcional)."
O motivo é opcional (até 500 caracteres), mas é o que a aba Recusados vai exibir depois — sem ele, o histórico não explica a decisão.
Recusar não tem volta pela interface. Um título recusado não pode ser aprovado depois e não pode ir ao banco. Ele fica na aba Recusados como registro, e nada mais.
As abas Aprovados e Recusados não têm ações — são auditoria. Clicar na descrição abre o título.
Quem pode aprovar
Qualquer pessoa com acesso ao espaço de trabalho. Não existe um papel de "aprovador", e não há trava impedindo que quem criou o título o aprove. O portão registra quem aprovou e quando; ele separa os dois momentos, não necessariamente as duas pessoas.
Aprovar também não é exposto na API — é ação exclusiva da tela.
Como o estado aparece em Contas a pagar
Na listagem de Contas a pagar, um título aprovado exibe um selo redondo com um escudo; passe o mouse para ler "Criação aprovada", seguido de quem aprovou e quando — é ali que a auditoria fica à mão, sem abrir o título. Os demais estados não aparecem ali — pela própria regra do portão, eles não chegam à lista.
Depois que o título é enviado ao banco, o selo dá lugar ao status do gateway.