Integração
Para sistemas externos que desejam realizar uma integração conosco, a NavegamLOG disponibiliza já algumas formas para facilitar essa conexão. Enquanto a integração por webhooks é mais simples e rápida, o método utilizando a API Rest é mais customizável e completo.
Webhooks
"Uma webhook é um mecanismo de comunicação automatizada entre aplicações web, que envia notificações em tempo real quando um evento específico ocorre em um sistema. Ela funciona como um "mensageiro digital", onde o sistema emissor envia dados automaticamente (HTTP POST) para um URL de destino (o receptor), eliminando a necessidade do sistema receptor consultar constantemente por atualizações. Isso permite integrar sistemas e automatizar fluxos de trabalho de forma eficiente."
Caso você queira somente receber notificações de fretes (criação e atualização por exemplo) ou saber quando acontecem ocorrências, nossas webhooks são a resposta. Primeiro é necessário ter uma empresa cadastrada no nosso sistema e um endpoint para receber nossas mensagens.
Clique aqui para ver mais sobre as nossas webhooks.
Pontos positivos
- Extremamente rápido de configurar - Basta nos passar uma URL para servir de receptor para o payload e os headers (caso existam);
- Eficiente - A webhook só faz a requisição quando há necessidade. Dessa forma, seu serviço não precisa constantemente ficar perguntando do nosso sistema;
- Simples e agnóstico de sistema - As webhooks são feitas para ser integráveis em qualquer sistema que possui uma conexão com a internet.
Pontos negativos
- Dados de mão única - A webhook é do lado da Navegam para o receptor, ou seja, não é possível "criar fretes" ou "alterar status" dos pedidos. Para isso, verifique o método abaixo.
API Rest
Para usar as rotas da NavegamLOG, sugerimos primeiro entrar em contato com o time de desenvolvedores, para esclarecer quaisquer dúvidas.
Utilizando nossa API Rest na sua integração, é possível realizar qualquer ação do dashboard, incluindo: Criar fretes e rotas, alterar status de pedidos, realizar buscas, gerar relatórios e muito mais.
Temos uma documentação no Swagger (Link para documentação do ambiente de testes), porém note que nem todas as rotas estão disponíveis para todos tipos de usuários.
Caso seja esse o caminho da sua integração, será necessário sempre estar autenticado para realizar as requisições. Veja Autetincação.
Pontos positivos
- Alta customização e controle - É possível solicitar dados com filtros, tratar cenários específicos (como de troca de status), criação de recursos, etc.
Pontos negativos
- Integração manual - Será necessário uma integração mais detalhada, que envia corretamente o dados para nossa API, seguindo nossos padrões. Normalmente mais trabalhosa do que Webhooks.
- Autenticação - Para as requisições, será necessário estar autenticado anteriormente.