Mudanças entre as edições de "Adiantamentos"

(Conclusão)
Linha 1: Linha 1:
 
==='''Conceito'''===
 
==='''Conceito'''===
  
O adiantamento permite realizar a cobrança antecipada dos produtos ou serviços que ainda serão faturados, gerando automaticamente um documento de adiantamento vinculado à ordem de serviço ou ao pedido de venda.
+
O adiantamento permite realizar a cobrança antecipada de produtos ou serviços que ainda serão faturados, gerando automaticamente um documento de adiantamento vinculado ao pedido de venda ou à ordem de serviço de origem.
  
Esse recurso é utilizado quando existe a necessidade de receber parte ou a totalidade do valor antes da conclusão da execução. O documento gerado permanece vinculado ao respectivo adiantamento, garantindo sua rastreabilidade durante todo o processo de faturamento.
+
Esse recurso é utilizado quando existe a necessidade de receber parte ou a totalidade do valor antes da conclusão do faturamento ou da execução dos serviços.
 +
 
 +
Ao realizar um adiantamento, o sistema identifica automaticamente os valores ainda pendentes de adiantamento e gera o documento correspondente, mantendo o vínculo entre o documento de origem, o adiantamento e o documento financeiro/fiscal gerado. Dessa forma, todo o processo permanece rastreável até a conclusão do faturamento.
  
 
==='''Cadastro do Adiantamento'''===
 
==='''Cadastro do Adiantamento'''===
  
Ao incluir um novo adiantamento, o sistema sugere automaticamente o valor disponível para adiantamento e a forma de cobrança cadastrada no documento de origem. Caso necessário, essas informações podem ser alteradas pelo usuário.
+
Ao incluir um novo adiantamento, o sistema realiza automaticamente as validações necessárias e sugere o valor disponível para adiantamento, considerando os valores já adiantados e o saldo ainda pendente dos itens do documento de origem.
 +
 
 +
A forma de cobrança também é preenchida automaticamente conforme a configuração do documento de origem, podendo ser alterada pelo usuário.
  
 
Durante o cadastro devem ser informados os seguintes campos:
 
Durante o cadastro devem ser informados os seguintes campos:
*'''Sequencia:''' Sequencia numérica gerada automaticamente pelo sistema.
+
 
*'''Valor:''' Valor do adiantamento. O sistema sugere automaticamente o saldo disponível para o tipo de item selecionado, permitindo sua alteração.
+
*'''Sequência:''' Sequência numérica gerada automaticamente pelo sistema para identificar o adiantamento dentro do documento de origem.
*'''Forma de Cobrança:''' Preenchida automaticamente com a forma de cobrança do documento de origem, podendo ser alterada pelo usuário.
+
*'''Valor:''' Valor que será adiantado. O sistema sugere automaticamente o saldo disponível para adiantamento, permitindo que o usuário informe um valor menor, quando necessário. Não é permitido informar um valor superior ao saldo disponível.
 +
*'''Forma de Cobrança:''' Preenchida automaticamente com a forma de cobrança definida no documento de origem, podendo ser alterada pelo usuário.
 
*'''Condição de Pagamento:''' Deve ser informada manualmente pelo usuário.
 
*'''Condição de Pagamento:''' Deve ser informada manualmente pelo usuário.
 +
 +
O sistema também valida se o documento de origem possui itens e se estão configurados os tipos de documento necessários para a geração do adiantamento de produtos e serviços.
 +
 +
==='''Geração do Documento de Adiantamento'''===
 +
 +
Após o cadastro do adiantamento, o sistema gera automaticamente o documento correspondente.
 +
 +
A geração considera separadamente os valores pendentes de '''produtos''' e '''serviços'''. Para determinar por qual tipo de item iniciar a geração, o sistema verifica o valor pendente de adiantamento de cada tipo e prioriza aquele que possuir o '''maior valor pendente'''.
 +
 +
Dessa forma:
 +
 +
* Quando o maior valor pendente estiver relacionado a '''produtos''', o sistema inicia a geração do documento de adiantamento utilizando os produtos.
 +
* Quando o maior valor pendente estiver relacionado a '''serviços''', o sistema inicia a geração utilizando os serviços.
 +
* Caso o valor do adiantamento seja totalmente utilizado pelo primeiro tipo de item, a geração é concluída.
 +
* Caso ainda exista saldo do adiantamento após utilizar todo o valor disponível para o primeiro tipo de item, o sistema continua a geração utilizando o '''segundo tipo de item'''.
 +
* Dessa forma, um mesmo adiantamento pode resultar na geração de documentos para produtos e serviços, quando necessário para utilizar integralmente o valor informado.
 +
 +
A prioridade é determinada automaticamente pelo valor pendente de cada tipo, não sendo necessário que o usuário selecione manualmente qual tipo deverá ser utilizado primeiro. O sistema consulta os valores pendentes e os ordena do maior para o menor.
 +
 +
==='''Exemplo de Geração'''===
 +
 +
Considerando um documento de origem com:
 +
 +
* '''Produtos:''' R$ 8.000,00 pendentes para adiantamento.
 +
* '''Serviços:''' R$ 3.000,00 pendentes para adiantamento.
 +
* '''Valor do adiantamento:''' R$ 5.000,00.
 +
 +
Como os produtos possuem o maior valor pendente, o sistema inicia a geração pelo tipo '''Produto''' e utiliza os R$ 5.000,00 nesse tipo.
 +
 +
Em outro cenário:
 +
 +
* '''Produtos:''' R$ 2.000,00 pendentes para adiantamento.
 +
* '''Serviços:''' R$ 6.000,00 pendentes para adiantamento.
 +
* '''Valor do adiantamento:''' R$ 5.000,00.
 +
 +
Nesse caso, o sistema inicia a geração pelo tipo '''Serviço''', pois é o tipo com maior valor pendente, e utiliza os R$ 5.000,00 nesse tipo.
 +
 +
Quando o valor do adiantamento for superior ao saldo pendente do primeiro tipo, o sistema utiliza o saldo disponível desse tipo e, havendo valor restante, continua a geração pelo segundo tipo.
 +
 +
Já em uma situação em que o primeiro tipo possui saldo inferior ao valor do adiantamento, o restante é direcionado ao segundo tipo. Por exemplo:
 +
 +
* '''Produtos:''' R$ 2.000,00 pendentes.
 +
* '''Serviços:''' R$ 6.000,00 pendentes.
 +
* '''Valor do adiantamento:''' R$ 7.000,00.
 +
 +
Nesse caso, são utilizados R$ 6.000,00 para serviços e os R$ 1.000,00 restantes são utilizados para produtos.
 +
 +
==='''Geração dos Itens'''===
 +
 +
Após definir o tipo de item que será utilizado, o sistema gera os itens do documento de adiantamento proporcionalmente ao valor adiantado.
 +
 +
Os itens são obtidos a partir do documento de origem e somente são considerados aqueles pertencentes ao tipo selecionado, seja produto ou serviço. Os valores dos itens são proporcionalizados de acordo com o valor do adiantamento em relação ao valor total dos itens daquele tipo.
 +
 +
Durante a geração, o sistema mantém as principais informações dos itens de origem, incluindo descrição, unidade, valores, informações fiscais e demais configurações necessárias para o documento de adiantamento.
 +
 +
O documento gerado também permanece vinculado ao adiantamento que o originou, permitindo identificar a origem e acompanhar os valores adiantados.
 +
 +
==='''Regras e Validações'''===
 +
 +
Para gerar o adiantamento, o sistema realiza algumas validações:
 +
 +
* O documento de origem deve possuir pelo menos um item.
 +
* O valor informado para o adiantamento não pode ser superior ao saldo disponível.
 +
* Deve existir um tipo de documento configurado para '''adiantamento de produtos'''.
 +
* Deve existir um tipo de documento configurado para '''adiantamento de serviços'''.
 +
* Somente são considerados valores que ainda possuem saldo pendente de adiantamento.
 +
* Os valores já utilizados em adiantamentos anteriores são descontados do saldo disponível.
 +
* A geração dos documentos ocorre automaticamente de acordo com o tipo de item e os valores pendentes.
  
 
==='''Quais os benefícios e/ou ganhos de uso'''===
 
==='''Quais os benefícios e/ou ganhos de uso'''===
  
A utilização do adiantamento da ordem de serviço proporciona diversos benefícios, entre eles:
+
A utilização do adiantamento proporciona diversos benefícios:
  
* Permite realizar cobranças antecipadas antes da conclusão da ordem de serviço.
+
* Permite realizar cobranças antecipadas antes da conclusão do faturamento ou da execução da ordem de serviço.
 +
* Automatiza a geração do documento de adiantamento.
 +
* Identifica automaticamente se o adiantamento será aplicado a produtos, serviços ou a ambos.
 +
* Prioriza automaticamente o tipo de item com maior valor pendente.
 +
* Permite utilizar o restante do valor do adiantamento em um segundo tipo de item quando o saldo do primeiro tipo não for suficiente.
 
* Proporciona maior controle financeiro sobre os valores recebidos antecipadamente.
 
* Proporciona maior controle financeiro sobre os valores recebidos antecipadamente.
* Evita a geração de adiantamentos superiores ao saldo disponível para produtos ou serviços.
+
* Impede a geração de adiantamentos superiores ao saldo disponível.
* Mantém o vínculo entre a ordem de serviço, o adiantamento e o documento gerado, facilitando consultas e rastreabilidade.
+
* Evita a duplicidade de valores já utilizados em adiantamentos anteriores.
* Automatiza a geração do documento de adiantamento, reduzindo retrabalho e minimizando erros operacionais.
+
* Mantém o vínculo entre o documento de origem, o adiantamento e os documentos gerados.
* Respeita a separação entre produtos e serviços, utilizando o tipo de documento configurado para cada situação.
+
* Mantém a separação entre produtos e serviços, utilizando o tipo de documento configurado para cada situação.
 +
* Reduz o retrabalho e minimiza erros operacionais durante o processo de faturamento.
  
 
==='''Conclusão'''===
 
==='''Conclusão'''===
  
O adiantamento torna o processo de cobrança antecipada mais seguro e organizado, automatizando a geração dos documentos necessários e mantendo o vínculo entre a ordem de serviço, o adiantamento e o documento gerado. Dessa forma, a solução proporciona maior controle financeiro, rastreabilidade das operações e agilidade no processo de faturamento.
+
O adiantamento torna o processo de cobrança antecipada mais seguro, automatizado e organizado.
 +
 
 +
A partir do valor informado pelo usuário, o sistema identifica os saldos ainda pendentes, determina automaticamente se deve iniciar a geração por produtos ou serviços e utiliza primeiro o tipo que possui o maior valor pendente. Quando o saldo desse tipo não é suficiente para absorver todo o valor do adiantamento, o sistema utiliza automaticamente o segundo tipo, permitindo que o valor seja distribuído entre produtos e serviços quando necessário.
 +
 
 +
Com isso, o processo garante maior controle financeiro, evita adiantamentos acima do saldo disponível, mantém a rastreabilidade entre as operações e reduz a necessidade de intervenção manual no processo de faturamento.

Edição das 11h37min de 18 de agosto de 2026

Conceito

O adiantamento permite realizar a cobrança antecipada de produtos ou serviços que ainda serão faturados, gerando automaticamente um documento de adiantamento vinculado ao pedido de venda ou à ordem de serviço de origem.

Esse recurso é utilizado quando existe a necessidade de receber parte ou a totalidade do valor antes da conclusão do faturamento ou da execução dos serviços.

Ao realizar um adiantamento, o sistema identifica automaticamente os valores ainda pendentes de adiantamento e gera o documento correspondente, mantendo o vínculo entre o documento de origem, o adiantamento e o documento financeiro/fiscal gerado. Dessa forma, todo o processo permanece rastreável até a conclusão do faturamento.

Cadastro do Adiantamento

Ao incluir um novo adiantamento, o sistema realiza automaticamente as validações necessárias e sugere o valor disponível para adiantamento, considerando os valores já adiantados e o saldo ainda pendente dos itens do documento de origem.

A forma de cobrança também é preenchida automaticamente conforme a configuração do documento de origem, podendo ser alterada pelo usuário.

Durante o cadastro devem ser informados os seguintes campos:

  • Sequência: Sequência numérica gerada automaticamente pelo sistema para identificar o adiantamento dentro do documento de origem.
  • Valor: Valor que será adiantado. O sistema sugere automaticamente o saldo disponível para adiantamento, permitindo que o usuário informe um valor menor, quando necessário. Não é permitido informar um valor superior ao saldo disponível.
  • Forma de Cobrança: Preenchida automaticamente com a forma de cobrança definida no documento de origem, podendo ser alterada pelo usuário.
  • Condição de Pagamento: Deve ser informada manualmente pelo usuário.

O sistema também valida se o documento de origem possui itens e se estão configurados os tipos de documento necessários para a geração do adiantamento de produtos e serviços.

Geração do Documento de Adiantamento

Após o cadastro do adiantamento, o sistema gera automaticamente o documento correspondente.

A geração considera separadamente os valores pendentes de produtos e serviços. Para determinar por qual tipo de item iniciar a geração, o sistema verifica o valor pendente de adiantamento de cada tipo e prioriza aquele que possuir o maior valor pendente.

Dessa forma:

  • Quando o maior valor pendente estiver relacionado a produtos, o sistema inicia a geração do documento de adiantamento utilizando os produtos.
  • Quando o maior valor pendente estiver relacionado a serviços, o sistema inicia a geração utilizando os serviços.
  • Caso o valor do adiantamento seja totalmente utilizado pelo primeiro tipo de item, a geração é concluída.
  • Caso ainda exista saldo do adiantamento após utilizar todo o valor disponível para o primeiro tipo de item, o sistema continua a geração utilizando o segundo tipo de item.
  • Dessa forma, um mesmo adiantamento pode resultar na geração de documentos para produtos e serviços, quando necessário para utilizar integralmente o valor informado.

A prioridade é determinada automaticamente pelo valor pendente de cada tipo, não sendo necessário que o usuário selecione manualmente qual tipo deverá ser utilizado primeiro. O sistema consulta os valores pendentes e os ordena do maior para o menor.

Exemplo de Geração

Considerando um documento de origem com:

  • Produtos: R$ 8.000,00 pendentes para adiantamento.
  • Serviços: R$ 3.000,00 pendentes para adiantamento.
  • Valor do adiantamento: R$ 5.000,00.

Como os produtos possuem o maior valor pendente, o sistema inicia a geração pelo tipo Produto e utiliza os R$ 5.000,00 nesse tipo.

Em outro cenário:

  • Produtos: R$ 2.000,00 pendentes para adiantamento.
  • Serviços: R$ 6.000,00 pendentes para adiantamento.
  • Valor do adiantamento: R$ 5.000,00.

Nesse caso, o sistema inicia a geração pelo tipo Serviço, pois é o tipo com maior valor pendente, e utiliza os R$ 5.000,00 nesse tipo.

Quando o valor do adiantamento for superior ao saldo pendente do primeiro tipo, o sistema utiliza o saldo disponível desse tipo e, havendo valor restante, continua a geração pelo segundo tipo.

Já em uma situação em que o primeiro tipo possui saldo inferior ao valor do adiantamento, o restante é direcionado ao segundo tipo. Por exemplo:

  • Produtos: R$ 2.000,00 pendentes.
  • Serviços: R$ 6.000,00 pendentes.
  • Valor do adiantamento: R$ 7.000,00.

Nesse caso, são utilizados R$ 6.000,00 para serviços e os R$ 1.000,00 restantes são utilizados para produtos.

Geração dos Itens

Após definir o tipo de item que será utilizado, o sistema gera os itens do documento de adiantamento proporcionalmente ao valor adiantado.

Os itens são obtidos a partir do documento de origem e somente são considerados aqueles pertencentes ao tipo selecionado, seja produto ou serviço. Os valores dos itens são proporcionalizados de acordo com o valor do adiantamento em relação ao valor total dos itens daquele tipo.

Durante a geração, o sistema mantém as principais informações dos itens de origem, incluindo descrição, unidade, valores, informações fiscais e demais configurações necessárias para o documento de adiantamento.

O documento gerado também permanece vinculado ao adiantamento que o originou, permitindo identificar a origem e acompanhar os valores adiantados.

Regras e Validações

Para gerar o adiantamento, o sistema realiza algumas validações:

  • O documento de origem deve possuir pelo menos um item.
  • O valor informado para o adiantamento não pode ser superior ao saldo disponível.
  • Deve existir um tipo de documento configurado para adiantamento de produtos.
  • Deve existir um tipo de documento configurado para adiantamento de serviços.
  • Somente são considerados valores que ainda possuem saldo pendente de adiantamento.
  • Os valores já utilizados em adiantamentos anteriores são descontados do saldo disponível.
  • A geração dos documentos ocorre automaticamente de acordo com o tipo de item e os valores pendentes.

Quais os benefícios e/ou ganhos de uso

A utilização do adiantamento proporciona diversos benefícios:

  • Permite realizar cobranças antecipadas antes da conclusão do faturamento ou da execução da ordem de serviço.
  • Automatiza a geração do documento de adiantamento.
  • Identifica automaticamente se o adiantamento será aplicado a produtos, serviços ou a ambos.
  • Prioriza automaticamente o tipo de item com maior valor pendente.
  • Permite utilizar o restante do valor do adiantamento em um segundo tipo de item quando o saldo do primeiro tipo não for suficiente.
  • Proporciona maior controle financeiro sobre os valores recebidos antecipadamente.
  • Impede a geração de adiantamentos superiores ao saldo disponível.
  • Evita a duplicidade de valores já utilizados em adiantamentos anteriores.
  • Mantém o vínculo entre o documento de origem, o adiantamento e os documentos gerados.
  • Mantém a separação entre produtos e serviços, utilizando o tipo de documento configurado para cada situação.
  • Reduz o retrabalho e minimiza erros operacionais durante o processo de faturamento.

Conclusão

O adiantamento torna o processo de cobrança antecipada mais seguro, automatizado e organizado.

A partir do valor informado pelo usuário, o sistema identifica os saldos ainda pendentes, determina automaticamente se deve iniciar a geração por produtos ou serviços e utiliza primeiro o tipo que possui o maior valor pendente. Quando o saldo desse tipo não é suficiente para absorver todo o valor do adiantamento, o sistema utiliza automaticamente o segundo tipo, permitindo que o valor seja distribuído entre produtos e serviços quando necessário.

Com isso, o processo garante maior controle financeiro, evita adiantamentos acima do saldo disponível, mantém a rastreabilidade entre as operações e reduz a necessidade de intervenção manual no processo de faturamento.