Adiantamento de Cliente
Adiantamento de Cliente
Registre valores que um cliente antecipa ao pagar antes de existir uma venda ou fatura formal vinculada a esse pagamento, gerando automaticamente lançamentos financeiros e títulos a receber em aberto.
Visão Geral do Adiantamento de Cliente
O Adiantamento de Cliente é uma rotina do módulo Financeiro, dentro do grupo “Transferências”, usada para registrar valores que um cliente antecipa ao pagar antes de existir uma venda ou fatura formal vinculada a esse pagamento. Ao registrar o adiantamento, o sistema lança automaticamente o dinheiro recebido no caixa ou banco e, ao mesmo tempo, cria um título a receber que fica em aberto, representando esse valor antecipado.
Esse título em aberto não é quitado por esta própria rotina. Ele fica “pendurado” no sistema até que, em um momento posterior, seja compensado (baixado) contra um título a receber real do mesmo cliente, gerado por exemplo a partir de uma venda ou fatura. Essa baixa é feita por uma rotina irmã, chamada “Compensação de Recebimento x Adiantamento de Cliente”, localizada em Extra-Caixa > Compensações, que não faz parte desta documentação.
Esta rotina trabalha exclusivamente com adiantamentos recebidos de clientes (Contas a Receber). O adiantamento pago a fornecedores (Contas a Pagar) é tratado por outra rotina do sistema, mesmo utilizando internamente uma lógica parecida.
Vídeo Tutorial do Adiantamento de Cliente
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso do Adiantamento de Cliente
O acesso à tela de Adiantamento de Cliente é controlado por permissão específica, associada ao grupo de menu “Transferências”. Para visualizar e usar a tela, o usuário precisa ter a permissão de acesso liberada pelo administrador do sistema. Além disso, existem permissões separadas para cada ação dentro da tela:
- Permissão para salvar (registrar) um adiantamento.
- Permissão para imprimir o comprovante do adiantamento.
Ou seja, é possível que um usuário tenha acesso à tela apenas para consulta/impressão, sem ter permissão para efetivamente registrar novos adiantamentos, dependendo de como o administrador configurou os perfis de acesso.
Cadastros Pré-requisitos
Para registrar um adiantamento, alguns cadastros já precisam existir previamente no sistema, pois são selecionados na tela a partir de listas já cadastradas:
- A carteira (conta bancária ou caixa) que vai receber o valor.
- A forma de cobrança que será usada na operação.
- O participante (cliente) que está fazendo o adiantamento.
Processo de Criação: Passo a Passo do Adiantamento de Cliente
Acessar a tela de Adiantamento de Cliente
O usuário acessa a tela de Adiantamento de Cliente, localizada dentro do grupo de menu “Transferências”, no módulo Financeiro.
Informar a filial
O usuário informa (ou já vê preenchida) a filial da operação. Esse valor é apenas informativo na tela: o sistema sempre grava, de fato, a filial do usuário que está logado no momento em que o adiantamento é salvo, independentemente do que estiver preenchido nesse campo (ver Regra 3, na seção de Regras de Negócio).
Selecionar a carteira
O usuário seleciona a carteira (conta bancária ou caixa) na qual o valor do adiantamento vai entrar. Esse campo é obrigatório.
Selecionar o participante (cliente)
O usuário seleciona o cliente que está realizando o adiantamento.
Informar o valor do adiantamento
Quando o adiantamento não será pago com cheque de terceiros, o usuário informa o valor recebido (e, se aplicável, o valor na moeda utilizada, caso diferente da moeda padrão do sistema).
Selecionar a forma de cobrança
O usuário seleciona a forma de cobrança da operação. Esse campo é obrigatório, pois esta rotina sempre trabalha no contexto de Contas a Receber.
Informar a data de lançamento
O usuário informa a data em que o lançamento deve ser considerado.
Informar o documento e a observação
O usuário pode informar um número/identificação de documento e uma observação livre sobre o adiantamento.
Informar cheques de terceiros (quando aplicável)
Caso o adiantamento seja pago com um ou mais cheques de terceiros, o usuário informa os dados dos cheques na tela, incluindo a série e o número do cheque (nesta rotina, diferente do fluxo de adiantamento de fornecedor, a série e o número do cheque são os informados pelo próprio usuário, e não gerados automaticamente pelo sistema). Se nenhum cheque for informado, o sistema entende que o pagamento é em carteira (dinheiro/depósito direto na conta).
Confirmar o salvamento
O usuário clica em Salvar. O sistema valida os dados informados (ver Regras de Negócio) e, se tudo estiver correto, processa o adiantamento dentro de uma única operação: gera a numeração do documento, cria o título a receber em aberto, gera os lançamentos financeiros (crédito e débito) e envia as informações necessárias para a integração contábil. Se qualquer etapa falhar, nada é gravado e o usuário recebe uma mensagem de erro.
Imprimir o comprovante (opcional)
Caso o usuário deseje, pode solicitar a impressão do comprovante do adiantamento. O sistema prepara o modelo de impressão (comprovante de caixa de adiantamento) para geração do documento impresso. Essa ação apenas prepara o arquivo de impressão e não grava nem altera nenhum dado do adiantamento.
Descrição de Cada Campo da Tela do Adiantamento de Cliente
Filial
Descrição: Indica a filial da empresa à qual o adiantamento está vinculado.
Comportamento: Mesmo que o usuário selecione uma filial diferente, o sistema sempre substitui esse valor pela filial do usuário que está logado no momento em que o adiantamento é salvo. Se nenhuma filial estiver disponível (nem informada, nem identificável pelo usuário logado), a operação é bloqueada com a mensagem “Não foi possível incluir Adiantamento, Para gerar um título de adiantamento é obrigatório informar filial e carteira”.
Impacto: Define em qual filial o título a receber e os lançamentos financeiros/contábeis do adiantamento serão registrados.
Carteira
Descrição: Representa a conta bancária ou o caixa que vai receber o valor do adiantamento.
Comportamento: A carteira selecionada precisa pertencer à mesma filial da operação, exceto quando a carteira for do tipo Caixa, caso em que essa exigência não se aplica. Se a carteira não for informada, a operação é bloqueada com a mensagem “Não foi possível incluir Adiantamento, Para gerar um título de adiantamento é obrigatório informar filial e carteira”. Se a carteira pertencer a uma filial diferente da informada para o título (e não for do tipo Caixa), a operação é bloqueada com a mensagem “Não foi possível incluir Adiantamento, A carteira informada pertence a uma filial diferente da que foi informada para o título”.
Impacto: Determina em qual conta/caixa o lançamento financeiro de entrada do valor será registrado.
Participante (Cliente)
Descrição: Identifica o cliente que está realizando o adiantamento junto à empresa.
Comportamento: [informação não disponível na documentação de origem, validar com analista responsável] sobre validações específicas de preenchimento deste campo. Contudo, é indispensável na prática, pois o adiantamento é sempre vinculado a um cliente específico.
Impacto: O título a receber gerado fica vinculado a este cliente, e é ele quem futuramente terá esse valor compensado contra um título real (venda/fatura) na rotina de Compensação.
Valor
Descrição: Valor do adiantamento recebido do cliente, em moeda corrente.
Obrigatoriedade: Obrigatório quando o adiantamento não é pago com cheque de terceiros; quando há cheque(s) de terceiros informado(s), o valor considerado é o dos próprios cheques, e não este campo.
Comportamento: É o valor usado para compor o título a receber gerado e a movimentação financeira de crédito do adiantamento, no sub-fluxo sem cheque de terceiros.
Impacto: Aparece no título a receber gerado, nos lançamentos financeiros e no reflexo contábil da operação; é também o valor que futuramente poderá ser compensado contra um título real do cliente.
Valor na Moeda
Descrição: Valor do adiantamento expresso na moeda selecionada para a operação, quando diferente da moeda padrão do sistema.
Obrigatoriedade: Condicional – usado junto com o campo Valor, quando não há cheques de terceiros informados.
Comportamento: [informação não disponível na documentação de origem, validar com analista responsável] sobre eventual cálculo automático de conversão entre moedas.
Impacto: Utilizado na composição do título a receber e da movimentação financeira do adiantamento, quando aplicável.
Moeda
Descrição: Identifica a moeda utilizada na operação de adiantamento.
Comportamento: Se nenhuma moeda for selecionada, o sistema assume automaticamente a moeda padrão do sistema.
Impacto: Define em qual moeda o valor do adiantamento é registrado no título e nos lançamentos financeiros.
Forma de Cobrança
Descrição: Identifica a forma de cobrança que será associada ao título de adiantamento gerado.
Comportamento: Como esta rotina sempre opera no contexto de Contas a Receber, este campo é sempre exigido. Se não for informado, a operação é bloqueada com a mensagem “Não foi possível incluir Adiantamento” – “Para gerar um título de adiantamento é obrigatório informar uma forma de cobrança.” – “Código informado: [código da forma de cobrança informada]. Favor informe uma forma de cobrança para operação”.
Impacto: Fica associada ao título a receber gerado pelo adiantamento.
Data de Lançamento
Descrição: Data em que a operação de adiantamento é considerada lançada no sistema.
Comportamento: [informação não disponível na documentação de origem, validar com analista responsável] sobre validações específicas (por exemplo, se aceita datas futuras ou retroativas).
Impacto: Define a data de referência do título a receber e dos lançamentos financeiros gerados pelo adiantamento.
Documento
Descrição: Número ou identificação de documento informado pelo usuário para a operação de adiantamento.
Comportamento: Este campo é diferente da série e do número do documento do título, que são gerados automaticamente pelo sistema a partir da sequência de numeração configurada para a filial e o tipo de documento (ver campo “Documento Gerado pelo Sistema”, abaixo). Este campo é de preenchimento livre pelo usuário.
Impacto: Fica registrado como referência do documento informado na operação.
Observação
Descrição: Campo de texto livre para o usuário registrar informações adicionais sobre o adiantamento (por exemplo, a forma como o valor foi recebido).
Comportamento: Aceita texto livre, sem validação específica relatada na documentação de origem.
Impacto: Fica registrado junto ao título de adiantamento, servindo como anotação de apoio para consultas futuras.
Cheques de Terceiros
Descrição: Relação de cheques de terceiros usados para compor o pagamento do adiantamento, quando aplicável. Para cada cheque informado, o usuário digita a série e o número do próprio cheque (diferente de outros fluxos do sistema, aqui esses dados não são gerados automaticamente).
Obrigatoriedade: Opcional – a presença ou ausência de cheques informados determina qual dos dois fluxos internos de processamento o sistema utiliza (ver Regra 6, na seção de Regras de Negócio).
Comportamento: Quando pelo menos um cheque é informado, o sistema passa a considerar o valor do adiantamento a partir dos cheques informados, e não do campo Valor. Para cada cheque, o sistema gera a numeração do documento correspondente, cria um título a receber específico para o cheque (além do título do adiantamento) e registra o cheque no sistema.
Impacto: Gera um título a receber adicional (referente ao cheque) e duas movimentações financeiras (uma de crédito referente ao adiantamento e uma de débito referente à inclusão do cheque), ambas refletidas na contabilidade. [informação não disponível na documentação de origem, validar com analista responsável] quanto a outros campos do cheque eventualmente exibidos na tela (como banco, agência ou data de compensação).
Documento Gerado pelo Sistema (série e número)
Descrição: Série e número do documento do título de adiantamento (e do título do cheque, quando houver), atribuídos automaticamente pelo sistema a partir da sequência de numeração configurada para a filial e o tipo de documento.
Comportamento: No sub-fluxo sem cheque de terceiros, se não houver uma sequência de numeração ativa cadastrada para a filial e o tipo de documento, o sistema exibe a mensagem “Não foi encontrada uma sequencia de numeração ativa para a filial [ID da filial] e documento [ID do tipo de documento])”, mas mesmo assim continua processando o adiantamento normalmente (essa mensagem não bloqueia a operação).
Impacto: Identifica o título de adiantamento gerado para consultas futuras e para a compensação posterior contra um título real.
Utilização e Consulta de Registros do Adiantamento de Cliente
Processo de Edição do Adiantamento de Cliente
Isso é consistente com a lógica de negócio da rotina: o título gerado pelo adiantamento fica com status “Aberto” até ser tratado pela rotina de Compensação de Recebimento x Adiantamento de Cliente (Extra-Caixa > Compensações), que é quem baixa (encerra) esse título contra um título a receber real do cliente. Ou seja, o encerramento do adiantamento acontece por compensação em outra rotina, e não por uma edição direta do registro original.
Estrutura Técnica e Comportamento do Sistema do Adiantamento de Cliente
Processamento Automático Integrado
Ao salvar um adiantamento de cliente, o sistema executa uma série de ações automáticas, todas dentro de uma única operação: se qualquer parte dela falhar, nada fica gravado, e o usuário recebe uma mensagem de erro (isso evita que fique registrado, por exemplo, apenas o título sem o lançamento financeiro correspondente, ou vice-versa).
Ações Automáticas Executadas
- Gera a numeração do documento do título de adiantamento (série e número), a partir da sequência de numeração configurada para a filial e o tipo de documento.
- Cria o título a receber referente ao adiantamento, sempre com status “Aberto” (pendente), pois ele representa um valor recebido antecipadamente, ainda sem vínculo com uma venda ou fatura real.
- Gera os lançamentos financeiros da operação: um lançamento de crédito, referente à entrada do valor do adiantamento, e um lançamento de débito, referente à movimentação no banco/caixa (ou, quando há cheque de terceiros, referente à inclusão do cheque).
- Envia automaticamente para a contabilidade os lançamentos financeiros que devem gerar reflexo contábil. Quando o adiantamento não é pago com cheque de terceiros, apenas o lançamento de crédito do adiantamento gera reflexo contábil automático (o lançamento de débito do banco/caixa, neste caso, não gera lançamento contábil automático por esta rotina). Quando o adiantamento é pago com cheque de terceiros, tanto o lançamento de crédito do adiantamento quanto o de débito da inclusão do cheque geram reflexo contábil automático.
Essa geração automática de lançamentos financeiros e contábeis é o que garante que, assim que o usuário salva o adiantamento, o valor já apareça refletido no caixa/banco e na contabilidade da empresa, sem necessidade de lançamentos manuais adicionais.
Ciclo de Vida do Título de Adiantamento
O título de adiantamento criado por esta rotina não é encerrado por ela. Ele permanece em aberto até que a rotina de Compensação de Recebimento x Adiantamento de Cliente (Extra-Caixa > Compensações) localize esse título e um título a receber real do mesmo cliente, e realize a baixa (liquidação) de um contra o outro, gerando um novo lançamento financeiro e contábil específico para essa compensação. Essa rotina de compensação não faz parte desta documentação.
Regras de Negócio e Restrições do Adiantamento de Cliente
Filial e carteira são obrigatórias
Para registrar um adiantamento, é obrigatório informar a filial e a carteira. Se qualquer um desses dados estiver ausente, o sistema bloqueia a operação e exibe a mensagem “Não foi possível incluir Adiantamento, Para gerar um título de adiantamento é obrigatório informar filial e carteira”.
A carteira precisa pertencer à mesma filial do título
A carteira selecionada deve pertencer à mesma filial informada para o título, exceto quando a carteira for do tipo Caixa, caso em que essa exigência é dispensada. Se a carteira informada for de outra filial (e não for do tipo Caixa), o sistema bloqueia a operação com a mensagem “Não foi possível incluir Adiantamento, A carteira informada pertence a uma filial diferente da que foi informada para o título”.
A filial gravada é sempre a do usuário logado
Independentemente do que for selecionado no campo Filial da tela, o sistema sempre grava, de fato, a filial do usuário que está logado no momento em que o adiantamento é salvo.
A forma de cobrança é obrigatória
Como esta rotina sempre trabalha no contexto de Contas a Receber, é obrigatório informar uma forma de cobrança. Se esse campo não for preenchido, a operação é bloqueada com a mensagem “Não foi possível incluir Adiantamento” – “Para gerar um título de adiantamento é obrigatório informar uma forma de cobrança.” – “Código informado: [código da forma de cobrança informada]. Favor informe uma forma de cobrança para operação”.
Toda a operação é registrada de uma só vez, ou não é registrada
O registro do adiantamento (título, cheque quando houver, lançamentos financeiros e reflexo contábil) acontece como uma única operação. Se qualquer etapa falhar no meio do processo, nada é gravado, evitando que fique um registro incompleto no sistema (por exemplo, um título sem o lançamento financeiro correspondente).
O processamento muda conforme o adiantamento é pago com cheque de terceiros ou não
Quando há um ou mais cheques de terceiros informados: Para cada cheque, o sistema gera a numeração do documento, porém usa a série e o número do cheque exatamente como informados pelo usuário na tela (diferente de outros fluxos de adiantamento, em que essa numeração seria gerada automaticamente). São criados dois títulos a receber (um do adiantamento e outro do cheque), o registro do cheque, e duas movimentações financeiras (crédito do adiantamento e débito da inclusão do cheque), ambas com reflexo automático na contabilidade.
Quando não há cheque de terceiros (pagamento em carteira/dinheiro/depósito): O sistema gera a numeração do documento; se não existir uma sequência de numeração ativa cadastrada para a filial e o tipo de documento, é exibida a mensagem “Não foi encontrada uma sequencia de numeração ativa para a filial [ID da filial] e documento [ID do tipo de documento])”, mas o processamento continua normalmente mesmo assim. É criado um único título a receber e duas movimentações financeiras (crédito do adiantamento e débito do banco/caixa), mas apenas a movimentação de crédito do adiantamento gera reflexo automático na contabilidade; a movimentação do banco/caixa, neste caso, não gera lançamento contábil automático por esta rotina.
Erros inesperados interrompem a operação
Se ocorrer qualquer erro não previsto durante o processamento do adiantamento, a operação é interrompida por completo e o sistema exibe uma mensagem indicando “Falha na operação.” e “Verifique os dados e tente novamente.”, junto com o detalhe técnico do erro ocorrido.
Não é possível salvar um adiantamento sem informar ao menos um título a processar
Se a tela enviar o pedido de salvamento sem nenhuma informação de título (por exemplo, sem carteira e participante preenchidos), o sistema não chega a processar a regra de negócio e exibe a mensagem “Não foi possível Salvar” – “Alguns dados podem estar incorretos” – “Verifique se os dados informados estão corretos.”.
Esta rotina é exclusiva para adiantamentos recebidos de clientes
Esta tela sempre registra o adiantamento no contexto de Contas a Receber, ou seja, sempre como um valor recebido de um cliente. O adiantamento pago a um fornecedor (Contas a Pagar) é tratado por outra rotina do sistema e não pode ser registrado por aqui.