# Impressora

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

## Impressora Térmica — Guia de Instalação e Configuração

### Visão Geral

O **App de Impressora Térmica** é um aplicativo desktop (Windows) que imprime automaticamente os pedidos recebidos no dashboard. Ele roda em segundo plano e se conecta ao servidor via WebSocket — assim que um pedido entra, o cupom é impresso sem nenhuma ação manual.

***

### Requisitos

* Windows 10 ou 11 (64-bit)
* Impressora térmica USB conectada ao computador
* Modelos testados e compatíveis:
  * Elgin i9
  * Bematech MP-4200 TH
  * Qualquer impressora ESC/POS (58mm ou 80mm)

***

### 1. Baixar o Aplicativo

A página de download fica dentro do painel administrativo do Traga Já.

**Caminho:** Menu lateral → **Impressora Térmica**

> Esta opção só aparece em planos que incluem o recurso de impressão térmica.

Na página:

1. Será exibida automaticamente a versão mais recente disponível
2. Clique no card **Windows** para baixar o instalador `.exe`
3. O arquivo será salvo na pasta de Downloads do seu navegador

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

***

### 2. Instalar o Aplicativo

1. Abra o arquivo `.exe` baixado
2. Se o Windows exibir um aviso de segurança ("Windows protegeu seu PC"), clique em **Mais informações** → **Executar assim mesmo**
3. Siga as etapas do instalador
4. Ao final, o app será aberto automaticamente

***

### 3. Fazer Login

Na primeira abertura, o app exibe a tela de login.

1. Informe o **e-mail** e **senha** da conta do estabelecimento (os mesmos usados no dashboard)
2. Clique em **Entrar**
3. O token de acesso é renovado automaticamente — você não precisará fazer login novamente

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

***

### 4. Configurar a Impressora

Após o login, o app abre na tela de pedidos. Acesse as configurações clicando no ícone de engrenagem no canto superior direito.

#### Selecionar a Impressora Padrão

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

1. Na seção **Impressora**, clique no seletor **Impressora Padrão**
2. Todas as impressoras instaladas no Windows aparecem na lista
3. Selecione a impressora térmica desejada
4. Clique em **Salvar Configuração**

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

> Se a impressora não aparecer, clique em **Atualizar Lista** e verifique se ela está ligada e conectada ao computador.

{% hint style="info" %}
A partir daqui, TODO pedido que chega é impresso automaticamente na impressora selecionada.
{% endhint %}

#### Inicialização Automática

Na seção **Configurações do Sistema**, ative o toggle **Inicialização Automática** para que o app inicie junto com o Windows.

> Recomendado para uso em produção — garante que o app esteja sempre rodando mesmo após reinicializações do computador.

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

***

### 5. Configurar o Layout da Impressão

Clique em **Configurar** na seção **Configurações de Impressão** para acessar o editor de layout com preview ao vivo.

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

#### Modo de Impressão

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

| Modo     | Descrição                                                 |
| -------- | --------------------------------------------------------- |
| Completo | Imprime o cupom completo com todos os dados do pedido     |
| Cozinha  | Imprime uma comanda simplificada para a equipe de preparo |
| Ambos    | Imprime os dois ao mesmo tempo                            |

#### Opções de Papel e Fonte

| Configuração             | Opções                       |
| ------------------------ | ---------------------------- |
| Largura do papel         | 58mm / 80mm                  |
| Família da fonte         | Monospace / Sans-serif       |
| Espaçamento entre linhas | Compacto / Normal / Espaçado |

#### Campos do Cupom Completo

Ative ou desative quais informações aparecem no cupom:

* CNPJ, número do pedido, data/hora
* Forma de pagamento, nome do cliente, telefone, CPF
* Cupom de desconto, endereço de entrega
* Adicionais dos itens, observações dos itens
* Subtotal, taxa de entrega, descontos, cashback ganho, troco
* Rodapé personalizado

#### Campos da Comanda de Cozinha

* Nome do cliente, endereço
* Adicionais e observações dos itens
* Horário do pedido
* Agrupamento de itens iguais (padrão) ou um a um

#### Tamanhos de Fonte

Cada campo do cupom tem seu próprio controle de tamanho de fonte, ajustável individualmente.

> O preview ao lado direito atualiza em tempo real conforme você altera as configurações.

Clique em **Salvar** para aplicar as mudanças.

***

### 6. Atualizações

O app verifica atualizações automaticamente. Para atualizar manualmente:

1. Acesse **Configurações → Atualizações**
2. Clique em **Verificar Atualizações**
3. Se houver uma versão nova, clique em **Baixar Atualização**
4. Após o download, clique em **Instalar e Reiniciar**

A versão atual do app é exibida na seção **Informações do Sistema**.

***

### Suporte

Em caso de dúvidas ou problemas, entre em contato pelo e-mail **<suporte@traga-ja.com>**.


---

# 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://traga-ja.gitbook.io/traga-ja/impressora.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.