# eTotem Printer

Funcionamento print server

O eTotem Printer é o programa instalado no computador Windows ligado à impressora de senhas. Ele faz duas coisas:

  1. abre a tela do totem para o tablet, pela rede local;
  2. imprime as senhas na impressora térmica ligada a esse computador.

Todos os tablets da empresa usam o mesmo computador.

Não precisa de Java

Diferente da versão anterior, o eTotem Printer não precisa de Java nem de nenhum outro programa instalado. Basta o arquivo .zip.

# 1 - Instale a impressora

Instale a impressora que vai imprimir as senhas e confirme que ela aparece em Configurações > Dispositivos > Impressoras e scanners.

O nome da impressora não importa: o eTotem Printer encontra a impressora térmica sozinho. Ele reconhece as famílias Epson TM, Zebra, Bematech, Elgin e Daruma, e também as impressoras com Receipt no nome. Nas impressoras Zebra, a etiqueta sai em ZPL. Nas demais, sai em ESC/POS.

ATENÇÃO

Se nenhuma impressora térmica for reconhecida, a senha sai na impressora padrão do Windows, que pode ser um gerador de PDF. Veja como escolher a impressora.

# 2 - Instalação do eTotem Printer

Download - eTotemPrinter.zip

ATENÇÃO

Se o computador já tem a versão anterior do servidor de impressão (a que pedia Java), desinstale-a antes em Configurações > Aplicativos > Adicionar ou remover programas. As duas versões usam a porta 80 e não funcionam ao mesmo tempo.

ATENÇÃO

Confira se outro programa não está usando a porta 80, como o IIS ou o Skype.

  1. Baixe o eTotemPrinter.zip, ou pegue-o na seção de downloads.
  2. Descompacte o arquivo: clique com o botão direito nele e escolha Extrair tudo.
  3. Abra a pasta totem que foi extraída. Ela tem os arquivos etotem-printer.exe, instalar.bat, desinstalar.bat, printer.json e LEIA-ME.txt.
  4. Clique com o botão direito em instalar.bat e escolha Executar como administrador.
  5. Aguarde a mensagem Pronto e pressione qualquer tecla para fechar a janela.

ATENÇÃO

Não execute o instalar.bat de dentro do .zip, sem descompactar: ele precisa dos outros arquivos da pasta totem ao lado dele.

OBS

O Windows pode avisar que protegeu o computador, porque o programa não tem assinatura digital. Clique em Mais informações e depois em Executar assim mesmo.

Se algo der errado, a janela mostra Falhou, e o motivo fica no arquivo printer.log, em C:\Program Files\eTotem Printer.

# Confira se o serviço subiu

No navegador do próprio computador, abra:

http://localhost/status

Deve aparecer um texto com a versão e a impressora escolhida, parecido com este:

{
  "versao": "0.1.0",
  "porta": 80,
  "colunas": 42,
  "linguagem": "escpos",
  "configurada": "",
  "destino": "EPSON TM-T88V Receipt",
  "origemDestino": "termica",
  "motivoDestino": "única térmica entre as 2 impressoras físicas de um total de 4",
  "ultimaImpressao": null
}

O campo destino diz em qual impressora as senhas vão sair, e origemDestino diz como ela foi escolhida:

origemDestino Significado
configurada o nome escrito no printer.json
termica a impressora térmica foi reconhecida sozinha
padrao-do-sistema nenhuma térmica foi reconhecida, e está usando a padrão do Windows

# 3 - Abra o eTotem no Tablet

Descubra o IP fixo do computador onde o eTotem Printer foi instalado. No Prompt de Comando, rode ipconfig. Depois, no navegador do tablet (de preferência o Google Chrome), abra esse endereço.

Exemplo:

http://192.168.0.100

Deve aparecer a seguinte tela:

etotem-tablet-01

OBS

Faça os testes de impressão de senha.

etotem-tablet-02

ATENÇÃO

A tela abre em http://localhost/ no computador mas não abre no tablet? É o firewall. Execute o instalar.bat de novo, como administrador, para recriar a regra da porta 80.

# 4 - Monitorando a comunicação

# Pelo navegador

No computador do eTotem Printer, abra http://localhost/status. O campo ultimaImpressao mostra a última senha que chegou, quando chegou, em qual impressora e se deu certo:

"ultimaImpressao": {
  "quando": "2026-09-16T10:42:07.512-03:00",
  "senha": "A001",
  "fila": "Atendimento Geral",
  "impressora": "EPSON TM-T88V Receipt",
  "sucesso": true
}

Quando a impressão falha, sucesso vem false e o campo erro explica o motivo. Se o printer.json tiver algum erro, o campo configInvalida aparece: o serviço continua funcionando, mas com as configurações padrão.

# Pelo arquivo de log

O eTotem Printer é instalado em C:\Program Files\eTotem Printer. Nessa pasta, abra o arquivo printer.log. Cada senha impressa gera uma linha:

time=2026-09-16T10:40:01.203-03:00 level=INFO msg="eTotem Printer no ar" versao=0.1.0 porta=80 colunas=42 front=true
time=2026-09-16T10:42:07.512-03:00 level=INFO msg="senha impressa" senha=A001 fila="Atendimento Geral"

Falhas aparecem com level=ERROR msg="falha ao imprimir". Se o serviço nem chega a iniciar, o motivo fica registrado no Visualizador de Eventos do Windows, com a origem eTotemPrinter.

# Trocar a impressora

Para escolher a impressora manualmente, abra http://localhost/impressoras no computador do eTotem Printer. Ele lista os nomes exatos das impressoras, do jeito que o Windows os escreve.

Depois edite o arquivo printer.json, em C:\Program Files\eTotem Printer, e escreva o nome no campo impressora:

{
  "porta": 80,
  "impressora": "EPSON TM-T88V Receipt",
  "linguagem": "escpos",
  "colunas": 42
}
Campo Padrão O que é
impressora "" nome exato da impressora; vazio = encontrar a térmica sozinho
linguagem escpos escpos para as impressoras de recibo, zpl para as Zebra. Só vale quando impressora está preenchida
colunas 42 largura da bobina de 80mm
porta 80 não altere: o tablet espera a porta 80

Salve o arquivo e reinicie o serviço eTotem Printer no Gerenciador de Tarefas, aba Serviços.

ATENÇÃO

Um nome que não existe no Windows é tratado como erro: o eTotem Printer não troca para outra impressora por conta própria. Para voltar à escolha automática, deixe o campo vazio: "impressora": "".

ATENÇÃO

Ao escrever o nome de uma impressora Zebra, escreva também "linguagem": "zpl". Com escpos, a impressão parece dar certo, mas nenhum papel sai.

# Atualizar

Baixe o .zip novo e repita a instalação. O instalar.bat para e remove a versão instalada antes de copiar a nova, e não sobrescreve o printer.json que já está no computador.

# Desinstalar

Use um dos dois caminhos:

  1. Configurações > Aplicativos > Adicionar ou remover programas, procure por eTotem Printer e clique em Desinstalar. O Windows vai pedir a confirmação de administrador.
  2. Ou clique com o botão direito em desinstalar.bat e escolha Executar como administrador. Esse arquivo fica na pasta totem do .zip e também em C:\Program Files\eTotem Printer.

A desinstalação para e remove o serviço, a regra da porta 80 no firewall e o programa.

OBS

O printer.json e o printer.log são mantidos em C:\Program Files\eTotem Printer, tanto na desinstalação quanto na atualização.