Cross Dock
Criado por Igor Ribeiro em 30 de setembro de 2026
Atualizado por Igor Ribeiro em 01 de outubro de 2026
Cross Dock
O Cross Dock é o fluxo que você usa, no ponto de transbordo, para vincular a si mesmo as notas fiscais (DANFEs) das mercadorias que está recebendo, sem depender de uma carga já roteirizada e enviada pelo escritório.
Visão Geral
O Cross Dock é o fluxo que você usa, no ponto de transbordo, para vincular a si mesmo as notas fiscais (DANFEs) das mercadorias que está recebendo, sem depender de uma carga já roteirizada e enviada pelo escritório. Em vez de receber a carga pronta, você lê, uma a uma, as notas fiscais no ponto de transbordo, e o aplicativo vai montando sua carga a partir dessas leituras. Cada nota lida vira uma entrega vinculada a você, com uma posição na sequência de entregas do dia. Ao concluir as leituras, você segue para a tela de Cargas, de onde continua normalmente a execução das entregas. Uma nota que o sistema ainda não reconhece pode, depois de o emitente ser confirmado, dar origem a uma entrega nova; se for preciso fotografar a nota nesse momento, isso acontece em uma tela seguinte, própria para essa captura.
Pré-requisitos
- Sua sessão precisa estar ativa no aplicativo para ler ou salvar qualquer nota.
- Você precisa estar operando em modo Cross Dock. Sem isso, toda tentativa de ler ou salvar uma nota é recusada com “Ação inválida para o motorista.” A alternância para o modo Cross Dock é feita pela Tela Inicial, não por esta tela.
- Permissão de localização concedida no aparelho. Sem ela, o aplicativo não carrega automaticamente uma carga pendente ao abrir a tela — mas a leitura de notas continua disponível normalmente.
- Câmera do aparelho disponível para ler o código de barras da nota; se não for possível usar a câmera, você pode digitar o código manualmente.
Fluxo Operacional
- Você abre a tela de Cross Dock (identificada no topo como “Leitura de NF-e”) a partir da Tela Inicial.
- Se as permissões necessárias estiverem concedidas, o aplicativo verifica em segundo plano se há uma carga pendente de sincronização e, se houver, retoma essa sincronização automaticamente.
- Você aponta a câmera para o código de barras da nota fiscal, ou toca em “Digitar” para informar manualmente os 44 dígitos do código de acesso da nota.
- O aplicativo confirma a nota com o servidor.
- Conforme o resultado:
- Se a nota já estiver vinculada a você, o aplicativo confirma com uma mensagem de sucesso e libera a tela para novas leituras.
- Se a nota não for encontrada, o aplicativo verifica automaticamente o cadastro do emitente da nota; se o emitente for confirmado, oferece salvar a nota como uma entrega nova.
- Em qualquer outro erro (nota de outro motorista, emitente não identificado, código inválido etc.), o aplicativo exibe a mensagem correspondente e você permanece na tela para tentar novamente.
- Ao confirmar o salvamento de uma nota nova, o aplicativo cria a entrega e segue automaticamente para a tela de captura da imagem da DANFE.
- Quando terminar de ler as notas do transbordo, toque em “Concluir” para seguir para a tela de Cargas.
Interface e Comportamentos
Tela de Leitura de NF-e (Cross Dock)
A tela principal exibe o leitor de código de barras em tempo real, com a instrução “Posicione o código de barras sobre a marcação indicada abaixo.” Dois botões ficam sempre disponíveis na parte inferior: “Digitar”, para entrada manual do código, e “Concluir”, para encerrar a leitura de notas e seguir para a carga resultante.
Indicador de carregamento durante a consulta
Enquanto o aplicativo verifica uma carga pendente ao abrir a tela, é exibido “Verificando cargas existentes… Aguarde!” no lugar da tela normal. Durante a consulta de uma nota lida (ou durante a verificação do emitente, no fluxo de nota não encontrada), o leitor de código de barras é substituído por “Obtendo carga do servidor… Aguarde!”.
Diálogo “DANFe não encontrada”
Quando uma nota lida não é localizada e o emitente é confirmado como válido, o aplicativo interrompe a leitura e exibe um diálogo com o título “DANFe não encontrada” e o texto “DANFe não existe no banco de dados, deseja salvá-la?”, com duas opções: “Não”, que fecha o diálogo e devolve a tela ao estado inicial de leitura, e “Sim”, que envia a nota para ser cadastrada como uma nova entrega.
Formulário de digitação manual do código da nota
Acionado pelo botão “Digitar”, abre um campo numérico limitado a 44 caracteres para você informar o código de acesso da nota sem usar a câmera, com botões de “Cancelar” e “Confirmar”.
Feedbacks ao Usuário
Leitura e busca da nota
| Situação | Feedback | Texto exato |
|---|---|---|
| Você não está com o modo Cross Dock ativo e tenta buscar uma nota | Mensagem de erro | “Ação inválida para o motorista.” |
| Código da nota lido/digitado com tamanho diferente de 44 caracteres, na busca | Mensagem de erro | “Código da DANFE inválido.” |
| Nenhum código de nota identificado na busca | Mensagem de erro | “Não foi possível identificar o código da DANFE da Nota Fiscal.” |
| Emitente da nota não cadastrado, na busca | Mensagem de erro | “Não foi possível identificar o Emitente.” |
| Nota já carregada por outro motorista | Mensagem de erro | “Entrega já carregada por outro motorista.” |
| Nota não encontrada (nunca registrada, ou ainda não carregada por ninguém) | Mensagem de erro que dispara a verificação automática do emitente | “Não foi possível encontrar a entrega.” |
| Falha ao gravar a atualização da entrega ao vincular ou reativar a nota | Mensagem de erro | “Não foi possível atualizar as informações da entrega.” |
| Nota já vinculada a você é confirmada novamente com sucesso | Mensagem de sucesso | “Carga adicionada com sucesso. Agora, realize novas leituras ou toque em “Concluir”” |
Verificação do emitente (CNPJ/CPF)
| Situação | Feedback | Texto exato |
|---|---|---|
| Nenhum documento identificado para a verificação | Mensagem de erro | “Não foi possível identificar o CNPJ/CPF do Emitente.” |
| Documento informado não é um CNPJ nem CPF válido | Mensagem de erro | “CNPJ/CPF do Emitente inválido.” |
| Documento válido, mas sem cadastro de emitente correspondente | Mensagem de erro | “CNPJ/CPF do Emitente não encontrado.” |
| Vínculo do documento existe, mas a empresa emissora não foi localizada | Mensagem de erro | “Emitente não econtrado.” |
| Cadastro do emitente com validade vencida | Mensagem de erro | “Cadastro do Emitente expirado.” |
| Cadastro do emitente válido e dentro da validade | Confirmação interna (segue para o diálogo abaixo) | “Emitente possui cadastrado ativo!” |
| Emitente confirmado — aplicativo oferece salvar a nota como entrega nova | Diálogo de confirmação (título “DANFe não encontrada”) | “DANFe não existe no banco de dados, deseja salvá-la?” |
Salvamento de uma nota nova
| Situação | Feedback | Texto exato |
|---|---|---|
| Código da nota com tamanho diferente de 44 caracteres, ao salvar | Mensagem de erro | “Código do DANFE da entrega é inválido.” |
| Nenhum código de nota identificado ao salvar | Mensagem de erro | “Não foi possível identificar o código do DANFE da entrega.” |
| Nota já cadastrada anteriormente (tentativa de duplicar) | Mensagem de erro | “Entrega já cadastrada.” |
Entrada manual do código
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo de código deixado em branco | Erro no campo | “O campo não pode ser vazio.” |
| Código digitado com tamanho diferente de 44 dígitos, ou com caractere não numérico | Erro no campo | “Por favor, insira exatamente 44 números.” |
Regras de Negócio
- Reconhecimento do código pela câmera: o leitor só aciona a busca de uma nota quando o código lido tem exatamente 44 caracteres, tamanho fixo da chave de acesso da nota fiscal eletrônica. Leituras de outro tamanho são descartadas sem aviso.
- Entrada manual do código: exige exatamente 44 dígitos numéricos; campo vazio ou com tamanho/formato incorreto bloqueia a confirmação.
- Nota já vinculada e carregada: se a nota pertence a você, ela é reativada e seus dados completos são carregados na tela, permitindo continuar de onde parou. Se pertence a outro motorista, a leitura é recusada.
- Nota nova ou ainda não vinculada a ninguém: ao ser confirmada, a nota passa a ficar vinculada a você e entra na sua sequência de entregas do dia.
- Posição na sequência de entregas do dia: cada nova nota lida entra ao final da sua sequência de entregas ainda em aberto (aguardando ou em andamento) daquele dia; se você ainda não tiver nenhuma entrega em aberto de Cross Dock, a nova nota inicia a sequência.
- Criação de uma nota nova: só é permitida se a mesma nota ainda não estiver cadastrada — não é possível cadastrar a mesma nota duas vezes. A entrega criada a partir dessa leitura não traz as informações do pedido (peso, quantidade, valor), porque o código de barras da nota não contém esses dados.
- Validade do CNPJ/CPF do emitente: o documento do emitente da nota precisa ser um CNPJ ou CPF válido para a verificação prosseguir.
- Validade do cadastro do emitente: o cadastro do emitente da nota tem uma data de validade; se já tiver vencido no momento da verificação, o cadastro é tratado como expirado, mesmo que o emitente exista no sistema.
Comportamento Offline e Dados Locais
Antes de buscar ou salvar uma nota, o aplicativo tenta enviar ao servidor qualquer informação pendente de sincronização salva no aparelho; se isso não for possível naquele momento, a leitura da nota continua normalmente mesmo assim. Ao abrir a tela, o aplicativo também verifica se há uma carga que ainda não foi sincronizada e, se houver, retoma essa carga automaticamente.
Evidências e Documentos Gerados
Nota fiscal (DANFE) da entrega criada em Cross Dock
Quando a nota lida não corresponde a nenhuma entrega já cadastrada e você confirma o salvamento, o sistema gera a nota fiscal da nova entrega a partir apenas dos dados disponíveis no momento da leitura (código da nota e seus dados como motorista) — por isso essa entrega não traz informações reais de produto, peso ou valor, já que o código de barras não contém esses dados. Quando a nota já existe e é apenas reaproveitada (reativada), uma nova nota fiscal não é gerada de novo.
Troubleshooting
Leitura pela câmera não reconhece o código de barras da nota
Cenário: você aponta a câmera para o código de barras, mas nada acontece.
Mensagem exibida: Nenhuma — o aplicativo só reage a códigos de exatamente 44 caracteres; qualquer leitura de tamanho diferente é ignorada silenciosamente.
O que fazer: confirme que o código de barras corresponde à chave de acesso completa da nota fiscal (44 dígitos) e tente reposicionar a câmera; se persistir, use a opção “Digitar” para informar o código manualmente.
Formulário de digitação manual recusa envio com o campo vazio
Mensagem exibida: “O campo não pode ser vazio.”
O que fazer: informe o código de 44 dígitos da nota antes de confirmar.
Formulário de digitação manual recusa envio com valor incompleto ou não numérico
Mensagem exibida: “Por favor, insira exatamente 44 números.”
O que fazer: confira se o código digitado tem exatamente 44 dígitos, sem letras ou símbolos.
Busca ou salvamento de nota recusados por você não estar em modo Cross Dock
Cenário: você tenta ler ou salvar uma nota sem estar operando em modo Cross Dock naquele momento.
Mensagem exibida: “Ação inválida para o motorista.”
O que fazer: confirme com o suporte se seu cadastro está habilitado para operar em modo Cross Dock; a alternância desse modo é feita pela Tela Inicial, não por esta tela.
Busca ou salvamento de nota recusados por tamanho de código inválido
Mensagem exibida: “Código da DANFE inválido.” (na busca) ou “Código do DANFE da entrega é inválido.” (ao salvar)
O que fazer: releia o código de barras ou reconfira os dígitos digitados manualmente; o código precisa ter exatamente 44 caracteres.
Emitente da nota não identificado ao buscar ou salvar a nota
Mensagem exibida: “Não foi possível identificar o Emitente.”
O que fazer: confirme se o CNPJ do emitente contido na nota está cadastrado no sistema; se o emitente for novo, acione o suporte para cadastrá-lo antes de repetir a leitura.
Nota já carregada por outro motorista
Mensagem exibida: “Entrega já carregada por outro motorista.”
O que fazer: confirme com o escritório qual motorista está responsável por essa nota; não é possível vinculá-la a dois motoristas ao mesmo tempo.
Nota não encontrada inicia a verificação automática do emitente
Cenário: a nota lida não corresponde a nenhuma entrega já cadastrada ou carregada.
Mensagem exibida: “Não foi possível encontrar a entrega.” — seguida automaticamente da verificação do CNPJ/CPF do emitente, sem nenhuma ação adicional de sua parte.
O que fazer: aguarde a verificação do emitente; se ele for confirmado, o aplicativo oferece salvar a nota como uma entrega nova.
Falha ao atualizar as informações da entrega ao vincular a nota
Mensagem exibida: “Não foi possível atualizar as informações da entrega.”
O que fazer: tente a leitura novamente; se o erro persistir, anote o código da nota e acione o suporte técnico.
Documento do emitente inválido na verificação de CNPJ/CPF
Mensagem exibida: “CNPJ/CPF do Emitente inválido.”
O que fazer: confira se o CNPJ contido na nota está correto; este cenário indica um problema no cadastro ou na própria nota, não em algo que você fez.
Documento do emitente não encontrado na verificação de CNPJ/CPF
Mensagem exibida: “CNPJ/CPF do Emitente não encontrado.” ou, quando o vínculo existe mas a empresa não é localizada, “Emitente não econtrado.”
O que fazer: confirme com o escritório se o emitente da nota está cadastrado no sistema.
Cadastro do emitente expirado na verificação de CNPJ/CPF
Mensagem exibida: “Cadastro do Emitente expirado.”
O que fazer: acione o escritório para renovar o cadastro do emitente antes de repetir a leitura.
Tentativa de salvar uma nota já cadastrada como entrega nova
Cenário: você confirma “Sim” no diálogo de “DANFe não encontrada” para uma nota que, entre a busca e a confirmação, já foi cadastrada.
Mensagem exibida: “Entrega já cadastrada.”
O que fazer: repita a leitura da nota pelo fluxo normal de busca — ela já deve estar disponível como entrega existente.
Casos de Uso
Caso 1 — Leitura de uma nota já vinculada anteriormente por você
Você, em modo Cross Dock, lê pela câmera o código de barras de uma nota que já havia carregado antes. O aplicativo confirma a nota, exibe “Carga adicionada com sucesso. Agora, realize novas leituras ou toque em “Concluir”” e permanece na tela pronto para a próxima leitura.
Caso 2 — Leitura de nota nova, emitente cadastrado e válido
Você lê uma nota que ainda não está cadastrada no sistema. O aplicativo não encontra a entrega, verifica automaticamente o CNPJ do emitente, confirma que o cadastro está ativo e dentro da validade, e exibe o diálogo “DANFe não encontrada”. Você toca em “Sim”; o aplicativo cria a nova entrega e segue para a tela de captura da imagem da DANFE.
Caso 3 — Leitura de nota com emitente sem cadastro válido
Você lê uma nota que não está cadastrada. Na verificação automática do emitente, o sistema constata que o CNPJ não tem cadastro correspondente e exibe “CNPJ/CPF do Emitente não encontrado.”. Você não consegue prosseguir com essa nota nesta tela e precisa acionar o suporte para regularizar o cadastro do emitente.
Caso 4 — Entrada manual do código com erro de digitação seguido de correção
Sem sinal de câmera disponível, você toca em “Digitar” e informa um código com 40 dígitos. O aplicativo recusa com “Por favor, insira exatamente 44 números.”. Você corrige o valor para os 44 dígitos corretos e confirma; o aplicativo então processa a busca da nota normalmente.
