Webhook de notificações

Quando houver uma atualização relevante em um veículo monitorado, a Autodock envia uma requisição POST para a URL de webhook configurada pelo integrador.

O payload identifica o evento com a tag VEHICLE_MONITORING e envia os dados do veículo junto com as informações encontradas.

Campos opcionais

O exemplo abaixo mostra vários tipos de informação no mesmo payload apenas para demonstrar a estrutura completa.

Na prática, nem todos os campos serão enviados juntos. Campos como multas, notificacao, ipva, dpvat e licenciamento são opcionais e podem chegar um de cada vez, em eventos separados.

Exemplo de payload

{
  "tag": "VEHICLE_MONITORING",
  "data": {
    "vehicleId": "9f3c7b21...",
    "licensePlate": "ABC1D23",
    "response": {
      "placa": "ABC1D23",
      "multas": {
        "ait": "A123456789",
        "tipo": "Infração",
        "data": "2026-05-18",
        "hora": "14:35",
        "vencimento": "2026-06-17",
        "codigo": "745-50",
        "descircao": "Transitar em velocidade superior à máxima permitida em até 20%",
        "endereco": "Av. Paulista, 1500",
        "cidade": "São Paulo",
        "estado": "SP",
        "pontosCNH": 4,
        "preco": 130.16,
        "precoComDesconto": 104.13
      },
      "notificacao": {
        "ait": "N987654321",
        "tipo": "Notificação",
        "data": "2026-04-02",
        "hora": "09:12",
        "vencimento": "2026-05-02",
        "codigo": "554-10",
        "descircao": "Estacionar em local proibido",
        "endereco": "Rua XV de Novembro, 320",
        "cidade": "Curitiba",
        "estado": "PR",
        "pontosCNH": 5,
        "preco": 195.23,
        "precoComDesconto": 156.18
      },
      "ipva": {
        "preco": 1420.75,
        "ano": "2026",
        "mes": "03",
        "dataExpedicao": "2026-01-10",
        "cota": 1
      },
      "dpvat": {
        "preco": 105.5,
        "ano": "2026",
        "mes": "01",
        "dataExpedicao": "2026-01-05",
        "cota": 1
      },
      "licenciamento": {
        "preco": 167.74,
        "ano": "2026",
        "mes": "09",
        "dataExpedicao": "2026-09-01",
        "cota": 1
      }
    }
  }
}

Campos principais

• tag: identifica o tipo de evento enviado. Para monitoramento de veículos, o valor será VEHICLE_MONITORING.
• data.vehicleId: identificador do veículo monitorado na Autodock.
• data.licensePlate: placa do veículo monitorado.
• data.response: objeto com as informações encontradas para o veículo.
• data.response.placa: placa retornada na resposta do monitoramento.
• data.response.multas: informações de multa, quando houver.
• data.response.notificacao: informações de notificação de infração, quando houver.
• data.response.ipva: informações de IPVA, quando houver.
• data.response.dpvat: informações de DPVAT, quando houver.
• data.response.licenciamento: informações de licenciamento, quando houver.

Processamento recomendado

Seu sistema deve tratar cada campo de data.response como opcional. Antes de processar uma multa, IPVA, DPVAT, licenciamento ou notificação, verifique se o campo existe no payload recebido.

Responda ao webhook com sucesso apenas depois de receber e registrar a notificação no seu sistema.