Check-in
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Check-in
O check-in é o momento em que o motorista, já fisicamente no local de entrega, confirma ao aplicativo B2b que chegou para atender a uma entrega específica dentro da carga do dia.
Visão Geral
O check-in é o momento em que o motorista, já fisicamente no local de entrega, confirma ao aplicativo B2b que chegou para atender a uma entrega específica dentro da carga do dia. No fluxo geral do motorista, o check-in acontece depois que o motorista navegou até o endereço da entrega a partir do detalhe da carga, e antes das etapas de comprovação (captura de evidências, assinatura digital, canhoto físico) que encerram a entrega. O check-in em si não finaliza a entrega — ele apenas registra a data e a localização de chegada, mantendo a entrega em andamento até que o motorista conclua ou reporte falha nela em uma etapa posterior. Por não mudar o status da entrega nem finalizar a carga, um check-in comum também não dispara notificação por e-mail ao destinatário nem encerra a carga do motorista — esses dois efeitos só acontecem quando o status da entrega muda de fato (por exemplo, ao concluir a entrega) ou quando a carga inteira é finalizada.
Pré-requisitos
- Sessão do motorista autenticada. Para processar o check-in, sua sessão no aplicativo precisa estar ativa; sem ela, o check-in não é registrado.
- Permissão de localização concedida ao aplicativo. Para registrar o check-in, o aplicativo precisa obter a posição geográfica atual do motorista. Se a permissão de localização não tiver sido concedida, o aplicativo a solicita ao sistema operacional no momento do check-in; se a posição não puder ser obtida de nenhuma forma, o check-in falha.
- Evidências capturadas sem conexão já sincronizadas com o servidor. Antes de processar o check-in, o aplicativo reenvia toda evidência de entrega (foto ou canhoto) capturada enquanto o dispositivo estava sem conexão. Se esse reenvio não for concluído com sucesso, o check-in é cancelado e nem chega a tentar registrar a chegada do motorista.
- Placa do veículo definida, fora do modo cross-dock. Quando o motorista não está operando em cross-dock, a sincronização da entrega (que grava o check-in) exige a placa do veículo; sem ela, ou com uma placa inválida, a sincronização é rejeitada.
- Entrega não pode estar desvinculada. Uma entrega marcada como desvinculada nunca é atualizada por uma sincronização nem aceita novas evidências — qualquer tentativa de check-in sobre ela é rejeitada pelo servidor.
Fluxo Operacional
- O motorista abre a tela de Check-in a partir do detalhe da entrega, dentro da tela de detalhe da carga.
- A tela de Check-in exibe a data da entrega vinda da carga, a data e hora atuais do dispositivo, o cabeçalho da entrega (documento, valor a receber) e um mapa com a localização esperada da entrega.
- O motorista toca no botão “Check-in”.
- O aplicativo tenta reenviar ao servidor as evidências de entrega capturadas sem conexão e ainda não sincronizadas.
- Se o reenvio das evidências for concluído com sucesso, o aplicativo obtém a localização atual do motorista, grava localmente a data/hora e a localização do check-in, e marca a entrega como pendente de sincronização com o servidor.
- O aplicativo dispara uma sincronização com o servidor, que reenvia essa entrega e também todas as demais entregas do dispositivo que estejam pendentes de sincronização.
- Ao concluir — com sucesso ou com falha — o aplicativo fecha as telas empilhadas até voltar para a tela da carga, exibindo a mensagem correspondente ao motorista.
Interface e Comportamentos
Tela de Check-in
A tela de Check-in exibe a data da entrega vinda da carga e, separadamente, a data e a hora atuais do dispositivo no momento em que a tela é aberta, formatadas como data curta e hora com minutos seguida de “h” (por exemplo, “11/09/2026 – 14:32h”). Enquanto o check-in está sendo processado, o botão de check-in exibe um indicador de carregamento no lugar do texto “Check-in”. Ao concluir o processamento — tanto em caso de sucesso quanto de falha — o aplicativo fecha as telas empilhadas até voltar para a tela da carga. Depois de uma falha, a tela de Check-in volta ao estado inicial, pronta para uma nova tentativa.
Cabeçalho da Entrega na Tela de Check-in
O cabeçalho da entrega mostrado na tela de Check-in exibe o número de sequência da entrega na rota com dois dígitos, com zero à esquerda quando o número tiver um dígito só. O identificador do documento é rotulado como “NF” quando a entrega é do tipo nota fiscal, ou como “Pedido” quando é do tipo pedido. O valor total a receber exibido no cabeçalho segue o cálculo descrito em Regras de Negócio.
Mapa de Localização na Tela de Check-in
A tela de Check-in exibe um mapa com um marcador único na posição geográfica informada para a entrega, com zoom fixo e sem controles de zoom visíveis ao motorista.
Botão Voltar na Tela de Check-in
O botão de voltar no topo da tela de Check-in retorna para a tela anterior da pilha de navegação — comportamento padrão de voltar, sem pular direto para uma tela específica.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| O reenvio das evidências pendentes capturadas sem conexão falha antes do check-in prosseguir | Mensagem de erro | “Falha na sincronização” |
| O check-in falha por qualquer outro motivo — sincronização da entrega rejeitada pelo servidor ou falha ao obter a localização do motorista | Mensagem de erro | “Erro ao fazer check-in” |
| O check-in é concluído com sucesso | Mensagem de sucesso | “Check-in realizado com sucesso!” |
Regras de Negócio
Status Aceitos na Sincronização da Entrega
Ao sincronizar uma entrega — inclusive quando a sincronização é disparada por um check-in — o servidor exige um status dentre um conjunto fechado de valores: aguardando, em andamento, finalizada, com falha, desvinculada ou cancelada. Qualquer outro valor enviado é rejeitado com a mensagem “Status é inválido.”.
Localização da Entrega Durante a Sincronização
Quando o motorista está operando em modo cross-dock, o servidor localiza a entrega apenas pelo identificador enviado. Fora do modo cross-dock, o servidor exige também a placa do veículo e localiza a entrega cruzando a empresa ativa do motorista, o motorista e a placa — considerando, para esse cruzamento, apenas empresas com vínculo ativo com o motorista. Se a placa não for informada, a sincronização é rejeitada com “Placa não encontrada.”; se a placa informada não sobrar nenhum caractere alfanumérico após a limpeza, é rejeitada com “Placa inválida.”; se nenhuma entrega correspondente for encontrada, é rejeitada com “Entrega não encontrada.”.
Entregas Desvinculadas Bloqueiam Atualizações
Uma entrega marcada como desvinculada nunca é atualizada por uma sincronização — qualquer tentativa é rejeitada com a mensagem “Não é possível alterar entrega {número do documento} é por estar desvinculada.”. Pela mesma razão, uma entrega desvinculada também não aceita novas evidências: o envio de evidência para uma entrega nessa condição é rejeitado com “Entrega desvinculada.”.
Registro da Data e Localização do Check-in
Quando a entrega está no status em andamento — situação em que o check-in acontece — a data e a localização do check-in só ficam registradas se o aplicativo conseguir enviá-las corretamente ao servidor durante a sincronização. Se essas informações não vierem preenchidas nessa sincronização, a data e a localização do check-in já registradas anteriormente são apagadas, sem gerar nenhum aviso ao motorista — veja o Troubleshooting para identificar essa situação.
Renovação de Sessão durante o Check-in
Se a sessão do motorista expira durante o check-in — seja na sincronização da entrega, seja no envio de uma evidência — o aplicativo tenta renovar o acesso automaticamente e repete a chamada uma única vez antes de considerar a operação como falha.
Cálculo do Valor Total a Receber
O valor total a receber exibido no cabeçalho da entrega, na tela de Check-in, é a soma dos valores de todos os pagamentos vinculados à entrega, formatada como moeda.
Comportamento Offline e Dados Locais
Ao confirmar o check-in de uma entrega, o aplicativo grava localmente no dispositivo a data/hora atual e a localização geográfica atual do motorista como data e local do check-in da entrega, e marca essa entrega como pendente de sincronização com o servidor. Sempre que uma sincronização é disparada — inclusive pelo check-in — o aplicativo tenta reenviar ao servidor todas as entregas do dispositivo marcadas como pendentes de sincronização, não apenas a entrega que originou o check-in. As evidências capturadas sem conexão seguem uma fila local própria — ver Evidências e Documentos Gerados.
Evidências e Documentos Gerados
Reenvio de Evidências Offline antes do Check-in
Antes do check-in, o aplicativo reenvia ao servidor cada evidência de entrega (foto ou canhoto) capturada enquanto o dispositivo estava sem conexão. Cada evidência enviada com sucesso é removida da fila local de pendências; evidências com falha continuam na fila para uma próxima tentativa.
Validação do Envio de Evidência
Antes de aceitar uma evidência, o servidor confirma que a entrega existe, pertence ao motorista autenticado (ou, em modo cross-dock, que foi carregada nesse modo) e que não está desvinculada. Se a localização enviada junto da evidência não for válida, a evidência é rejeitada — ver Troubleshooting.
Tipo e Data da Evidência
O tipo da evidência enviada é evidência comum, por padrão, ou canhoto; qualquer outro valor enviado é tratado como evidência comum. Se a data não for enviada, o servidor usa a data e a hora atuais do servidor, no horário de São Paulo.
Geração de Miniatura da Evidência
Depois de salvar a evidência, o servidor tenta gerar automaticamente uma miniatura da imagem para facilitar a visualização. Uma falha nessa geração não impede que a evidência seja considerada salva com sucesso para o motorista.
Geolocalização e Rastreamento
Para obter a localização usada no check-in, o aplicativo solicita permissão de localização ao sistema operacional caso ainda não tenha sido concedida, e tenta obter a posição com a maior precisão disponível quando há conexão com a internet, caindo para precisões menores quando o dispositivo está sem conexão. Se não conseguir obter nenhuma posição, o check-in falha. Toda vez que a localização de início, pausa, check-in ou fim da entrega é recebida e aceita pelo servidor, essa mesma coordenada também é gravada como a última localização conhecida do motorista.
Troubleshooting
Check-in bloqueado por falha ao sincronizar evidências pendentes
Cenário: o motorista aciona o check-in, mas o aplicativo não consegue reenviar ao servidor uma ou mais evidências capturadas sem conexão antes de prosseguir com o check-in.
Mensagem exibida: “Falha na sincronização”
O que fazer: verificar a conexão do dispositivo com a internet e orientar o motorista a tentar novamente; se a falha persistir, verificar se há evidências antigas na fila local do dispositivo que não conseguem ser enviadas.
Check-in falha com mensagem genérica, sem indicar o motivo específico
Cenário: as evidências capturadas sem conexão sincronizaram com sucesso, mas o registro do check-in em si falha — por rejeição da sincronização da entrega pelo servidor, por falha ao obter a localização do motorista, ou por uma sessão expirada que a nova tentativa automática do aplicativo também não conseguiu resolver.
Mensagem exibida: “Erro ao fazer check-in”
O que fazer: como essa mensagem não distingue o motivo, o suporte deve consultar a resposta do servidor ou os registros da sincronização para identificar a causa entre as demais listadas neste Troubleshooting.
Check-in falha por não conseguir obter a localização atual do motorista
Cenário: o aplicativo não conseguiu obter nenhuma posição geográfica do dispositivo, mesmo tentando as precisões disponíveis com e sem conexão.
Mensagem exibida: “Erro ao fazer check-in” — a causa específica (falha de localização) não é exibida separadamente ao motorista.
O que fazer: orientar o motorista a verificar se o serviço de localização do dispositivo está ativado e se a permissão de localização foi concedida ao aplicativo.
Sincronização da entrega rejeitada por placa do veículo não enviada
Cenário: fora do modo cross-dock, a sincronização da entrega disparada pelo check-in é enviada sem a placa do veículo.
Mensagem exibida: “Placa não encontrada.”
O que fazer: verificar se o motorista está corretamente configurado fora do modo cross-dock e se a placa do veículo está definida no aplicativo antes do check-in.
Sincronização da entrega rejeitada por placa do veículo inválida
Cenário: fora do modo cross-dock, a placa do veículo enviada não sobra nenhum caractere alfanumérico depois da limpeza de caracteres especiais.
Mensagem exibida: “Placa inválida.”
O que fazer: verificar o valor de placa cadastrado para o veículo do motorista.
Sincronização da entrega rejeitada por entrega não localizada
Cenário: fora do modo cross-dock, o cruzamento de empresa ativa, motorista e placa não encontra nenhuma entrega correspondente ao identificador enviado.
Mensagem exibida: “Entrega não encontrada.”
O que fazer: confirmar se a entrega ainda pertence a uma empresa com vínculo ativo com o motorista e se a placa enviada corresponde à cadastrada para essa entrega.
Sincronização da entrega rejeitada por entrega desvinculada
Cenário: o motorista tenta fazer check-in em uma entrega que já foi marcada como desvinculada.
Mensagem exibida: “Não é possível alterar entrega {número do documento} é por estar desvinculada.”
O que fazer: informar ao motorista que essa entrega não está mais disponível para atualização; verificar com o suporte por que ela foi desvinculada.
Data ou localização do check-in apagadas silenciosamente na sincronização
Cenário: a entrega está em andamento e uma sincronização é enviada sem a data de check-in preenchida, ou com a data em um formato que o servidor não reconhece.
Mensagem exibida: Nenhuma — o servidor apaga a data e a localização de check-in já registradas, sem retornar erro.
O que fazer: verificar no aplicativo se o check-in foi de fato confirmado antes de investigar por que a data não chegou ou chegou em formato inválido nessa sincronização.
Envio de evidência rejeitado por localização com coordenadas inválidas
Cenário: a localização enviada junto de uma evidência não está separada por vírgula, ou a latitude está fora do intervalo de -90 a 90, ou a longitude está fora do intervalo de -180 a 180.
Mensagem exibida: “Posição da evidência é inválida.” (formato sem vírgula), “Latitude da evidência é inválida.” (latitude fora do intervalo) ou “Longitude da evidência é inválida.” (longitude fora do intervalo)
O que fazer: verificar a permissão e a precisão de localização do dispositivo no momento da captura da evidência.
Sincronização da entrega rejeitada por status inválido enviado
Cenário: a sincronização da entrega é enviada com um valor de status fora do conjunto aceito (aguardando, em andamento, finalizada, com falha, desvinculada ou cancelada).
Mensagem exibida: “Status é inválido.”
O que fazer: verificar a versão do aplicativo instalada no dispositivo do motorista; esse cenário normalmente indica dessincronismo entre app e servidor quanto aos valores de status aceitos.
Envio de evidência rejeitado por entrega desvinculada
Cenário: o motorista tenta reenviar uma evidência (capturada sem conexão ou no momento) para uma entrega já marcada como desvinculada.
Mensagem exibida: “Entrega desvinculada.”
O que fazer: informar ao motorista que essa entrega não aceita mais evidências; verificar com o suporte por que ela foi desvinculada.
Envio de evidência rejeitado por entrega não localizada
Cenário: o identificador da entrega enviado junto da evidência não corresponde a nenhuma entrega válida para o motorista (considerando cross-dock ou o cruzamento de empresa ativa, motorista e placa).
Mensagem exibida: “Entrega inválida.”
O que fazer: confirmar se a entrega ainda existe e pertence ao motorista antes de reenviar a evidência.
Casos de Uso
Caso 1 — Check-in de entrega comum concluído com sucesso, fora do cross-dock
O motorista chega ao endereço de uma entrega de nota fiscal com 2 volumes e placa do veículo já definida no aplicativo. Não há evidências pendentes capturadas sem conexão. Ao tocar em “Check-in”, o aplicativo obtém a localização atual com precisão alta (dispositivo com conexão), grava data e localização localmente, marca a entrega como pendente de sincronização e sincroniza com sucesso. O motorista vê “Check-in realizado com sucesso!” e retorna à tela da carga.
Caso 2 — Check-in em modo cross-dock, sem exigência de placa
O motorista está operando em cross-dock e aciona o check-in de uma entrega do tipo pedido. Como está em cross-dock, o servidor localiza a entrega apenas pelo identificador, sem exigir a placa do veículo. O check-in é registrado normalmente e o motorista vê a mensagem de sucesso.
Caso 3 — Check-in bloqueado por evidência pendente de sincronizar, capturada sem conexão
O motorista capturou uma foto de comprovação em uma entrega anterior enquanto estava sem conexão, e essa evidência ainda não foi enviada ao servidor. Ao chegar na entrega seguinte e tocar em “Check-in”, o aplicativo tenta reenviar essa evidência pendente antes de prosseguir; a conexão do dispositivo está instável e o reenvio falha. O motorista vê “Falha na sincronização” e o check-in não é registrado. Depois que a conexão se estabiliza, o motorista tenta novamente e o check-in é concluído com sucesso.
Caso 4 — Nova tentativa de check-in após falha por localização indisponível
O motorista está em uma área sem sinal de GPS e sem conexão de dados. Ao tocar em “Check-in”, o aplicativo não consegue obter nenhuma posição, mesmo tentando as precisões mais baixas disponíveis sem conexão, e o check-in falha com “Erro ao fazer check-in”. A tela de Check-in é reiniciada para uma nova tentativa. Ao se deslocar para um ponto com sinal e tocar em “Check-in” novamente, o aplicativo obtém a posição normalmente e o check-in é concluído com sucesso.
