RN / Reembolsos (revisada)
Descrição
Este documento descreve os comportamentos das telas de reembolsos para criar, visualizar e aprovar/negar requisições de reembolsos.
Fluxo
Reembolsos
| Protótipo / Mobile | Protótipo / Desktop |
Os reembolsos são uma forma dos usuários ajustarem valores relacionados ao contrato, seja acrescentando (acréscimo) ou diminuindo (desconto) valores que estão comresponsável/proprietário ume contratoo inquilino acordarem entre si.
Importante: Reembolsos são considerados itens financeiros independentes dentro da fatura.
Eles possuem três atributos essenciais:
- Tipo: acréscimo ou desconto
- Status: pendente, aprovado, recusado, pago ou atrasado.
- Momento de
aluguelaplicação:ativopróximasefaturareembolsaremfuturaporoueventualidades ao longo do prazo do aluguel.Os valoresvistoria dereembolsossaída.
Esses aatributos cobrançadeterminam como o sistema trata o reembolso nos cálculos de split, repasse, garantia e rescisão.
Reembolsos não estãfazem parte da garantia Mellro e não inclusosdevem naser garantia.tratados como multa ou atraso.
Quem pode solicitar?
Apenas o usuário o usuário que assinou o contrato (administrador ou dono) pode criar novas requisições de reembolsoreembolso. Ele pode acessar através da página inicial, aba contratos, gerenciar contrato, é direcionado para a tela de informações desse contrato, cuja opção de reembolsos fica no quadro a esquerda.
Para criar um novo reembolso, o responsável/ dono precisa clicar no botão Novo reembolso;reembolso
Esse botão só aparece para usuários responsáveis pelo imóvel;
O responsável/ dono precisa preencher um formulário para criar a nova requisição de reembolso com os seguintes itens:
-
Acréscimo ou Desconto
O tipo do reembolso define como ele impacta financeiramente a fatura:
AcréscimoReembolso de DESCONTO
-
reduz apenas o valor destinado ao responsável/proprietário;
-
não reduz o valor do plano Mellro;
-
não reduz a comissão do corretor;
-
em rescisões, pode reduzir o valor devido do inquilino somente ao proprietário.
Reembolso de ACRÉSCIMO
-
aumenta o valor devido pelo inquilino ao responsável/proprietário;
-
não aumenta o valor do plano Mellro ou
Desconto
comissão; -
só é repassado se o inquilino pagar a fatura;
-
não é garantido pela Mellro em caso de atraso.
O valor do reembolso não altera o valor base da fatura — ele é processado separadamente como item financeiro específico.
-
Mês da fatura
Para garantir previsibilidade no cálculo da fatura, o reembolso sempre é vinculado à próxima fatura futura.
NãoO responsável só pode sercriar selecionadoreembolsos umaté mês em que a fatura já foi fechada
Só é possível selecionar uma fatura que faltam 20 dias paraantes gerarda ageração fatura,da assimpróxima fatura, respeitando o inquilino tem tempo útil de visualizaraprovação edo aceitarinquilino.
Caso recusarexista rescisão já agendada, o reembolso
é automaticamente vinculado à vistoria de saída. A partir do momento que a vistoria de saída fica disponível para edição, deve ser possível selecionar o mês da fatura “Vistoria de saída“;
Todo reembolso adicionada na Vistoria de saída, deve constar na cobrança final de saída;
A opção de Vistoria de saída só deve ficar disponível enquanto for possível editar vistoria de saída;
Nos billings do contrato, deve existir uma linha referente a vistoria de saída para que nosso time consiga acompanhar todos os reembolsos que são adicionados a vistoria de saída;
-
O que é a requisição
-
Descrição opcional
-
Valor
-
Anexar comprovantes e fotos
O tamanho máximo das imagens que o usuário pode fazer upload é de 20 mb;
Quando é feito o upload, precisamos ajustar para que o resizer comprima a imagem no máximo em full hd (1920 x 1080px) e que a compressão fique abaixo de 5mb
A compressão precisa respeitar as proporções e orientações da imagens;
O canal pro só aceita imagens com até 5mb, por isso o limite do resizer;
Assim que a requisição for enviada, ela aparece na listagem e fica disponível para o inquilino aceitar ou recusar.
Se o contrato de aluguel é rescindido, o botão de Novo reembolso não deve ser mais exibido assim que finalizar a edição da vistoria de saída;
Da mesma forma, o backend deve bloquear a criação de novos reembolsos assim que finalizar a edição da vistoria de saída;
Aprovar ou Negar requisição
| Protótipo / Mobile | Protótipo / Desktop |
Apenas o usuário inquilino pode aprovar ou recusar as requisições de reembolsoreembolso.
Caso não tenha resposta até a data da emissão da fatura em questão (requisição ser aprovada ou recusada), a requisição é aprovada automaticamente;
Para aceitar ou recusar a requisição, os inquilinos precisam acessar a tela interna da requisição em questão;
Resposta da requisição:
Uma vez que a requisição tem resposta ocorre:
- A requisição vai para o agrupamento de Antigos e o visual no item na listagem é atualizado dependendo da resposta;
- O item na listagem dentro dos detalhes da fatura é atualizado;
- Caso o reembolso seja aprovado, o sistema altera o valor do billing em questão;
- Caso o reembolso seja recusado, o valor do billing não é alterado;
Listagem:
| Protótipo / Mobile | Protótipo / Desktop |
Todos os reembolsos são exibidos por meio de uma listagem:
Aguardando resposta: Reembolsos criados pelo dono que ainda não foram aceitos, recusados ou não haja resposta até a data da emissão da fatura em questão;
Antigos: Reembolsos já resolvidos;
Carregar mais: O Botão aparece no final dos agrupamentos para exibir mais reembolsos;
Caso nenhuma requisição de reembolso tenha sido adicionada, exibimos mensagens para situar o usuário;
Itens da listagem:
Todos os reembolsos são exibidos por listagem com os seguintes itens:
- Título do reembolso;
- Data limite do prazo, caso esteja no agrupamento aguardando resposta;
- Data de aprovação ou recusa, caso esteja no grupo Antigos;
- Valor;
- Cores: As cores indicam o status do reembolso:;
- Colorido: Reembolsos aguardando resposta e Reembolsos
aprovados;
aprovados.A cor dos ícones e dos valores são referentes
fatura:oao reembolsoestáestar aumentando ou diminuindo afatura;-
- Verde se for diminuir o valor da fatura;
- Vermelho se for aumentar o valor da fatura;
- Cinza caso o reembolso foi resolvido e recusado;
- Verde se for diminuir o valor da fatura;
-
- Colorido: Reembolsos aguardando resposta e Reembolsos
Quando um reembolso é clicado na listagem ele direciona para a tela de detalhes.
Tela de detalhes do reembolso:
- Os usuários podem ver todos os detalhes do reembolso adicionado;
- Os usuários
DonosResponsáveis/ donos pode ver detalhes do reembolso cadastrado, mas não possuem botões de ação billing; - Os usuários Inquilinos podem ver detalhes do reembolso cadastrado e podem aprovar ou recusar o reembolso;
- Uma vez que o reembolso é aprovado ou recusado, o botão de ação exibido na tela de detalhes é “Ver fatura” que direciona o usuário para a tela de detalhes daquela fatura.
Comportamento financeiro do reembolso
Os reembolsos são tratados pelo sistema como componentes financeiros independentes da fatura.
Financeiramente, o sistema deve:
1. Controle de status:
Reembolsos pagos → não entram na rescisão.
Reembolsos pendentes → entram apenas se estiverem vinculados à fatura de vistoria.
2. Garantia:
Reembolso nunca compõe valores garantidos pela Mellro.
Em atraso, apenas o valor base da fatura é garantido.
3. Split:
Descontos reduzem somente a parte do proprietário.
Acréscimos aumentam somente a parte do proprietário.
Nenhum reembolso deve alterar plano Mellro ou comissão.
4. Rescisão:
Reembolsos pagos devem ser excluídos do cálculo.
Reembolsos pendentes de desconto reduzem somente o débito do inquilino com o proprietário, caso haja.
Reembolsos pendentes de acréscimo aumentam o valor devido pelo inquilino ao proprietário.
Reembolsos nunca entram como “valor em atraso”.
O backend deve sempre processar reembolsos separadamente do valor total da fatura, garantindo itemização correta.
Notificações
Reembolso criado
Gatilho: Quando um reembolso é criado;
Tipos de notificação: Notificação, e-mail e SMS;
Quem recebe: Responsável e todos os inquilinos do contrato;
SMS: “Mellro: Um reembolso foi adicionado no seu aluguel do contrato [AAA000]. Clique aqui para aprovar ou recusar: [Link-encurtado]”;
Reembolso Aprovado:
Quando: Quando um reembolso é aceito por um inquilino ou por tempo sem resposta;
Tipos de notificação: Notificação, e-mail (acréscimo e desconto), e SMS;
Quem recebe: Responsável e todos os inquilinos do contrato;
SMS: “Mellro: Um reembolso foi aprovado no seu aluguel do contrato [AAA000]. Clique aqui para ver os detalhes: [Link-encurtado]”
E-mail: Reembolso desconto aprovado / Reembolso acréscimo aprovado
Reembolso recusado:
Quando: Uma vez que o reembolso é recusado por um inquilino;
Tipos de notificação: Notificação, e-mail (acréscimo e desconto), e SMS;
Quem recebe: Responsável e todos os inquilinos do contrato;
SMS: “Mellro: Um reembolso foi recusado no seu aluguel do contrato [AAA000]. Clique aqui para ver os detalhes: [Link-encurtado]”
E-mail: Reembolso desconto recusado / Reembolso acréscimo recusado
Fluxos relacionados
| Fluxo | Como os fluxos se relacionam |
|
Plataforma / Criação de pagamentos |
Descreve como os pagamentos são criados pelo sistema, seus comportamentos e o disparo de notificações. |
|
Plataforma / Gerenciar meu aluguel |
Descreve como os clientes acessam a área de gerenciar seu aluguel. |
|
Admin / Contrato |
Descreve como nosso time da mell.ro consegue visualizar todos os detalhes sobre um contrato criado. |
| Plataforma / Pagamentos | Descreve como um cliente consegue visualizar todo seu histórico de pagamentos pela plataforma. |
| Admin / Reembolsos | Descreve como nosso time consegue visualizar todos os detalhes sobre reembolsos criados. |
| Admin / Acordo amigável | Descreve como nosso time pode configurar acordos amigáveis pelo admin. |
| Plataforma / Rescisão | Descreve como um cliente consegue preencher o fluxo de rescisão de contrato. |
| Admin / Rescisão | Descreve como nosso time consegue preencher o fluxo de rescisão de contrato e visualizar detalhes de uma rescisão iniciada ou finalizada. |
Requisitos de aceitação
[Descrever]