Canhoto Físico
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Canhoto Físico
O Canhoto Físico é a etapa de comprovação de entrega em que você fotografa o documento (canhoto) assinado pelo recebedor, para registrar essa foto como evidência da entrega.
Visão Geral
O Canhoto Físico é a etapa de comprovação de entrega em que você fotografa o documento (canhoto) assinado pelo recebedor, para registrar essa foto como evidência da entrega. Ela entra na sequência de encerramento de uma entrega logo depois das demais formas de comprovação que a carga exigir — assinatura digital do recebedor e selfie de conferência — e é a última etapa antes de a entrega ser dada como concluída. Nem toda carga passa por esta etapa: ela só aparece quando a carga está configurada para exigir a coleta de um canhoto físico fotografado.
Pré-requisitos
- A carga da entrega precisa estar configurada para exigir a coleta do canhoto físico. Sem essa configuração, esta tela nunca aparece e o app conclui a entrega direto ao final das demais comprovações.
- Esta tela só aparece depois que as etapas anteriores da sequência de comprovação (assinatura digital do recebedor, selfie de conferência) foram concluídas ou não eram exigidas pela carga — ver `## Fluxo Operacional`.
- Se a carga já tiver um canhoto físico salvo de uma tentativa anterior, esse arquivo é recuperado e exibido automaticamente assim que a tela abre.
Fluxo Operacional
- Você chega a esta tela ao final da sequência de comprovação de uma entrega, vindo do formulário de dados do recebedor, da visualização do canhoto de assinatura já assinado, da tela de selfie de conferência, ou diretamente do detalhe da carga — conforme o que a carga exige (ver `## Interface e Comportamentos`).
- Se já existe um canhoto salvo anteriormente para esta carga, ele aparece pronto na pré-visualização; caso contrário, a área de pré-visualização aparece vazia com um ícone de câmera.
- Você toca no botão de captura e é levado à câmera para fotografar o canhoto assinado.
- Ao retornar da câmera com uma foto, o app avalia automaticamente se ela pode ser aceita (ver `## Regras de Negócio`) e, se aceita, ela passa a ser exibida na pré-visualização; se rejeitada, um aviso explica o motivo e você pode tentar novamente.
- Com uma foto aceita na pré-visualização, você pode tocar em “Limpar” para descartá-la e capturar outra, ou em “Salvar” para confirmar.
- Ao salvar, o app registra a foto como evidência da entrega e, em seguida, volta para a lista de cargas com a entrega já concluída.
Interface e Comportamentos
Tela de Coleta do Canhoto Físico
A tela mostra o título “Coleta de imagem” e o texto de instrução “Colete a imagem do Canhoto Físico”. Abaixo, uma área de pré-visualização mostra a foto capturada (ou um ícone de câmera, quando ainda não há foto) — junto com o texto “Toque no botão abaixo\npara coletar a imagem do Canhoto Físico” enquanto nenhuma foto foi capturada.
Enquanto não há foto na pré-visualização, a parte inferior da tela mostra apenas o botão “Coletar imagem”, que leva você à câmera de captura do canhoto. Assim que uma foto é aceita na pré-visualização, esse botão é substituído por dois botões lado a lado: “Limpar” (descarta a foto atual) e “Salvar” (confirma e registra a foto). Durante o processamento de qualquer uma dessas ações, os botões ficam desabilitados e mostram um indicador de carregamento em vez do texto.
Ordem de Exibição desta Etapa na Comprovação de Entrega
A tela de Canhoto Físico pode aparecer a partir de quatro pontos diferentes do fluxo de comprovação de entrega, todos seguindo a mesma prioridade: assinatura digital do recebedor, depois selfie de conferência, depois canhoto físico. Isso significa que o canhoto físico só é solicitado depois que as etapas anteriores exigidas pela carga já foram cumpridas (ou não eram exigidas):
- ao concluir o preenchimento dos dados do recebedor, quando a carga não exige assinatura nem selfie mas exige canhoto físico;
- ao detalhar a carga, seguindo a mesma ordem de prioridade das três comprovações;
- depois de você visualizar o canhoto da assinatura digital já assinada, quando a carga não exige selfie mas exige canhoto físico;
- depois de você salvar a selfie de conferência, quando a carga também exige canhoto físico.
Em qualquer um desses quatro pontos, se a carga não exigir nenhuma comprovação adicional, o app conclui a entrega imediatamente, sem passar pelo Canhoto Físico.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Foto rejeitada por baixa confiança da verificação automática | Diálogo “Imagem Inválida” | “A imagem capturada não parece ser um comprovante de entrega físico válido.\nAjuste a iluminação e o enquadramento (garantindo que o número da nota esteja visível no canto direito) e tente novamente.” |
| Foto rejeitada por o número da nota fiscal não coincidir com o esperado | Diálogo “Imagem Inválida” | “O número da NF-e não foi identificado ou não coincide com o esperado (NUMERO_ESPERADO).\nAjuste a iluminação e o enquadramento (garantindo que o número da nota esteja visível no canto direito) e tente novamente.” |
| Erro inesperado ao capturar ou verificar a foto | Aviso rápido (snackbar) | “Erro ao tirar a foto: DETALHE” |
| Tentativa de salvar sem nenhuma foto disponível | Aviso rápido (snackbar) | “Nenhuma imagem selecionada.” |
| Falha ao registrar a foto no aparelho, sem detalhe de erro | Aviso rápido (snackbar) | “Erro ao persistir o canhoto físico” |
| Falha ao registrar a foto no aparelho, com erro inesperado | Aviso rápido (snackbar) | “Erro ao persistir o canhoto físico DETALHE” |
Regras de Negócio
Validação Automática da Foto do Canhoto
Se a carga não exigir validação automática do canhoto físico: a foto tirada é aceita diretamente, sem qualquer verificação de conteúdo, assim que você retorna da câmera.
Se a carga exigir validação automática: a foto passa por uma verificação automática de imagem, que calcula um grau de confiança entre 0 e 1 de que a imagem é de fato um canhoto físico.
- Se o grau de confiança for menor que 0,8: a foto é rejeitada, independentemente do conteúdo.
- Se o grau de confiança for maior ou igual a 0,8: o app tenta reconhecer o número da nota fiscal impresso na foto — primeiro numa área recortada do canto direito da imagem; se nenhum número compatível aparecer ali, repete o reconhecimento considerando a imagem inteira.
- A foto só é aceita quando o número da nota fiscal reconhecido confere com o número da nota fiscal esperado da carga.
- Se o número reconhecido não coincidir com o esperado, a foto também é rejeitada.
Reconhecimento do Número da Nota Fiscal na Foto
Ao ler o texto da foto do canhoto, o app procura primeiro por um número precedido de indicadores como “Nº”, “NF-e” ou “N.” na imagem. Se não encontrar nenhum número dessa forma, considera como alternativa todos os dígitos identificados na área analisada, limitando a 9 dígitos (tamanho padrão do número da nota fiscal) quando a sequência de dígitos encontrada for maior que isso.
Comparação do Número Reconhecido com o Esperado
Para validar o número da nota fiscal reconhecido na foto, o app desconsidera zeros à esquerda tanto no número extraído da imagem quanto no número esperado da carga. A foto é considerada válida quando o número esperado (sem os zeros à esquerda) aparece contido no texto reconhecido da imagem (sem os zeros à esquerda) — não é exigida uma correspondência exata de toda a informação lida, apenas que o número esperado apareça dentro do texto reconhecido.
Substituição de uma Foto Já Salva
O botão “Limpar” apenas remove a foto exibida na tela e retorna a pré-visualização ao estado vazio; ele não apaga um canhoto que já tenha sido salvo anteriormente no aparelho para esta carga. A foto salva anteriormente só deixa de existir quando uma nova foto é efetivamente confirmada em “Salvar” no lugar dela.
Conclusão da Entrega ao Salvar o Canhoto
Assim que o registro do canhoto físico é concluído no aparelho, o app volta para a lista de cargas e conclui a entrega imediatamente, sem esperar a confirmação de que o arquivo já chegou ao servidor — o envio ao servidor acontece de forma independente, mais adiante.
Comportamento Offline e Dados Locais
Ao salvar, o canhoto físico é registrado primeiro só no próprio aparelho, associado à carga, à placa do veículo e à data/hora da captura, e identificado como “Canhoto” — o que o distingue de outra evidência (como a selfie) guardada da mesma forma no aparelho.
Esse registro não envia nada ao servidor na hora. O canhoto salvo fica pendente de envio e é enviado automaticamente em outros momentos do uso do app — por exemplo, ao atualizar a lista de cargas, ao fazer check-in em uma entrega ou ao concluir outra entrega — sem um envio dedicado disparado só por esta tela. Enquanto isso, a entrega já aparece concluída (ver `## Regras de Negócio`).
Evidências e Documentos Gerados
Canhoto físico fotografado — a foto que você tira na câmera de captura do canhoto e que é enviada ao servidor como comprovante da entrega. É criado um novo registro sempre que você salva uma foto nesta tela; se já existisse um canhoto salvo anteriormente para a mesma carga, ele é substituído pela nova foto, nunca acumulado.
Miniatura da foto do canhoto — uma versão reduzida da imagem, gerada automaticamente pelo servidor assim que o arquivo é recebido, usada sempre que uma representação resumida do canhoto for necessária, sem qualquer ação sua.
Troubleshooting
O diálogo “Imagem Inválida” aparece dizendo que a foto não parece ser um comprovante válido
Cenário: você fotografou o canhoto físico, mas a verificação automática não reconheceu a imagem como um canhoto válido.
Mensagem exibida: “A imagem capturada não parece ser um comprovante de entrega físico válido.\nAjuste a iluminação e o enquadramento (garantindo que o número da nota esteja visível no canto direito) e tente novamente.”
O que fazer: fotografe novamente o canhoto com melhor iluminação e enquadramento, garantindo que o número da nota fiscal fique visível no canto direito da foto.
O diálogo “Imagem Inválida” aparece citando um número de nota fiscal que não confere
Cenário: a foto do canhoto foi reconhecida como válida pela verificação automática, mas o número da nota fiscal identificado na imagem não coincide com o número esperado para esta carga.
Mensagem exibida: “O número da NF-e não foi identificado ou não coincide com o esperado (NUMERO_ESPERADO).\nAjuste a iluminação e o enquadramento (garantindo que o número da nota esteja visível no canto direito) e tente novamente.”
O que fazer: confira se o canhoto fotografado é realmente o desta entrega e fotografe novamente garantindo que o número da nota fiscal esteja legível e visível no canto direito.
Aparece um aviso “Erro ao tirar a foto” com detalhe técnico
Cenário: ocorreu uma falha inesperada durante a captura ou a verificação automática da foto do canhoto.
Mensagem exibida: “Erro ao tirar a foto: DETALHE”
O que fazer: tente capturar a foto novamente; se o erro persistir, reinicie o aplicativo antes de tentar de novo.
O botão “Salvar” não registra nada e aparece “Nenhuma imagem selecionada.”
Cenário: você tentou salvar sem que houvesse nenhuma foto capturada ou já existente na pré-visualização.
Mensagem exibida: “Nenhuma imagem selecionada.”
O que fazer: capture uma foto do canhoto antes de tocar em “Salvar”.
Aparece “Erro ao persistir o canhoto físico” ao tentar salvar
Cenário: o registro da foto no aparelho não foi concluído com sucesso.
Mensagem exibida: “Erro ao persistir o canhoto físico” (sem mais detalhes) ou “Erro ao persistir o canhoto físico DETALHE” (quando há um erro específico identificado)
O que fazer: verifique o espaço de armazenamento disponível no aparelho e tente salvar novamente; se persistir, reinicie o aplicativo.
A entrega aparece concluída, mas é preciso confirmar se o canhoto realmente chegou ao servidor
Cenário: você salvou o canhoto físico e o app avançou imediatamente para a lista de cargas com a entrega concluída, mas o envio do arquivo ao servidor só acontece depois, mais adiante no uso do app.
Mensagem exibida: Nenhuma — a entrega aparece concluída normalmente, sem qualquer indicação de que o envio ao servidor ainda está pendente.
O que fazer: se houver dúvida sobre se o canhoto chegou ao servidor, garanta que o aparelho tenha conexão com a internet e use o aplicativo normalmente (abra a lista de cargas, faça check-in em outra entrega) para que o envio pendente seja concluído.
O canhoto físico pode nunca ser confirmado no servidor, mesmo com a entrega já aparecendo concluída
Cenário: o app envia o canhoto físico pendente ao servidor mais adiante, depois que a entrega já foi mostrada como concluída na tela.
Mensagem exibida: Nenhuma — se o servidor não conseguir confirmar o envio (por exemplo, por não conseguir associar a entrega à placa do veículo informada, ou porque a entrega perdeu o vínculo com você), o arquivo simplesmente não é aceito, e o app não avisa disso no momento em que acontece.
O que fazer: em caso de dúvida sobre se o canhoto físico de uma entrega já concluída foi de fato recebido, contate o suporte informando o número da entrega e a placa do veículo usada, para confirmar o recebimento.
Casos de Uso
Caso 1 — Canhoto físico aceito de primeira, sem validação automática
A carga de uma entrega não exige validação automática do canhoto físico. Você fotografa o documento assinado pelo recebedor; a foto é aceita imediatamente ao retornar da câmera, sem qualquer verificação de conteúdo. Você confere a foto na pré-visualização e toca em “Salvar”; a entrega é concluída em seguida.
Caso 2 — Canhoto físico validado com sucesso pela verificação automática
A carga exige validação automática do canhoto físico. Você fotografa o documento; a verificação automática calcula confiança de 0,92 de que é um canhoto válido e reconhece o número “000123456” na foto, que confere com o número esperado da nota fiscal da carga. A foto é aceita e exibida na pré-visualização; você toca em “Salvar” e a entrega é concluída.
Caso 3 — Foto rejeitada por número de nota fiscal divergente
A carga exige validação automática. Você fotografa por engano o canhoto de outra entrega, de nota fiscal diferente. A verificação automática identifica confiança suficiente de que é um canhoto físico, mas o número reconhecido não confere com o esperado desta carga; o app exibe o diálogo “Imagem Inválida” citando o número esperado. Você toca em “OK”, volta a fotografar o canhoto correto e prossegue normalmente.
Caso 4 — Correção de uma foto já salva antes de continuar
Você já havia salvo um canhoto físico para a carga numa tentativa anterior; ao reabrir a tela, a foto salva aparece automaticamente na pré-visualização. Você percebe que a foto ficou ilegível, toca em “Limpar” para descartar a pré-visualização atual, fotografa novamente o canhoto e toca em “Salvar” — a nova foto substitui a anterior e a entrega é concluída.
