> For the complete documentation index, see [llms.txt](https://traga-ja.gitbook.io/traga-ja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://traga-ja.gitbook.io/traga-ja/impressora.md).

# Impressora

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FS4rTVmu4DOa2RkgAyWl4%2FScreenshot%202026-04-12%20at%2019-46-59%20Impressora%20T%C3%A9rmica%20-%20Traga%20J%C3%A1.png?alt=media&amp;token=00b4cc66-6b4b-4c76-b4e3-cc5708567cef" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2Fdp7CxvWC3BuU6Q1SBTEk%2FScreenshot%202026-04-12%20at%2019-53-27%20Impressora%20T%C3%A9rmica%20-%20Traga%20J%C3%A1.png?alt=media&amp;token=c55bb978-ba26-4fb4-8c17-7f6cbbe65f13" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FDfZf91gI8niBtGO7Wmdp%2FCaptura%20de%20tela%202026-04-12%20195446.png?alt=media&amp;token=ef352254-6de6-450c-a429-25719fd443f2" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FxqVyvui8VRJHhGEZjumn%2FCaptura%20de%20tela%202026-04-12%20201257.png?alt=media&amp;token=d3d23cf1-4894-40bf-bf30-661c7e7abb7c" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FlyGhmaIJhalFUetA3kJV%2FCaptura%20de%20tela%202026-04-12%20201431.png?alt=media&amp;token=918e4588-5ef6-4878-b206-4c5702f9d5ed" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2Fa9D7MXIygYkCd98LaiIT%2FCaptura%20de%20tela%202026-04-12%20200905.png?alt=media&amp;token=4aa1ad14-f932-4375-bb3f-0ececaecd1d3" 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="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FEUnrhi8M2GJGWYZtktsN%2FCaptura%20de%20tela%202026-04-12%20231931.png?alt=media&amp;token=064af70d-ed9c-4c5e-bece-e018b9b8024a" alt=""><figcaption></figcaption></figure>

#### Modo de Impressão

<figure><img src="https://3112138314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F03FNhFX3GgByGAyQ7GlQ%2Fuploads%2FcuHFSfa8gFeMAtus9F63%2FCaptura%20de%20tela%202026-04-12%20231953.png?alt=media&amp;token=fae9f41a-21c6-40ce-8f23-c581045be611" 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>**.