Impressão na cozinha e no salão
Toda a impressão física do estabelecimento passa pela Cenaly Hardware Bridge — um pequeno programa no dispositivo de caixa ao qual as impressoras estão conectadas. O navegador não imprime diretamente na impressora térmica: ele envia o documento à ponte, e a ponte fala com o hardware na linguagem ESC/POS.
Através da ponte são impressos: tíquetes de cozinha por estação, etiquetas por item e por pacote, recibo de venda e de devolução, pré-conta, relatórios X e Z e o manifesto do pacote na tela de entrega.
Tíquetes de cozinha por estação#
O tíquete deve chegar onde o prato é preparado: a cozinha fria — na sua impressora, a grelha — na sua, o bar — no seu.
A configuração fica em Cozinha (KDS) → painel «Setores», com a tabela «estação → impressora» dentro dele. Para cada estação definem-se:
| Campo | O que significa |
|---|---|
| Impressora | dispositivo específico da ponte; vazio — imprimir na impressora com a função «cozinha» |
| Impressora de reserva | para onde vai o tíquete se a principal não responder |
| Quem imprime | desativado, caixa ou KDS |
| Largura da fita | 42 caracteres (fita de 80 mm) ou 32 (58 mm) |
| Página de código | ver abaixo |
| Etiquetas por item | imprimir adesivos ao mover o tíquete para «pronto» |
A lista de impressoras é carregada da ponte local, portanto a estação deve ser configurada a partir da máquina à qual a impressora está fisicamente conectada.
O que entra no tíquete. Fonte grande (o cozinheiro lê o papel atravessando o salão), nome do prato, quantidade, modificadores em linha separada abaixo do prato, comentário («sem cebola»), número do convidado e curso de serviço, se o pedido estiver dividido por eles. Não há preços nem totais no tíquete de cozinha.
Imprime-se apenas o novo. Um novo toque do garçom não imprime um segundo tíquete: o sistema lembra quais linhas já foram enviadas à estação. Se um item foi adicionado ou a quantidade foi alterada — vai um tíquete complementar, e não uma duplicata completa do pedido.
Etiquetas por item e por pacote#
O adesivo de 60×40 mm no copo e na caixa resolve dois problemas da entrega: os pacotes deixam de se confundir entre os entregadores, e o convidado vê no copo que o leite é realmente sem lactose — o modificador deixa de ficar apenas no tíquete de cozinha.
- etiqueta por item — impressa ao mover o tíquete para «pronto», se a configuração correspondente estiver ativada na estação;
- etiqueta por pacote — impressa na entrega: a tela pergunta o número de pacotes e imprime «Pacote 1 de 3», «2 de 3» e assim por diante;
- manifesto do pacote — papel dentro do pacote com a composição completa do pedido, incluindo modificadores em linhas separadas: por ele o entregador e o convidado conferem a completude, e a disputa de «faltou um item» com o agregador se encerra com prova impressa. O botão fica na tela Entrega (Expo).
As etiquetas são impressas pelo dispositivo com a função «impressora de etiquetas»; se essa função não existir na ponte, o adesivo vai para uma impressora de recibo comum.
Documentos de caixa#
| Documento | Pela ponte | Comentário |
|---|---|---|
| Recibo de venda / devolução | sim | fallback — impressão pelo navegador |
| Pré-conta (conta do cliente) | sim | não fiscal, com assinatura explícita no papel |
| Relatórios X e Z | sim | ver Turno de caixa |
| Manifesto do pacote | sim | tela Entrega (Expo) |
| Tíquete de cozinha, etiquetas | sim | sem fallback pelo navegador |
A reimpressão de um recibo emitido é sempre registrada no log de operações de risco; o PIN gerencial só é solicitado para os cargos em que «reimpressão sob PIN» está ativado — ver Controle de perdas.
O recibo fiscal é outra história: ele é impresso pelo registrador fiscal e obedece às leis do país, ver Fiscalização.
Fila de impressão e o que o resultado significa#
Na Ponte há uma fila com retentativas à prova de reinício: se a impressora estiver offline, a tarefa não se perde, mas espera e é repetida. O indicador da fila fica visível no cabeçalho do Caixa.
Uma tarefa travada pode ser removida. O problema clássico da cozinha: a impressora engole o papel, leva meia hora para ser consertada e, quando é ligada, cospe cinquenta tickets desatualizados. Na fila do cabeçalho do Caixa, a tarefa é cancelada uma a uma: a Ponte marca como "cancelado" e, quando a impressora voltar, simplesmente a ignora. Se a tarefa já tiver ido para impressão, o cancelamento avisará isso com honestidade — nesse caso, o papel sairá.
O botão "cancelar" existe apenas para as travadas — aquelas que esperam pela impressora há mais de três minutos. As tarefas recentes aparecem na linha, mas não podem ser removidas, e isso é proposital: uma demora de segundos (a impressora acordou, o cabo foi puxado) é normal, a Ponte termina de imprimir sozinha, e um botão ao lado de uma tarefa assim significaria um recibo perdido.
O resultado da impressão é de quatro valores, e para o operador de caixa são notícias diferentes:
| Resultado | O que aconteceu |
|---|---|
| Impresso | a Ponte confirmou a impressão física |
| Na fila | a Ponte aceitou a tarefa, mas a impressora está indisponível — o cliente não recebeu o recibo em mãos |
| Pelo navegador | não há Ponte ou ela não aceitou o documento, a impressão saiu pelo diálogo do navegador |
| Não impresso | não foi possível de jeito nenhum |
No resultado "na fila", o fallback do navegador não é acionado — caso contrário, um recibo seria impresso duas vezes.
As tarefas são idempotentes: reenviar o mesmo documento não gera um segundo papel.
Páginas de código e caracteres não latinos#
A impressora térmica não sabe o que é UTF-8: ela desenha um glifo por byte da tabela de um byte selecionada. Por isso, a página de código é definida para cada impressora configurada:
| Valor | O que faz |
|---|---|
auto (padrão) |
encontrou cirílico — muda a cabeça para CP1251; latim e latim estendido (turco, polonês, albanês) permanecem como estão |
cp1251 / cp866 |
escolha explícita da tabela cirílica — cabeças baratas vêm com uma das duas |
georgian-academy / georgian-ps / georgian-expert |
layouts da ROM de fontes de dispositivos georgianos |
utf8 |
comportamento histórico: em qualquer não latino — caracteres ilegíveis |
Sobre o georgiano, com honestidade. Qual tabela uma cabeça específica "entende" é uma propriedade do dispositivo físico, isso não consta na especificação do protocolo; por isso a tabela é escolhida por dispositivo. Não existe página de código georgiana no padrão ESC/POS, então antes "ხინკალი" saía romanizado — khinkali: dá para ler, mas não foi isso que foi pedido.
Agora, a linha que a cabeça não consegue imprimir, a Ponte desenha como imagem — impressão raster com fonte embutida, que funciona em qualquer impressora e não depende da ROM dela. A fonte embutida cobre latim e latim estendido, grego, cirílico, armênio e os três estilos georgianos (mkhedruli, mtavruli, asomtavruli). Onde o texto é impresso da forma normal, nada muda — o raster é acionado apenas quando necessário.
O comportamento é controlado pela caixa de seleção "raster para não latinos" em cada dispositivo (ativada por padrão, disponível tanto na página da Ponte quanto na seção em nuvem "Hardware"). Se você desmarcar, volta a romanização anterior: isso é necessário para cabeças raras que não entendem impressão raster.
Ideogramas (chinês, japonês, coreano), hebraico e árabe não entraram na fonte de propósito: em escritas da direita para a esquerda, a linha sairia ao contrário, e isso é pior que o resultado atual. O painel de estações na cozinha mostra com honestidade o que acontecerá com a linha: "sairá como imagem" ou "não há tabela nem fonte".
O latim turco, polonês e albanês não passam por CP1251 de propósito: ali ş, ğ, ą se tornariam ?.
O que é necessário para começar#
- Ponte no computador do Caixa — Cenaly Hardware Bridge. Toda a impressão física passa por ela.
- Impressora conectada a esse mesmo computador — USB, LAN ou Bluetooth; a Ponte encontra os dispositivos sozinha.
- Mapeamento "estação → impressora" — caso contrário, os tickets não têm para onde ser roteados.
- Rolo no formato correto para os adesivos de item e de pacote.
- Estações nos pratos — o ticket é montado pela estação do item (KDS).
Limitações#
- A Ponte imprime apenas do seu próprio computador. O navegador não alcança a Ponte em outro PC: instale a Ponte em cada dispositivo de Caixa ou use a impressão via nuvem para a impressora de outro PC.
- Impressoras de etiquetas TSPL/ZPL não foram testadas em hardware real — atualmente as etiquetas são impressas em raster na impressora de recibo.
- A largura da fita é decidida pelo dispositivo. Ela é obtida da configuração da impressora, senão do modelo do registrador fiscal, senão é assumida como segura; a largura de documento de 80 mm não se transfere para o registrador fiscal, porque o registrador não quebra a linha, mas a corta junto com os valores.
- A pré-conta não fica na fila. Se a impressora de recibo estiver configurada, mas offline, a conta do cliente é impressa no registrador fiscal: o papel é necessário agora, e uma cópia uma hora depois por cima de um pedido já pago seria um segundo papel. O recibo de venda se comporta de outra forma — ele espera a repetição.
- A pré-conta não vai para a impressora da cozinha — para a conta do cliente, essa impressora é considerada inadequada, e o trabalho vai para o Caixa.
Solução de problemas#
O tíquete não foi impresso. Verifique o status da Ponte: se ela estiver offline, a tarefa fica na fila de impressão e será enviada quando a conexão com ela for restabelecida — a fila sobrevive a reinicializações.
Está imprimindo na impressora errada. A estação não tem uma impressora própria definida, e o resolvedor escolheu "qualquer uma disponível". Defina o mapeamento das estações explicitamente.
Em vez de letras, aparecem ideogramas ou quadrados vazios. É um problema de página de código da impressora: ative a fonte raster — ela desenha o texto como imagem e imprime qualquer idioma.
Os valores são cortados à direita. A largura da fita está definida como muito grande: coloque a largura real na opção do Dispositivo.
Os adesivos saem com tamanho errado. Verifique o formato do rolo e se a impressão está indo para uma impressora de etiquetas, e não para uma impressora de recibos (no momento, as etiquetas em impressora de recibos são impressas em raster).
Seções relacionadas#
- Cenaly Hardware Bridge — instalação da Ponte, lista de Dispositivos, funções das Impressoras
- Cozinha (KDS) — estações, cursos de entrega e configuração de impressão
- Caixa (POS) — Recibo, pré-conta, reimpressão
- Expedição (Expo) — manifesto e adesivos do pacote
- Turno de caixa — relatórios X e Z
- Controle de perdas — reimpressão como evento de risco
Perguntas frequentes#
O tíquete foi impresso duas vezes — por quê?#
Provavelmente a estação está com impressão ativada tanto no Caixa quanto no KDS. São dois Dispositivos diferentes com duas Pontes, e cada um imprimiu sua própria via. Deixe apenas um valor no campo "Quem imprime".
A impressora foi desligada — os Pedidos se perderam?#
Não. A tarefa vai para a fila da Ponte e é impressa quando a Impressora voltar a funcionar. Mas enquanto ela está na fila, o papel fisicamente não existe — a interface diz isso claramente.
É possível imprimir para a cozinha sem a Ponte?#
Tíquetes de cozinha e adesivos — não, eles passam apenas pela Ponte. Os documentos de Caixa têm um fallback pelo navegador: impressão pelo diálogo de impressão comum. A exceção é a Unidade onde o único hardware é o Registrador fiscal: nesse caso, o Recibo é impresso pelo próprio Caixa, e o fallback pelo navegador não é ativado.
Por que a lista de Impressoras está vazia?#
A lista vem da Ponte neste Dispositivo. Se a Ponte não estiver em execução ou a Impressora estiver conectada a outra máquina, os Dispositivos não aparecerão — configure a estação a partir da máquina onde a Impressora está fisicamente conectada.
Os modificadores são impressos no manifesto do pacote?#
Sim. O tíquete de cozinha, o adesivo do Item e o manifesto do pacote são montados com o mesmo formato de linha: nome do prato, abaixo dele os modificadores em linhas separadas e o comentário. Assim, os três papéis de um mesmo Pedido ficam iguais e podem ser conferidos a olho.