Especificação do serviço de notificação de placa

Arquitetura

A arquitetura do sistema será Cliente – Servidor através do protocolo HTTP. Recomenda-se a utilização de autenticação e  comunicação com criptografia.

O sistema Link será o cliente HTTP, que se encarregará de enviar uma mensagem ao servidor sempre que existir uma placa detectada por qualquer via do estabelecimento, sendo entrada ou saída. A informação sobre o tipo da via deverá ser controlada pelo servidor.

O sistema MoveMais será o servidor HTTP. Este deverá implementar uma API para ser consumida pelo sistema LINK. O sistema Link executará o método POST na URL indicada pela Move Mais, contendo como body a mensagem abaixo descrita. O sistema MoveMais deverá responder apenas 200 quando receber a mensagem. Caso ocorra algum erro, o sistema deverá responder conforme o erro ocorrido, podendo adicionar uma descrição mais detalhada no body de resposta.

Em caso de erro, o sistema Link não tentará enviar aquela mensagem novamente. Caso um novo veículo seja detectado, a mensagem referente a este novo veículo será enviada.

Estrutura da mensagem

A mensagem possuirá a seguinte estrutura:

{
    "estabelecimento": "Codigo_ou_nome_do_estabelecimento",
    "via": "Codigo_ou_nome_da_via",
    "placa": "AAA1111",
    "dataLeitura": "2025-04-01T10:25:00.000"
}

A tabela abaixo descreve de maneira breve os campos da mensagem.

Descrição dos passos

É esperado uma rotina de acontecimentos para que o sistema Link envie os dados para o sistema MoveMais. Abaixo são descritos os passos:

1. Veículo aproxima-se do equipamento;
2. Ao detectar o veículo, o equipamento envia uma mensagem de disparo para o sistema OCR;
3. O sistema OCR dispara a câmera e aguarda a leitura da placa;
4. Ao obter uma placa válida, o sistema OCR envia esta informação para o sistema MoveMais;
5. O sistema MoveMais processa a informação, realizando as ações pertinentes.
6. Caso a imagem obtida não retorne uma placa legível, o sistema executará novamente a rotina a partir do passo 3, até que o usuário pressione o botão para entrar ou efetue a leitura de um cartão válido.