Fornecedores¶
A tela de Fornecedores permite cadastrar, consultar e editar os fornecedores da empresa, além de registrar pagamentos efetuados e visualizar o extrato de conta-corrente.
Como abrir¶
- Menu: Pessoas → Fornecedores
- Atalho de teclado:
Ctrl+Shift+P
Layout da tela¶
A tela usa um layout mestre-detalhe:
- Painel esquerdo — lista de fornecedores dividida em duas seções: ativos (visíveis por padrão) e inativos (exibidos com opacidade reduzida). No topo há um campo de pesquisa por nome e um botão Adicionar (
+) para criar um novo fornecedor. - Painel direito — exibe um estado vazio ao iniciar. Ao selecionar um fornecedor (ou clicar no botão
+), aparece um cabeçalho com nome e número, seguido de três abas: Detalhes, Pagamentos e Extrato.
O divisor entre os painéis pode ser arrastado para ajustar a largura.
Aba Detalhes — Referência de campos¶
Geral¶
| Campo | Descrição |
|---|---|
| Nº Fornecedor | Identificador numérico único, atribuído automaticamente. Só de leitura. |
| Nome | Razão social ou nome completo do fornecedor (obrigatório). |
| Nome Fantasia | Nome comercial ou nome fantasia. |
| Descontinuado | Interruptor que marca o fornecedor como inativo. |
Contacto e Endereço¶
| Campo | Descrição |
|---|---|
| Contacto | Nome da pessoa de contacto no fornecedor. |
| Telefone | Número de telefone principal. |
| Endereço de correio electrónico. | |
| Endereço | Logradouro (rua, avenida, etc.). |
| Número | Número do endereço. |
| Complemento | Complemento do endereço (bloco, sala, etc.). |
| Bairro | Bairro ou distrito. |
| Estado | Unidade federativa (UF). |
| Cidade | Município. |
| CEP | Código de endereçamento postal. |
Financeiro e Fiscal¶
| Campo | Descrição |
|---|---|
| CNPJ/CPF | Número de identificação fiscal do fornecedor. |
| Inscrição Estadual | Número de registo estadual. |
| Saldo | Saldo actual do fornecedor. Só de leitura. |
CPF/CNPJ
O campo CPF/CNPJ aceita tanto CPF (pessoas físicas, 11 dígitos) como CNPJ (pessoas jurídicas, 14 dígitos). A validação completa será implementada numa atualização futura.
Notas¶
| Campo | Descrição |
|---|---|
| Detalhes | Campo de texto livre para observações internas sobre o fornecedor. |
Aba Pagamentos¶
A aba Pagamentos exibe o ledger de pagamentos efetuados (AP) ao fornecedor selecionado. Os dados são carregados na primeira vez que a aba é aberta para cada fornecedor.
Referência de campos e cenários complexos
O modal de adicionar/editar é documentado na página Modal de Pagamento, que também cobre parcelas e pagamentos em bloco para várias ordens de compra.
Filtro de status¶
Use o seletor no topo da aba para filtrar os pagamentos:
| Opção | O que exibe |
|---|---|
| Todos | Todos os pagamentos registrados. |
| Pago | Apenas pagamentos com data de pagamento preenchida. |
| Pendentes | Apenas pagamentos sem data de pagamento. |
Colunas da grade¶
| Coluna | Descrição |
|---|---|
| Ordem de Compra | Número da ordem de compra relacionada, se houver. |
| Usuário | Usuário que registrou o pagamento. |
| Método | Forma de pagamento (DINHEIRO, PIX, TRANSFERÊNCIA, etc.). |
| Parcela | Número da parcela (ex.: 2/3), para pagamentos parcelados. |
| Valor | Valor do pagamento. |
| Vencimento | Data de vencimento. Vermelho = vencido, verde = a vencer, âmbar = hoje. |
| Pago em | Data em que o pagamento foi efetuado. Vazio se ainda pendente. |
| Referência | Número de referência ou observação do pagamento. |
Adicionar um pagamento¶
- Selecione o fornecedor no painel esquerdo.
- Clique na aba Pagamentos.
- Clique em Adicionar pagamento.
- Preencha os campos na janela modal: ref. nº pedido, método, valor, parcela (se aplicável), vencimento, data de pagamento e referência.
- Clique em Salvar.
Editar ou excluir um pagamento¶
Clique no ícone de lápis (✏) para editar ou no ícone de lixeira (🗑) para excluir um pagamento.
Permissões
- Usuários sem permissão
sales:manageouownersó podem editar os próprios pagamentos com data de pagamento igual a hoje ou no futuro. Pagamentos de outros usuários ou com data já passada exigem privilégio elevado. - O mesmo privilégio é exigido para registrar um pagamento com data de pagamento anterior a hoje (retroativa). Datas futuras são bloqueadas para todos — não há exceção por privilégio.
Pagamentos offline
Pagamentos requerem conexão com o servidor. Em modo offline, a operação não é concluída e um aviso é exibido.
Cheques de fornecedores
O endosso de cheques para fornecedores é um recurso planejado e será adicionado em uma atualização futura.
Carregar mais¶
A grade exibe até 20 pagamentos por vez. Clique em Carregar mais para buscar o próximo lote de registros.
Aba Saldo¶
A aba Saldo exibe o extrato de conta-corrente do fornecedor selecionado, combinando ordens de compra e pagamentos em ordem cronológica. Os dados são carregados na primeira vez que a aba é aberta para cada fornecedor.
Tipos de lançamento¶
| Linha | Aparência | Valor | Significado |
|---|---|---|---|
| Ordem de compra recebida | Vermelho (débito) | Valor da ordem de compra | Mercadorias recebidas; o valor é debitado na conta. |
| Ordem de compra aguardando | Itálico, sombreado (informação) | Zero | Pedido efetuado mas ainda não recebido; exibido apenas como referência de atividade. |
| Pagamento | Verde (crédito) | Valor pago | Pagamento efetuado ao fornecedor. |
Colunas¶
| Coluna | Descrição |
|---|---|
| Data | Data do lançamento (data de recebimento para ordens de compra, data de pagamento para pagamentos). |
| Tipo | Tipo de entrada (Ordem de Compra ou Pagamento). |
| Descrição | Descreve o lançamento: status recebido/aguardando com número da ordem, ou método de pagamento. |
| Débito | Valor debitado para ordens de compra recebidas. |
| Crédito | Valor pago ao fornecedor. |
| Saldo | Saldo acumulado até esta linha. Saldo negativo indica que a empresa deve ao fornecedor. |
Barra de ferramentas¶
- Período — intervalo de datas dos lançamentos exibidos.
- Total recebido — soma de todos os créditos de pagamento na visualização atual.
- Total comprado — soma de todos os débitos de ordens de compra recebidas na visualização atual.
- Somente lançamentos financeiros — oculta os lançamentos de ordens aguardando (valor zero) para focar nas entradas que afetam o saldo.
Cálculo do saldo¶
O saldo acumulado reflete a posição da conta: pagamentos efetuados menos o valor total de todas as ordens de compra (recebidas ou aguardando). Saldo negativo significa que foram realizadas mais compras do que pagamentos — situação normal para fornecedores com faturas em aberto.
Paginação¶
O extrato é paginado por data descendente, exibindo até 50 lançamentos por vez. Se houver entradas anteriores ao período atual, o botão Carregar período anterior aparece abaixo da tabela. Clique nele para adicionar os lançamentos mais antigos acima dos já exibidos.
Tarefas comuns¶
Adicionar um novo fornecedor¶
- Clique no botão
+na barra de ferramentas do canto superior esquerdo (ao lado do campo de pesquisa). - Um formulário em branco abre no painel direito com o cabeçalho "Novo Fornecedor".
- Preencha ao menos o campo Nome (obrigatório pelo banco de dados).
- Complete os demais campos nas seções Geral, Contato e Endereço, Financeiro e Fiscal e Notas, conforme necessário.
- Clique em Salvar. O novo fornecedor é criado, aparece na lista do painel esquerdo e é selecionado automaticamente.
Clique em Cancelar a qualquer momento antes de salvar para descartar o novo registro e voltar ao estado vazio.
Permissões
A criação de um novo fornecedor requer permissão owner. O botão + é visível a todos os usuários, mas o salvamento será recusado se o usuário logado não tiver a permissão necessária.
Editar um fornecedor¶
- No painel esquerdo, localize o fornecedor pelo campo de pesquisa ou percorrendo a lista.
- Clique no nome do fornecedor para carregar os dados no formulário à direita.
- Edite os campos desejados na aba Detalhes.
- Clique em Salvar.
Cada gravação gera automaticamente um registro no log de auditoria.
Registrar um pagamento a um fornecedor¶
- Selecione o fornecedor no painel esquerdo.
- Clique na aba Pagamentos.
- Clique em Adicionar pagamento, preencha os campos e clique em Salvar.
Desativar um fornecedor¶
- Selecione o fornecedor na lista.
- Na aba Detalhes, ative o interruptor Descontinuado.
- Clique em Salvar.
Desativação
Desativar um fornecedor não elimina seus dados nem o histórico de transações associado. O fornecedor deixa de aparecer nas listas de seleção mas continua consultável nesta tela.
Fornecedores inativos aparecem na seção inferior da lista com opacidade reduzida.