v1

latestOpenAPI 3.1.02026-07-2678221359.6 KB
AutoRadar

Ativar Assinatura

Ativa uma assinatura

Esta função ativa uma assinatura existente

  • Funcionalidade síncrona: o retorno de sucesso ou erro é imediato na requisição.
  • Apenas assinaturas inativas poderão ser reativadas.
  • Esta funcionalidade é reversível, podendo ser desativada caso necessário.
  • Esta funcionalidade fará com que as consultas sejam reprogramadas.
  • Ao ativar uma inscrição, a consulta não ocorrerá imediatamente, mas será agendada conforme os parâmetros do contrato.
  • Caso a inscrição esteja cancelada, este processo não será permitido.
    • Em caso de assinaturas canceladas, será necessário fazer uma nova inscrição.

Regras de agendamento

Quando uma assinatura é reativada, a consulta deste veículo deverá ocorrer dentro das próximas 24 horas. Após esta primeira consulta, os próximos agendamentos seguirão o mesmo algoritmo de reagendamento, levando em consideração os parâmetros de negócio definidos no contrato de serviço (parâmetro de periodicidade, offset de consulta e data de vencimento).

Quando reagendado, o algoritmo selecionará uma data base a partir da data do reagendamento mais 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 da reativação (D): 1º de janeiro
  • Parâmetro de periodicidade (X): 15 dias
  • Offset de consulta (Y): 5 dias
  • Data de vencimento (Z): 6 dias
Primeira consulta (P)

Ocorre dentro das primeiras 24 horas após a reativação, portanto:

P ≈ D + 24 horas

Cálculo da Data Base do Reagendamento (F):

F = P + X + 1 ≈ 17 de janeiro

Determinação do Período:

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

Ou seja,

Período ≈ (17/01 - 5 dias) até (17/01 + 6 dias)

Portanto, a primeira consulta ocorrerá entre os dias 1 e 2 de janeiro, e a segunda consulta ocorrerá aproximadamente entre os dias 12 e 23 de janeiro.

post/autoradar/{subscription_id}/activate/

Path parameters

subscription_idstring required

Identificador da assinatura

Identificador da assinatura

Response

Assinatura reativada com sucesso

idstring uuid required

Identificador da assinatura

store_idinteger nullable

Identificador do estabelecimento

created_atstring date-time required

Data e hora da criação da assinatura

updated_atstring date-time required

Data e hora da atualização da assinatura

is_activeboolean

Indica se a assinatura esta ativa

is_canceledboolean

Indica se a assinatura foi cancelada

external_idstring nullable

Identificador da assinatura no parceiro

channel'embedded' | 'offer' | 'application'
canceled_reasonstring nullable

Motivo de cancelamento

update_action_notification_sentboolean

Indica que o cliente foi notificado caso os requisitos mínimos não tenham sido atendidos

enqueuedboolean

Indica se a inscrição está em fila de processamento

last_enqueued_atstring date-time nullable

Data e hora da inscrição em fila de processamento