# Guia de Resolução de Problemas — Lokk
### Para uso interno: Call Center, Suporte e Administradores

---

## Como usar este documento

Cada problema está descrito da forma como um utilizador ou administrador o reporta, seguido de:
- **Diagnóstico** — perguntas a fazer e onde verificar
- **Resolução passo a passo** — ações ordenadas do mais simples para o mais complexo
- **Escalamento** — quando e para quem escalar se o problema não se resolver

Os problemas estão organizados por vertente de negócio. Começa sempre pelo **diagnóstico** antes de avançar para a resolução — muitos problemas diferentes têm sintomas parecidos.

---

## Índice

1. [Entregas (Deliveries)](#1-entregas-deliveries)
2. [Vending (Produtos em Cacifos)](#2-vending-produtos-em-cacifos)
3. [Office (Aluguer Gratuito)](#3-office-aluguer-gratuito)
4. [Aluguer Pago (Rental)](#4-aluguer-pago-rental)
5. [Cacifos — Hardware e Estado](#5-cacifos--hardware-e-estado)
6. [Pagamentos e Transações](#6-pagamentos-e-transações)
7. [SMS e Notificações](#7-sms-e-notificações)
8. [Autenticação e Acesso ao Dashboard](#8-autenticação-e-acesso-ao-dashboard)
9. [Utilizadores e PINs](#9-utilizadores-e-pins)
10. [Configurações e Comportamento Inesperado](#10-configurações-e-comportamento-inesperado)

---

## 1. Entregas (Deliveries)

---

### 1.1 "Não recebi o SMS com o código para levantar a encomenda"

**Quem reporta:** destinatário da encomenda

**Diagnóstico — perguntas a fazer:**
- Qual é o número de telemóvel? Tem indicativo de país? (ex: +351 para Portugal)
- Confirmou com o estafeta que a encomenda foi depositada no cacifo?
- Já esperou pelo menos 5 minutos após o depósito?

**Verificação no dashboard:**
1. Localiza a entrega pelo nome, email, telefone ou referência
2. Verifica se a encomenda já consta como guardada no cacifo. Se ainda estiver numa fase anterior do processo, o SMS ainda não foi enviado (ver problema 1.3)
3. Vai ao histórico da entrega e procura os eventos relacionados com o envio do SMS
4. Se aparece registo de envio mas não de entrega ao destinatário, o SMS saiu mas não chegou
5. Vai à lista de SMS não entregues — confirma se esta entrega aparece lá e qual o motivo indicado

**Resolução:**
1. Se o número estiver errado → edita a entrega com o número correto → reenvia o SMS
2. Se o número estiver certo mas o envio falhou → usa a opção de reenviar SMS
3. Se o reenvio também falhar → consulta o motivo do erro na lista de SMS não entregues:
   - Número inválido ou inativo → pede ao utilizador um número alternativo
   - Bloqueio por parte da operadora → tenta reenviar mais tarde ou usa outro canal
   - Linha fixa que não recebe SMS → pede número de telemóvel diferente
4. Como alternativa imediata → fornece o código de levantamento diretamente (disponível nos detalhes da entrega)

**Escalamento:** Se o SMS continua a falhar depois de corrigir o número e tentar 2 vezes, escala para equipa técnica com: ID da entrega, número de destino, e motivo do erro indicado pelo sistema.

---

### 1.2 "Tentei o código PIN mas o cacifo não abriu"

**Quem reporta:** destinatário da encomenda

**Diagnóstico — perguntas a fazer:**
- Qual é a referência ou número de encomenda?
- Onde está a introduzir o código — no ecrã junto aos cacifos, na app, ou noutro local?
- O ecrã/app deu alguma mensagem de erro?
- Qual é o número de cacifo indicado no SMS?

**Verificação no dashboard:**
1. Localiza a entrega e verifica o estado atual
2. Confirma o PIN registado na entrega e o cacifo atribuído
3. Verifica se o cacifo está ativo e com a porta fechada
4. Consulta os registos do cacifo para ver se houve alguma tentativa de abertura registada

**Resolução:**
1. Confirma que o cliente está a usar o cacifo correto — pode estar a tentar num cacifo errado
2. Confirma que o PIN está correto — lê o PIN ao cliente e pede para tentar novamente
3. Se o cacifo não responde → vai aos detalhes do cacifo → sincroniza → tenta abrir manualmente pelo dashboard
4. Se o cacifo abrir pelo dashboard mas não pelo ecrã/app → problema no ecrã ou na app, não no cacifo; regista o problema do ecrã
5. Se o cacifo não abrir por nenhum meio → hardware offline ou avariado (ver secção 5)

**Escalamento:** Se o cacifo não abre por nenhum meio, escala para manutenção com: ID do cacifo, localização física, e último registo de comunicação.

---

### 1.3 "A encomenda foi depositada mas o sistema não a marcou como guardada"

**Quem reporta:** estafeta ou administrador

**Diagnóstico:**
1. Verifica o estado atual da entrega no dashboard
2. Verifica se o cacifo está marcado como reservado para esta entrega e se a porta está fechada
3. Consulta os registos do cacifo — houve registo de fecho de porta?

**Resolução:**
1. Se a porta fisicamente está fechada mas o sistema não registou → o sensor pode ter falhado; vai ao cacifo e sincroniza para forçar a leitura do estado real
2. Depois de sincronizar, se o cacifo mostrar a porta fechada, atualiza manualmente o estado da entrega para indicar que a encomenda está guardada
3. Após esta atualização, o sistema envia automaticamente o SMS — confirma que foi enviado

**Escalamento:** Se o sensor de porta falha com frequência no mesmo cacifo, regista para manutenção preventiva.

---

### 1.4 "O destinatário quer levantar a encomenda mas perdeu/não tem acesso ao PIN"

**Quem reporta:** destinatário ou estafeta no local

**Resolução:**
1. Verifica a identidade do destinatário (nome + número de telefone ou email da encomenda)
2. Se confirmar a identidade → no dashboard, vai à entrega → usa a opção de levantamento pelo staff — o cacifo abre e a entrega fica registada como entregue diretamente pela equipa
3. Alternativamente, podes reenviar o SMS com um novo PIN se o número estiver acessível

> Nunca forneças o PIN a uma pessoa que não consiga confirmar a sua identidade como destinatário.

---

### 1.5 "A encomenda já não pode ser levantada pelo prazo normal mas o destinatário ainda a quer"

**Quem reporta:** destinatário ou administrador

**Diagnóstico:**
- Qual é o prazo configurado para este tipo de entrega?
- O cacifo ainda está atribuído à entrega ou já foi libertado?

**Resolução:**
1. Se o cacifo ainda está atribuído e a encomenda fisicamente ainda lá está:
   - O PIN original pode já não funcionar
   - Usa a opção de levantamento pelo staff para abrir o cacifo e entregar ao destinatário
   - Atualiza o estado da entrega para concluída
2. Se o cacifo já foi libertado depois do prazo ter passado:
   - Verifica fisicamente o cacifo — pode estar vazio (a encomenda foi recolhida por alguém) ou ainda lá estar
   - Se ainda lá estiver, abre pelo dashboard e procede ao levantamento manual
3. Cancela ou arquiva a entrega conforme o desfecho

---

### 1.6 "Há uma referência duplicada — a mesma encomenda foi criada duas vezes"

**Quem reporta:** administrador

**Verificação:**
- Usa a ferramenta de referências duplicadas no módulo de entregas para identificar todos os casos
- Verifica qual das entregas tem o cacifo atribuído e está com encomenda física

**Resolução:**
1. Identifica a entrega "real" (normalmente a que tem cacifo atribuído e está mais avançada no processo)
2. Cancela a entrega duplicada — o sistema liberta o cacifo se tiver algum atribuído
3. Se ambas têm cacifo atribuído, abre os cacifos, verifica qual tem a encomenda e liberta o vazio

---

### 1.7 "O estafeta não consegue abrir o cacifo para depositar a encomenda"

**Quem reporta:** estafeta no local

**Diagnóstico:**
- A entrega existe no sistema e já tem um cacifo atribuído?
- Qual é o método que o estafeta está a usar — ecrã, app, leitor?

**Resolução:**
1. Verifica a entrega no dashboard e confirma o cacifo atribuído
2. Verifica que o cacifo está ativo e com a porta fechada
3. Tenta abrir o cacifo diretamente pelo dashboard
4. Se o cacifo abrir pelo dashboard, o problema é no ecrã/leitor — o estafeta pode depositar na mesma
5. Se o cacifo não abre por nenhum meio → hardware offline (ver secção 5); atribui outro cacifo disponível à entrega

---

### 1.8 "Quero cancelar uma entrega"

**Quem reporta:** administrador ou cliente da operação

**Verificação:** O cancelamento é possível em qualquer fase anterior à entrega final — incluindo quando a encomenda já está guardada no cacifo, caso em que o cacifo abre para permitir a recolha.

**Não é possível cancelar se:** a entrega já foi entregue ou já foi arquivada.

**Resolução:**
1. Localiza a entrega
2. Clica em "Cancelar"
3. Se a encomenda ainda estiver guardada no cacifo, o sistema abre-o para permitir recolhê-la — confirma que foi fisicamente retirada antes de fechar a porta
4. O cacifo é libertado automaticamente

---

## 2. Vending (Produtos em Cacifos)

---

### 2.1 "O produto não aparece disponível na app / no ecrã"

**Quem reporta:** utilizador final ou administrador

**Diagnóstico:**
1. No dashboard, localiza o item pelo nome
2. Verifica se está marcado como disponível e se está ativo
3. Verifica se o cacifo atribuído ao item está ativo e com a porta fechada

**Resolução:**
1. Se o item ainda não foi atribuído a nenhum cacifo → atribui um e guarda o produto
2. Se o cacifo já foi atribuído mas o produto ainda não foi colocado → usa a opção de armazenar para abrir o cacifo, coloca o produto e fecha a porta
3. Se o produto já foi vendido e está à espera de reposição → usa também a opção de armazenar para repor
4. Se o item foi cancelado → cria um novo ou edita o existente e atribui-lhe um novo cacifo
5. Se o item está disponível mas não aparece na app → verifica se a localização está corretamente configurada na app; se sim, escala para equipa técnica

---

### 2.2 "Um cliente pagou mas o cacifo não abriu para entregar o produto"

**Quem reporta:** utilizador final

**Diagnóstico:**
1. Localiza a compra no dashboard — pelo nome do utilizador ou data/hora
2. Verifica se o pagamento foi confirmado e se o sistema está à espera de abrir o cacifo
3. Verifica o estado do cacifo — está ativo? Tem a porta fechada?

**Resolução:**
1. Se o pagamento foi confirmado mas o cacifo não abriu → vai ao item correspondente → usa a opção de entrega pelo staff — o cacifo abre para o cliente levantar o produto
2. Se o cacifo está offline ou avariado → abre manualmente (ver secção 5) e entrega o produto ao cliente
3. Se o pagamento não consta como confirmado apesar de o cliente dizer que pagou → verifica diretamente na plataforma de pagamento pelo ID da transação; se o pagamento foi processado, sincroniza o estado; se não foi processado, o cliente não foi cobrado e pode tentar novamente

---

### 2.3 "O cliente quer devolver / pedir reembolso de um produto de vending"

**Quem reporta:** utilizador final

**Diagnóstico:**
- O cliente já levantou o produto ou ainda está à espera?
- O produto tem defeito ou o cliente simplesmente não quer?

**Resolução:**
1. Localiza a compra no dashboard
2. Se o produto já foi levantado e o cliente quer reembolso por defeito:
   - Usa a opção de devolução — o sistema processa o reembolso automaticamente através do método de pagamento original
   - O item volta a ficar disponível (se for produto de stock)
3. Se o cliente ainda não levantou o produto e quer cancelar:
   - Usa a opção de cancelar a compra — não há cobrança, ou a autorização é anulada
   - O item volta a ficar disponível
4. Confirma ao cliente o prazo habitual de reembolso no cartão (tipicamente 3-5 dias úteis)

> Reembolsos só funcionam automaticamente se o pagamento foi processado através da plataforma de cartão habitual. Se foi processado por outro método, escala para equipa financeira.

---

### 2.4 "O produto está no cacifo mas o item aparece como vendido"

**Quem reporta:** administrador durante inspeção

**Situação:** Alguém marcou o item como vendido mas o produto continua no cacifo (ex: cliente abriu o cacifo e não levou o produto, ou erro operacional).

**Resolução:**
1. Localiza o item no dashboard
2. Usa a opção de verificação — o cacifo abre para inspeção sem alterar o estado de venda
3. Confirma fisicamente que o produto está lá
4. Se o produto está lá e a compra associada consta como concluída, resolve caso a caso:
   - Se foi erro operacional → contacta equipa técnica para correção do estado
   - Se o cliente pagou e não levantou → contacta o cliente

---

### 2.5 "O cacifo de vending está a mostrar um alerta de reposição"

**Quem reporta:** administrador

**Verificação:**
1. Vai à lista de itens à espera de reposição
2. Identifica quais os itens e respetivos cacifos que precisam de reabastecimento

**Resolução:**
1. Reúne os produtos de reposição
2. Para cada item em falta, usa a opção de armazenar — o cacifo abre
3. Coloca o produto e fecha a porta
4. O sistema regista automaticamente e o item volta a ficar disponível

---

## 3. Office (Aluguer Gratuito)

---

### 3.1 "O colaborador não consegue abrir o cacifo com o cartão"

**Quem reporta:** colaborador no local ou responsável de escritório

**Diagnóstico — perguntas a fazer:**
- O colaborador já usou o sistema antes ou é a primeira vez?
- Qual é o leitor que está a usar — número ou localização?
- O cartão é o mesmo que usou noutras vezes?
- O ecrã ou leitor dá alguma mensagem de erro?

**Verificação no dashboard:**
1. Localiza o utilizador pelo nome ou número de cartão
2. Verifica se o utilizador está ativo
3. Verifica se o número de cartão registado corresponde ao cartão que está a usar
4. Verifica se o cacifo atribuído (se for dedicado) está ativo e com a porta fechada
5. Verifica as configurações de horário da localização — o acesso está dentro do horário permitido?

**Resolução:**
1. Se o utilizador está inativo → ativa-o no dashboard
2. Se o número de cartão está errado → atualiza-o no perfil do utilizador
3. Se o cacifo dedicado está ocupado ou avariado → verifica o estado e liberta se necessário (ver problema 3.2)
4. Se está fora do horário configurado → explica ao colaborador o horário de acesso; se precisar de ser alargado, configura nas definições da localização
5. Se o leitor não está a funcionar → testa abrir o cacifo pelo dashboard para confirmar que o cacifo funciona; o problema é no leitor — escala para manutenção

---

### 3.2 "O cacifo de um colaborador ficou ocupado e ele não consegue recuperar os seus pertences"

**Quem reporta:** colaborador

**Diagnóstico:**
- O cacifo é dedicado ao colaborador ou partilhado?
- O colaborador perdeu o acesso pelo cartão, app, ou ambos?

**Resolução:**
1. Verifica no dashboard o cacifo atribuído ao utilizador
2. Abre o cacifo manualmente pelo dashboard
3. O colaborador retira os pertences e fecha a porta
4. Investiga por que razão o acesso normal falhou (cartão atualizado? Leitor offline?)

---

### 3.3 "O sistema está a pedir pagamento mas o cacifo devia ser gratuito"

**Quem reporta:** utilizador final ou administrador

**Diagnóstico:**
- O modo gratuito está ativo para esta localização?
- O utilizador tem o tipo correto configurado (ex: visitante)?

**Verificação no dashboard:**
1. Vai às Configurações → filtra pela localização em questão
2. Localiza a opção de modo gratuito
3. Confirma que está ativa para o tipo de utilizador adequado

**Resolução:**
1. Se o modo gratuito está desativado → ativa-o nas configurações da localização
2. Se está ativo mas o sistema continua a pedir pagamento → pode ser um problema de cache ou de tipo de utilizador não reconhecido; escala para equipa técnica com: ID da localização e tipo do utilizador

---

### 3.4 "Um colaborador não devolve o cacifo — está ocupado há mais de X dias"

**Quem reporta:** responsável de escritório / administrador

**Resolução:**
1. Identifica o cacifo ocupado e o utilizador a quem está atribuído
2. Contacta o colaborador para levantar os pertences
3. Se não for possível contactar ou resolver → abre o cacifo pelo dashboard, retira os pertences, guarda-os num local seguro e liberta o cacifo
4. Regista a ação com observação no perfil do utilizador ou no histórico

---

### 3.5 "Nenhum cacifo está disponível — todos estão ocupados"

**Quem reporta:** colaborador ou responsável de escritório

**Diagnóstico:**
1. Vai ao painel de análise de office → confirma a taxa de ocupação atual
2. Identifica cacifos ocupados há muito tempo cujo utilizador pode já não precisar deles
3. Verifica se há cacifos desativados que podem ser reativados

**Resolução:**
1. Se há cacifos ocupados com muito tempo de inatividade → liberta os inativos (ver problema 3.4)
2. Se há cacifos desativados sem motivo aparente → reativa-os
3. Se a ocupação é genuinamente total → considera aumentar o número de cacifos ou rever se há cacifos de outras vertentes (entrega, aluguer pago) que possam ser reconfigurados

---

### 3.6 "O cacifo ficou com a porta aberta e ninguém fecha"

**Quem reporta:** colega de escritório ou administrador

**Resolução:**
1. Na lista de cacifos com porta aberta, identifica o cacifo em questão
2. Verifica se o utilizador atribuído ainda está no local — se sim, notifica-o
3. Se ninguém fechar fisicamente a porta, envia alguém para fechar
4. Depois de fechada, sincroniza para atualizar o estado no sistema

---

## 4. Aluguer Pago (Rental)

---

### 4.1 "Iniciei o aluguer mas não consigo terminar e continua a cobrar"

**Quem reporta:** utilizador final

**Diagnóstico:**
1. Localiza a transação ativa do utilizador
2. Verifica se o cacifo continua registado como alugado
3. O utilizador está a tentar terminar pela app, pelo ecrã, ou pelo dashboard?

**Resolução:**
1. Se o utilizador fez o checkout na app mas o sistema não registou → vai à transação → sincroniza com a plataforma de pagamento para atualizar o estado
2. Se o checkout não foi feito e o utilizador quer terminar agora → faz o checkout pelo dashboard — o valor é capturado até ao momento atual e o cacifo é libertado
3. Se o utilizador não tem forma de pagar imediatamente → podes cancelar a transação se ainda não tiver sido cobrada de facto; se já foi cobrada, é necessário emitir uma nota de crédito

---

### 4.2 "Fui cobrado mais do que esperava"

**Quem reporta:** utilizador final

**Diagnóstico:**
1. Localiza a transação pelo utilizador ou referência
2. Verifica a hora de início, hora de fim, duração total, o pacote aplicado e se havia algum voucher
3. Confirma se o voucher foi corretamente aplicado, caso existisse um código de desconto

**Resolução:**
1. Se o pacote ou a duração parecem incorretos → verifica o histórico da transação para perceber o que aconteceu
2. Se o utilizador tinha um voucher que não foi aplicado → vai à transação e atualiza com o código correto; o sistema recalcula o preço
3. Se houve um erro real no cálculo → escala para equipa técnica com: ID da transação, pacote esperado e valor cobrado
4. Se se confirmar erro → emite uma nota de crédito para reembolsar a diferença

---

### 4.3 "O cacifo passou do tempo de aluguer e o utilizador não terminou"

**Quem reporta:** administrador

**Verificação:**
- Vai à lista de cacifos com aluguer vencido para ver todos os casos em aberto

**Resolução:**
1. Tenta contactar o utilizador para que termine o aluguer normalmente
2. Se não for possível → faz o checkout pelo dashboard (será capturado o valor máximo permitido pelo método de pagamento)
3. Abre o cacifo pelo dashboard para verificar se há pertences — se sim, guarda-os em local seguro
4. Liberta o cacifo

---

### 4.4 "O utilizador quer usar um voucher mas o código não está a funcionar"

**Quem reporta:** utilizador final

**Diagnóstico — perguntas a fazer:**
- Qual é o código exato?
- Em que ecrã/app está a tentar?
- Qual é o tipo de aluguer que está a fazer?

**Verificação no dashboard:**
1. Localiza o voucher pelo código
2. Verifica:
   - Está ativo?
   - Está dentro do período de validade?
   - Já atingiu o limite de usos (total ou diário)?
   - O tipo de aluguer corresponde ao tipo do voucher?
   - A localização do utilizador corresponde à localização do voucher (quando aplicável)?

**Resolução:**
1. Se o voucher já expirou → informa o utilizador; se for caso excecional, escala para gestor que pode editar a data de validade
2. Se atingiu o limite diário → informa que pode tentar no dia seguinte
3. Se o tipo ou a localização não coincidem → informa o utilizador que o voucher não se aplica a este caso
4. Se tudo parece correto mas mesmo assim não funciona → escala para equipa técnica com: código do voucher, ID da localização, tipo de aluguer e mensagem de erro apresentada

---

## 5. Cacifos — Hardware e Estado

---

### 5.1 "O cacifo não abre por nenhum meio"

**Quem reporta:** qualquer utilizador ou administrador

**Diagnóstico:**
1. Vai aos detalhes do cacifo no dashboard
2. Verifica se está ativo
3. Verifica quando foi a última atualização do estado da porta
4. Tenta sincronizar — o cacifo responde ou dá timeout?

**Resolução por cenário:**

| Situação | Ação |
|----------|------|
| Cacifo desativado no dashboard | Ativa o cacifo → tenta abrir novamente |
| Hardware responde mas cacifo não abre fisicamente | Pode ser problema mecânico; envia alguém para inspeção física |
| Hardware não responde (timeout) | Cacifo offline — verifica ligação de rede/alimentação no local |
| Cacifo num período de segurança temporário | Aguarda esse tempo expirar; ou força a libertação se urgente |

**Escalamento:** Se o hardware não responde depois de verificar a ligação, escala para equipa técnica com: ID do cacifo, localização física e momento da última comunicação registada.

---

### 5.2 "A porta do cacifo ficou aberta e não fecha"

**Quem reporta:** utilizador ou staff no local

**Diagnóstico:**
- A porta está fisicamente aberta ou é apenas o sistema que indica isso?
- Há algum objeto a bloquear o fecho?

**Resolução:**
1. Verifica fisicamente se há algo a bloquear a porta
2. Se a porta fecha fisicamente mas o sistema continua a indicar que está aberta → sincroniza para atualizar o sensor
3. Se a porta não fecha mesmo fisicamente → problema mecânico na fechadura; marca o cacifo para manutenção e desativa-o para impedir novas utilizações

---

### 5.3 "O sistema diz que o cacifo está ocupado mas está visualmente vazio"

**Quem reporta:** staff no local ou administrador

**Situação:** O sistema mostra o cacifo como ocupado ou reservado, mas está vazio fisicamente.

**Resolução:**
1. Verifica nos detalhes do cacifo se há uma transação ativa ou uma entrega atribuída
2. Se tem uma entrega → cancela-a (o cacifo liberta automaticamente)
3. Se tem uma transação → faz checkout pelo dashboard (captura o valor devido, se aplicável)
4. Se não tem nenhum registo mas o estado continua a indicar ocupado → atualiza diretamente o estado para livre
5. Sincroniza para confirmar que o hardware está alinhado com o sistema

---

### 5.4 "Um cacifo está constantemente a dar alertas"

**Quem reporta:** administrador via dashboard

**Diagnóstico:**
- O alerta é sobre porta aberta, ou sobre o cacifo estar offline?
- Quantas vezes ocorreu e em que intervalo de tempo?

**Resolução:**
1. Verifica o histórico do cacifo para perceber o padrão dos alertas
2. Se for sobre a porta → pode ser problema no sensor de fecho; pede inspeção física
3. Se for alerta frequente sem padrão aparente → pode ser instabilidade de comunicação; verifica a rede no local
4. Desativa temporariamente o cacifo para evitar que seja atribuído a novas utilizações
5. Marca para manutenção
6. Escala para equipa técnica com: ID do cacifo, tipo de alerta, frequência e histórico das últimas 24h

---

### 5.5 "Precisamos de desativar vários cacifos temporariamente (ex: manutenção, obras)"

**Quem reporta:** administrador

**Resolução:**
1. Seleciona os cacifos a desativar (individualmente ou em lote)
2. Usa a opção de ativar/desativar — os cacifos ficam marcados como inativos e deixam de aparecer para novas atribuições
3. Garante que nenhum cacifo tem uma utilização ativa antes de desativar — se tiver, resolve primeiro (termina o aluguer ou cancela a entrega)
4. Quando a manutenção terminar, reativa os cacifos pelo mesmo processo

---

## 6. Pagamentos e Transações

---

### 6.1 "Fiz o pagamento mas continua a aparecer como pendente"

**Quem reporta:** utilizador final

**Diagnóstico:**
1. Localiza a transação pelo utilizador ou referência
2. Verifica se ainda está em processamento ou já foi capturada
3. Confirma qual a plataforma de pagamento usada

**Resolução:**
1. Consulta diretamente a plataforma de pagamento para ver o estado real
2. Se a plataforma confirma que o pagamento foi processado mas o sistema não atualizou → sincroniza
3. Se a plataforma diz que está pendente ou falhou:
   - Informa o utilizador que o pagamento não foi concluído
   - O utilizador pode tentar novamente
   - Cancela a transação pendente se já não for possível concluir
4. Se a plataforma diz que a autorização expirou → cancela a transação; o utilizador pode iniciar novo aluguer

---

### 6.2 "Fui cobrado mas não usei o cacifo / não recebi o serviço"

**Quem reporta:** utilizador final

**Diagnóstico:**
1. Localiza a transação
2. Verifica no histórico se houve abertura de cacifo e se o pagamento foi mesmo capturado
3. Confirma a duração do aluguer registada

**Resolução:**
1. Se houve cobrança mas não houve uso real (ex: cacifo avariou logo após o início):
   - Confirma o problema no histórico do cacifo
   - Emite uma nota de crédito pelo valor cobrado
2. Se a transação foi capturada por erro do sistema:
   - Documenta o caso com as evidências disponíveis (registo de cacifo, registo de transação)
   - Emite a nota de crédito
   - Escala para equipa técnica investigar a causa raiz

---

### 6.3 "Preciso de emitir uma fatura para uma transação"

**Quem reporta:** administrador ou utilizador final (pedido por email/telefone)

**Resolução:**
1. Localiza a transação no dashboard
2. Confirma que o pagamento foi concluído
3. Usa a opção de criar fatura
4. Preenche: valor, NIF do cliente (valida o NIF se for português), código de produto
5. A fatura é gerada e fica associada à transação
6. Para enviar ao cliente → usa a opção de enviar fatura → introduz o email

> Se o cliente precisar de retificar os dados da fatura (ex: NIF errado), não é possível editar a fatura já emitida — emite uma nota de crédito e cria uma nova fatura com os dados corretos.

---

### 6.4 "A transação está em erro — o cliente não consegue pagar"

**Quem reporta:** utilizador final

**Diagnóstico — perguntas a fazer:**
- Qual é o método de pagamento (cartão, MBWay)?
- Qual é a mensagem de erro apresentada?
- O cartão está válido? Tem saldo/limite?

**Resolução:**
1. Pede ao utilizador para verificar os dados do cartão (número, validade, código de segurança) e tentar novamente
2. Se for MBWay → confirma que o número de telemóvel registado na app é o mesmo que introduziu; a confirmação tem um prazo de cerca de 4 minutos
3. Se continua a falhar com cartão válido → pode ser restrição da operadora ou do banco; sugere tentar com outro cartão
4. Consulta o histórico da transação para ver o motivo específico do erro
5. Se o erro for persistente com múltiplos cartões → escala para equipa técnica com: ID da transação e motivo do erro

---

### 6.5 "Quero aplicar um reembolso parcial"

**Quem reporta:** administrador

**Situação:** O cliente foi cobrado um valor total mas tem direito a uma devolução parcial (ex: aluguer interrompido por avaria, promoção retroativa).

**Resolução:**
1. Localiza a transação
2. Usa a opção de criar nota de crédito e define o valor parcial a reembolsar
3. O sistema processa o reembolso para o método de pagamento original
4. A transação passa a refletir um reembolso parcial
5. Informa o cliente do prazo habitual de reembolso (3-5 dias úteis)

---

## 7. SMS e Notificações

---

### 7.1 "O SMS chegou mas com o conteúdo errado / número de cacifo errado"

**Quem reporta:** destinatário de entrega

**Diagnóstico:**
1. Verifica a entrega no dashboard — o cacifo atribuído é o correto?
2. Compara o conteúdo esperado do SMS com a mensagem configurada para o local

**Resolução:**
1. Se o cacifo atribuído estiver errado → verifica se houve uma substituição posterior; o SMS pode ter sido enviado com os dados anteriores
2. Reenvia o SMS depois de confirmar que o cacifo correto está atribuído
3. Se o problema for no próprio modelo de mensagem (uma variável a mostrar o valor errado) → corrige o modelo nas configurações do local; reenvia

---

### 7.2 "Estamos a receber demasiados SMS — o sistema parece estar em loop"

**Quem reporta:** destinatário ou administrador

**Diagnóstico:**
1. Verifica nas configurações do local o número de tentativas de reenvio configurado e o intervalo entre elas
2. Verifica no histórico da entrega quantos reenvios já foram feitos

**Resolução:**
1. Se o número de tentativas está demasiado alto → reduz o valor nas configurações
2. Se o intervalo entre tentativas é muito curto → aumenta-o
3. Para a entrega específica → cancela manualmente os reenvios pendentes se o destinatário já tiver o PIN

---

### 7.3 "O SMS está a ser enviado para o número errado"

**Quem reporta:** destinatário ou administrador

**Resolução:**
1. Verifica na entrega se o número de telemóvel registado tem o indicativo de país correto (ex: 351 antes do número, e não o número isolado)
2. Se o indicativo estiver em falta → edita a entrega e corrige o número; reenvia o SMS
3. Se o número estiver completamente errado → corrige-o da mesma forma

---

## 8. Autenticação e Acesso ao Dashboard

---

### 8.1 "Não consigo fazer login — a palavra-passe está incorreta"

**Quem reporta:** administrador

**Resolução:**
1. Usa a opção de recuperar palavra-passe na página de login
2. Introduz o email da conta
3. Verifica o email recebido (incluindo pasta de spam) para o link de redefinição
4. O link tem validade limitada — se expirou, repete o processo

**Se não receberes o email de recuperação:**
- Confirma que o email introduzido é o correto
- Verifica a pasta de spam
- Escala para outro administrador verificar se o email da conta está correto no dashboard

---

### 8.2 "Não estou a receber o código de verificação por SMS"

**Quem reporta:** administrador

**Diagnóstico:**
- O número de telemóvel da conta está correto?
- Há sinal de rede no local?

**Resolução:**
1. Aguarda 1-2 minutos — pode haver atraso na rede da operadora
2. Tenta pedir um novo código
3. Se continua a não receber → escala para outro administrador para:
   - Verificar o número de telemóvel no perfil da conta
   - Corrigir se estiver errado
   - Confirmar se o serviço de SMS está ativo nas configurações do sistema

---

### 8.3 "Fui convidado mas o link de ativação não funciona / expirou"

**Quem reporta:** novo administrador

**Resolução:**
1. Qualquer administrador com permissão pode aceder ao perfil do novo administrador
2. Usa a opção de reenviar convite
3. Um novo email de ativação é enviado com um link válido

---

### 8.4 "Consigo fazer login mas não vejo nenhum local / as listas aparecem vazias"

**Quem reporta:** administrador

**Diagnóstico:**
- O teu perfil tem locais atribuídos?
- O teu nível de permissão permite ver estes dados?

**Resolução:**
1. Pede ao administrador principal para verificar o teu perfil
2. No módulo de administradores → detalhes do teu utilizador → confirma que estão atribuídos os locais corretos
3. Se os locais estão atribuídos mas os dados continuam a não aparecer → verifica o nível de permissão; pode não ter acesso suficiente

---

### 8.5 "Preciso de desativar um administrador que saiu da empresa"

**Quem reporta:** administrador principal / gestor

**Resolução:**
1. Vai ao módulo Administradores
2. Localiza o utilizador
3. Usa a opção de desativar — o acesso é imediato e o utilizador não consegue fazer login
4. Opcionalmente, elimina a conta se não houver necessidade de manter o histórico associado

> Prefere **desativar** a **eliminar** — a eliminação apaga o histórico de ações do administrador, o que pode ser necessário para auditoria.

---

## 9. Utilizadores e PINs

---

### 9.1 "O utilizador esqueceu o PIN e não consegue abrir o cacifo"

**Quem reporta:** utilizador ou rececionista

**Resolução:**
1. Localiza o utilizador no dashboard
2. Podes consultar o PIN atual nos detalhes do utilizador e fornecê-lo (se a política de segurança o permitir)
3. Ou define um novo PIN e comunica-o ao utilizador
4. Podes usar a geração automática de PIN para criar um PIN único

---

### 9.2 "O PIN do utilizador está a ser rejeitado mas parece estar correto"

**Quem reporta:** utilizador

**Diagnóstico:**
1. Verifica no dashboard o PIN exato do utilizador
2. Confirma que o utilizador está a introduzir o PIN no cacifo/ecrã certo
3. Verifica se o utilizador está ativo
4. Se for cacifo dedicado, verifica se ainda está atribuído a este utilizador

**Resolução:**
1. Se o utilizador está inativo → ativa-o
2. Se a atribuição do cacifo foi removida → reatribui o cacifo
3. Se o PIN parece correto mas é rejeitado pelo hardware → pode ser problema no leitor; testa abrir o cacifo pelo dashboard para isolar se é o PIN ou o hardware

---

### 9.3 "Preciso de criar muitos utilizadores de uma vez"

**Quem reporta:** administrador

**Situação:** Novo cliente com muitos colaboradores (ex: abertura de novo escritório).

**Resolução:**
1. Não existe importação massiva de utilizadores na versão atual
2. Para cada utilizador, usa a opção de criar novo utilizador preenchendo os dados mínimos: nome, email, telefone, PIN, tipo e local
3. Usa a geração automática de PIN para agilizar o processo
4. Se o volume for muito grande, escala para equipa técnica para avaliar uma importação direta

---

### 9.4 "Um utilizador foi eliminado por engano e os seus cacifos foram libertados"

**Quem reporta:** administrador

**Situação:** A eliminação de um utilizador liberta todos os cacifos. Esta ação não é reversível pelo dashboard.

**Resolução:**
1. Cria um novo utilizador com os mesmos dados
2. Reatribui os cacifos ao novo utilizador
3. Se havia histórico de transações associadas ao utilizador eliminado, esse histórico é perdido — escala para equipa técnica se for necessário recuperar dados

> **Prevenção:** Sempre que possível, usa **"Desativar"** em vez de **"Eliminar"** — o utilizador perde acesso mas os dados e histórico são preservados.

---

## 10. Configurações e Comportamento Inesperado

---

### 10.1 "Uma configuração foi alterada mas o sistema não está a respeitar"

**Quem reporta:** administrador

**Diagnóstico:**
- A configuração foi feita a nível global ou apenas para um local específico?
- Há uma configuração mais específica que sobrepõe a configuração global?

**Verificação:**
1. Vai às Configurações e filtra especificamente pelo local em questão
2. Verifica se existe ali uma configuração com um valor diferente do global

**Resolução:**
1. Se o local tem uma configuração específica que sobrepõe a global → edita diretamente essa configuração
2. Aguarda alguns minutos após guardar — algumas alterações requerem um período de processamento
3. Se após 15 minutos o comportamento não mudou → escala para equipa técnica com: nome da configuração, âmbito (global/local), valor anterior e novo valor

---

### 10.2 "O sistema está a bloquear alugueres fora de horas — mas o horário não devia estar configurado"

**Quem reporta:** utilizador final ou administrador

**Diagnóstico:**
1. Vai às configurações de horário do local em questão
2. Verifica se há um horário definido e quais os dias/horas configurados

**Resolução:**
1. Se o horário está ativo e não devia estar → desativa a configuração de horário
2. Se o horário está correto mas o bloqueio está a acontecer dentro do horário permitido → escala para equipa técnica

---

### 10.3 "Os preços dos pacotes parecem estar errados"

**Quem reporta:** utilizador ou administrador

**Diagnóstico:**
1. Vai aos Pacotes do local em questão
2. Verifica o preço de cada pacote e a moeda configurada
3. Verifica se há voucher aplicado que altera o preço final

**Resolução:**
1. Se o preço do pacote está errado → edita-o com o valor correto
2. Se a moeda está errada → corrige a moeda no pacote ou nas configurações de moeda do local
3. Se há um voucher a aplicar desconto inesperado → verifica o voucher associado e remove se for indevido

---

### 10.4 "O sistema parece estar em modo de emergência ou offline"

**Quem reporta:** qualquer utilizador

**Diagnóstico:**
1. Vai às Configurações → verifica o estado geral do sistema

**Resolução:**
1. Se o estado estiver marcado como offline ou em emergência → muda para ativo
2. Se o estado já está ativo mas o sistema parece offline → pode ser problema de infraestrutura; escala imediatamente para equipa técnica

---

### 10.5 "Os webhooks estão a falhar / sistema externo não está a receber notificações"

**Quem reporta:** equipa técnica do cliente ou administrador

**Diagnóstico:**
1. Vai à configuração de Webhooks
2. Verifica o URL configurado e o estado das últimas chamadas — tiveram sucesso, falharam, ou esgotaram as tentativas?

**Resolução:**
1. Se o estado mostra falha simples → o sistema está a tentar novamente automaticamente
2. Se as tentativas já se esgotaram → verifica se o URL do destino está correto e acessível
3. Testa o endpoint externamente (abre o URL num browser ou faz um teste de conectividade)
4. Se o endpoint está a funcionar mas os webhooks continuam a falhar → escala para equipa técnica com: URL, evento em questão e detalhe do último erro

---

## Regras Gerais de Escalamento

Escala sempre para a equipa técnica quando:

- O problema envolve discrepâncias entre o que o sistema mostra e o estado real do hardware, mesmo depois de sincronizar
- O mesmo problema se repete no mesmo cacifo mais de 3 vezes em 24 horas
- Há cobranças duplicadas ou valores incorretos já confirmados mas que não conseguem ser corrigidos com uma nota de crédito
- O sistema de pagamento devolve erros desconhecidos
- O serviço de SMS está com falhas generalizadas (mais de 5 entregas com SMS não entregue no mesmo período)
- Há qualquer perda de dados (utilizadores, transações ou entregas que desapareceram)

Ao escalar, inclui sempre:
1. **ID do objeto afetado** (entrega, transação, cacifo, utilizador)
2. **Descrição do problema** e quando começou
3. **O que já foi tentado** e qual foi o resultado
4. **Screenshots ou registos** se possível

---

*Guia de Troubleshooting Lokk — Uso Interno | Versão 1.0 | Junho 2026*
