Cargas

A tela de Cargas é a listagem das entregas (notas fiscais ou pedidos) que compõem uma carga já selecionada por você na tela de Cargo.

A tela de Cargas é a listagem das entregas (notas fiscais ou pedidos) que compõem uma carga já selecionada por você na tela de Cargo. É aqui que você escolhe qual entrega abrir em seguida: cada entrega aparece como um cartão com status, valor, endereço e horário-limite de entrega. Tocar em um cartão elegível leva à tela de detalhe daquela entrega, onde o check-in e a execução da entrega acontecem. A tela também sincroniza automaticamente, em segundo plano, as evidências e cargas pendentes de envio, e permite compartilhar o DANFE das entregas com nota fiscal.

• É preciso estar com sua sessão ativa no aplicativo.
• É preciso já existir uma carga (placa) selecionada na tela de Cargo — é essa seleção que fornece a lista inicial de entregas exibida aqui. A tela de Cargas não busca entregas por conta própria a partir do zero.
• Para compartilhar o DANFE, o aparelho precisa ter algum aplicativo capaz de receber o menu de compartilhamento nativo; sem isso, o compartilhamento não se completa.
• A sincronização de evidências e cargas pendentes só ocorre havendo conexão com a internet no momento da tentativa; sem conexão, os dados pendentes permanecem guardados no aparelho até a próxima tentativa.

1. Você chega à tela de Cargas a partir da tela de Cargo, já com a lista de entregas daquela carga carregada.
2. Assim que a tela abre — e sempre que você volta ao aplicativo com essa tela ativa — o aplicativo verifica se todas as entregas carregadas já estão sincronizadas e, havendo pendência, sincroniza em segundo plano, sem interromper a visualização da lista.
3. Você visualiza os cartões de entrega: status, valor total, endereço do destinatário e horário-limite de entrega.
4. Você toca em um cartão elegível (não cancelado, não reagendado) para abrir a tela de detalhe daquela entrega, onde a execução (check-in, comprovação) continua.
5. Ao voltar da tela de detalhe para a tela de Cargo, se todas as entregas já estiverem sincronizadas, o aplicativo busca novamente a lista de cargas da placa atual, em segundo plano.
6. Para entregas com nota fiscal, você pode compartilhar o DANFE diretamente do cartão, a qualquer momento.

Cabeçalho da Tela de Cargas

O cabeçalho mostra a placa do veículo seguida do identificador da carga entre colchetes, e a data da carga alinhada à direita. A data aparece no formato dia/mês/ano, mas com o ano reduzido a dois dígitos (ex.: 22/09/26 em vez de 22/09/2026).

Abaixo do cabeçalho, enquanto o aplicativo busca a entrega que você acabou de tocar (ver “Toque em um Cartão de Entrega”), aparece um texto com uma barra de progresso indicando a busca em andamento.

Se a carga não tiver nenhuma entrega para exibir, a lista é substituída por um texto único informando que nenhum item foi encontrado.

Cartão de Entrega na Listagem de Cargas

Cada entrega da carga aparece como um cartão com as seguintes informações:

• Identificação: “NF” seguido do número do documento quando a entrega é do tipo Nota Fiscal, ou “Pedido” seguido do número do documento para qualquer outro tipo.
• Valor: a soma de todos os pagamentos associados àquela entrega, no formato de moeda padrão.
• Indicador de pagamento: um ícone de cifrão aparece ao lado do número do cartão quando a entrega tem um link de pagamento associado; sem link, o espaço fica vazio.
• Destinatário e endereço: razão social, logradouro e número, município e UF do destinatário.
• Horário-limite de entrega (“Entregar até”): o horário final da janela de entrega vigente no momento em que a tela é exibida — o aplicativo localiza, entre as janelas cadastradas para o dia da semana atual, aquela cujo intervalo contém o horário atual, e mostra o horário final dessa janela. Se o horário atual não estiver dentro de nenhuma janela cadastrada para o dia, o campo mostra “–” no lugar do horário.
• Status: rótulo e cor de fundo conforme a tabela abaixo.
• Compartilhar DANFE: visível apenas para entregas do tipo Nota Fiscal — ver “Compartilhamento do DANFE” em Evidências e Documentos Gerados.

As entregas aparecem na lista na mesma ordem em que o servidor as retornou — o aplicativo não reordena a lista por conta própria.

Status exibido no cartão

A checagem de reagendamento tem prioridade sobre a checagem de cancelamento na cor do cartão. Essa prioridade é invertida no comportamento do toque — ver “Toque em um Cartão de Entrega” abaixo.

Toque em um Cartão de Entrega

Ao tocar em um cartão, o aplicativo avalia nesta ordem:

1. Se a entrega está com status “cancelada”: exibe um aviso e não navega.
2. Senão, se a entrega está reagendada: exibe outro aviso e não navega.
3. Senão, se o status é “em andamento”, “aguardando”, “finalizada” ou “não entregue”: o aplicativo abre a tela de detalhe daquela entrega.
4. Para qualquer outro valor de status não coberto acima, o toque não tem efeito.

O aplicativo evita abrir a tela de detalhe duas vezes para o mesmo toque: aguarde a tela de detalhe abrir antes de tocar novamente no cartão.

Sincronização ao Retornar da Tela de Detalhe

Quando você volta da tela de detalhe de uma entrega para a tela de Cargo, e todas as entregas carregadas já estão sincronizadas, o aplicativo busca novamente a lista de cargas da placa atual, em segundo plano — sem o indicador de carregamento de tela cheia usado na primeira abertura. Enquanto essa atualização está em andamento, uma faixa escura cobre a tela com um indicador de progresso central.

A tela de Cargas também mantém um indicador interno de “entrega em andamento”, que é ativado quando a lista chega com pelo menos uma entrega no status “em andamento”, desativado quando uma entrega é confirmada como não entregue ou concluída a partir da tela de detalhe, e reativado quando uma entrega é iniciada a partir da tela de detalhe. Esse indicador não bloqueia nenhuma interação visível na listagem atualmente.

Elegibilidade de toque no cartão. A entrega só abre a tela de detalhe quando o status é “em andamento”, “aguardando”, “finalizada” ou “não entregue” — e mesmo nesses casos, uma entrega cancelada ou reagendada é bloqueada antes dessa checagem (ver “Toque em um Cartão de Entrega”). Qualquer outro valor de status não abre nada.

Localização da entrega para compartilhar o DANFE. Quando a carga é do tipo crossdock, o servidor localiza a entrega pela carga e pelo indicador de que ela já passou pelo ponto de transbordo, sem precisar checar a placa do veículo. Fora do modo crossdock, a entrega é localizada pela carga e pela placa do veículo, sempre dentro das empresas às quais você está vinculado.

Envio de evidências. Antes de aceitar uma evidência enviada, o servidor confirma que ela pertence a uma entrega válida, vinculada a você e à placa (ou ao modo crossdock) certos, e que a entrega não está desvinculada. Quando a localização é enviada junto com a evidência, ela também é conferida; envios com entrega inválida, placa incorreta ou localização fora do formato esperado não são aceitos pelo servidor.

Classificação da evidência. Toda evidência enviada é classificada como Evidência (padrão) ou Canhoto, conforme o tipo indicado no momento da captura.

As evidências (fotos, canhotos) capturadas por você quando o aplicativo está sem conexão ficam guardadas no aparelho. Toda vez que a tela de Cargas é aberta, ou que você volta ao aplicativo com ela ativa, o aplicativo verifica se há entregas ainda não sincronizadas e, havendo, tenta enviar primeiro as evidências pendentes e, em seguida, as cargas com alterações feitas sem conexão. A sincronização só é considerada completa se ambas as partes tiverem sucesso.

Cada evidência pendente só é enviada se houver conexão disponível no momento da tentativa; ao ser enviada com sucesso, ela é removida do aparelho. Se o envio falhar — por qualquer um dos motivos descritos em Regras de Negócio, ou por falta de conexão — a evidência permanece guardada no aparelho para uma nova tentativa na próxima sincronização.

Nem o sucesso nem a falha dessa sincronização em segundo plano são hoje indicados na tela de Cargas — ver “Sincronização Sem Retorno Visível” em Troubleshooting.