Canhoto da Entrega
Canhoto da Entrega
A tela de Canhoto da Entrega exibe, em formato PDF, o comprovante de recebimento gerado logo depois que o motorista coleta a assinatura do recebedor.
Visão Geral
A tela de Canhoto da Entrega exibe, em formato PDF, o comprovante de recebimento gerado logo depois que o motorista coleta a assinatura do recebedor. Ela fica entre a etapa de assinatura (onde o comprovante é montado) e a etapa seguinte de comprovação de entrega — coleta de selfie de conferência ou de canhoto físico fotografado, conforme a configuração da carga. Nesta tela o motorista confere o comprovante gerado e confirma para seguir adiante; não é aqui que o comprovante é criado, apenas exibido e confirmado.
Pré-requisitos
A tela de canhoto da entrega só pode ser aberta com dois dados já prontos: a carga em questão e o comprovante em PDF, já gerado na etapa anterior de assinatura. Sem esses dois itens, a tela não tem como ser aberta — ela não gera o comprovante por conta própria.
Fluxo Operacional
- O motorista chega à tela de canhoto logo após concluir a assinatura do recebedor, já com o comprovante em PDF pronto para conferência.
- O aplicativo trava a orientação do aparelho em retrato durante a exibição do canhoto.
- O motorista folheia o comprovante arrastando o dedo horizontalmente sobre o documento, página a página.
- Ao conferir o comprovante, o motorista toca no botão de avançar (ícone de seta) para confirmá-lo.
- Enquanto a confirmação está em andamento, o botão mostra um indicador de carregamento.
- Confirmado o comprovante, o aplicativo segue automaticamente para a próxima etapa da comprovação de entrega (coleta de selfie, coleta de canhoto físico fotografado, ou conclusão direta da entrega), conforme a configuração da carga.
- Se preferir, o motorista pode usar o botão de voltar do aparelho a qualquer momento antes de confirmar, abandonando a confirmação pendente e retornando à tela de detalhe da carga.
Interface e Comportamentos
Visualização do comprovante em PDF
A tela exibe o comprovante (canhoto) em PDF ocupando toda a área abaixo do título “Canhoto da Entrega”. O motorista navega entre as páginas do documento arrastando horizontalmente; a rolagem vertical não é habilitada. O fundo ao redor do documento é cinza.
Botão de avançar na tela do canhoto da entrega
Um botão flutuante fixo no canto inferior direito da tela do canhoto da entrega permite confirmar o comprovante exibido e seguir para a próxima etapa. Em estado normal, mostra um ícone de seta. Enquanto a confirmação está em andamento, o ícone é substituído por um indicador de carregamento.
Retorno pelo botão de voltar do aparelho na tela do canhoto
Se o motorista usar o botão de voltar do dispositivo enquanto o canhoto da entrega está sendo exibido, o aplicativo abandona a confirmação pendente e retorna diretamente para a tela de detalhe da carga, sem salvar o canhoto nem avançar no fluxo de comprovação de entrega.
Feedbacks ao Usuário
| Situação | Feedback | Mensagem |
|---|---|---|
| Confirmação do comprovante em andamento | O botão de avançar mostra um indicador de carregamento no lugar do ícone de seta | Nenhuma — apenas indicação visual de carregamento |
Nenhuma outra mensagem textual é exibida ao motorista nesta tela; falhas de confirmação e falhas de exibição do documento não geram aviso visível — ver seção Troubleshooting.
Regras de Negócio
Confirmação do comprovante na tela do canhoto da entrega
Ao tocar no botão de avançar na tela do canhoto da entrega, o aplicativo confirma o comprovante que está sendo mostrado para a carga em questão.
Encaminhamento após a confirmação do canhoto da entrega
Confirmado o comprovante do canhoto da entrega com sucesso, o aplicativo decide o próximo passo do fluxo de comprovação de entrega a partir da configuração da carga, nesta ordem:
- Se a carga permite coleta de selfie de conferência, o aplicativo verifica se já existe uma selfie salva para esta carga e abre a tela de captura de selfie, levando a selfie já salva se houver, ou vazio caso contrário.
- Caso contrário, se a carga permite coleta de canhoto físico fotografado, o aplicativo verifica se já existe um canhoto físico salvo para esta carga e abre a tela de captura do canhoto físico, levando o canhoto já salvo se houver, ou vazio caso contrário.
- Caso nenhuma das duas condições anteriores se aplique, o aplicativo não abre nenhuma tela de captura adicional: volta diretamente para a lista de cargas e conclui a entrega correspondente a esta carga.
Falha ao confirmar o comprovante do canhoto da entrega
Se a confirmação do comprovante na tela do canhoto da entrega falhar (por exemplo, por erro ao gravar o comprovante localmente), a tela não exibe nenhum aviso ao motorista: apenas o indicador de carregamento do botão desaparece e a tela permanece como estava, sem avançar.
Falha ao exibir o documento do canhoto da entrega
Se o comprovante em PDF estiver corrompido ou não puder ser lido, ou se alguma página específica do documento não puder ser exibida, o aplicativo não mostra nenhum aviso ao motorista.
Comportamento Offline e Dados Locais
Ao confirmar o comprovante exibido, o aplicativo grava no dispositivo, associado à carga, o comprovante confirmado, a placa do veículo e o instante exato da confirmação. Esse registro substitui qualquer comprovante confirmado anteriormente para a mesma carga. Essa gravação é feita inteiramente no aparelho, sem depender de conexão com internet.
Evidências e Documentos Gerados
O comprovante em PDF exibido nesta tela não é gerado aqui — ele chega pronto da etapa anterior de coleta de assinatura. O papel desta tela é de conferência e confirmação: ao confirmar, o aplicativo associa esse comprovante à carga, preparando o caminho para as evidências complementares (selfie de conferência ou canhoto físico fotografado) que podem ser coletadas na sequência, conforme a configuração da carga.
Troubleshooting
Comprovante não avança e nenhuma mensagem aparece ao tocar em avançar
Cenário: o motorista toca no botão de avançar para confirmar o canhoto exibido, mas a confirmação do comprovante falha.
Mensagem exibida: Nenhuma — o indicador de carregamento do botão desaparece e a tela permanece exibindo o mesmo comprovante, sem avançar para a etapa seguinte.
O que fazer: tocar novamente no botão de avançar; se o problema persistir, verificar o espaço de armazenamento livre no aparelho e reiniciar o aplicativo antes de tentar novamente.
O canhoto não é exibido corretamente na tela
Cenário: o comprovante não pôde ser aberto corretamente ao entrar na tela do canhoto.
Mensagem exibida: Nenhuma — a tela pode permanecer em branco ou travada numa página, sem indicação do motivo.
O que fazer: voltar para a tela anterior e refazer a coleta da assinatura; se persistir, contatar o suporte informando a carga em questão.
Ao voltar da tela do canhoto, o comprovante não é confirmado
Cenário: o motorista usa o botão de voltar do aparelho enquanto o canhoto está sendo exibido, antes de tocar em avançar.
Mensagem exibida: Nenhuma — o aplicativo retorna diretamente para a tela de detalhe da carga; nenhum canhoto é salvo e o fluxo de comprovação não avança.
O que fazer: repetir o fluxo de assinatura e, desta vez, tocar no botão de avançar (seta) para confirmar o comprovante antes de sair da tela.
Casos de Uso
Caso 1 — Entrega que também exige selfie de conferência
O motorista finaliza a assinatura, chega à tela de canhoto e confirma o comprovante. Como a carga está configurada para coletar selfie de conferência, o aplicativo abre em seguida a tela de captura de selfie.
Caso 2 — Entrega que exige canhoto físico fotografado, sem selfie
O motorista confirma o comprovante exibido; a carga não exige selfie de conferência, mas exige canhoto físico fotografado. O aplicativo abre a tela de captura do canhoto físico.
Caso 3 — Entrega que não exige nenhuma evidência adicional
O motorista confirma o comprovante exibido; a carga não exige nem selfie nem canhoto físico. O aplicativo volta direto para a lista de cargas e marca a entrega como concluída.
Caso 4 — Motorista desiste da confirmação
O motorista abre o canhoto para conferir e usa o botão de voltar do aparelho antes de confirmar. O aplicativo retorna à tela de detalhe da carga sem salvar nada, e o motorista pode refazer o fluxo de assinatura posteriormente.