Guia de Configuração do EmiliaCloudPrinter¶

Captura de Pedidos POS na Nuvem¶

Este guia técnico explica como configurar impressoras virtuais no Windows que enviam os dados de impressão diretamente para o serviço CloudPOS da Emilia Vision.

Público-alvo: Administradores de sistemas, técnicos de suporte e fornecedores de POS.

Visão Geral¶

O EmiliaCloudPrinter permite capturar os pedidos que seu sistema POS envia para impressoras térmicas (cozinha, bar, sobremesas, caixa) e armazená-los na nuvem para análise.

Existem quatro métodos de configuração:

*Requer driver APD pré-instalado (ver Método C, Passos 1-2)

Pré-requisitos¶

• Windows 10 ou Windows 11
• Permissões de Administrador
• Conectividade com a Internet

Dados de conexão:

Verificar conectividade (PowerShell):

Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100

Deve exibir TcpTestSucceeded : True

Método A: Configuração com PowerShell (Recomendado)¶

Este método é mais rápido e permite criar múltiplas impressoras em segundos.

Passo 1: Abrir PowerShell como Administrador¶

1. Pressione Win + X
2. Selecione "Windows PowerShell (Admin)" ou "Terminal (Admin)"
3. Aceite o prompt do UAC se aparecer

Passo 2: Criar Impressora Básica¶

Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter" -DriverName "Generic / Text Only" -PortName "EmiliaCloud"

Passo 3: Criar Múltiplas Impressoras por Estação¶

Configuração recomendada: Uma impressora virtual por estação de trabalho.

Script completo:

# EmiliaCloudPrinter - Script de Instalação

# Cozinha
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Bar"

# Sobremesas
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Desserts"

# Caixa
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Cashier"

Write-Host "Instalação concluída" -ForegroundColor Green

Passo 4: Verificar Instalação¶

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Método B: Configuração com Interface Gráfica¶

Este método utiliza o assistente do Windows para adicionar impressoras.

Passo 1: Abrir Configurações de Impressoras¶

1. Pressione Win + I para abrir Configurações
2. Vá para Dispositivos → Impressoras e scanners
3. Clique em "A impressora que desejo não está na lista"

Passo 2: Selecionar Tipo de Conexão¶

Selecione "Adicionar uma impressora usando um endereço TCP/IP ou nome de host" e clique em Avançar.

Passo 3: Inserir Dados de Conexão¶

Importante: Desmarque "Consultar a impressora e selecionar automaticamente o driver a ser usado"

Passo 4: Detecção de Porta¶

Aguarde enquanto o Windows detecta a porta TCP/IP.

Passo 5: Configurar Porta RAW¶

Quando o diálogo de configuração de porta aparecer:

Deixe desmarcado "Status SNMP habilitado".

Passo 6: Selecionar Driver¶

• Fabricante: Generic
• Impressora: Generic / Text Only

Passo 7: Usar Driver Existente¶

Se o driver já estiver instalado, selecione "Usar o driver atualmente instalado".

Passo 8: Nomear a Impressora¶

Digite o nome: EmiliaCloudPrinter

Passo 9: Instalação Concluída¶

A impressora aparece na lista de dispositivos instalados.

Para criar impressoras adicionais (Kitchen, Bar, Desserts, Cashier), repita o processo alterando o nome da porta e da impressora.

Método C: Driver Epson (Interface Gráfica)¶

Este método utiliza o driver nativo EPSON TM-T20II com o assistente do Windows.

Pré-requisitos¶

1. Complete primeiro o Método A ou B para criar a porta TCP/IP
2. Baixe e instale o Epson APD (Advanced Printer Driver)

Passo 1: Baixar Driver APD da Epson¶

Acesse o site de suporte da Epson para TM-T20II:

Baixe: Advanced Printer Driver (APD) v5.13 (~70 MB)

Passo 2: Instalar o Driver APD¶

Extraia o ZIP e execute APD_513_T20II.exe como Administrador:

Passo 3: Adicionar Impressora com Configuração Manual¶

1. Vá para Configurações → Dispositivos → Impressoras e scanners
2. Clique em "A impressora que desejo não está na lista"
3. Selecione "Adicionar uma impressora local ou de rede com configurações manuais"

Passo 4: Usar Porta Existente¶

Selecione "Usar uma porta existente" e escolha a porta EmiliaCloudPrinter que você criou anteriormente.

Passo 5: Selecionar Driver Epson¶

• Fabricante: EPSON
• Impressora: EPSON TM-T20II Receipt5

Passo 6: Usar Driver Instalado¶

Selecione "Usar o driver atualmente instalado (recomendado)"

Passo 7: Compartilhamento de Impressora (Opcional)¶

Configure o compartilhamento se necessário. Nome de compartilhamento: EmiliaCloudPrinterEpson

Passo 8: Instalação Concluída¶

A impressora Epson está agora configurada para enviar dados para a nuvem EmiliaVision.

Método D: Driver Epson (PowerShell)¶

O método mais rápido se você já tem o driver APD da Epson instalado.

Pré-requisitos¶

• Driver APD da Epson instalado (ver Método C, Passos 1-2)

Impressora Individual¶

# Criar porta e impressora com driver Epson
Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinterEpson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud"

Múltiplas Impressoras com Driver Epson¶

# Cozinha
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Bar"

# Sobremesas
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Desserts"

# Caixa
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Cashier"

Verificar Instalação¶

Get-Printer | Where-Object {$_.Name -like "*Epson*"} | Format-Table Name, DriverName, PortName

Quando Usar Driver Epson vs Generic¶

Testes de Funcionamento¶

Teste Individual¶

"Teste de impressão EmiliaCloudPrinter" | Out-Printer -Name "EmiliaCloudPrinter"

Teste por Estação¶

"=== COZINHA ===`r`nMesa: 12`r`n2x Hambúrguer`r`n1x Salada" | Out-Printer -Name "EmiliaCloudPrinter-Kitchen"
"=== BAR ===`r`nMesa: 12`r`n2x Margarita`r`n1x Cerveja" | Out-Printer -Name "EmiliaCloudPrinter-Bar"
"=== SOBREMESAS ===`r`nMesa: 12`r`n1x Cheesecake" | Out-Printer -Name "EmiliaCloudPrinter-Desserts"
"=== CAIXA ===`r`nMesa: 12`r`nTotal: R$45.50" | Out-Printer -Name "EmiliaCloudPrinter-Cashier"

Entre em contato com a equipe da Emilia Vision para confirmar o recebimento dos dados.

Comandos Úteis¶

Listar Drivers Disponíveis¶

Get-PrinterDriver | Format-Table Name

Verificar se o Driver Epson está Instalado¶

Get-PrinterDriver | Where-Object {$_.Name -like "*TM-T20II*"}

Se o comando não retornar nada, o driver APD da Epson não está instalado. Ver Método C, Passos 1-2.

Listar Todas as Impressoras¶

Get-Printer | Format-Table Name, DriverName, PortName

Listar Apenas Impressoras EmiliaCloud¶

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Excluir uma Impressora¶

Remove-Printer -Name "EmiliaCloudPrinter"

Excluir uma Porta de Impressora¶

Remove-PrinterPort -Name "EmiliaCloud"

Excluir Todas as Impressoras e Portas EmiliaCloud¶

# Excluir impressoras
Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Remove-Printer

# Excluir portas
Get-PrinterPort | Where-Object {$_.Name -like "*Emilia*"} | Remove-PrinterPort

Solução de Problemas¶

Erro: "O Windows não consegue conectar à impressora"¶

1. Verifique a conectividade:

   Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100
   

2. Verifique a configuração do firewall

Os dados chegam como binário/lixo¶

• Verifique se está usando o driver Generic / Text Only
• NÃO use "Microsoft Software Printer Driver"

A impressora não aparece na lista¶

Restart-Service Spooler

Resumo da Configuração¶

Configuração Concluída!¶

Para suporte técnico, entre em contato com a equipe da Emilia Vision.