# Permissão do site para acesso ao Qz Tray

## Contexto

Após uma decisão da WICG (Web Incubator Community Group) impondo restrições adicionais à comunicação entre navegadores web e aplicações locais (como o QZ Tray), afim de combater atividades maliciosas, alguns aplicativos já instalados podem sofrer um bloqueio, qual será necessário um ajuste de permissão dentro do navegador web (como Google Chrome, Mozilla Firefox, Ethernet, entre outros).

Assim como os aplicativos ao serem recém instalados, terão de receber a nova permissão também dentro do navegador web.

## Possíveis problemas

1. Caso você já utilize o QZ Tray, já o tenha instalado, devidamente configurado e vinculado a um perfil de impressora dentro do sistema, é possível que, ao tentar imprimir uma comanda, o navegador — devido à nova medida de segurança — não realize a impressão e solicite a permissão de acesso. Ou seja, a comanda não será impressa até que você conceda essa permissão no navegador.
2. Caso você esteja tentando vincular uma impressora ao perfil de impressora da Deeliv pelo QZ Tray pela primeira vez, ao tentar carregar uma impressora para permitir o acesso da Deeliv ao QZ Tray, o navegador também poderá solicitar essa permissão. Dessa forma, ao tentar carregar a impressora, a janela do QZ Tray não será exibida até que você autorize o acesso diretamente pelo navegador.

## Solução

A seguir está o passo a passo para fornecer as permissões necessárias ao aplicativo assistente de impressão (**QZ Tray**):

{% hint style="warning" %}
O tutorial a seguir foi realizado em um sistema operacional **macOS**, utilizando o navegador **Google Chrome**. As imagens podem variar caso você esteja usando outro sistema operacional e/ou navegador.\
Em caso de dúvida ou dificuldade, não hesite em entrar em contato com o nosso suporte!
{% endhint %}

1. Ao tentar imprimir uma comanda ou carregar uma impressora no perfil de configuração, o navegador poderá exibir uma janela no canto superior esquerdo solicitando permissão de acesso. Clique em **“Permitir”**.

<figure><img src="/files/o59QgX9G6ECOoUd3uWeE" alt=""><figcaption></figcaption></figure>

2. Após conceder a permissão, será necessário recarregar a página.\
   Geralmente, o próprio navegador exibirá a faixa com a opção **“Recarregar”** — clique nela.

<figure><img src="/files/VtFHHRJzEeFrmk1wcFGp" alt=""><figcaption></figcaption></figure>

Se a faixa de recarregamento não surgir automaticamente, você pode atualizar a página manualmente por meio de qualquer uma das opções:

* Pressionar o botão **F5** no teclado.
* Pressionar **Ctrl + R** (Windows/Linux) ou **Command + R** (Mac).
* Fechar a guia (ou o navegador) e abrir novamente a página.
* Clicar manualmente no botão **“Recarregar esta página”** no navegador:

<div align="center"><figure><img src="/files/B0QGzAplXdeBNXPuDVt1" alt="" width="375"><figcaption></figcaption></figure></div>

3. Se a janela de permissão não for exibida, você pode conceder o acesso manualmente. É simples: Clique no ícone **“Ver informações do site”** (canto superior esquerdo da barra de endereços). Localize a opção **“Acesso à rede local”** e ative o botão **switch** para permitir o acesso.

<figure><img src="/files/TXQ1uRyReXpUaoLf7a0T" alt=""><figcaption></figcaption></figure>

Como deve ficar após ativar:

<figure><img src="/files/Te4diOqLP3R9WL6DZWnS" alt="" width="242"><figcaption></figcaption></figure>

Após permitir, recarregue a página novamente seguindo os mesmos passos mencionados anteriormente.

4. Se a opção “Acesso à rede local” não estiver disponível na janela de informações do site, será necessário acessar as configurações detalhadas do navegador. Clique em **“Configurações do site”** na mesma janela.

<figure><img src="/files/edf5QgYW3cVOTMyl1bSP" alt=""><figcaption></figcaption></figure>

5. Você terá acesso a página de configurações do site no navegador. Na nova página, verifique no menu lateral se você está em **“Privacidade e segurança”**. Role até encontrar a opção **“Acesso à rede local”**.

<figure><img src="/files/GL06WykzAuk6AXjCKNQn" alt=""><figcaption></figcaption></figure>

6. Clique no botão à direita da opção **“Acesso à rede local”** para abrir o menu de seleção.

<figure><img src="/files/nzXpuDjP26SARN6qxXPF" alt=""><figcaption></figcaption></figure>

7. Escolha e clique na opção **“Permitir”**.

<figure><img src="/files/k3pz28qnyxqALr3KgAmb" alt=""><figcaption></figcaption></figure>

8. Após definir a opção como **"Permitir"**, feche a página de configurações (clicando no "X" da guia).

<figure><img src="/files/FpQCUvjOM03xExMDfHmt" alt=""><figcaption></figcaption></figure>

9. Agora recarregue a página novamente seguindo os mesmos passos mencionados anteriormente.

<figure><img src="/files/9UgtQhRNvxstOCsD2W8I" alt=""><figcaption></figcaption></figure>

Pronto! Após seguir todos os passos, o navegador estará autorizado a permitir que o sistema acesse o aplicativo assistente de impressão (**QZ Tray**).\
Com isso, você poderá voltar a imprimir suas comandas e vincular as impressoras aos perfis corretamente dentro do sistema.

## Dúvidas e Respostas frequentes

* Por que o navegador está pedindo permissão de “Acesso à rede local”?

  * Essa é uma nova medida de segurança dos navegadores para proteger o acesso a dispositivos locais. Para imprimir comandas, o sistema da Deeliv precisa dessa permissão para acessar o QZ Tray.

* Cliquei em “Permitir”, mas continua sem imprimir. O que faço?

  * Após permitir o acesso, é necessário **recarregar a página**.\
    Use F5, Ctrl + R / Command + R ou clique no botão “Recarregar”. Sem recarregar, a permissão não é aplicada.

* O navegador não mostrou a janela pedindo permissão. Como habilito manualmente?

  * Você pode ativar manualmente indo em **Informações do site** → **Acesso à rede local** → **Permitir**.\
    Se essa opção não aparecer, acesse **Configurações do site** → **Privacidade e segurança** → **Acesso à rede local**. Você pode voltar ao item 3 do tópico "[S**oluções**](#solucao)" e acompanhar as etapas com imagens. 

* Preciso fazer esse processo toda vez que for imprimir?

  * Não. Essa permissão é feita apenas uma vez por site. Depois de autorizada, o navegador lembra da configuração e o QZ Tray funcionará normalmente.

* Esse processo é seguro?

  * Sim. O acesso à rede local é utilizado apenas para permitir que o sistema da Deeliv se comunique com o QZ Tray e envie comandos de impressão. Nenhum dado externo é acessado.

* Uso mais de um navegador. Preciso liberar em todos?

  * Sim. A permissão é armazenada por navegador.\
    Se você usa Chrome e depois alterna para Edge, por exemplo, cada um precisará da permissão separadamente.

* A opção “Acesso à rede local” não aparece de jeito nenhum. O que pode ser?

  * Isso pode acontecer se o navegador estiver desatualizado ou se houver políticas de segurança no computador (como em empresas). Atualize o navegador ou solicite ao TI a liberação.

{% hint style="warning" %}
Algumas imagens demonstradas acima podem destoar da versão atual da plataforma devido as frequentes atualizações para a melhora do produto.
{% endhint %}

{% hint style="info" %}
Em caso de dúvidas, entre em contato conosco! :smile:

Site: [www.deeliv.app](https://centraldeajuda.deeliv.app/outros/www.deeliv.app)\
E-mail: <ajuda@deeliv.app>\
Chat de suporte: [chat.deeliv.app](https://chat.deeliv.app)\
Telefone: (15) 3261-7778
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://centraldeajuda.deeliv.app/outros/permissao-acesso-qztray.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.