---
title: "Criar Assinatura"
method: POST
path: "/autoradar/"
tags: ["AutoRadar"]
---

# Criar Assinatura

`POST /autoradar/`

### Cria uma nova assinatura

*Este endpoint permite que você cadastre um novo veículo no serviço AutoRadar*

+ Funcionalidade **síncrona**, o retorno de sucesso ou erro é retornado imediatamente na requisição.
+ Quando uma assinatura é criada, ela será agendada seguindo as regras contratuais e não será consultada imediatamente.
+ Erro 412 está mapeado para situações que impedem a criação de uma assinatura
  + Quando não há suporte para o UF informado
  + Os estados suportados no momento são SP, RJ, PR, MG, DF, ES, MT, RS, BA e SC

#### Regras de agendamento de consulta

Na criação de uma nova assinatura, o algoritmo selecionará uma data base calculada como a soma da data atual com o parâmetro de periodicidade. Com essa data base, será determinado um período através da subtração do offset e adição do intervalo de vencimento. Dentro desse período, será escolhida uma data de balanceamento para distribuir de maneira eficiente a consulta.

##### Exemplo:

- **Data atual (D):** 1º de janeiro
- **Parâmetro de periodicidade (X):** 15 dias
- **Offset de consulta (Y):** 5 dias
- **Data de vencimento (Z):** 6 dias

##### Cálculo da Data Base (F):

`F = D + X = 16 de janeiro`

##### Determinação do Período:

`Período = (F - Y) até (F + Z)`

Ou seja,

`Período = (16/01 - 5) até (16/01 + 6)`

Portanto, a data da próxima consulta ocorrerá entre os dias **11 de janeiro** e **22 de janeiro**.

## Request body

- SubscriptionRequestCreateDTO
  - `license_plate` string, required — Placa do veiculo
  - `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'
  - `document` string, nullable — Documento do proprietario
  - `renavam` string, nullable — Renavam do veiculo
  - `chassis` string, nullable — Chassi do veiculo
  - `external_id` string, nullable — Identificador externo do parceiro
  - `channel` 'embedded' | 'offer' | 'application'

## Response `201`

Assinatura criada com sucesso

- SubscriptionResponseDTOInput
  - `id` string, uuid, required — Identificador da assinatura
  - `store_id` integer, nullable — Identificador do estabelecimento
  - `created_at` string, date-time, required — Data e hora da criação da assinatura
  - `updated_at` string, date-time, required — Data e hora da atualização da assinatura
  - `is_active` boolean — Indica se a assinatura esta ativa
  - `is_canceled` boolean — Indica se a assinatura foi cancelada
  - `external_id` string, nullable — Identificador da assinatura no parceiro
  - `channel` 'embedded' | 'offer' | 'application'
  - `canceled_reason` string, nullable — Motivo de cancelamento
  - `vehicle` VehicleBaseDTO, required
    - `license_plate` string, required — Placa do veículo
    - `renavam` string, nullable — Renavam do veículo
    - `chassis` string, nullable — Chassi do veículo
    - `state` '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'
    - `owner_document` string, nullable — Documento do proprietário
    - `model` string, nullable — Modelo do veículo
    - `color` string, nullable — Cor do veículo
    - `fabrication_year` integer, nullable — Ano de fabricação do veículo
    - `model_year` integer, nullable — Ano do modelo do veiculo
    - `last_enrich_date` string, date-time, nullable — Data do último enriquecimento
  - `update_action_notification_sent` boolean — Indica que o cliente foi notificado caso os requisitos mínimos não tenham sido atendidos
  - `enqueued` boolean — Indica se a inscrição está em fila de processamento
  - `last_enqueued_at` string, date-time, nullable — Data e hora da inscrição em fila de processamento

## Other responses

- `403` — Usuário não tem permissão para esta ação
- `406` — Usuário já possui uma assinatura ativa
- `412` — Não cumpre os requisitos necessários
- `422` — Validation Error
- `503` — Serviço indisponivel

---

[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)