---
title: "Atualiza Veículo"
method: PATCH
path: "/autoradar/subscriptions/{license_plate}"
tags: ["AutoRadar"]
---

# Atualiza Veículo

`PATCH /autoradar/subscriptions/{license_plate}`

### Atualiza as informações de um veículo

*Esta função atualiza um veículo e utiliza um serviço de enriquecimento de dados, se necessário*

+ Funcionalidade **síncrona**, o retorno de sucesso ou erro é retornado imediatamente na requisição.
+ O veículo deve ter uma assinatura ativa pelo requisitante.
+ A assinatura deve estar ativa e não cancelada.
+ Caso algum dado não seja informado e o enriquecimento falhar ao recupera-lo, será retornado o erro **417**
+ O veículo pode ser atualizado apenas quando um webhook `autoradar_vehicle_update_required` for enviado.
  + Caso o webhook não tenha sido enviado e esta rota for requisitada, um erro **428* será retornado.
+ O erro **412** está mapeado para requisitos mínimos como no caso de UF não suportado
  + Os estados suportados no momento são SP, RJ, PR, MG, DF, ES, MT, RS, BA e SC

#### Webhook de atualização necessária

O evento `autoradar_vehicle_update_required` não pode ser forçado, ele é o resultado de várias regras de negócio internas que farão todo o possível para consultar os débitos veículares.

Quando nenhuma outra ação for possível, será enviado este webhook e liberado a rota para alteração de dados.

## Path parameters

- `license_plate` string, required — Placa que será atualizada

## Request body

- VehicleRequestUpdateDTO
  - `document` string, nullable — Documento do proprietário do veículo
  - `renavam` string, nullable — Renavam do veículo
  - `uf` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO'

## Response `200`

Veículo atualizado com sucesso

- SubscriptionAsyncSuccessResponseDTO
  - `success` string, required — Sucesso no processamento sa solicitação

## Other responses

- `403` — Atualização de veículo não permitida
- `404` — Veículo não encontrado ou não há inscrição para ele
- `412` — Não cumpre os requisitos necessários
- `417` — Dados obrigatórios não informados e não recuperados pelo enriquecimento
- `422` — Validation Error
- `428` — Veículo não atende requisitos mínimos para atualização
- `500` — Inconsistência na atualização cadastral do veículo

---

[API](https://skmtc.net/usezapay/apis/zapi.md) · [All operations](https://skmtc.net/usezapay/apis/zapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usezapay/zapi/versions/50c96157fff4/schema)