Cenaly Hardware Bridge — Hardware do estabelecimento

O navegador por si só não consegue imprimir recibos em uma impressora POS, abrir a gaveta de dinheiro ou ler o peso de uma balança. Essa tarefa é resolvida pelo Cenaly Hardware Bridge — um pequeno aplicativo gratuito que é instalado no computador do caixa, funciona em segundo plano e conecta a página do painel administrativo/caixa ao Hardware local do estabelecimento.

Abrir: Painel administrativo → Hardware (admin.cenaly.com).

O que se conecta#

Fila de impressão#

Imprimir pela ponte não é "enviou e torça para dar certo". A ponte tem sua própria fila de tarefas com repetições, que sobrevive a reinicializações: se a impressora foi desligada ou o papel acabou, a tarefa não se perde e será impressa quando o dispositivo voltar a funcionar.

Por isso a impressão tem cinco desfechos diferentes, e não "deu certo/não deu certo": impresso, aceito na fila (ainda sem papel!), impresso pelo navegador, o registrador fiscal está imprimindo (veja abaixo) e não impresso. No cabeçalho do caixa há um indicador da fila com o número de tarefas aguardando.

As tarefas são idempotentes: reenviar o mesmo documento não gera um segundo papel.

O registrador fiscal não é uma impressora de recibos reserva. Se a unidade não tem uma impressora de recibos separada, a ponte NÃO vai imprimir o nosso recibo pelo registrador fiscal: o recibo fiscal é impresso por ele mesmo, e o nosso documento é outro papel. O caixa, nessa situação, diz exatamente isso: "o recibo é impresso pelo próprio registrador fiscal". Pelo registrador são permitidos apenas impressão de teste e pré-recibo — e neles é impressa uma observação de que não é um documento fiscal.

Detalhes, vinculação de impressoras a estações e páginas de código para cirílico e georgiano — Impressão na cozinha e no salão.

Instalação da Ponte#

Se a Ponte não for encontrada neste PC, a página vai sugerir instalá-la:

1. Baixe a versão para o seu sistema operacional — Windows, Linux (x64) ou Linux (ARM64) (macOS — em planos). Para verificação, é indicado o SHA-256.
2. Execute o aplicativo. Windows — clique duplo: a Ponte vai para segundo plano (ícone na bandeja) e abre a página de status. Linux — é mais confiável instalar logo como serviço em segundo plano com um comando de uma linha da página "Hardware" (curl … | sudo … bash): ele inicia na inicialização do PC e se reinicia sozinho. Executar o arquivo baixado manualmente (chmod +x e executar) também funciona, mas a Ponte só fica ativa enquanto o terminal estiver aberto e não volta após reiniciar; a página de status no Linux você abre manualmente — http://127.0.0.1:9100.
3. Confirme na página de status que a Ponte está em execução. Abra o painel administrativo neste mesmo PC, selecione a Unidade desejada e a seção "Hardware": o navegador se conecta automaticamente.
4. Volte ao painel administrativo e clique em "Buscar novamente" — o Caixa encontra sozinho a Ponte neste PC e se conecta.

Se o Windows mostrar um aviso ao baixar/executar — isso é esperado: escolha "Salvar" e, ao executar, "Mais informações" → "Executar assim mesmo". Para Linux, há a instalação de uma linha como serviço em segundo plano.

Como remover a Ponte do computador (Linux). Com o mesmo comando de uma linha da página "Hardware", só que com um subcomando — na página ele fica oculto em "Linux — parar ou remover a Ponte":

• … | sudo bash -s -- stop — para o serviço e o remove da inicialização automática; os arquivos e as configurações permanecem, para ativar de novo — start;
• … | sudo bash -s -- uninstall — remove o serviço e desinstala o próprio programa. As configurações e a vinculação do Caixa permanecem, e o script informa onde elas estão;
• … | sudo bash -s -- uninstall --purge — o mesmo mais as configurações: a lista de Hardware e a vinculação à Unidade. Depois disso, será preciso vincular o Caixa novamente;
• … | sudo bash -s -- status — se a Ponte está funcionando e em qual endereço (se a 9100 estiver ocupada, a Ponte pega a próxima livre, até 9109).

No Windows, para isso existe o "Instalação e desinstalação de programas" comum (registro "Cenaly Bridge") — o desinstalador também remove a inicialização automática.

Ponte em um computador onde o painel administrativo não é aberto (servidor na despensa, PC separado junto às Impressoras) não pode ser vinculada por busca automática — a vinculação automática funciona apenas entre a Ponte e a página do Caixa no mesmo computador. Para esse caso, o proprietário gera no painel administrativo um código de vinculação de uso único (válido por 15 minutos) e o insere na página de status da Ponte.

A Ponte é vinculada à sua marca: baixada de um domínio de outra marca, ela não atenderá o seu painel administrativo, e se a Ponte já estiver vinculada a outra Unidade do mesmo proprietário, a página mostrará isso e oferecerá revinculá-la aqui com um clique.

Três formas de conexão#

O código de entrada do funcionário da seção "Dispositivos" é um mecanismo separado. Se o PIN ou o código expirar, crie um novo com o botão correspondente.

Gerenciamento e verificações#

Quando a Ponte está conectada, a página mostra:

• Dispositivos — lista com o estado de cada um (conectado / atenção / erro / não encontrado);
• Verificação de Hardware — teste rápido de impressão, leitura, peso;
• Configurações de Hardware;
• Atividade — feed de eventos (leitura, peso, impressão) em tempo real;
• Atualização — se saiu uma nova versão da Ponte, é possível instalá-la direto daqui.

Ao adicionar uma Impressora, escolha a sua finalidade: cupom, cozinha ou etiquetas. A função aparece no cartão do Dispositivo. Ela define a finalidade dentro da Ponte; a distribuição do Hardware entre estações de trabalho separadas é outro nível de configuração. Se a leitura das configurações falhar, o assistente oferecerá repetir e manterá a lista existente.

O Hardware encontrado pode ser desativado ou removido. "Desativar" mantém o Dispositivo na lista com todas as configurações, mas o driver não é carregado: a porta COM fica livre, não há consulta, a função passa para outro Dispositivo — e ele é reativado com um clique. "Remover" (com confirmação) exclui o Dispositivo de vez, e a captura automática de Hardware conhecido não o trará de volta na próxima inicialização da Ponte. O Hardware que foi configurado antes, mas que a busca atual não encontra, é mostrado em um grupo separado — caso contrário, não haveria como gerenciá-lo.

Pode haver várias Pontes por Conta, e a cada uma é atribuída uma função: universal, Hardware, câmeras ou telefonia. As Pontes da Unidade são listadas separadamente — é possível renomeá-las e definir uma Ponte padrão.

Hardware de toda a conta e trabalho pela nuvem#

Além da ponte "deste computador", a página tem um registro de Hardware da conta — uma tabela consolidada de todas as pontes, Dispositivos e câmeras de todas as Unidades da rede: dá para ver o que está onde, se a ponte está online e quais Unidades ela atende com Hardware. O Dispositivo pode ser movido para outra Unidade se a ponte estiver online naquele momento; com a ponte offline, o registro apenas mostra, mas não altera.

Para cada máquina no registro, abre-se um cartão "Detalhes do PC": nome do computador, IP e MAC, sistema, modelo, processador, memória por slot, unidades de armazenamento com espaço livre e estado, todo o Hardware conectado e todas as portas COM — com a indicação de qual porta está ocupada por quem e qual está livre. É o primeiro lugar a consultar quando "a Impressora estava lá e agora não aparece" ou quando o espaço acaba no PC do Caixa. Os dados são coletados pela própria ponte; em uma versão antiga da ponte, a lista de Hardware pode estar vazia — nesse caso, basta atualizar a ponte.

Além do canal local (navegador ↔ ponte neste PC), há o canal da nuvem: o comando vai até a ponte pelo servidor, então dá para imprimir um Recibo ou verificar a Impressora de outro Dispositivo — por exemplo, o garçom imprime do próprio celular na Impressora do Caixa no balcão. Na página, isso aparece como "vínculo de nuvem" na ponte e um botão separado de impressão de teste pela nuvem.

Impressão na Impressora de outro computador. Se a Impressora estiver fisicamente conectada a outro PC, não é obrigatório "compartilhá-la" na rede nem passar cabo. A ação "Imprimir de outro PC" no registro cria nesta máquina uma referência à Impressora de outra pessoa: escolhem-se o computador proprietário, a Unidade e o nome; depois, a linha fica marcada como "pela nuvem → PC proprietário", e os trabalhos são impressos pela fila daquele computador. Não são necessários pasta compartilhada, VPN nem visibilidade direta entre as máquinas — basta que as duas pontes atendam à mesma Unidade.

Tela remota do Caixa. Da mesma página (e por convite no chat de trabalho), é possível ver a tela do computador do Caixa — por exemplo, para ver com os próprios olhos o que o Caixa está exibindo. Quem decide é sempre o outro lado: enquanto o proprietário não habilitar o acesso remoto no próprio computador, não há botão de conexão, e cada sessão exige o consentimento individual dele — "não perguntar novamente" não existe de propósito. Visualização e controle são duas permissões diferentes, e fechar a janela encerra a sessão de forma garantida.

Seções relacionadas#

• Caixa (POS) — onde são usadas a impressão de Recibos e a gaveta de dinheiro
• Recibos e devoluções — impressão e reimpressão de Recibos
• Fiscalização — Impressoras fiscais e Caixas online
• Impressão na cozinha e no salão — estações, etiquetas, fila e páginas de código
• Produto por peso e etiquetas — uso de balanças, unidades de medida e etiquetas de prateleira
• Hardware: o que se conecta — visão geral das classes de equipamento e kits mínimos por formato
• Telefonia: PABX próprio — telefones e gateways não exigem a ponte de Hardware e funcionam em circuito próprio
• Controle de perdas — videoclipes de operações de risco a partir da câmera da ponte

Perguntas frequentes#

É preciso digitar um código para vincular?#

Normalmente não: a ponte é iniciada no mesmo PC onde o Caixa é aberto, e ele a encontra sozinho pelo botão "Buscar novamente". O código só é necessário para a ponte em um computador onde o painel administrativo não é aberto — nesse caso, o proprietário gera um código de uso único e o digita na página da ponte.

Em quais sistemas operacionais a ponte funciona?#

Windows e Linux (x64 e ARM64). A versão para macOS está nos planos.

O Hardware não aparece — o que verificar?#

Confirme que a ponte está em execução (página de estado) e clique em "Buscar novamente". O estado de cada Dispositivo e verificações rápidas estão disponíveis na página "Hardware". Se o Dispositivo não aparecer, abra no registro de Hardware o cartão "Detalhes do PC" dessa máquina: lá dá para ver todo o equipamento que o próprio computador enxerga e todas as portas COM com a indicação de quem ocupa a porta — isso normalmente basta para entender se o problema está no cabo, na porta ou em outro programa que está segurando a porta.