Histórico de Saldo - devbasetecnologia/devmobility GitHub Wiki
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.
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.
O prestador pode visualizar seu sado através do menu, escolhendo opção Financeiro e tocando sobre o valor de seu saldo atual.
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.
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.
- 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.
- 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.
-
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.
-
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.
- 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.
- 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.
- 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.
-
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.