Hardware: o que se conecta

Para começar a trabalhar, não é preciso comprar Hardware: a vitrine abre no telefone do cliente, e o Caixa é uma página no navegador em qualquer computador ou tablet. O Hardware é adicionado quando surge a necessidade de papel, peso, código de barras ou Recibo fiscal.

A regra principal: o navegador não conversa sozinho com o Hardware. Entre a página e o equipamento fica o Cenaly Hardware Bridge — um programa gratuito para Windows ou Linux, que é instalado no mesmo computador onde o Caixa é aberto. Para abrir a lista de Dispositivos: Painel de administração → Hardware (admin.cenaly.com/hardware).

Quem precisa do quê#

O Registrador fiscal é necessário onde a lei do país exigir e, nesse caso, ele não é «depois», mas desde o primeiro dia — verifique seu país no artigo Fiscalização.

Três formas de conexão#

Pode haver várias Pontes por Conta, e cada uma tem seu papel: universal, Hardware, câmeras ou telefonia. A tabela completa de todas as Pontes e Dispositivos da rede é o registro de Hardware da Conta na mesma página.

Impressoras de Recibos e de cozinha#

Pela Ponte são impressos o Recibo de venda e de devolução, o pré-Recibo, os relatórios X e Z, os tickets de cozinha por setor, os adesivos e o manifesto do pacote.

• Transporte de trabalho — de rede: Impressora com Ethernet ou Wi-Fi, acessível por endereço IP (porta 9100). A Ponte consegue procurar essas Impressoras na rede local sozinha, e o endereço também pode ser digitado manualmente.
• O que é impresso: linguagem ESC/POS — Epson TM, Star, Bixolon, Xprinter, Rongta e clones compatíveis; largura da fita de 80 mm (42 caracteres) e 58 mm (32 caracteres).
• Não latino: o cirílico é impresso por página de código (CP1251/CP866), e a linha que a cabeça não consegue imprimir (por exemplo, georgiana) a Ponte desenha como imagem com a fonte embutida. Em detalhes — Impressão na cozinha e no salão.
• USB e Bluetooth — em desenvolvimento: atualmente a Impressora de Recibos é conectada por rede Ethernet ou Wi-Fi, porta 9100. Uma Impressora em cabo USB ou porta COM pode ser adicionada no assistente, mas o driver desses transportes ainda não existe — o Dispositivo entrará na lista com uma observação sobre o transporte, e a impressão sairá pelo diálogo do navegador; o Bluetooth está sendo preparado no mesmo lugar. «Impressoras na Nuvem sem PC» (quando a tarefa vai direto do servidor para a Impressora) não existem de forma alguma: a impressão sempre passa pela Ponte. A conclusão prática para hoje — escolha um modelo com Ethernet ou Wi-Fi.

A tarefa não se perde: a Ponte tem sua própria fila de impressão com repetições, que sobrevive a reinicializações.

Impressoras de etiquetas#

• Como se conecta: pela Ponte, como Dispositivo com o papel de «Impressora de etiquetas».
• O que é impresso: adesivos por Item e por pacote (60×40 mm) na entrega, etiquetas de preço e etiquetas de estoque com código de barras, nome, preço e data de validade — Estoque, Impressão na cozinha e no salão. As etiquetas de preço também podem ser impressas em folha comum numa Impressora de escritório.
• O que não há: linguagens próprias de Impressoras de etiquetas — ZPL (Zebra) e TSPL (TSC, Godex) a Ponte não gera. O adesivo sai como documento estreito ESC/POS na cabeça de Recibo da classe de 60 mm, e o destacamento é feito pela guilhotina; em Hardware de etiquetas real isso ainda não foi testado. Balanças com impressão própria de etiquetas (CAS, DIGI, SHTRIH-Print) calculam peso, preço e código de barras internamente — não controlamos a impressão delas.

Scanners de códigos de barras#

• Como se conecta: diretamente em USB, a Ponte não é necessária. O Scanner funciona como teclado: «digita» o código lido onde estiver o cursor e geralmente acrescenta Enter.
• O que é suportado: qualquer Scanner em modo teclado. Para marcação e QR é necessário um Scanner 2D — um leitor unidimensional não lê DataMatrix.
• Onde é usado: busca de produto no Caixa pelo código, recebimento e inventário no estoque, códigos de marcação (Rússia), recebimento e entrega de encomendas no ponto de retirada.
• O que não há: Scanner em modo de porta COM virtual — mude-o para o modo teclado. Inventário móvel por Scanner no telefone também ainda não existe.

Balanças#

• Como se conecta: pela Ponte, por porta serial (COM ou USB-COM).
• O que é compatível: balanças que enviam continuamente uma linha com o peso pela porta — CAS, Mettler Toledo, DIGI, SHTRIH, Massa-K e balanças COM "sem marca". O driver é genérico: ele pega o primeiro número decimal da linha, por isso a maioria das balanças é configurada sem modelo específico.
• Onde é usada: peso do produto na recepção e peso do prato com preço por peso na expedição — o peso é inserido no item automaticamente, não é preciso digitar à mão. O peso ao vivo e o indicador de estabilidade aparecem na página "Hardware".
• O que não há: balanças de rede e balanças por USB-HID; em balanças com formato de linha muito exótico pode ser necessário adaptar o driver.

Display do cliente#

• Como se conecta: é uma segunda tela, não um dispositivo da Ponte. Duas opções: abrir a página do display em um segundo monitor do PC do caixa ou instalar o aplicativo em um tablet ou telefone na mesma rede Wi-Fi e pareá-lo com um PIN a partir da página da Ponte.
• O que é exibido: a composição do pedido e o valor a pagar.
• O que não há: displays VFD/LCD clássicos de duas linhas para balcão — eles ainda não funcionam como dispositivo separado da Ponte, e não é preciso adicioná-los.

Gaveta de dinheiro#

• Como se conecta: com um cabo à impressora de recibos — na entrada DK dela (RJ-11/RJ-12) ou por USB. A impressora envia um pulso por comando do caixa, e a gaveta abre; as duas conexões foram testadas.
• Onde é usada: abertura em venda em dinheiro e manualmente pelo botão (no caixa e na página "Hardware"). O registrador fiscal também consegue abrir a gaveta — o pulso sai da entrada dele, e não é preciso uma impressora de recibos separada para isso.
• O que considerar: a gaveta é aberta pelo aparelho ao qual está conectada, por isso em uma unidade com duas impressoras a gaveta é ligada na do caixa, e não na da cozinha.

Terminais de pagamento#

• Como se conecta: pela Ponte. Em nuvem — SumUp, Square, Stripe Terminal, Adyen; por rede local — Nexo/SaleToPOI e OPI (Ingenico, Wincor Nixdorf e compatíveis). Há também o modo "manual": o operador de caixa paga no próprio terminal e insere o resultado manualmente.
• O que faz: pagamento pelo caixa, vários terminais em uma mesma unidade com escolha no momento do pagamento, vinculação do terminal ao quiosque (o cliente paga com cartão sozinho, sem sair para a página do provedor).
• Importante: o terminal continua sendo seu: os dados do provedor (chave de acesso, identificador do leitor) são inseridos uma vez nas configurações do dispositivo, e o dinheiro segue pelo seu contrato — nós transmitimos o valor e recebemos o resultado do pagamento.
• Terminal ≠ pagamento online. A aceitação de cartões no site é um provedor de pagamento, que se conecta separadamente e depende do país: veja Pagamentos.

Caixas e registradores fiscais por país#

O recibo fiscal é impresso pelo seu caixa, registrado com os seus dados; nós somos o transporte e a fila. Ele se conecta pela mesma Ponte.

Outros países, gateways de fiscalização em nuvem e o que ainda não existe no produto estão no artigo Fiscalização. No cenaly.ru a escolha do aparelho é explicada separadamente: Como escolher a KKT; lá também fica o UTM EGAIS, que é configurado como um dispositivo comum da Ponte.

Tablets e PCs#

Tablets e monitores são vinculados à unidade pelo código de entrada do dispositivo — não é preciso digitar login e senha em um dispositivo compartilhado.

Telefones, DECT e gateways#

A telefonia tem seu próprio circuito e não exige a Ponte de hardware: o aparelho se registra com os dados do ramal diretamente na nossa central telefônica.

• Telefones de mesa, bases e aparelhos DECT, adaptadores ATA, interfones, softphones — Configuração de telefones SIP: o que inserir em qualquer aparelho e instruções por marca (Yealink, Grandstream, Fanvil, Panasonic, Cisco, Snom, Poly, Gigaset e outras).
• Chip SIM, linha fixa, ISDN — por gateway: Gateways GSM e linhas fixas.
• Número de operadora sem hardware — Tronco SIP.
• O panorama geral da seção — Telefonia.

Rede do estabelecimento#

• Ponte e navegador no mesmo computador. A página do caixa encontra a ponte pelo endereço local, sem precisar digitar código. A ponte em um PC onde o painel administrativo não é aberto (servidor na sala dos fundos) é vinculada com um código de uso único gerado no painel administrativo.
• Impressora na mesma rede da ponte, por IP e porta 9100. É melhor fixar o endereço da impressora (reserva DHCP ou IP estático): endereço alterado = "impressora não responde".
• Tablet do garçom, tela da cozinha, totem e display do cliente — na mesma rede; o tablet-caixa e o display se conectam à ponte com um PIN, que aparece somente na tela do PC do caixa.
• Wi-Fi de visitantes é melhor manter em uma rede separada da rede do caixa — o visitante não tem nada a fazer na rede com o caixa e as impressoras.
• Internet é necessária para os recursos na nuvem; o próprio caixa continua registrando e imprimindo sem ela — Se a internet cair.

Limitações#

• A ponte imprime somente a partir do seu computador. Ou a ponte em cada dispositivo de caixa, ou impressão via nuvem em uma impressora de outro PC.
• USB e Bluetooth nas impressoras estão em desenvolvimento: atualmente funciona o transporte de rede (Ethernet ou Wi-Fi, porta 9100). Impressoras na nuvem sem PC não haverá de forma alguma: a impressão sempre passa pela ponte.
• Linguagens de impressoras de etiquetas (ZPL/TSPL) não são suportadas — a etiqueta é impressa em ESC/POS no cabeçote de recibo, não testado em hardware real de etiquetas.
• Scanner — somente modo teclado, balanças — somente COM, display do cliente — somente segunda tela.
• Controle de dose (fluxômetros de torneiras) — estrutura: o relatório "servido ↔ vendido" funciona, mas até a conexão do sensor físico o lado "servido" mostra dados de demonstração, e a página avisa isso com honestidade.
• macOS para a ponte ainda não existe — Windows e Linux.

Solução de problemas#

Resumidamente — o que verificar primeiro; a análise completa por sintomas está no artigo Solução de problemas.

Perguntas frequentes#

É preciso comprar um registrador fiscal?#

Somente se a lei do seu país exigir. O próprio caixa é uma página no navegador em um PC ou tablet comum; o caixa "de hardware" é necessário para o recibo fiscal, veja Fiscalização.

Qual impressora de recibos comprar?#

Um modelo com Ethernet ou Wi-Fi, compatível com ESC/POS, 80 mm ou 58 mm. USB e Bluetooth ainda estão em desenvolvimento, por isso a "impressora USB mais barata" hoje não vai imprimir.

É possível imprimir recibos sem a ponte?#

Documentos de caixa — sim, com a caixa de diálogo de impressão comum do navegador. Tickets de cozinha e etiquetas — não, somente pela ponte. A exceção é a unidade onde o único hardware é o registrador fiscal: ali o próprio caixa imprime o recibo, e o fallback do navegador não é ativado.

A impressora está em outro computador — puxar cabo?#

Não. A ação "Imprimir de outro PC" no registro de hardware cria um link para a impressora de outro computador, e a tarefa vai pela nuvem até a ponte proprietária. Basta que as duas pontes atendam à mesma unidade.

Um terminal inteligente com Android (SUNMI, PAX, MSPOS) serve?#

Como tablet com navegador — sim, o caixa abre nele. Sua impressora integrada, segunda tela e módulo fiscal não são usados pela nossa ponte.

Seções relacionadas#

• Cenaly Hardware Bridge — instalação da ponte, lista de dispositivos, verificações, registro de hardware
• Impressão na cozinha e no salão — estações, etiquetas, fila de impressão, páginas de código
• Fiscalização — registradores fiscais e gateways na nuvem por país
• Caixa (POS) — onde tudo isso é usado
• QR codes e códigos de dispositivos — vinculação de tablets e monitores
• Telefonia: PABX próprio — seção à qual pertence o hardware de telefonia
• Configuração de telefones SIP · Gateways GSM e linhas fixas — hardware de telefonia
• Solução de problemas — análise por sintomas