> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobway.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Ignição

> Comandos relacionados a ignição do veículo.

<Info>
  Os comandos `enable_ignition` e `disable_ignition` dependem da área de cobertura do sinal de telefonia para comunicação com o veículo. É fundamental assegurar que o veículo esteja acessível e conectado antes de enviar qualquer um desses comandos. Caso um deles seja executado e o veículo fique fora da área de cobertura, poderá ser necessária uma intervenção física.
</Info>

<Warning>
  Por segurança, `enable_ignition` e `disable_ignition` exigem **confirmação em duas etapas**. Na primeira chamada (sem o campo `code`), o comando **não é executado**: a resposta retorna `status: "Confirmation"`, um `code` de 6 dígitos e uma `message` para exibir ao usuário. Para executar, reenvie a mesma requisição incluindo o `code` recebido. Detalhes em [POST vehicle-command](/api-reference/endpoint/command).

  Exemplo da resposta da primeira etapa (confirmação):

  ```json theme={null}
  {
    "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
    "vin": "6AHFT68CKAF501652",
    "command": "disable_ignition",
    "status": "Confirmation",
    "code": "559289",
    "message": "<mensagem de alerta retornada pela API>"
  }
  ```
</Warning>

<Warning>
  **Requisitos e responsabilidades de uso (desativação de ignição)**

  A desativação remota da ignição é uma funcionalidade sensível. Ao utilizá-la, a sua empresa é responsável por garantir que:

  * O acesso aos comandos de ignição seja restrito a usuários autorizados, não liberado a todos os usuários.
  * O comando seja iniciado apenas pela sua empresa, e não por terceiros.
  * O veículo seja de propriedade da sua empresa, alugado, ou esteja legalmente sob a sua frota.
  * Haja consentimento do usuário final do veículo.
  * O uso se restrinja a situações em que o veículo esteja desaparecido, com suspeita razoável de furto ou roubo, ou em uso não autorizado.
  * Seus procedimentos internos tenham sido concluídos antes do envio, incluindo, quando aplicável, a tentativa de localizar o veículo pelas APIs disponíveis, conforme a legislação aplicável.
  * Tenha havido uma tentativa de notificar o usuário final antes do envio.
  * Tenham sido feitos esforços razoáveis para confirmar que a desativação pode ser concluída com segurança.

  Após desativar, reative a ignição (`enable_ignition`) assim que não for mais seguro ou necessário manter o veículo desativado.
</Warning>

## enable\_ignition

Ativa ignição

* Descrição: habilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo).
* Pré-condições:
  * O veículo precisa estar desligado.
  * A ignição do veículo precisa ter sido desabilitada previamente por comando remoto.
* Exemplo:

```json theme={null}
{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "enable_ignition",
  "status": "Success",
  "detail": {
    "date_time": "2023-02-14 09:52:48"
  },
  "updated": "2023-02-14 09:53:48"
}
```

## disable\_ignition

Desativa ignição

* Descrição: desabilita a ignição quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo). Um aviso será mostrado no painel do veículo.
* Pré-condições:
  * O veículo precisa estar desligado.
* Exemplo:

```json theme={null}
{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "disable_ignition",
  "status": "Success",
  "detail": {
    "date_time": "2023-02-14 09:52:48"
  },
  "updated": "2023-02-14 09:53:48"
}
```

## start

Aciona remotamente

* Descrição: aciona remotamente quando as pré-condições de segurança estabelecidas pelo veículo são cumpridas (verificar abaixo).
* Pré-condições:
  * O capô do motor deve estar fechado.
  * O tanque de combustível não deve estar na reserva.
  * A tensão da bateria deve estar em níveis adequados.
  * O pisca-alerta não deve estar ligado.
  * A transmissão  deve estar na posição de “Park” (P).
  * Não deve haver luzes de anomalia no painel do veículo.

<Info>
  O veículo não deve ter realizado mais de duas partidas remotas consecutivas com sucesso. Para que a próxima partida remota seja bem-sucedida, o cliente deve ligar o carro fisicamente antes de tentar novamente.
</Info>

* Exemplo:

```json theme={null}
{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "start",
  "status": "Success",
  "detail": {
    "date_time": "2023-02-14 09:52:48"
  },
  "updated": "2023-02-14 09:53:48"
}
```

## cancel\_start

Cancela acionamento remoto

* Descrição: cancela o acionamento remoto do veículo enviando anteriormente ou desliga o veículo caso ele tenha sido ligado via comando remoto e não tenha ligado a ignição manualmente.
* Pré-condições:
  * O veículo precisa ter sido acionado remotamente previamente por comando remoto.
* Exemplo:

```json theme={null}
{
  "id": "8619b2df-1d68-40e1-8760-cf36f06d00b5",
  "vin": "6AHFT68CKAF501652",
  "command": "cancel_start",
  "status": "Success",
  "detail": {
    "date_time": "2023-02-14 09:52:48"
  },
  "updated": "2023-02-14 09:53:48"
}
```