Pular para o conteúdo principal
Versão: 2.x

Ler códigos de barras

Leia um código de barras e o produto vai direto para o carrinho. Quase todo leitor funciona sem configuração adicional, pois digita o código como um teclado muito rápido, e o WCPOS distingue uma leitura da digitação por essa velocidade. Não tem leitor? Use a câmera.

Ler o código de um produto​

Vai usar a câmera? Abra o caixa se sua loja usar um e siga Ler com a câmera. Com um leitor:

  1. Emparelhe ou conecte seu leitor (Conectar um leitor).
  2. Se sua loja usa caixas, abra o caixa primeiro: enquanto ele estiver fechado, nada será adicionado ao carrinho.
  3. Posicione o cursor conforme o seu dispositivo:
    • Navegador ou aplicativo para desktop: clique ou toque fora de qualquer campo de texto.
    • Aplicativo WCPOS no iPad, iPhone ou Android: toque em Buscar produtos.
  4. Leia o código.
Por que a posição do cursor importa

Um leitor no modo teclado digita o código como um teclado faria.

No navegador ou no aplicativo para desktop, basta clicar em uma área vazia da tela, em qualquer dispositivo. Enquanto o cursor estiver em um campo de texto, inclusive na caixa de busca, o WCPOS trata as teclas recebidas ali como digitação.

No aplicativo WCPOS, Buscar produtos é onde chegam as teclas do leitor. Um leitor que você registrou no Android funciona onde quer que o cursor esteja.

Nada acontece ou o código aparece como texto digitado?

Uma leitura adicionou uma jaqueta ao carrinho: a mensagem Adicionado ao carrinho, um campo de busca vazio e a nova linha no carrinho
  1. Adicionado ao carrinho — aparece por um instante com o nome do que foi adicionado, para que você não precise olhar o carrinho. Para uma variação, o nome são suas opções, aqui XS, Cinza.
  2. Buscar — fica vazio novamente após a leitura, em todos os dispositivos, pronto para a próxima.
  3. A nova linha — o tamanho e a cor lidos. Leia o mesmo código novamente para adicionar mais uma unidade.

No navegador ou no aplicativo para desktop, você pode ler códigos em qualquer parte do POS, inclusive no carrinho e na finalização da compra.

Um código menor que o Comprimento mínimo do código de barras (8 por padrão) não pode ser adicionado; veja Configurações de detecção.

nota

Enquanto você está contando o dinheiro da gaveta, as leituras são recusadas até a contagem terminar.

Nas telas Produtos e Pedidos, a leitura vai para a caixa de busca da tela, permitindo que você leia o código de um produto para encontrá-lo ou encontrar seus pedidos.

O que o WCPOS procura​

O WCPOS primeiro procura neste dispositivo um produto ou uma variação com o código de barras correspondente. Se não encontrar, consulta sua loja (Buscando na loja…). Quando a loja encontra o produto, o WCPOS o adiciona ao carrinho. O campo usado como código de barras é definido em Campo de código de barras.

Códigos SKU, GTIN, UPC, EAN e ISBN

Além do Campo de código de barras, o SKU e o campo GTIN, UPC, EAN ou ISBN do produto também funcionam sempre, tanto neste dispositivo quanto na loja.

Códigos de barras de 12 e 13 dígitos

Um código UPC-A de 12 dígitos corresponde à sua forma EAN de 13 dígitos e vice-versa. Assim, uma embalagem impressa com 12 dígitos ainda encontra um produto salvo com o zero inicial.

Um produto encontrado na sua loja

Um produto encontrado na loja é baixado para este dispositivo antes de ser adicionado, de modo que a próxima leitura não precise consultar a loja. Um dispositivo novo baixa o restante do catálogo automaticamente; veja Sincronização de produtos.

O que a tela informa​

Quando uma leitura não consegue adicionar exatamente um produto, uma mensagem no topo informa o motivo e permanece por seis segundos.

A leitura de um código desconhecido: a mensagem Código de barras não encontrado, o código mantido no campo de busca e uma lista de produtos vazia
  1. Código de barras não encontrado — com o código lido: ele não está nesta loja, nem localmente nem online.
  2. O código — permanece no campo de busca para você conferir o que o leitor leu. A lista não mostra nada até você limpar o campo usando o X no final.

Se o código permanecer em Buscar produtos, limpe-o com o X no final do campo para ver seus produtos novamente. Para saber o que fazer, abra abaixo o título correspondente à mensagem na tela:

Código de barras não encontrado

Nada neste dispositivo ou na sua loja tem esse código. Compare o código no campo de busca com o do produto. Se estiver correto, adicione o código de barras ao produto no WooCommerce.

Várias correspondências

Mais de um produto tem esse código, que permanece no campo de busca. Escolha o produto correto nos resultados e depois atribua um código de barras exclusivo a cada produto.

Escolha uma variação

O código pertence a um produto variável, não a uma de suas opções, e permanece no campo de busca. Escolha a opção nos resultados. Atribua um código de barras exclusivo a cada variação para adicioná-la diretamente pela leitura.

… sem estoque

O produto foi encontrado, mas está sem estoque. Ele é recusado enquanto Mostrar produtos sem estoque estiver desativado; veja Configurações de exibição.

Leitura indisponível

Não está neste dispositivo e não é possível buscar na loja enquanto estiver offline: a loja está inacessível e o código permanece no campo de busca. Pressione Ver status para ver Saúde da loja e leia novamente quando estiver online.

Banco de dados local indisponível: o WCPOS não consegue ler seu próprio banco de dados. Recarregue o aplicativo antes de realizar mais vendas.

Falha na busca

Sua loja não respondeu em dez segundos ou respondeu com um erro. O código permanece no campo de busca. Verifique sua conexão e leia novamente.

Não foi possível adicionar ao carrinho

O produto foi encontrado, mas houve uma falha ao adicioná-lo. Leia novamente ou toque no produto.

Ler com a câmera​

Se seu dispositivo tiver uma câmera, você pode usá-la para ler códigos, sem um leitor separado. Pressione o botão de leitura ao lado do campo de busca. A câmera abre em um painel abaixo dos filtros, mantendo a lista de produtos visível.

O painel da câmera abaixo da barra de filtros, solicitando acesso à câmera com o botão Permitir câmera
  1. Ler código — abre o painel da câmera. Pressione novamente para fechá-lo.
  2. Permitir câmera — na primeira vez, o WCPOS solicita acesso à câmera. Pressione o botão e permita o acesso na solicitação que aparecer.

Segure um código de barras diante da câmera. Quando ele é lido, a borda do painel pisca em verde e a leitura funciona exatamente como a de um leitor, com as mesmas mensagens. O produto é adicionado uma única vez, não importa por quanto tempo você mantenha o código ali. Para adicionar mais uma unidade, tire o código do campo de visão por um instante e mostre-o novamente.

Se a câmera não puder iniciar, o painel informa o motivo na linha de status. Neste exemplo, nenhuma câmera disponível foi encontrada:

O painel da câmera em detalhe, com a mensagem Câmera indisponível — verifique se outro aplicativo está usando a câmera
  1. Status — o que a câmera está fazendo, na parte inferior da visualização. Quando a câmera inicia, a área preta acima mostra a imagem da câmera.
  2. Redimensionar — arraste para aumentar ou diminuir a altura da visualização da câmera. O WCPOS lembra a altura neste dispositivo.
  3. Fechar — fecha o painel.

Para saber o que fazer, abra abaixo o título correspondente ao status no painel:

Iniciando câmera…

Aguarde um instante.

O WCPOS precisa de acesso à câmera para ler códigos de barras.

Pressione Permitir câmera. Se você recusou antes, a solicitação pode não aparecer novamente: permita o acesso à câmera para o WCPOS nas configurações de sites do navegador ou nas configurações do dispositivo e abra o painel novamente.

Câmera indisponível — verifique se outro aplicativo está usando a câmera.

Feche o outro aplicativo ou aba que está usando a câmera ou verifique se há uma câmera conectada.

Falha ao decodificar o código de barras — feche o leitor e tente novamente.

Feche o painel com Fechar e abra-o novamente com o botão de leitura.

Uma nota abaixo do status avisa quando uma leitura pode não encontrar todos os produtos:

  • Offline — somente produtos já neste dispositivo poderão ser lidos. Os demais produtos poderão ser lidos quando você estiver online novamente.
  • A sincronização ainda está iniciando — alguns produtos podem não ser encontrados ainda. Aguarde um instante e leia novamente. Se a nota permanecer, verifique Saúde da loja.
  • Banco de dados local indisponível — recarregue o aplicativo para restaurar a leitura. Recarregue o aplicativo e leia novamente.

Sons de leitura​

Um som a cada leitura permite manter a atenção no cliente. Ative Reproduzir som ao ler em Configurações → Leitura de código de barras, em Som. A opção vem desativada e é salva apenas neste dispositivo, para que cada caixa tenha sua própria configuração.

Escolher e testar sons de leitura
A seção Som das configurações de Leitura de código de barras com Reproduzir som ao ler ativado: três temas sonoros com botões de prévia, Volume, Som de sucesso e Som de falha
  1. ▶ — reproduz o som de sucesso de um tema.
  2. ▶✕ — reproduz o som de falha do tema.
  3. Volume ▶ — reproduz o som de sucesso no volume definido.
  • Reproduzir som ao ler — o interruptor na parte superior. Ativa os sons e abre as opções abaixo.
  • Tema sonoro — Clássico (bipe agudo ascendente / zumbido grave), Caixa (bipe constante de supermercado / tom grave duplo) ou Suave (toque delicado / batida abafada, para lojas silenciosas).
  • Volume — arraste o controle deslizante.
  • Som de sucesso — toca quando um produto entra no carrinho.
  • Som de falha — toca para todas as outras mensagens em O que a tela informa. Buscando na loja… não emite som.
  • Vibração de falha — apenas no iPhone, iPad e Android. O dispositivo vibra em caso de falha, junto com o som de falha ou sozinho se Som de falha estiver desativado. É necessário ativar Reproduzir som ao ler.

Configurações de detecção​

A seção Leitura da mesma tela define o que é considerado uma leitura. A maioria das lojas nunca precisa alterá-la. Se as leituras aparecerem como texto digitado ou códigos curtos forem recusados, execute o Teste de leitura de código de barras nessa seção: ele mede o tempo do leitor e sugere valores. Veja Configurações de código de barras.

Configurações, Leitura de código de barras: a seção Leitura com o limite em 24, comprimento mínimo em 8 e prefixo e sufixo vazios, acima das seções Som, Leitor e Teste de leitura de código de barras
  1. Limite de tempo médio de entrada do código de barras (ms) — a velocidade com que as teclas precisam chegar para serem consideradas uma leitura.
  2. Comprimento mínimo do código de barras — códigos menores nunca são adicionados.
  3. Prefixo do leitor de código de barras — um único caractere que o leitor adiciona antes do código, removido antes da busca. Deixe vazio, a menos que o leitor esteja configurado para adicionar um prefixo.
  4. Sufixo do leitor de código de barras — o mesmo vale para um único caractere adicionado após o código.
O que cada configuração de detecção faz
ConfiguraçãoO que fazValor inicial
Limite de tempo médio de entrada do código de barras (ms)Quando o intervalo médio entre as teclas é menor que esse valor, elas são consideradas uma leitura. Teclas mais lentas são tratadas como digitação.24
Comprimento mínimo do código de barrasCódigos menores nunca são adicionados. Defina o valor para o seu código de barras mais curto.8
Prefixo do leitor de código de barrasUm caractere que o leitor adiciona antes do código, removido antes da busca.Vazio
Sufixo do leitor de código de barrasUm caractere que o leitor adiciona após o código, removido antes da busca.Vazio

Um código menor que o Comprimento mínimo do código de barras: se parecer uma leitura, contendo apenas dígitos ou terminando com Enter, o WCPOS mostra Código de barras lido com O código de barras deve ter pelo menos 8 caracteres, no máximo uma vez a cada 30 segundos. Uma sequência curta de letras é tratada como digitação rápida e mantida como está.

Conectar um leitor​

Quase todo leitor vem no modo teclado e, nesse modo, não precisa de configuração: basta emparelhar ou conectar e começar a ler. Isso atende à maioria das lojas. Para seguir um passo a passo de configuração ou solução de problemas, use o Assistente de configuração do leitor.

Uma conexão direta pode ajudar se as leituras contiverem caracteres incorretos, como maiúsculas e símbolos trocados pelo layout do teclado, ou se você precisar ler códigos com o cursor em um campo de texto.

Conectar um leitor diretamente (avançado)

Um leitor conectado diretamente é reconhecido pelo próprio dispositivo, não pela velocidade de digitação, pelo layout do teclado ou pelo foco. Todo leitor de código de barras vem em um dos modos disponíveis, e o modo determina como o WCPOS recebe as leituras:

ModoComo a leitura chegaConfiguração
Teclado (HID), o padrão de fábrica de quase todo leitorO leitor digita o código; o WCPOS reconhece as teclas rápidasNenhuma: basta emparelhar ou conectar e ler
HID-POSUma conexão USB diretaAltere o modo do leitor e depois selecione Conectar por USB
Serial (SPP / USB-COM)Uma conexão serial direta por Bluetooth ou USBAltere o modo do leitor e depois selecione Conectar por Bluetooth serial. Um leitor Bluetooth que não aparece na lista pode usar seu próprio UUID de serviço: adicione-o em Meu leitor não está na lista.
Bluetooth LEUma conexão direta por Bluetooth Low Energy, no aplicativo para iPhone e iPadRemova o leitor das configurações de Bluetooth do dispositivo e não o emparelhe novamente. Depois, pressione Conectar leitor Bluetooth. A conexão é feita com o primeiro leitor Bluetooth LE encontrado, então mantenha os demais desligados.

Os botões de conexão ficam em Configurações → Leitura de código de barras → Leitor → Conectar um leitor diretamente (avançado).

Um leitor no modo teclado não pode ser conectado diretamente

Seu dispositivo trata um leitor no modo teclado exatamente como um teclado, e nenhum aplicativo tem permissão para assumir o controle de um teclado. Se o leitor não aparecer na lista depois que você pressionar um botão de conexão, é quase certo que ele ainda esteja no modo teclado.

Para trocar de modo, encontre o código de barras de configuração no manual do leitor (procure por "modo SPP", "modo serial" ou "modo HID-POS") e leia-o. O leitor se reconfigura sozinho. Para um leitor Bluetooth, esqueça o emparelhamento antigo nas configurações de Bluetooth do dispositivo e emparelhe novamente após a troca. Ler o código "HID" ou "teclado" do manual restaura o modo anterior a qualquer momento.

Conexões seriais por USB e Bluetooth funcionam no aplicativo para desktop e em navegadores baseados no Chrome. O aplicativo para desktop exibe um seletor de dispositivos dentro do aplicativo; o Chrome mostra seu próprio seletor. O aplicativo para iPhone e iPad conecta-se diretamente a um leitor Bluetooth LE. Safari e Firefox não oferecem conexão direta: use o modo teclado ou a câmera.

Registrar um leitor no Android​

No Android, registre um leitor no modo teclado para ler códigos onde quer que o cursor esteja, inclusive em um campo de texto. O Comprimento mínimo do código de barras continua valendo.

  1. Emparelhe ou conecte o leitor.
  2. Em Configurações → Leitura de código de barras, na seção Leitor, toque em Registrar um leitor e depois em Registrar leitor.
  3. Leia qualquer código de barras com esse leitor. O WCPOS mostra Detectado "…" — dê um nome e salve.
  4. Dê um nome e toque em Salvar leitor.

O leitor ganha sua própria linha com a indicação Registrado. Outros leitores no modo teclado continuam funcionando sem registro. Veja Registrar seu leitor no Android.

Como funciona o registro de leitores no Android

O Android não pode se conectar diretamente a um leitor, mas reconhece um leitor registrado pelo dispositivo de origem. Suas leituras são capturadas antes de chegarem a qualquer campo de texto, sem depender de estimativas da velocidade de digitação.

Se algo der errado​

  • Nada acontece ao ler um código — no navegador ou no aplicativo para desktop, clique em uma área vazia da tela e leia novamente. No aplicativo WCPOS para iPad, iPhone ou Android, toque primeiro na caixa de busca. Depois, verifique o leitor em Teste de leitura de código de barras; veja Configurações de código de barras.
  • O código aparece na caixa de busca como texto digitado — no navegador ou no aplicativo para desktop, o cursor estava no campo: clique em uma área vazia da tela e leia novamente. No aplicativo WCPOS para iPad, iPhone ou Android, mantenha o cursor na caixa de busca. Em qualquer caso, o leitor pode ser mais lento que o Limite de tempo médio de entrada do código de barras (ms): execute o teste e pressione Aplicar na sugestão.
  • Código de barras não encontrado para um produto que você conhece — verifique a configuração Campo de código de barras e o código de barras do produto no WooCommerce. Um produto marcado como somente online nunca aparece no POS. Em um dispositivo novo, aguarde a primeira sincronização terminar: Saúde da loja → Banco de dados mostra o progresso.
  • Leitura indisponível — você está offline e o produto ainda não está neste dispositivo. Verifique Saúde da loja.
  • A câmera não inicia — veja as mensagens da câmera.

Perguntas frequentes​

Um produto que acabei de adicionar à loja não é reconhecido na leitura. Por quê?

O WCPOS consulta sua loja para buscar qualquer código que não tenha neste dispositivo, então um produto novo pode ser lido desde que você esteja online. Se aparecer Código de barras não encontrado, a loja também não tem esse código: verifique o campo de código de barras do produto no WooCommerce. Se aparecer Leitura indisponível, você está offline; leia novamente quando estiver online.

O POS gera e imprime códigos de barras?

Não, no momento. O WCPOS lê códigos de barras existentes, mas não os cria nem imprime. Para gerar códigos de barras para seus produtos, use um plugin do WooCommerce especializado em criação e impressão de códigos de barras, por exemplo:

Depois, adicione cada código ao campo de código de barras do produto para poder lê-lo no caixa.