Enviar viagens

Além do envio de pedidos para montagem de carga via NDD Elog, também é possível enviar viagens por API. Esse endpoint recebe todas as informações necessárias para o transporte como prestador de serviço, veículos, roteirização, documentos, locais de coleta e entrega e componentes do frete, garantindo a integração dos dados e o registro completo da operação.

Montar carga

Ao enviar as viagens, elas podem aparecer no NDD Elog em três etapas diferentes, conforme os campos informados no envio.

1. Roteirização

Se os campos de roteirização não forem enviados, as viagens ficarão com o status Aguardando Roteirização, que corresponde à primeira etapa do processo. Nesse caso, o usuário deverá realizar a roteirização manualmente pela tela do sistema.

O mesmo acontecerá caso apenas alguns campos relacionados à roteirização sejam enviados, já que o sistema precisa de todas as informações obrigatórias para avançar para a próxima etapa. Essa regra também se aplica às etapas seguintes: se faltar qualquer campo necessário, a viagem permanecerá na etapa atual até que os dados sejam preenchidos manualmente ou enviados via integração.

Caso todos os campos exigidos sejam informados no envio, a viagem seguirá diretamente para a etapa de contratação.

Nota

Essa etapa será utilizada apenas se o cliente tiver contratado o módulo Vale-pedágio.

2. Contratação

Nesta etapa aparecerão todas as viagens que não tiveram os campos Prestador e CustosFrete informados. A viagem permanecerá na etapa atual até que os dados sejam preenchidos manualmente ou enviados via integração.

Caso todos os campos exigidos sejam informados no envio, a viagem seguirá diretamente para a etapa de Expedição.

3. Expedição

Esta é a etapa final do processo. Para que a viagem esteja pronta para expedição, é necessário que os campos ChaveNumero, Motorista e Placa sejam enviados previamente ou preenchidos manualmente no sistema.

• Se todos esses dados forem informados, a viagem será considerada pronta para expedição.
• Se houver falta da chave de acesso em algum pedido, o status será Dados pendentes.
• Se estiverem ausentes motorista e/ou placa, o status será Aguardando expedição.

A expedição da viagem deve ser concluída manualmente pelo usuário do sistema, momento em que os documentos associados serão gerados.

Fluxo de envio de viagens via API

Exemplo de requisição

• Método: POST
• URL: [URL_BASE]/api/v1/Viagem/Planejamento

Cabeçalhos

Content-Type: application/json
Authorization: Bearer {accessToken}

Corpo

Ver detalhes na documentação do endpoint

Campo	Obrigatório	Descrição
Identificador	Não	Identificador único.
TipoVeiculo	Sim	Tipo de veículo requerido para a carga (informar objeto com tipo e categoria).
Pedidos	Não	Lista de pedidos que compoem a carga.
TipoOperacao	Sim	Tipo da operação logística (informar objeto com código e descrição).
Prestador	Sim	Dados do prestador de transporte.
CustosFrete	Não	Detalhamento dos custos de frete da rota (componentes de frete).
CustosPedidos	Não	Custos específicos por pedido, se houver.
Motorista	Sim	Dados do motorista que irá realizar o transporte.
VeiculoTracao	Sim	Dados do veículo de tração utilizado (ex.: caminhão).
VeiculosReboque	Não	Lista de veículos de reboque/acoplados que fazem parte da operação.
Roteirizacao
LocalOrigem	Sim	Local de origem da viagem (endereço completo, dados do ponto de partida).
LocalOrigem.Identificador	Não	Identificador do local de origem.
LocalOrigem.Dados	Sim	Dados completos do local de origem.
DefinicaoRota	Não	Estratégia de definição da rota: 1 (Eficiente), 2 (Curta), 3 (Evitar pedágio).
CalcularRetorno	Não	Define se o retorno será calculado automaticamente (true / false).
ValorPedagio	Não	Valor total do pedágio calculado.
Destinos	Não	Lista de destinos com tipo (coleta/entrega) e ordem sequencial.
Destinos.Sequencia	Não	Ordem da parada no trajeto.
Destinos.Tipo	Sim	Tipo de parada: 1 (Coleta), 2 (Entrega).
Distancia	Não	Distância total estimada da rota (em km).
Duracao	Não	Duração estimada da viagem.
DataCalculo	Não	Data em que o cálculo da rota foi realizado.
MapaEstaticoBase64	Não	Imagem da rota em base64.
Polilinha	Não	Representação gráfica do trajeto.
PracasPedagio
Nome	Não	Nome da praça de pedágio.
Rodovia	Não	Nome da rodovia onde a praça está localizada.
Km	Não	Quilômetro em que a praça está posicionada.
Valor	Não	Valor total cobrado na praça.
ValorPorEixo	Não	Valor por eixo do veículo, quando aplicável.

---

Próximos passos

Acompanhe as notificações da viagem.

---