Pular para o conteúdo principal

Integrações e API · Guia

Envie leituras de dispositivos à A-REX

Conecte um registrador de dados, um rastreador ou uma plataforma de frota para que temperatura, umidade, portas e outras leituras cheguem às suas entregas rastreadas, verificadas por um único conjunto de regras.

As leituras de dispositivos mostram como a mercadoria viajou: a temperatura no baú, a umidade em um contêiner, o momento em que uma porta foi aberta. A A-REX recebe essas leituras de qualquer dispositivo ou plataforma capaz de enviar uma mensagem, verifica cada uma pelas mesmas regras publicadas e a acrescenta à entrega rastreada. Você não precisa de um acordo de parceria com o fabricante do dispositivo: sua empresa ou sua transportadora aponta a própria plataforma para um endereço que a A-REX lhe dá.

Uma leitura nunca altera uma entrega sozinha. Ela alimenta o gráfico da entrega, os avisos dela e propostas que uma pessoa aprova.

Escolha como as leituras chegam

Você tem…Use
uma plataforma de frota, de visibilidade ou de registradores que consegue enviar um webhookum endpoint de Entrada cujo destino são as leituras de dispositivos
um software próprio que consegue entrar como cliente de máquinaa API de leituras, com um cliente que tenha permissão para gravar leituras
um registrador que você lê depois da viagemCarregue o arquivo do registrador na entrega

Conecte uma plataforma

  1. Abra Entrada e escolha Adicionar endpoint de entrada. Indique leituras de dispositivos como o que ele recebe e o formato que sua plataforma envia: o JSON de leituras A-REX ou os dados de sensores EPCIS.
  2. Copie o endereço e o segredo nas configurações de encaminhamento da sua plataforma. Escolha a mesma forma de assinatura dos dois lados.
  3. Se a sua plataforma envia outro JSON, abra o endpoint e use Mapear outro JSON em Mapeamento de leituras: indique onde ficam o horário, os valores e o ID do dispositivo, cole uma mensagem de exemplo e teste antes de publicar.
  4. Cadastre cada dispositivo em Leituras, em Fontes de leituras, com o ID que ele envia e a frequência com que deve enviar. Veja Fontes de leituras e dispositivos.

Verifique antes de entrar em operação

Cada mensagem recebe um relatório de validação: quantas leituras foram guardadas e, para as recusadas, o que está errado e como corrigir, pelo nome do campo. As leituras válidas são mantidas mesmo quando outras da mesma mensagem são recusadas. Veja Como ler um relatório de validação.

Acompanhe o fluxo de dados

O cartão da entrega na página do lote mostra a Qualidade do fluxo de dados com uma letra de A a E. Abra-a para ver a pontuação e os dois principais problemas, por exemplo uma lacuna longa. Veja Entenda a qualidade do fluxo de dados.

O que fica registrado

Cada leitura guarda quem responde por ela: Declarado pela sua empresa (um arquivo que você carregou), Informado por uma plataforma conectada ou Medido e assinado pelo dispositivo. As leituras são registradas no livro de rastreabilidade desde o momento em que são recebidas, em períodos de até quatro horas. As posições são dados pessoais do motorista e são tratadas à parte; veja Posições e privacidade.