Menu: Integrações > Serviço de integração Sankhya (WebHook) (configuração realizada pelo Suporte Lincros)
Objetivo: Entender como funciona o envio automático dos eventos da rota para o seu sistema, o que é necessário para solicitar a integração e como configurar a autenticação no seu endpoint.
Considerações:
Ambiente na versão 4.49.3 do Tracking ou superior;
Possuir um endpoint (URL) preparado para receber requisições do tipo POST, com conteúdo em JSON;
O cadastro e a manutenção da integração no Tracking são realizados pelo Suporte Lincros, mediante abertura de chamado.
Nome da integração
No Tracking, esta integração é cadastrada com o tipo Serviço de integração Sankhya (WebHook). Apesar do nome, ela não é exclusiva para o Sankhya: os eventos podem ser enviados para o endpoint de outros sistemas que você utilize, desde que ele esteja preparado para receber as requisições conforme descrito neste artigo.
Como funciona
A integração envia, em tempo real, os eventos da rota para o endpoint informado, conforme o motorista registra as ações no aplicativo. Cada evento gera um envio (POST) com os dados daquele momento, permitindo que o seu sistema acompanhe o andamento da operação.
Os eventos disponíveis são:
Início de rota;
Entrega;
Devolução;
Envio de comprovante;
Fim de rota;
Início de parada;
Coleta realizada;
Vou pra lá (saiu para entrega).
É possível receber todos os eventos ou apenas os selecionados. Também é possível ter mais de um destino, cada um com seu próprio endpoint, token e seleção de eventos.
Pontos importantes sobre o envio:
Cada envio aguarda a resposta do endpoint por até 10 segundos;
Não há reenvio automático: se o endpoint estiver indisponível ou recusar a requisição, aquele evento não é enviado novamente;
Uma falha no recebimento não afeta a operação do motorista no aplicativo.
Como solicitar a integração
Abra um chamado com o Suporte Lincros solicitando a integração Serviço de integração Sankhya (WebHook) e informando:
A URL do endpoint que vai receber os eventos (recomendamos o uso de https);
O token de autenticação, caso opte por utilizar autenticação (recomendado);
Os eventos que deseja receber, ou se deseja receber todos.
Com essas informações, o Suporte realiza o cadastro e a ativação da integração no Tracking.
Como configurar a autenticação no seu endpoint
A autenticação é opcional, mas recomendamos utilizá-la para garantir a segurança do recebimento dos eventos no seu sistema.
Caso opte por utilizar autenticação, ela precisa ser configurada no formato Authorization Bearer. O Tracking envia o token no cabeçalho da requisição, sempre acompanhado da palavra "Bearer" antes do token. Por isso, o sistema que recebe os eventos deve estar configurado para validar o cabeçalho no seguinte formato:
Nome do cabeçalho: Authorization
Valor: Bearer + espaço + token
Exemplo: em uma configuração no n8n, o campo Name recebe "Authorization" e o campo Value recebe "Bearer" seguido de um espaço e do token.
Outros formatos de autenticação, como usuário e senha, não são compatíveis com a integração e farão com que os envios sejam recusados pelo seu endpoint.
Atenção: caso o token seja alterado no seu sistema, abra um chamado com o Suporte informando o novo token, pois a atualização na integração do Tracking é realizada pelo nosso time. Até essa atualização, os envios serão recusados pelo seu endpoint e os eventos desse período não serão reenviados.
Exemplo do conteúdo enviado (JSON)
Exemplo ilustrativo de um evento de Entrega. Os campos que não se aplicam ao evento são enviados como null.
{
"TipoEvento": 2,
"TipoEventoDescricao": "Entrega",
"DataEvento": "2026-09-01T14:32:05",
"CodigoRota": 84567,
"CodigoNegocioRota": "[código da rota]",
"DataRota": "2026-09-01T00:00:00",
"PlacaVeiculo": "[placa do veículo]",
"CodigoMotorista": 1032,
"NomeMotorista": "[nome do motorista]",
"CodigoEntrega": 5567012,
"CodigoCliente": 88123,
"NomeCliente": "[nome do cliente]",
"NumeroNotaFiscal": "[número da nota fiscal]",
"SerieNotaFiscal": "1",
"NomeRecebedor": "[nome do recebedor]",
"DocumentoRecebedor": "[documento do recebedor]",
"CodigoMotivoDevolucao": null,
"DescricaoMotivoDevolucao": null,
"Latitude": -23.5615,
"Longitude": -46.6559,
"Comprovantes": [
{ "Tipo": "ASSINATURA", "Url": "[endereço do comprovante]" }
]
}Observação: no momento, o endereço do comprovante não é disponibilizado como link público.
Resultado esperado: após o cadastro pelo Suporte e a configuração da autenticação no seu endpoint, os eventos da rota passam a ser recebidos automaticamente pelo seu sistema, conforme os registros do motorista no aplicativo.