Como consultar as movimentações do saldo do prestador - devbasetecnologia/devmobility GitHub Wiki
Como consultar as movimentações do saldo do prestador
📖 O que é o saldo do prestador?
O saldo do prestador é utilizado pela plataforma para registrar as movimentações financeiras relacionadas ao motorista.
Ele pode aumentar ou diminuir de acordo com as corridas realizadas, recargas, acertos e outras movimentações financeiras.
Por isso, ao analisar o saldo de um prestador, é importante verificar qual foi a movimentação responsável pela alteração do valor.
🎯 Quando utilizar?
Utilize esta consulta sempre que precisar:
✅ Verificar por que o saldo de um prestador aumentou ou diminuiu.
✅ Identificar uma movimentação relacionada a uma solicitação.
✅ Conferir uma recarga realizada pelo prestador.
✅ Verificar um acerto realizado no saldo.
✅ Conferir valores relacionados a pagamentos de saldo pendente.
📍 Onde consultar as movimentações?
Existem duas formas principais de consultar as movimentações do saldo.
👤 Consulta pelo cadastro do prestador
Para verificar as movimentações de um prestador específico:
Prestadores → Selecione o prestador → Clique no ícone de três linhas ao lado do saldo
Ao clicar no ícone, será apresentada a movimentação de saldo daquele prestador.
A consulta inicia utilizando a data atual, mas é possível aumentar o período para consultar movimentações de até 3 meses.
📊 Consulta pelo histórico de saldo
Para consultar movimentações de forma geral, acesse:
Financeiro → Histórico de saldo motorista
Nesta tela é possível:
- Filtrar um prestador específico;
- Filtrar um período;
- Consultar movimentações de forma geral;
- Exportar os dados para Excel.
💡 Qual consulta utilizar?
Se você precisa investigar o saldo de um prestador específico, utilize a movimentação disponível no cadastro do prestador.
Se precisa analisar movimentações de vários prestadores ou gerar um relatório, utilize o Histórico de saldo motorista.
💰 Como interpretar os valores?
Na movimentação de saldo existem duas informações importantes:
Valor da movimentação
A coluna da esquerda apresenta o valor daquela movimentação.
Esse valor representa quanto foi adicionado ou retirado do saldo.
Saldo atual
A coluna da direita apresenta o saldo do prestador após aquela movimentação.
Exemplo:
Saldo anterior: R$ 0,00 Movimentação: +R$ 5,00 Saldo atual: R$ 5,00
Nesse caso:
R$ 5,00 → valor da movimentação.
R$ 5,00 → saldo total após a movimentação.
Outro exemplo:
Saldo anterior: R$ 20,00 Movimentação: -R$ 5,00 Saldo atual: R$ 15,00
⚠️ Atenção
O valor da movimentação não é necessariamente o mesmo que o saldo atual.
Sempre confira as duas colunas para entender o que aconteceu com o saldo.
🔄 Principais motivos
Os motivos informam por que aquela movimentação aconteceu.
🚗 Solicitação Finalizada
É utilizada quando uma solicitação é finalizada e existe uma movimentação relacionada à cobrança da plataforma.
A solicitação pode ser identificada através da coluna Pedido.
🔴 Em vermelho
Indica que o pagamento está em posse do prestador.
Exemplos:
- 💵 Dinheiro;
- Pix para o prestador;
- 💳 Maquininha de cartão do prestador.
Como o valor é recebido diretamente pelo prestador, a parte correspondente à plataforma é retirada do saldo do prestador.
🟢 Em verde
Indica que o pagamento está em posse da plataforma.
Exemplos:
- Pix para a plataforma;
- Cartão de crédito realizado pelo aplicativo.
Nesse caso, o valor passa pela plataforma e a parte pertencente ao prestador é adicionada ao saldo dele.
📌 Pré-pago período
Quando o prestador utiliza Pré-pago período, a solicitação também pode aparecer como Solicitação Finalizada no histórico de movimentações.
O comportamento do saldo dependerá da posse do pagamento:
🔴 Pagamento em posse do prestador
Quando o pagamento é realizado diretamente ao prestador, como dinheiro, Pix para o prestador ou maquininha de cartão, a solicitação aparecerá no histórico, porém a movimentação do saldo ficará em R$ 0,00.
Isso acontece porque, durante o período contratado, o prestador permanece com 100% do valor da solicitação e não há cobrança da plataforma sobre o saldo.
Exemplo:
Valor da solicitação: R$ 20,00 Forma de pagamento: Dinheiro Acerto: Pré-pago período Movimentação no saldo: R$ 0,00
🟢 Pagamento em posse da plataforma
Quando o pagamento é realizado para a plataforma, como Pix para a plataforma ou cartão de crédito pelo aplicativo, a solicitação também será registrada no histórico e o valor pertencente ao prestador será adicionado ao saldo.
Exemplo:
Valor da solicitação: R$ 20,00 Forma de pagamento: Cartão de crédito pelo aplicativo Acerto: Pré-pago período Movimentação no saldo: R$ 20,00
⚠️ Atenção
No Pré-pago período, não significa que todas as solicitações terão movimentação de R$ 0,00.
O valor será zerado apenas quando o pagamento estiver em posse do prestador.
Quando o pagamento estiver em posse da plataforma, o valor pertencente ao prestador será registrado normalmente no saldo.
💸 Pagamento Saldo Pendente
É utilizado quando um passageiro possui um valor pendente de pagamento de uma solicitação anterior.
Exemplo:
Valor da corrida: R$ 20,00 Valor pago: R$ 15,00 Valor pendente: R$ 5,00
O valor pendente poderá ser cobrado em uma solicitação futura e direcionado ao prestador que tinha recebido o pagamento incompleto.
🔄 Solicitação Finalizada - Saldo Pendente
É utilizada quando uma nova solicitação é utilizada para quitar um valor pendente de uma solicitação anterior.
Exemplo:
Nova solicitação: R$ 10,00 Saldo pendente: R$ 5,00 Total pago: R$ 15,00
Os R$ 5,00 da pendência são direcionados ao prestador que tinha direito ao valor.
💰 Solicitação Finalizada - Saldo Parcial
É utilizada quando o passageiro paga uma parte da solicitação utilizando seu saldo e outra parte diretamente ao prestador.
Exemplo:
Valor da corrida: R$ 10,00 Saldo utilizado: R$ 5,00 Valor pago ao prestador: R$ 5,00
➕ Recarga
É utilizada quando um administrador realiza uma recarga manual no saldo do prestador.
Normalmente, será possível identificar o administrador responsável pela operação na coluna Administrador.
💳 Recarga Boleto Pago
É utilizada quando o próprio prestador realiza uma recarga automática através do aplicativo, utilizando os meios de pagamento disponibilizados pela plataforma.
🔄 Acerto Pagamento
É utilizado para adicionar ou retirar valores do saldo do prestador.
O acerto deve ser utilizado preferencialmente para realizar ajustes de saldo, pois mantém o registro da movimentação.
Para entender como funciona cada tipo de acerto, consulte a wiki [Tipos de Acerto](INSERIR LINK).
🔍 Como validar uma movimentação?
Ao investigar uma alteração no saldo, confira:
☐ Motivo da movimentação
☐ Valor da movimentação
☐ Saldo atual
☐ Pedido, quando houver uma solicitação relacionada
☐ Administrador, quando for uma movimentação manual
☐ Data da movimentação
💡 Dica
Quando a movimentação estiver relacionada a uma corrida, utilize o número apresentado na coluna Pedido para localizar a solicitação e comparar as informações.
Dessa forma, fica mais fácil entender de onde veio o valor e por que o saldo foi alterado.
⚠️ Problemas mais comuns
O saldo do prestador aumentou ou diminuiu e não sei o motivo
Confira:
☐ Motivo da movimentação
☐ Valor movimentado
☐ Saldo atual
☐ Pedido relacionado à movimentação
☐ Tipo de acerto
☐ Administrador, caso seja uma movimentação manual
A solicitação aparece no histórico, mas o valor está zerado
Confira se o prestador utiliza Pré-pago período.
Nesse tipo de acerto, a solicitação pode aparecer normalmente no histórico, mas a movimentação do saldo será R$ 0,00.
O valor da movimentação não é igual ao saldo do prestador
Isso é esperado.
A coluna da esquerda apresenta o valor da movimentação, enquanto a coluna da direita apresenta o saldo total após a movimentação.
Não consigo encontrar uma movimentação antiga
Confira o período selecionado.
A consulta pelo cadastro do prestador permite consultar movimentações de até 3 meses.
Caso precise realizar uma análise mais ampla, utilize:
Financeiro → Histórico de saldo motorista
💼 Boas práticas
✔ Sempre confira o motivo antes de analisar uma alteração no saldo.
✔ Quando houver um Pedido, utilize-o para relacionar a movimentação com a solicitação.
✔ Em movimentações manuais, confira o Administrador responsável pela operação.
✔ Confira o tipo de acerto antes de interpretar uma movimentação.
✔ Para ajustes de saldo, prefira utilizar o Acerto.
✔ Ao investigar um problema, compare o valor da movimentação com o saldo atual.
❓ Perguntas Frequentes
O saldo do prestador representa quanto ele recebeu em dinheiro?
❌ Não necessariamente.
O saldo representa o saldo financeiro registrado na plataforma e pode aumentar ou diminuir de acordo com as movimentações realizadas.
Posso consultar o saldo de um prestador específico?
✅ Sim.
Acesse:
Prestadores → Selecione o prestador → Ícone de três linhas ao lado do saldo
Posso consultar movimentações de vários prestadores?
✅ Sim.
Acesse:
Financeiro → Histórico de saldo motorista
Nessa tela é possível utilizar filtros e exportar os dados para Excel.
Por que uma Solicitação Finalizada pode aparecer em vermelho ou verde?
A cor está relacionada à posse do valor.
🔴 Vermelho: valor em posse do prestador.
🟢 Verde: valor em posse da plataforma.
O que significa o campo Pedido?
O campo Pedido identifica a solicitação relacionada à movimentação.
Ele pode ser utilizado para localizar a corrida e entender a origem daquela alteração no saldo.
O que significa o motivo Recarga?
É uma recarga realizada manualmente por um administrador.
O que significa Recarga Boleto Pago?
É uma recarga realizada automaticamente pelo próprio prestador através do aplicativo.
Posso alterar o saldo manualmente?
É possível realizar uma edição manual, porém recomendamos utilizar o Acerto para adicionar ou retirar valores do saldo, mantendo o registro correto da movimentação.
Para mais informações, consulte a wiki [Tipos de Acerto](INSERIR LINK).
📞 Precisa de ajuda?
Caso tenha dúvidas durante a análise de uma movimentação, entre em contato com o Suporte DevBase.