A mesma análise como Container On-Prem na sua rede
A API é o mesmo núcleo de análise do programa Desktop, empacotado numa imagem de Container que é executada On-Prem, ou seja, num servidor próprio ou no seu cluster. Os seus sistemas enviam os ficheiros de cartão por HTTP ao Container e recebem a análise em JSON. O Container mantém os ficheiros de cartão apenas na memória de trabalho. Não os guarda em disco nem os escreve em nenhum ficheiro de registo. Não nos envia ficheiros de cartão nem resultados. Para que possamos contar quantos condutores analisa com a sua licença, liga-se ao nosso servidor de licenças em license.scernetta.com, concretamente após o arranque, aproximadamente de 6 em 6 horas e quando surge um novo condutor. O servidor de licenças recebe, nessa ocasião, o texto do seu ficheiro de licença com o nome da sua empresa, o número de versão do Container, alguns valores técnicos de verificação e, para cada novo condutor, um código de condutor. O código de condutor é calculado pelo Container no seu servidor a partir do cartão de condutor e da sua chave secreta.
A quem se destina
Destina-se a frotas com TMS ou ERP próprios que queiram continuar a processar aí a análise. Os fornecedores de telemática, que de qualquer modo já recolhem os dados do cartão, podem mandá-los verificar diretamente, e os prestadores de serviços que analisam cartões de condutor para muitos clientes poupam o desvio por um programa Desktop.
Como decorre
Recebe de nós um ficheiro de licença. Antes do primeiro arranque, gera uma única vez, com um comando da imagem de Container, uma chave secreta a partir da qual o Container calcula os códigos de condutor. Utilize esta chave em todas as instalações e guarde uma cópia. O Container é executado num servidor da sua rede e precisa aí de uma pasta própria, na qual regista os condutores que já têm uma vaga de condutor. O servidor tem de conseguir aceder a license.scernetta.com, diretamente ou através do seu proxy HTTP. Os seus sistemas autenticam-se com uma chave de API e entregam os ficheiros .ddd por HTTP, individualmente ou agrupados por condutor, e o Container reúne-os exatamente como o faz o programa Desktop. Em resposta, recebe um JSON com os turnos, as infrações na vista escolhida, as previsões e os períodos não avaliáveis, que pode processar diretamente.
Para uma frota inteira de uma só vez existe um endpoint de lote. Carrega todos os ficheiros num único pedido, o Container atribui-os ele próprio aos condutores e calcula em segundo plano. Para cada novo condutor no pedido, o Container ocupa uma vaga de condutor logo no momento da submissão. Se as vagas de condutor livres não chegarem para todos os novos condutores, recusa o pedido inteiro e não ocupa nenhuma vaga. O progresso e os resultados por condutor consulta-os através de um ID de tarefa.
O mesmo núcleo
O programa Desktop e a API calculam com o mesmo código. Para o mesmo ficheiro e a mesma vista, a API fornece os mesmos resultados que o programa, como dados.
Duas vistas
Cada resposta contém uma das duas listas de infrações. Por predefinição, aplica-se a vista rigorosa, que deriva cada constatação do texto do regulamento e indica o artigo correspondente. Segundo o direito da UE, pode, em alternativa, consultar a vista de referência, que está calibrada com base no resultado de software estabelecido. Segundo as regras suíças ARV 1 e ARV 2, existe apenas a vista rigorosa. Um endpoint próprio fornece o catálogo das regras com as respetivas referências.
Relatórios
O relatório do programa Desktop também está disponível através da API, em HTML ou como tabelas CSV num Zip. A par disso, um manifesto de origens regista, para cada dia, qual o ficheiro carregado que o comprova.
Autenticidade
As assinaturas e os certificados de um cartão de condutor ou de um descarregamento de unidade-veículo podem ser verificados através da API. A resposta indica o que foi verificado. As assinaturas da primeira geração de cartões ainda não são verificadas por esta versão, o que não constitui indício de manipulação.
Unidade-veículo
Também o ficheiro de descarregamento do veículo pode ser lido. Vê que cartões estiveram inseridos num período e que condutores conduziram com eles.
Gerações
São lidos cartões de condutor da geração 1, bem como da geração 2, incluindo a versão 2. A API lê ficheiros de unidades-veículo apenas nos formatos da geração 2.
OpenAPI
A interface está descrita como especificação OpenAPI 3.1 que o próprio Container disponibiliza. A documentação em docs.scernetta.com é gerada a partir dela.
Como são contados os condutores
Cada cartão de condutor que analise durante o período de vigência da sua licença conta uma vez como condutor, independentemente de quantas vezes o analise. Se um condutor receber um cartão renovado ou um cartão de substituição, continua a ser o mesmo condutor. Se receber um cartão de outro país, conta como novo condutor. Um condutor mantém a sua vaga de condutor até ao fim do período de vigência, mesmo que deixe a sua empresa antes disso. A contagem abrange todas as suas instalações em conjunto, incluindo uma instalação de teste. O cartão de exemplo do nosso sítio Web, a verificação de autenticidade e os ficheiros de unidades-veículo não ocupam nenhuma vaga de condutor.
Licença
A API é licenciada pelo número de condutores e faturada anualmente. O Container verifica ele próprio, pela assinatura digital, se o ficheiro de licença é autêntico, e para isso não precisa de qualquer ligação a nós. Quando um condutor é analisado pela primeira vez no período de vigência, o Container pede ao nosso servidor de licenças uma vaga de condutor para esse condutor. Se uma licença paga expirar, o Container continua a calcular durante mais 14 dias, para que a análise não pare quando a renovação chega alguns dias mais tarde. O preço indicamo-lo a pedido, porque depende da dimensão da frota.
Sem ligação ao servidor de licenças
Os condutores que já têm uma vaga de condutor continuam a ser analisados pelo Container mesmo sem ligação ao nosso servidor de licenças, durante 30 dias a contar da última ligação, ou 14 dias com uma licença de teste. Para novos condutores, uma licença paga dispõe de uma reserva, caso o nosso servidor de licenças não esteja acessível durante mais de um minuto. A reserva corresponde a um décimo das vagas de condutor, mas no mínimo a 2 vagas por período de vigência, ou seja, 3 com 30 vagas. Para isso, o Container precisa da sua pasta no servidor. Comunica esses condutores posteriormente, logo que o servidor de licenças volte a estar acessível. Uma licença de teste não tem reserva.
O que sai do servidor
Os ficheiros de cartão são processados On-Prem, ou seja, na sua rede, e nunca nos são transmitidos. O código de condutor é calculado pelo Container no seu servidor a partir do cartão de condutor e da sua chave secreta, que nunca recebemos. A partir do código, não conseguimos saber quem é o condutor. Com a sua chave, porém, o código pode ser novamente associado a um condutor, pelo que, nos termos do RGPD, constitui um dado pessoal. As últimas 20 mensagens que o Container enviou ao nosso servidor de licenças desde o seu arranque podem ser consultadas e lidas no Container, tal como eram antes da cifragem.
A documentação da interface encontra-se em docs.scernetta.com e é gerada a partir do ficheiro OpenAPI. Começa com um guia sobre o arranque, a licença e o tratamento de erros e descreve cada endpoint com os seus parâmetros.Ir para a documentação
Se quiser utilizar a API, escreva-nos indicando que sistemas pretende integrar e de quantos condutores ou veículos se trata. Depois, entramos em contacto consigo e facultamos-lhe um acesso.