O que é a Roteirização (Routech)
A tela Documentos a Roteirizar é onde o usuário seleciona as Notas Fiscais (NF-e) de entrega que devem ser enviadas para a Routech, um sistema externo especializado em otimizar rotas de entrega e acompanhar a execução delas em campo (chegada no local, finalização, insucesso).
O fluxo básico é: o TMS envia os dados de entrega da nota (endereço, peso, volume) para a Routech montar a rota; depois, conforme o motorista vai entregando as mercadorias, a Routech avisa o TMS automaticamente sobre o andamento de cada entrega.
A tela não mostra a posição do caminhão em tempo real — ela mostra apenas em que etapa está o ciclo de envio/entrega de cada nota fiscal dentro do processo de roteirização.
Quando uma NF-e aparece na tela
Nem toda nota fiscal emitida aparece automaticamente nesta tela. Para uma NF-e aparecer, ela precisa:
- Estar ativa no sistema;
- Bater com os filtros preenchidos (Série, Número, Chave, período de Data Cadastro);
- Ter a cidade de entrega dentro de um Grupo de Cidade habilitado para roteirização (cadastro em
Cadastros → Localidades → Grupos de Cidade, campo “Roteirizar”).
O motivo mais comum é o período de Data Cadastro: por padrão a tela já abre filtrando só o dia de ontem (Data Inicial e Data Final vêm com a mesma data). E esse filtro é pela data em que a nota foi cadastrada no TMS — não pela data de emissão da nota fiscal. Se a nota foi cadastrada num dia diferente de ontem (por exemplo, importada com atraso), ela simplesmente não aparece até você alargar esse período manualmente, mesmo estando tudo certo com ela.
Se mesmo alargando o período a nota continuar sem aparecer, o segundo motivo mais comum é a cidade de entrega não estar cadastrada (ou não estar marcada como “Roteirizar”) em nenhum Grupo de Cidade. Verifique também se o filtro de Status selecionado (Disponível/Processando/Integrado) é o esperado para aquela nota.
Acessando a Tela
Gestão de Transportes → Expedição → Documentos a Roteirizar
Filtros e Status das Notas
Filtros
| Campo | Descrição |
|---|---|
| Série | Série da NF-e. |
| Número Fiscal | Aceita um número único, um intervalo (ex: 100-200) ou uma lista. |
| Chave | Chave de acesso completa da NF-e (44 dígitos). |
| Data Inicial / Data Final | Período de data de cadastro da nota no TMS (não é a data de emissão da nota fiscal). Por padrão, a tela já abre com os dois campos preenchidos com o mesmo dia (ontem) — ou seja, mostra só o que foi cadastrado num único dia, não os últimos dias. |
Como os dois campos vêm com a mesma data (ontem), qualquer nota cadastrada no TMS antes de ontem ou já hoje fica fora do resultado por padrão. Se você não tem certeza de quando a nota foi cadastrada, alargue o período (por exemplo, para a última semana) antes de concluir que ela “sumiu”.
Depois de ajustar os filtros, clique em Carregar para atualizar a lista.
Status (botões de opção acima da grade)
| Status | Cor da linha | Significado |
|---|---|---|
| Disponível | Sem cor | Nota ainda não foi enviada para a Routech (ou foi devolvida por algum motivo). Pronta para envio. |
| Processando | Amarelo claro | Nota já foi enviada e está aguardando a confirmação da Routech de que entrou numa rota. |
| Integrado | Verde claro | A Routech confirmou o recebimento da nota — ela já faz parte de uma rota de entrega. |
A legenda de cores também aparece fixa no rodapé da tela.
Enviar para Roteirizador
1 – Filtrar e localizar as notas desejadas com o status Disponível.
2 – Selecionar as linhas na grade (é possível marcar várias de uma vez).
3 – Clicar em Enviar.
Mensagem “Documentos enviados com sucesso!” e a grade recarrega — as notas enviadas já aparecem em Processando. Em seguida, quando a Routech confirma o recebimento, o status muda sozinho para Integrado (não é preciso fazer nada — a tela reflete isso na próxima atualização/consulta).
Aparece se alguma das notas selecionadas já não está mais com status “Disponível” (por exemplo, já está Processando ou Integrada). Selecione apenas notas com status Disponível para enviar.
Se você selecionar várias notas e clicar em Enviar, e uma única nota do grupo não puder ser enviada (por exemplo, endereço de entrega incompleto), o envio de todas as notas selecionadas falha — não só da nota com problema. A mensagem de erro é genérica (“Falha no envio dos documentos”) e não diz qual nota causou o problema. Se isso acontecer, tente enviar as notas em grupos menores (ou uma de cada vez) até identificar qual delas está com problema.
Consultar Status
Usado para forçar uma verificação do andamento de notas que já estão Integradas, sem esperar o próximo evento automático.
1 – Filtrar pelo status Integrado.
2 – Selecionar as notas desejadas.
3 – Clicar em Consultar.
Mensagem “Documentos encaminhados para consulta com sucesso!”. O resultado não aparece na hora — se a Routech responder que a entrega falhou, a nota volta automaticamente para Disponível (veja a seção de Eventos Relacionados para o histórico).
Só é possível consultar notas com status Integrado.
Eventos Relacionados
Sempre que a Routech reporta algum evento de entrega para uma nota (motorista chegou, finalizou ou falhou), um ícone 📋 aparece na coluna correspondente da grade, ao lado da nota. Clicar nesse ícone abre uma janela com o histórico de eventos daquela NF-e.
Enquanto a nota ainda está sendo confirmada pela Routech (status Processando), o ícone de eventos fica oculto — ele só é exibido quando a nota já está Integrada (ou voltou a ficar Disponível) e existe pelo menos um evento registrado.
Ícones de status na janela de Eventos
| Ícone | Significado |
|---|---|
| Pendente | Motorista ainda não chegou no local de entrega. |
| No Local | Motorista chegou no endereço, mas ainda não finalizou a entrega. |
| Finalizado | Entrega concluída com sucesso. |
| Falha | Motorista sinalizou que não conseguiu concluir a entrega. Este evento faz a nota voltar automaticamente para o status Disponível, para ser reenviada. |
Retornar Notas
Usado quando é necessário desistir manualmente do envio de uma nota já integrada — por exemplo, se a rota planejada pela Routech não deve mais ser seguida.
1 – Filtrar pelo status Integrado.
2 – Selecionar as notas a retornar.
3 – Clicar em Retornar notas.
Esta ação apenas libera a nota de volta para “Disponível” dentro do TMS, para permitir um novo envio. Ela não cancela a rota do lado da Routech — se a rota já foi montada, alinhe com a operação/Routech antes de usar este botão para casos que já estão em execução.
Só é possível retornar notas com status Integrado.
Perguntas Frequentes
Enviei a nota e ela ficou “Processando” por muito tempo. É normal?
Normalmente a confirmação da Routech é rápida. Se a nota ficar muito tempo em Processando, entre em contato com o suporte técnico — pode haver um problema de comunicação com a Routech.
Preciso enviar as notas uma por vez?
Não é obrigatório — é possível selecionar várias linhas na grade e enviar/consultar/retornar todas de uma vez. Mas se o envio de um grupo falhar sem motivo aparente, vale tentar enviar uma nota de cada vez: basta uma nota inválida no grupo pra travar o envio de todas as outras (ver aviso na seção 5).
O que acontece se o motorista não conseguir entregar?
A Routech avisa o TMS automaticamente e a nota volta sozinha para o status “Disponível”, ficando pronta para ser reenviada. O evento de falha fica registrado em “Eventos Relacionados”.
Uma nota fiscal que deveria aparecer não está na lista. O que fazer?
Primeiro, alargue o período de Data Inicial/Data Final — por padrão os dois campos abrem com a mesma data (ontem), e o filtro é pela data de cadastro no TMS, não pela data de emissão da nota. Uma nota cadastrada em outro dia fica fora dessa janela de 1 dia até você mudar o período manualmente. Confira também o filtro de Status selecionado.
Se mesmo assim não aparecer, verifique se a cidade de entrega está cadastrada e habilitada em Cadastros → Localidades → Grupos de Cidade — esse é o segundo motivo mais comum.
Posso desfazer um envio?
Sim, use o botão Retornar notas — mas lembre-se de que ele não cancela a rota do lado da Routech, apenas libera a nota no TMS para reenvio.