> For the complete documentation index, see [llms.txt](https://docs.scorepositivo.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scorepositivo.com.br/veiculo/relatorios-para-placa/monitoramento-veiculo.md).

# Monitoramento Veículo

Recurso de notificação através de Webhook e E-mail contendo passagens dos veículos.

<table><thead><tr><th width="237">Código</th><th>Tipo</th></tr></thead><tbody><tr><td><mark style="color:blue;">plate-tracking</mark></td><td><mark style="color:red;">Síncrono</mark></td></tr></tbody></table>

{% hint style="warning" %}
&#x20;<mark style="color:orange;">**INFO**</mark>

Para utilização do recurso de notificações através de Webhook e E-mail, entre em contado com o atendimento.\
Acesse a seção  [Notificação - Webhook](/notificacao-webhook.md) para mais detalhes.
{% endhint %}

### Cadastrar Veículo

Este endpoint será utilizado para cadastrar veículos. A placa deverá ser enviada no campo **document.**

#### Exemplo de requisição:

```bash
curl --location --request POST 'https://core.scorepositivo.com.br/api/report' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMDAwMDAxIiwianRpIjoiNTgyYWNhNTRmYTdlYTE0NTdiMDViNmM1NDUzMzgxZDc5OWRiOGU4Mzk1YzY5ZTA4YTExNDg2NjY1OThkM2U4YTVkY2UxN2U5MGM2NDk0ZTgiLCJpYXQiOjE2OTkzODMyMjguODA0NTEsIm5iZiI6MTY5OTM4MzIyOC44MDQ1MTUsImV4cCI6MTY5OTM4NTAyOC43OTYyMTgsInN1YiI6IiIsInNjb3BlcyI6W119.VaFhMERsuxNZCtNxmDQuB6y3MLuUaKCuPA5VmyijKBT2m6So6Iku5713kzjaDiZaAa87jghnq0xJAcrALikotqR4SCX9rnoHt1SN1t_p4ZLGx53n9mfJbhEMoSxn4L54u9lT471oo6JOnu0aaeYGv798bS4yKcCZq_myrLzIw8fM167qw8CGOthcgHXRdm8ryE3wgLzyH7N8W7U_ydQTh0Vfn3IU7AhMxX6E7Z6wIz47F3rIcNOH-EURcLNimxlKOZgz-1KRLkrg2xDuCH52b-b9-AQrVPwyQSa0565FW5LPckR9YR_6n2V0Xjjx5Xv4bw9NbsRzHUApiwqXgv4R_CzyZFDcOmugUIcRutuufEBUmklKSaWM0aTlIC0NAf8h1MIRCd917Zbbds9KxZcZzzUKnOD9PMRs4xAD40k2NbvLqih9v_XNdrhUtFfD6XKs9nddQnygbwFCBP0bm6u1hNB0izjjdpSi3WsA-dOXEe8LNCwU4ZKqbHFowARe6CSxUA5goh58M7OE5mcjdIK8T8yg6xKibAwGMrxvIVu7amVTTu8rAlJKJeuyQhRXHTQ49KmCxZ-921wAJB2aSoaSQsPKcQwMv4u5o3vXe18n6KEVsaHc76OJxxJDRjRI4b3mLSovm5VLYVsY6QIewtvcQ30r4sPgfq3ebCFbFClphCU' \
--data '{
    "report_id":"plate-tracking",
    "document":"CNB3316"
}'
```

### Ativar e Desativar notificações Veículo

Para ativar/desativar as notificações de um veículo, basta adicionar na requisição o parâmetro **active,** sendo **0** para desativação e **1** para ativação. \
Ao desativar, as notificações via webhook e email serão paralisadas.&#x20;

#### Exemplo de requisição:

```bash
curl --location --request POST 'https://core.scorepositivo.com.br/api/report' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMDAwMDAxIiwianRpIjoiNTgyYWNhNTRmYTdlYTE0NTdiMDViNmM1NDUzMzgxZDc5OWRiOGU4Mzk1YzY5ZTA4YTExNDg2NjY1OThkM2U4YTVkY2UxN2U5MGM2NDk0ZTgiLCJpYXQiOjE2OTkzODMyMjguODA0NTEsIm5iZiI6MTY5OTM4MzIyOC44MDQ1MTUsImV4cCI6MTY5OTM4NTAyOC43OTYyMTgsInN1YiI6IiIsInNjb3BlcyI6W119.VaFhMERsuxNZCtNxmDQuB6y3MLuUaKCuPA5VmyijKBT2m6So6Iku5713kzjaDiZaAa87jghnq0xJAcrALikotqR4SCX9rnoHt1SN1t_p4ZLGx53n9mfJbhEMoSxn4L54u9lT471oo6JOnu0aaeYGv798bS4yKcCZq_myrLzIw8fM167qw8CGOthcgHXRdm8ryE3wgLzyH7N8W7U_ydQTh0Vfn3IU7AhMxX6E7Z6wIz47F3rIcNOH-EURcLNimxlKOZgz-1KRLkrg2xDuCH52b-b9-AQrVPwyQSa0565FW5LPckR9YR_6n2V0Xjjx5Xv4bw9NbsRzHUApiwqXgv4R_CzyZFDcOmugUIcRutuufEBUmklKSaWM0aTlIC0NAf8h1MIRCd917Zbbds9KxZcZzzUKnOD9PMRs4xAD40k2NbvLqih9v_XNdrhUtFfD6XKs9nddQnygbwFCBP0bm6u1hNB0izjjdpSi3WsA-dOXEe8LNCwU4ZKqbHFowARe6CSxUA5goh58M7OE5mcjdIK8T8yg6xKibAwGMrxvIVu7amVTTu8rAlJKJeuyQhRXHTQ49KmCxZ-921wAJB2aSoaSQsPKcQwMv4u5o3vXe18n6KEVsaHc76OJxxJDRjRI4b3mLSovm5VLYVsY6QIewtvcQ30r4sPgfq3ebCFbFClphCU' \
--data '{
    "report_id":"plate-tracking",
    "document":"CNB3316",
    "active": 0
}'
```

### Exemplo de payload da notificação webhook

```json
{
    "plate":"XXX9X99",
    "brand":"GM - CHEVROLET",
    "model":"ONIX", 
    "color":"Branca",
    "year_vehicle":"2020",
    "captured":"2026-08-19T15:27:10",
    "coordinates":"458,368;519,361;521,380;460,387", //Quatro eixos do retângulo da placa onde a leitura foi realizada na imagem. Pode ser útil caso o consumidor queira desenhar o retângulo em volta da placa do veículo após realizar o download da imagem.
    "image_width":1280,
    "image_height":912,
    "storage_path":"https:\/\/scorepositivo-plate-tracking.s3.amazonaws.com\/bd754a56-8697-487b-982a-264eae098ce3.jpg",
    "highlights":["Em cima do guincho", "Avaria"], //Atipicidades que foram encontradas durante a qualificação da captura. Tipos: Adesivo de contato, Alteração na estrutura, Aplicativo, Avaria, Avaria pequena, Avaria grande, Em cima do guincho, Outros, Taxi, Uso comercial)
    "latitude":"-26.896184726215942",
    "longitude":"-48.82422253489494",
    "street":"Rod. Jorge Lacerda",
    "street_number":"690",
    "postal_code":"88320-000",
    "locality":"CENTRO", //bairro
    "city":"ILHOTA",
    "state":"SC",
    "device_name":"CAM216039279", //Código do dispositivo que efetuou a captura.
    "camera_type":"FIXED", //Tipo do dispositivo que efetuou a captura. (Fixa ou Móvel)
    "camera_tag":null, //Características do dispositivo que efetuou a captura. (Área de Desmanche, Autódromo, Estacionamento, Fronteira, Rodovias)
    "camera_orientations":["Frente-Direita","Frente","Traseira","Traseira-Esquerda"] //Em caso de câmera do tipo Fixa, as orientações no qual as capturas são realizadas. (Frente, Esquerda Dianteira, Direita Dianteira, Traseira, Esquerda Traseira, Direita Traseira)
}
```