📘 Guia de Funcionamento das Travas Sonoff / eWeLink

Este documento tem como objetivo orientar sobre o funcionamento do sistema de abertura de portas utilizando dispositivos Sonoff / eWeLink, em conjunto com a API de Portas do sistema Mercatus.

O processo completo envolve três pontos fundamentais:

✅ 1. Funcionamento do Dispositivo Sonoff (Lado do Cliente)

O primeiro ponto essencial para garantir o funcionamento correto da trava é o dispositivo Sonoff, instalado na porta, geladeira ou equipamento.
Ele deve estar:

• 100% ONLINE

• Conectado ao Wi-Fi do local

• Respondendo normalmente no aplicativo eWeLink

🔍 Como o cliente pode verificar isso?

No aplicativo eWeLink, acessar, e checar o status do dispositivo, e também, aqui, permite os seguintes recursos:

✔ Notificação de dispositivo OFFLINE

O usuário pode ativar alertas para ser avisado sempre que o Sonoff perder conexão.

✔ Histórico de comandos

É possível visualizar todos os acionamentos enviados ao dispositivo, confirmando se:

• o comando chegou ao Sonoff,

• o dispositivo respondeu,

• houve falha ou sucesso.

📌 Importante

Se o dispositivo estiver offline, nenhum comando de abertura da porta será executado, pois o servidor não conseguirá se comunicar com o equipamento.

✅ 2. Funcionamento do Aplicativo que Envia o Comando (E4 GO / E4 Pay)

O segundo ponto fundamental está no app que envia o comando de abertura, como:

• E4 GO

• E4 Pay

Para que o comando chegue ao servidor, o dispositivo onde está sendo executado o comando [E4 GO ou E4 Pay] precisa estar:

• Conectado à internet (Wi-Fi ou 4G)

• Com o aplicativo funcionando corretamente

• Conseguindo acessar APIs externas

📌 Se o dispositivo onde está sendo executado o E4 GO ou E4 PAY estiver sem internet:

O comando não chegará ao servidor, e a porta não abrirá.

Erro comum nesse cenário:

“Falha ao abrir a porta”
Esse erro normalmente indica que o aplicativo não conseguiu nem se comunicar com a API de Travas do Mercatus, geralmente por problema de conexão no próprio celular.

✅ 3. Funcionamento da API do Mercatus (Servidor)

Quando os dois pontos anteriores estão funcionando, o comando chega ao servidor Mercatus.

O fluxo é:

1. O APP envia o pedido para abrir a porta

2. A API do Mercatus recebe o comando

3. A API identifica qual tipo de trava está configurada

4. O comando é repassado à API correspondente

Os tipos de travas atualmente suportados são:

1. ControlID QrCode

2. AccessRun

3. Sonoff / eWeLink

4. HomeLabs

5. E4 Sistemas (E4 Lock IOT)

Cada tipo de trava possui sua própria API e forma de retorno.

✅ 4. Resposta: Sucesso ou Falha

Quando uma API de trava recebe o comando, ela tenta enviá-lo ao dispositivo correspondente. A resposta poderá ser:

• Sucesso → porta aberta corretamente

• Falha → comando não chegou ao equipamento ou não foi possível processá-lo

Exemplos de erros específicos do Sonoff:

• Não foi possível abrir a porta devido a uma falha na comunicação com o serviço Sonoff.

• A API do Sonoff retornou conteúdo inválido.

• Falha ao acionar Sonoff.

Essas falhas aparecem diretamente no aplicativo que o cliente utilizou para abrir a porta [E4 GO ou E4 Pay].

📡 5. Importante: Este modelo depende de conectividade online

O fluxo Sonoff/eWeLink é um modelo 100% online.
Mesmo que o cliente esteja fisicamente na frente da porta, ele depende de:

• Wi-Fi funcionando no dispositivo Sonoff

• Internet no dispositivo android (App E4 GO ou E4 Pay)

• APIs externas (eWeLink + Mercatus) funcionando

• Servidores online

Se qualquer etapa estiver offline, a porta não abrirá.

🔵 6. Modelos de Trava via Bluetooth (Sem Internet)

Existem modelos de travas que permitem acionamento direto via Bluetooth, sem depender de:

• Wi-Fi

• Internet

• APIs externas

Esse método é mais estável, pois o comando é enviado diretamente do dispositivo android para a controladora da porta quando o cliente está próximo dela, utilizando o protocolo Bluetooth.

🔧 Travas com abertura via Bluetooth:

✔ Via aplicativo E4 GO

• Keypass

• E4 Sistemas (E4 Lock IOT)

✔ Via aplicativo E4 Pay

• E4 Sistemas (E4 Lock IOT) (em implementação)

Vantagens do Bluetooth:

• Funciona mesmo sem internet

• Evita problemas de rede do cliente

• Execução instantânea

• Mais segurança e estabilidade

🧭 Resumo para o Cliente

📄 Conclusão

O sistema de abertura de portas via Sonoff/eWeLink oferece praticidade, mas depende totalmente de conectividade online. Por isso, recomendamos que o cliente:

• Mantenha o Sonoff sempre conectado ao Wi-Fi

• Verifique notificações de offline no eWeLink

• Certifique-se de que o celular tem internet ao tentar abrir a porta

• Considere o uso de modelos Bluetooth para maior estabilidade