Captura de DANFE
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Captura de DANFE
A Captura de DANFE é a etapa em que você fotografa o documento impresso da nota fiscal (DANFE) para comprová-la junto à entrega.
Visão Geral
A Captura de DANFE é a etapa em que você fotografa o documento impresso da nota fiscal (DANFE) para comprová-la junto à entrega. Ela aparece dentro do fluxo de Cross Dock (Leitura de NF-e): assim que você confirma no leitor de Cross Dock uma nova entrega a partir da chave de acesso da nota fiscal, o aplicativo abre automaticamente a Captura de DANFE para aquela entrega recém-criada, sem que você precise navegar até ela por conta própria. É a única forma, hoje, de chegar a esta tela.
Pré-requisitos
A Captura de DANFE só é aberta depois que uma entrega de Cross Dock já foi confirmada com sucesso — não existe caminho no aplicativo para abrir esta tela sem uma entrega recém-criada associada. Não há outra condição de acesso própria da tela: assim que ela abre, você já pode acionar a câmera imediatamente.
Fluxo Operacional
- Você confirma no Cross Dock (Leitura de NF-e) uma nova entrega a partir da chave de acesso da nota fiscal.
- Assim que a entrega é confirmada, o aplicativo fecha a etapa de confirmação e abre a tela de Captura de DANFE para essa entrega.
- Você toca em “Coletar imagem” para acionar a câmera do aparelho e fotografar o documento da DANFE.
- A foto tirada aparece em destaque na tela, substituindo o texto de instrução inicial.
- Você pode tocar em “Limpar” para descartar a foto e recomeçar, ou em “Salvar” para gravar a foto e prosseguir.
- Ao salvar, a imagem é gravada no aparelho e o aplicativo tenta imediatamente enviar as evidências pendentes da entrega.
- Se o envio é concluído, você recebe a confirmação e volta automaticamente à tela de Cross Dock. Se não é concluído, você vê uma mensagem de erro e permanece na tela, com a foto ainda visível, podendo tentar salvar novamente sem precisar fotografar de novo.
Interface e Comportamentos
Tela de Captura de DANFE
A tela é identificada pelo título “Coleta de imagem” e traz o texto de instrução “Colete a imagem da Danfe” no topo. A área central ocupa a maior parte da tela: enquanto nenhuma foto foi capturada, mostra um ícone de câmera com o texto “Toque no botão abaixo\npara coletar a imagem da Danfe”; assim que uma foto é capturada, essa mesma área passa a exibir a foto em tela cheia, dentro de uma moldura arredondada, substituindo o texto de instrução.
A tela é travada em orientação retrato (vertical) enquanto está aberta, voltando ao comportamento normal do aplicativo ao ser fechada.
Botão “Coletar Imagem” na Captura de DANFE
Enquanto não há foto capturada, a parte inferior da tela mostra apenas o botão “Coletar imagem”, que abre a câmera do aparelho. Se você cancelar a captura sem tirar a foto, a tela permanece exatamente como estava — sem foto, ou com a foto capturada anteriormente, se já houver uma.
Botões “Limpar” e “Salvar” na Captura de DANFE
Assim que uma foto é capturada, o botão “Coletar imagem” dá lugar a dois botões lado a lado: “Limpar”, que descarta a foto e volta ao estado inicial da tela sem enviar nada; e “Salvar”, que grava a foto e inicia o envio. Enquanto o salvamento está em andamento, os dois botões ficam desabilitados e o botão “Salvar” mostra um indicador de carregamento no lugar do ícone e do texto.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Falha ao acionar a câmera para fotografar a DANFE | Mensagem na tela | “Erro ao tirar a foto: ” + detalhe técnico do erro |
| Gravação da DANFE processada sem nenhuma foto associada (situação defensiva, não deve ocorrer no uso normal) | Mensagem na tela | “Nenhuma imagem selecionada.” |
| Falha ao gravar a foto da DANFE no aparelho | Mensagem na tela | “Erro ao persistir imagem da danfe” |
| Erro inesperado durante o processo de salvar a foto da DANFE | Mensagem na tela | “Erro ao persistir imagem da danfe” + detalhe técnico do erro |
| Envio da DANFE não concluído (por exemplo, sem conexão no momento) | Mensagem na tela | “Erro ao enviar a DANFe. Documento salvo offline para envio posterior.” |
| Envio da DANFE concluído | Mensagem na tela + retorno automático à tela de Cross Dock | “Envio da DANFe realizado com sucesso.” |
| Falha genérica sem mensagem específica associada | Mensagem na tela | “Erro ao enviar foto da Danfe” |
Regras de Negócio
Captura sempre pela câmera, nunca da galeria. A foto da DANFE é sempre tirada na hora pela câmera do aparelho; não existe opção de selecionar uma imagem já existente na galeria do aparelho.
Qualidade e dimensão da captura. A foto é capturada com qualidade de imagem de 85% e redimensionada para no máximo 1024 por 1024 pixels — valores fixos, iguais para todas as entregas.
Cancelamento da captura. Se você abrir a câmera e cancelar sem tirar a foto, a tela de Captura de DANFE não muda: continua sem foto, ou com a foto que já estava capturada antes de abrir a câmera novamente.
Uma única DANFE por entrega. A foto da DANFE fica associada à entrega. Uma nova captura para a mesma entrega substitui a foto salva anteriormente — não existe histórico de mais de uma foto de DANFE por entrega.
Disparo do salvamento. O botão “Salvar” só grava e envia a foto quando há uma foto capturada na tela; enquanto o salvamento está em andamento, tanto “Salvar” quanto “Limpar” ficam bloqueados para nova interação.
Envio disparado pelo salvamento. Ao salvar a foto da DANFE com sucesso no aparelho, o aplicativo tenta imediatamente enviar toda a fila de evidências pendentes da entrega — não apenas a foto recém-capturada. Se esse envio é concluído, a Captura de DANFE é encerrada e você retorna à tela de Cross Dock; caso contrário, a foto permanece salva no aparelho e a tela continua aberta para nova tentativa.
Comportamento Offline e Dados Locais
A captura e o salvamento da foto da DANFE funcionam inteiramente sem conexão: a foto é sempre gravada primeiro no aparelho, independentemente de haver internet disponível. Só depois disso o aplicativo tenta enviar a fila de evidências pendentes da entrega ao servidor — e essa tentativa, ao contrário de outras capturas de evidência do aplicativo, acontece imediatamente após você tocar em “Salvar”, em vez de esperar por outro momento do uso do aplicativo.
Se o aparelho estiver sem conexão no momento em que você salva a foto, ou se não houver nada pendente de envio, a tentativa de envio não encontra o que mandar e o aplicativo pode indicar sucesso mesmo sem ter enviado a foto ao servidor — ver Troubleshooting.
Evidências e Documentos Gerados
Foto da DANFE
Documento gerado a partir da câmera do aparelho, no momento em que você fotografa a DANFE após confirmar uma entrega de Cross Dock. É criada uma nova foto a cada captura confirmada; uma nova foto salva para a mesma entrega substitui a foto de DANFE salva anteriormente para ela — não há acúmulo de mais de uma foto de DANFE por entrega.
A foto da DANFE entra na mesma fila de evidências pendentes usada pelas demais capturas da entrega (foto avulsa de evidência, canhoto físico, selfie de conferência) e é enviada ao servidor pelo mesmo mecanismo. Diferente do canhoto físico, que é enviado com um tipo de documento próprio, a foto da DANFE não tem um tipo de documento dedicado: ela é registrada como uma evidência genérica.
Troubleshooting
Mensagem “Erro ao tirar a foto” ao tentar fotografar a DANFE
Cenário: você tocou em “Coletar imagem”, mas a câmera do aparelho falhou (por exemplo, permissão de câmera negada ou outra falha do dispositivo).
Mensagem exibida: “Erro ao tirar a foto: ” seguida do detalhe técnico do erro.
O que fazer: verificar se o aplicativo tem permissão de câmera concedida nas configurações do aparelho e tentar novamente.
Botão “Salvar” não avança e aparece “Nenhuma imagem selecionada”
Cenário: esta mensagem é apenas uma proteção interna do aplicativo e não deve aparecer no uso normal, já que o botão “Salvar” só fica disponível depois de uma foto já capturada.
Mensagem exibida: “Nenhuma imagem selecionada.”
O que fazer: capturar a foto da DANFE antes de tocar em “Salvar”.
Mensagem “Erro ao persistir imagem da danfe” ao salvar
Cenário: você tocou em “Salvar”, mas o aplicativo não conseguiu gravar a foto no próprio aparelho.
Mensagem exibida: “Erro ao persistir imagem da danfe” (pode vir seguida do detalhe técnico do erro, conforme a causa exata da falha).
O que fazer: tentar salvar novamente; se o problema persistir, verificar o espaço de armazenamento disponível no aparelho.
Mensagem “Erro ao enviar a DANFe. Documento salvo offline para envio posterior.”
Cenário: a foto foi gravada com sucesso no aparelho, mas o envio das evidências pendentes da entrega não foi concluído.
Mensagem exibida: “Erro ao enviar a DANFe. Documento salvo offline para envio posterior.”
O que fazer: nenhuma ação obrigatória — a foto já está salva no aparelho; ela será reenviada automaticamente no próximo envio de evidências, mesmo sem tocar em “Salvar” de novo nesta tela. Se preferir, é possível tocar em “Salvar” novamente para tentar o envio de imediato.
Confirmação de envio da DANFE aparece mesmo sem conexão no aparelho
Cenário: você salva a foto da DANFE enquanto o aparelho está sem conexão à internet (ou no instante exato em que a conexão cai).
Mensagem exibida: “Envio da DANFe realizado com sucesso.” — mesmo texto usado quando o envio realmente acontece.
O que fazer: nenhuma ação impede esse comportamento hoje; a foto está de fato salva no aparelho e será enviada ao servidor no próximo envio de evidências. Se precisar confirmar que a DANFE já chegou ao servidor, aguarde o próximo momento em que o aplicativo sincronizar com conexão disponível (por exemplo, ao atualizar a lista de cargas) antes de considerar a comprovação concluída.
Casos de Uso
Caso 1 — Captura e envio da DANFE com sucesso, com conexão disponível
Você confirma uma nova entrega de Cross Dock a partir da chave de acesso da nota fiscal. O aplicativo abre a Captura de DANFE automaticamente. Você toca em “Coletar imagem”, fotografa o documento impresso e toca em “Salvar”. Com conexão disponível, o aplicativo grava a foto no aparelho, envia ao servidor, exibe “Envio da DANFe realizado com sucesso.” e retorna à tela de Cross Dock.
Caso 2 — Você descarta a primeira foto e captura outra
Depois de fotografar a DANFE, você percebe que a foto ficou ilegível e toca em “Limpar”. A tela volta ao estado inicial, sem foto. Você toca em “Coletar imagem” novamente, fotografa o documento com melhor enquadramento e toca em “Salvar” para concluir.
Caso 3 — Captura sem conexão no momento do salvamento
Você fotografa a DANFE numa área sem sinal de internet e toca em “Salvar”. A foto é gravada no aparelho, mas a confirmação exibida na tela não garante que ela já chegou ao servidor: sem conexão, a Captura de DANFE pode indicar sucesso mesmo com o envio ainda pendente. A foto é enviada de fato assim que o aplicativo conseguir sincronizar com conexão disponível, em qualquer momento do uso.
Caso 4 — Falha ao gravar a foto no aparelho
Você fotografa a DANFE e toca em “Salvar”, mas o aplicativo não consegue gravar a foto no aparelho (por exemplo, por falta de espaço). O aplicativo exibe “Erro ao persistir imagem da danfe” e permanece na tela, com a foto ainda em exibição, para que você possa tentar salvar novamente.
