Cadastro de Conta a Receber
Módulo: Financeiro Caminho na aplicação: Menu > Financeiro > Contas a Receber > "Nova conta" ou botão Editar Última atualização: 20/04/2026
Para que serve
Permite criar contas a receber manualmente — em uma ou múltiplas parcelas — e editar contas manuais existentes. Contas geradas por faturamento de pedido de venda não podem ser editadas por aqui.
Quem pode usar
Usuários com acesso ao módulo Financeiro.
Como usar (passo a passo)
Criar nova conta
- Na Lista de Contas a Receber, clique em Nova conta.
- Selecione o Cliente. Se o cliente ainda não existir, clique em Novo cliente para cadastrá-lo rapidamente.
- Preencha os dados da conta (filial, documento, forma de pagamento, datas, valor e parcelas).
- Se informar mais de 1 parcela, o sistema exibe um resumo com o valor por parcela.
- Clique em Criar.
- 1 parcela: o sistema redireciona para o Detalhe da conta criada.
- Mais de 1 parcela: o sistema retorna para a Lista de Contas a Receber.
Editar conta existente
- No Detalhe de Conta a Receber, clique em Editar (disponível apenas para contas manuais sem baixas).
- Altere os campos desejados. A filial não pode ser alterada na edição.
- Clique em Salvar. O sistema permanece na tela com os dados atualizados.
A edição altera apenas a parcela atual. Para criar novas parcelas, use o formulário de criação.
Campos da tela
Seção — Cliente
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Cliente | Sim | Busca por nome ou documento | Campo com pesquisa; exibe nome e CPF/CNPJ |
| Novo cliente (botão) | — | — | Abre modal de cadastro rápido de cliente |
Seção — Dados da conta
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Filial | Sim | Lista suspensa | Desabilitado na edição |
| Número do documento | Não | Texto livre (ex.: DUP-12345) | Até 30 caracteres; gerado automaticamente como CR<id_interno> se vazio |
| Forma de pagamento | Não | Lista de formas ativas | Opcional |
| Data de emissão | Sim | Data (DD/MM/AAAA) | Pré-preenchida com a data atual na criação |
| Vencimento da 1ª parcela | Sim | Data (DD/MM/AAAA) | Pré-preenchida com D+30 na criação; na edição o campo se chama "Vencimento" |
| Valor total | Sim | Valor monetário (R$) | Mínimo R$ 0,01 |
| Parcelas | Sim (criação) | Número inteiro | Mínimo 1, máximo 120; oculto na edição |
| Intervalo (dias) | Não (criação) | Número inteiro | Entre 0 e 365; ignorado se parcelas = 1; oculto na edição |
| Observações | Não | Texto livre | Até 500 caracteres |
Validações e regras
- Cliente é obrigatório ("Selecione um cliente").
- Filial é obrigatória ("Selecione a filial").
- Data de emissão é obrigatória ("Obrigatorio").
- Vencimento é obrigatório ("Obrigatorio").
- Valor total é obrigatório ("Obrigatorio") e mínimo R$ 0,01.
- Parcelas é obrigatório ("Obrigatorio") na criação.
- Quando
parcelas > 1, o sistema divide o valor total igualmente; o resíduo de centavos vai na última parcela. - O campo Intervalo (dias) fica desabilitado quando
parcelas = 1. - Contas geradas por pedido de venda são redirecionadas para o detalhe com a mensagem "Contas geradas por pedido nao podem ser editadas".
- Ao salvar com
parcelas > 1, o sistema retorna à lista em vez de abrir o detalhe (pois foram criados vários registros).
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Selecione um cliente" | Campo Cliente em branco | Selecione ou cadastre um cliente |
| "Selecione a filial" | Campo Filial em branco | Selecione a filial |
| "Obrigatorio" | Campo de data ou valor em branco | Preencha o campo indicado |
| "Conta atualizada com sucesso" | Confirmação de sucesso na edição | — |
| "Conta criada" | Confirmação de sucesso (1 parcela) | — |
{N} parcelas criadas | Confirmação de sucesso (múltiplas parcelas) | — |
| "Contas geradas por pedido nao podem ser editadas" | Tentativa de editar conta de pedido | Use o Detalhe para registrar baixas |
| "Erro ao carregar conta a receber" | Falha ao buscar o registro para edição | Recarregue a página |
| — | Validações do servidor | Verifique os dados e tente novamente |
Integrações e dependências
- Clientes: cadastro via modal rápido ou vínculo com cadastro existente em
- Filiais: cadastradas no módulo de configuração da empresa.
- Formas de pagamento: cadastradas em
- Conta criada aparece na Lista de Contas a Receber e no Fluxo de Caixa.
Dúvidas frequentes
Posso criar uma conta já paga? Não diretamente. Crie a conta e, em seguida, acesse o detalhe e registre a baixa.
O número do documento é obrigatório? Não. Se deixado em branco, o sistema gera automaticamente no formato CR<id_interno> (ex.: CR47).
Como criar uma conta parcelada? Preencha o campo Parcelas com o número de parcelas e o campo Intervalo (dias) com quantos dias separam cada parcela. O sistema cria todos os registros automaticamente.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |