Histórico de Saldo - devbasetecnologia/devmobility GitHub Wiki

Introdução


Cada movimentação financeira que altera saldo do cliente, prestador ou plataforma gera um registro de histórico de saldo. Este histórico pode ser consultado pelos clientes e prestadores através dos respectivos aplicativos, ou pelo administrador através do painel web. Neste documento serão detalhadas as formas de consultar este histórico e também o os motivos que descrevem qual é a movimentação que resultou em sua criação.

Visualização do Saldo


App do Cliente

O cliente pode visualizar seu sado através do menu, escolhendo opção Forma de Pagamento e tocando sobre o valor de seu saldo atual.

App do Prestador

O prestador pode visualizar seu sado através do menu, escolhendo opção Financeiro e tocando sobre o valor de seu saldo atual.

Painel do Administrador

O administrador pode visualizar os históricos do saldo do cliente, do prestador, da plataforma e o saldo pendente. Para visualizar estes históricos bastar acessar o menu Financeiro e escolher uma das opções destacadas na imagem abaixo

Cada uma das telas tem uma lista do histórico de saldo da entidade escolhida onde é possível se filtrar a data desejada, os participantes da movimentação qual o pedido ou pagamento que gerou este registro etc. No vídeo abaixo há uma breve demonstração das funcionalidades da tela.

historicosaldo

Marcar movimentações do prestador como confirmadas

Quando é feito um acerto por período, as movimentações que foram pagas naquele período são marcadas como Confirmado. Caso seja necessário marcar alguma solicitação que não foi realizada o acerto, ou que o acerto foi realizado de outra forma e ela precisa ser marcada como confirmada, é possível fazer issto pela tela Financeiro > Hist. Saldo Motorista. Para isso basta clicar no botão Marcar Confirmado ou Desmarcar Confirmado, e isso fará com que todas as movimentações filtradas sejam marcadas/desmarcadas como confirmado.

Ou, para realizar esta operação em uma única movimentação, clicar em Ações e Marcar Confirmado ou Desmarcar Confirmado, como pode ser observado na imagem abaixo.

As alterações marcadas como confirmadas não aparecem no relatório financeiro para os acertos.

Motivos


Crédito -Cliente

  • 2 - Recarga: Credita o valor para o cliente quando ele realiza a recarga pelo aplicativo ou quando o administrador realiza a recarga pelo painel.
  • 6 - Edição de Saldo: Credita saldo para cliente quando o administrador atribui a ele um valor de saldo maior do que o atual.
  • 8 - Edição de Pagamento: Credita saldo ao cliente quando o administrador edita o pagamento de uma solicitação, alterando o valor total da mesma, e atribui a ela um valor menor do que o atual (somente para solicitações com tipo de pagamento via app. Ex: cartão, faturado e pago com saldo da carteira).
  • 20 - Cancelamento Administrador: Credita saldo para cliente quando o administrador cancela uma solicitação finalizada que foi paga com saldo; OU uma solicitação cancelada pelo cliente ou prestador em que a taxa de cancelamento foi debitada do cliente e não foi paga pelo cartão de crédito.
    • Exemplo: Cliente teve sua solicitação cancelada pelo motorista e ficou como o saldo negativo injustamente. O administrador cancela esta solicitação pelo painel e esta taxa de cancelamento é devolvida ao cliente.
  • 23 - Solicitação Finalizada - Saldo Pendente: Credita o valor do Saldo Pendente (de uma corrida anteriormente cancelada ou que tenha gerado saldo negativo para o cliente) para o cliente quando uma solicitação é finalizada.
    • Exemplo: O cliente cancelou uma solicitação e foi multado com a taxa de cancelamento de R$ 5,00, seu saldo ficou R$ -5,00. Na próxima solicitação deste cliente este valor foi pago como saldo pendente. Uma solicitação que custaria R$ 10,00 cobrou R$ 15,00 devido ao saldo pendente. No momento do pagamento dessa solicitação o cliente volta a ter o saldo R$ 0,00.

Débito - Cliente

  • 1 - Solicitação Cancelada: Debita a taxa de cancelamento, quando ela existe e as condições de cancelamento são atendidas, do Cliente quando a solicitação é cancelada pelo Cliente ou Prestador e o tipo de pagamento não é Cartão de Crédito.
  • 3 - Solicitação Finalizada com Saldo: Debita o valor da corrida do cliente quando ele finaliza uma viagem escolhendo o saldo como forma de pagamento.
  • 5 - Edição de Saldo: Debita saldo do cliente quando o administrador atribui a ele um valor de saldo menor do que o atual.
  • 7 - Edição de Pagamento: Debita saldo do cliente quando o administrador edita o pagamento de uma solicitação, alterando o valor total da mesma, e atribui a ela um valor maior do que o atual.
  • 19 - Pagamento não autorizado: Debita o saldo do cliente quando um pagamento efetuado pelo cartão de crédito não é autorizado.
  • 25 - Cancelamento Administrador - Saldo Pendente: Debita o valor do Saldo Pendente do cliente quando uma solicitação finalizada que tem este saldo é cancelada pelo administrador.
    • Exemplo: O cliente estava com o saldo negativo por causa de um cancelamento efetuado por ele, na corrida seguinte o cliente fez uma corrida com dinheiro onde esta taxa seria paga e esta corrida foi finalizada (Por engano, com valor errado ou teve qualquer problema que justifique o cancelamento). Ao cancelar esta corrida com problema, este valor é novamente debitado do cliente para que ele pague em outra corrida.
  • 48 - Acerto Pagamento: Debita o saldo do cliente, quando o administrador realiza um pagamento para ele através da tela de acerto.

Crédito - Prestador

  • 9 - Solicitação Cancelada: Credita o repasse do prestador referente a taxa de cancelamento, caso ela exista e as condições de cancelamento sejam atendidas, quando a solicitação é cancelada pelo Cliente ou Prestador utilizando Saldo ou pagamento pelo cartão de crédito.
    • Obs: Se a corrida for cancelada por outras formas de pagamento, é criado um registro na tabela de saldo pendente, e esse valor será repassado ao prestador apenas quando este valor for pago pelo cliente em uma solicitação futura.
  • 11 - Recarga: Credita o valor para o prestador quando ele realiza a recarga pelo aplicativo utilizando o cartão de crédito.
  • 12 - Solicitação Finalizada: Credita o repasse do prestador quando uma solicitação é finalizada e o pagamento fica em posse da plataforma OU quando o pagamento está em posse do prestador, mas o valor do desconto excede o repasse da empresa, está diferença é creditada ao prestador.
    • Exemplo: Uma corrida paga pelo dinheiro, máquina de cartão ou outros meios de pagamento que ficam em posse do prestador de R$20,00 onde 25% seria repassado para a empresa (R$5,00), recebe um desconto de R$10,00. Os R$5,00 que deveriam ser pagos para o prestador e não foram são creditados ao saldo.
  • 15 - Edição de Saldo: Credita saldo para prestador quando o administrador atribui a ele um valor de saldo maior do que o atual.
  • 18 - Edição de Pagamento: Credita saldo ao prestador quando o administrador edita o pagamento de uma solicitação, alterando o valor do prestador da mesma, e atribui a ela um valor maior do que o atual OU quando o saldo pendente da solicitação é alterado para um menor do que o atual.
  • 21 - Cancelamento Administrador: Credita o repasse da empresa quando uma solicitação em que o pagamento está em posse do prestador é cancelada pelo administrador E credita o saldo pendente quando este estaria em posse do prestador.
  • 32 - Pagamento Saldo Pendente: Credita o saldo pendente para o prestador quando a plataforma recebe o acerto e ele ainda não havia sido pago.

Débito - Prestador

  • 10 - Cancelamento Administrador: Debita repasse do prestador de uma viagem finalizada em que o pagamento está em posse da plataforma, ou o repasse referente a taxa de cancelamento, caso esse exista, quando a solicitação já cancelada pelo Cliente ou Prestador é cancelada pelo Administrador.
    • Exemplo 1: Uma corrida paga pelo dinheiro, máquina de cartão ou outros meios de pagamento que ficam em posse do prestador de R$20,00 onde 25% seria repassado para a empresa (R$5,00) já finalizada é cancelada pelo administrador. Estes R$5,00 que foram debitados do prestador são devolvidos
    • Exemplo 2: Uma corrida paga pelo dinheiro, máquina de cartão ou outros meios de pagamento que ficam em posse do prestador de R$20,00 tem um saldo pendente (valor de uma solicitação cancelada anteriormente) de R$5,00 foi finalizada e é cancelada pelo administrador. Além dos R$5,00 que foram debitados do prestador referentes ao repasse da empresa serem devolvidos, também são devolvidos os R$5,00 que foram debitados do prestador referentes a esse saldo pendente.
  • 13 - Solicitação Finalizada: Debita o repasse da empresa, caso ele exista, quando uma solicitação é finalizada e o pagamento fica em posse do prestador.
  • 16 - Edição de Saldo: Debita saldo do cliente quando o administrador atribui a ele um valor de saldo menor do que o atual.
  • 17 - Edição de Pagamento: Debita saldo do prestador quando o administrador edita o pagamento de uma solicitação, alterando o valor do prestador da mesma, e atribui a ela um valor menor do que o atual.
  • 24 - Solicitação Finalizada - Saldo Pendente: Debita o saldo pendente do prestador, caso ele exista, quando uma solicitação é finalizada e o pagamento fica em posse do prestador.
    • Exemplo: Uma corrida paga pelo dinheiro, máquina de cartão ou outros meios de pagamento que ficam em posse do prestador de R$20,00 tem um saldo pendente (valor de uma solicitação cancelada anteriormente) de R$5,00 foi finalizada. Estes R$5,00 referentes a esse saldo pendente são debitados do prestador.
  • 49 - Acerto Pagamento: Debita o saldo do prestador, quando o administrador realiza um pagamento para ele através da tela de acerto.

Crédito - Plataforma

  • 45 - Edição Pagamento: Credita para a plataforma quando uma solicitação finalizada com desconto tem o valor do repasse da empresa alterado pelo administrador para um maior que o anterior.
  • 47 - Cancelamento Administrador: Credita para a plataforma quando uma solicitação finalizada com desconto é cancelada.

Débito - Plataforma

  • 42 - Solicitação Finalizada com Desconto: Debita da plataforma a diferença entre o valor pago pelo cliente e o valor recebido pelo prestador quando uma solicitação em que o desconto excede o repasse da empresa é finalizada.
  • 43 - Acerto com Desconto: Debita da plataforma a diferença entre o valor pago pelo cliente e o valor recebido em saldo pelo cliente quando uma recarga é efetuada e ela tem desconto.
  • 46 - Edição Pagamento: Debita da a plataforma quando uma solicitação tem o valor do repasse da empresa alterado pelo administrador para um valor menor que zero e menor que o anterior.

Motivo Pendente - Pendente

  • 28 - Solicitação Finalizada - Saldo Pendente: Cria um registro de Saldo Pendente no histórico, já como pago para o prestador, quando um cliente finaliza uma solicitação paga pelo saldo e devido a mudança de valor não tem saldo suficiente para pagar a corrida.
  • 31 - Cancelamento Administrador: Cria um registro de Saldo Pendente no histórico quando o administrador cancela uma solicitação que havia pago um saldo pendente OU quando o cliente fica com o saldo negativo após o cancelamento.
    • Exemplo: O cliente estava com um saldo de -R$5,00 e ao finalizar uma corrida usando dinheiro este saldo foi zerado. Quando o administrador cancela esta corrida, este valor de R$5,00 é novamente debitado do cliente.
  • 38 - Edição Saldo: Insere um registro de Saldo Pendente no histórico quando um cliente tem seu saldo editado pelo administrador para um menor que o atual.
  • 40 - Pagamento não autorizado: Insere um registro de Saldo Pendente no histórico quando um cliente finaliza ou cancela uma solicitação com cartão de crédito e a transação não é autorizada. Quando a solicitação é finalizada, este registro já é incluído como pago.
  • 41 - Solicitação Cancelada: Insere um registro de Saldo Pendente no histórico quando uma solicitação é cancelada pelo cliente ou prestador e o cliente não tem saldo suficiente para pagar a taxa de cancelamento.

Motivo Acerto - Pendente

  • 29 - Solicitação Finalizada - Saldo Pendente: Acerta um registro de Saldo Pendente no histórico quando o cliente paga um saldo pendente em uma solicitação é finalizada OU quando uma solicitação é cancelada e o cliente que estava com um saldo negativo volta a ficar com o saldo positivo
    • Exemplo: O cliente estava com um saldo de R$5,00 e fez uma corrida, ao finalizar a corrida deu um valor maior do que o estimado pois o prestador fez um caminho mais longo, e foi cobrado R$7,00. Este valor excedente de -R$2,00 foi debitado do cliente e uma registro de saldo pendente foi criado no histórico. Ao cancelar esta corrida pelo painel do administrador, o saldo é devolvido para o cliente e é realizado um acerto no saldo pendente.
  • 30 - Cancelamento Administrador: Acerta um registro de Saldo Pendente no histórico quando uma solicitação é cancelada pelo administrador e o cliente que estava com o saldo negativo passa a ter saldo positivo
  • 37 - Edição Saldo: Acerta um registro de Saldo Pendente no histórico quando um cliente tem seu saldo editado pelo administrador para um maior que o atual.
⚠️ **GitHub.com Fallback** ⚠️