Leitura de códigos de barras e página de leitura

Códigos de barras e leitura

Como funciona a pesquisa por código de barras

Quando digitaliza ou introduz um código de barras, o Stokkap procura uma correspondência exata nos seus produtos sincronizados, seguindo esta ordem:

1. SKU - verifica se existe uma correspondência exata do SKU
2. GTIN - verifica se existe uma correspondência exata do GTIN (número do código de barras)

Se for encontrada uma correspondência, o produto é carregado imediatamente. Se não for encontrada nenhuma correspondência, será apresentada uma página com a mensagem «Não encontrado», com opções para criar um novo produto ou associar o código de barras a um produto já existente.

O que é um GTIN?

Um GTIN (Global Trade Item Number) é o número codificado no código de barras de um produto. Os formatos mais comuns incluem:

• EAN-13 - Número de Artigo Europeu de 13 dígitos (o mais comum a nível mundial)
• EAN-8 - versão compacta de 8 dígitos
• UPC-A - Código Universal de Produto de 12 dígitos (EUA/Canadá)
• UPC-E - UPC comprimido de 6 dígitos

Para que um código de barras físico possa ser lido no Stokkap, o campo GTIN do produto deve estar preenchido no WooCommerce. O Stokkap utiliza o campo de introdução de GTIN padrão do WooCommerce (introduzido na versão 9.2 do WooCommerce). Quando sincroniza a sua loja, o Stokkap obtém este valor automaticamente.

Se os seus produtos não tiverem GTINs definidos, ainda assim pode procurá-los pelo SKU — basta digitar ou digitalizar o SKU.

Três formas de digitalizar

1. Leitor de códigos de barras USB/Bluetooth (recomendado)

Os leitores de códigos de barras «plug-and-play» funcionam como um teclado: «digitam» automaticamente o número do código de barras no campo de entrada.

• Aponte o leitor de códigos de barras para o código de barras de um produto
• O leitor introduz os dígitos no campo de introdução do código de barras
• O Stokkap deteta automaticamente o tipo de entrada e pesquisa o produto após uma breve pausa (500 ms sem digitação)
• Não é preciso premir Enter — a pesquisa é feita automaticamente

Qualquer leitor de códigos de barras USB ou Bluetooth HID serve. Os modelos económicos de marcas como a Netum, a Inateck ou a Tera são perfeitamente adequados. Os leitores sem fios Bluetooth são ideais para utilização em armazéns com um telemóvel ou tablet.

2. Câmara do telemóvel

Use a câmara do seu telemóvel ou tablet para digitalizar códigos de barras diretamente — sem necessidade de hardware adicional.

1. Toque no ícone da câmara ao lado do campo de introdução do código de barras
2. Aponte a câmara para o código de barras
3. Mantenha o aparelho imóvel — o Stokkap necessita de três leituras consecutivas para confirmar o código de barras (evita erros de leitura)
4. Após a leitura bem-sucedida, a câmara minimiza-se e o produto é carregado
5. Toque no ícone da câmara para o ampliar novamente para a próxima digitalização

Dicas para fotografar:

• Utilize o botão de alternância para mudar entre a câmara frontal e a traseira
• Uma boa iluminação ajuda — evite digitalizar em áreas muito escuras
• Segure o código de barras a uma distância de cerca de 15 a 30 cm da câmara
• A câmara desliga-se automaticamente após 60 segundos quando minimizada, para poupar bateria

Feedback sonoro e tátil:

• Sucesso: Tom curto e agudo + pulso de vibração
• Erro: Som grave + duplo pulso de vibração

3. Introdução manual

Digite um número de código de barras ou SKU diretamente no campo de entrada e prima Enter (ou toque no botão de pesquisa). Isto é útil quando o código de barras físico está danificado ou ilegível, ou quando pretende procurar um produto pelo seu SKU.

Informações sobre o produto

Quando um produto é encontrado, a página de pesquisa apresenta:

• Imagem do produto - toque para abrir a janela de visualização em tamanho real
• Nome do produto
• ID do produto - o ID do produto no WooCommerce
• Tipo de crachá - Simples, Variável ou Variação
• Emblema de estado - Publicado, Rascunho ou Privado (Ativado/Desativado para variações)
• Emblema Stokkap - exibido quando o produto é gerido pela Stokkap
• SKU e GTIN - editáveis se tiver permissão
• Preços - preço normal, preço promocional e preço de custo
• Discriminação do stock - stock por localização para produtos geridos pelo Stokkap, ou stock total para produtos geridos pelo WooCommerce

Produtos variáveis

Os produtos variáveis (produtos com variações, como tamanho ou cor) não têm stock próprio. Ao digitalizar um produto variável, será apresentada uma mensagem para aceder à página do produto, onde poderá gerir as variações individuais. Para gerir o stock, digitalize o código de barras da variação específica.

Gestão de stocks

Produtos geridos pelo Stokkap (stock por localização)

Os produtos geridos pela Stokkap permitem controlar o stock em cada local. A visualização do stock apresenta os locais agrupados por tipo, com o total indicado na parte superior.

Ajuste de stock:

• Utilize os botões + e - para aumentar ou diminuir o stock num local específico
• Altere o número entre os botões para ajustar em mais de 1 (por exemplo, defina para 5 e, em seguida, toque em + para adicionar 5)
• Utilize a opção «Definir entrada» para definir o stock com um número exato nesse local

Adicionar um local:

• Toque em + Adicionar localização para atribuir o produto a uma nova localização
• Selecione o tipo de localização e a localização específica
• Introduza a quantidade inicial em stock

Produtos geridos pelo WooCommerce (stock simples)

Os produtos não geridos pela Stokkap apresentam um controlo de stock simples, com os mesmos botões +/- e o campo «Definir», mas sem discriminação por localização.

Ativar/desativar a gestão de stock

• Ativar gestão de stock - ativa o acompanhamento de stock do WooCommerce, permitindo-lhe gerir as quantidades
• Desativar gestão de stock - desativa o acompanhamento das quantidades. Em vez disso, o produto utiliza um estado de stock simples (Em stock / Esgotado / Em espera)

Ativar/desativar o Stokkap

• Ativar o Stokkap - converte um produto gerido pelo WooCommerce para um sistema de controlo de stock por localização. Ser-lhe-á solicitado que distribua o stock existente pelas suas localizações
• Desativar Stokkap - volta ao sistema de stock simples do WooCommerce. O total de todas as localizações passa a ser a nova quantidade em stock

Edição de produtos

Edição no próprio texto

Com a permissão «Editar produtos», os campos SKU, GTIN e preço no cartão do produto podem ser editados diretamente. Aparece um botão «Guardar» quando se efetuam alterações. Apenas os campos que foram efetivamente alterados são enviados para o WooCommerce.

Botão de alternância de estado

Clique no ícone de estado para alterar o estado de um produto:

Tipo de produto	Opções
Simple / Variable	Publicado, Rascunho, Privado
Variation	Ativado (Publicado), Desativado (Privado)

Peso e dimensões

Expanda o separador «Peso e dimensões» para definir o peso, o comprimento, a largura e a altura. Os valores são apresentados nas unidades configuradas na sua loja (por exemplo, kg, lbs, cm, in). Esta secção está recolhida por predefinição, uma vez que estes campos são editados com menos frequência.

Excerto e descrição

Expanda as secções de descrição para editar o conteúdo do produto:

Tipo de produto	Secções disponíveis
Simple	Excerto + Descrição
Variable	Excerto + Descrição
Variation	Descrição da variação, Excerto do elemento pai, Descrição do elemento pai

As descrições são carregadas dinamicamente — só são obtidas do WooCommerce quando se expande a secção, mantendo a página rápida.

O editor suporta o modo visual (texto formatado com negrito, itálico, listas e links) e o modo HTML (toque no botão de código para alternar). Um botão «Guardar» aparece quando o conteúdo é alterado.

No caso das variações, pode editar tanto a descrição da própria variação como o resumo/descrição do produto principal. As secções do produto principal estão identificadas para que isso fique claro.

Criação de produtos

Quando digitaliza um código de barras que não corresponde a nenhum produto, o ecrã «Não encontrado» apresenta várias opções:

Criar um produto simples

1. O código de barras digitalizado é preenchido automaticamente — selecione se se trata de um GTIN ou de um SKU utilizando o botão de alternância
2. Introduza o nome do produto (obrigatório)
3. Opcionalmente, defina o SKU, o GTIN e os preços
4. Marque a opção «Criar como rascunho» se ainda não quiser que o produto fique visível na sua loja
5. Toque em «Criar» — o produto é criado no WooCommerce e carregado imediatamente na página de digitalização

Adicionar uma variante ao produto existente

Um assistente passo a passo para adicionar uma nova variação a um produto variável já existente:

1. Pesquisar pai - encontrar o produto variável ao qual esta variação pertence
2. Código de barras de ligação - atribuir o código de barras digitalizado como GTIN ou SKU da variação
3. Definir preços - definir, opcionalmente, preços normais, de promoção e de custo (uma tabela de referência apresenta os preços de variação existentes, a título de orientação)
4. Selecionar atributos - escolher valores de atributos (por exemplo, cor: Vermelho, tamanho: Grande) entre os atributos definidos pelo elemento pai. Também é possível adicionar novos valores de atributos, se necessário

Associar o código de barras a um produto existente

Se o produto já existir, mas não tiver um código de barras atribuído:

1. Pesquise o produto pelo nome ou pelo código de referência
2. O código de barras digitalizado é atribuído ao campo GTIN (ou SKU) do produto
3. As próximas leituras deste código de barras irão localizar o produto imediatamente

Detecção de conflitos

O Stokkap utiliza bloqueio otimista para evitar a perda de dados quando várias pessoas (ou webhooks do WooCommerce) modificam o mesmo produto ao mesmo tempo.

• Quando carrega um produto, o Stokkap regista a data da última modificação
• Quando guardas as alterações, o Stokkap verifica se mais alguém as modificou entretanto
• Se for detetado um conflito, será exibida uma mensagem a solicitar que recarregue com os dados mais recentes
• Toque em «Atualizar» para obter os dados mais recentes e, em seguida, volte a efetuar as alterações

Isto evita que uma atualização de stock resultante de uma encomenda recebida seja acidentalmente substituída pela sua gravação.

Modo offline

Se perder a ligação à Internet, a página de verificação recorre aos dados armazenados em cache:

• Produtos em cache - os produtos que já digitalizou anteriormente são armazenados localmente e continuam disponíveis para visualização
• Apenas leitura - pode visualizar os detalhes do produto, mas não pode ajustar o stock nem editar campos
• Produtos não armazenados em cache - os códigos de barras dos produtos que ainda não foram digitalizados irão apresentar a mensagem «Não encontrado»

Os ajustes e alterações ao stock requerem uma ligação à Internet ativa, uma vez que todos os dados são sincronizados com o WooCommerce em tempo real.

Referência rápida

Ação	Como	Autorização
Pesquisar produto	Leia o código de barras, utilize a câmara ou introduza o SKU/GTIN	Products View
Ajustar o stock	Toque em +/- ou utilize a opção «Definir»	Stock Edit
Adicionar localização ao produto	Toque em + Adicionar localização	Stock Edit
Ativar/desativar o Stokkap	Toque no botão «Ativar/Desativar Stokkap»	Stock Edit
Editar SKU/GTIN/preços	Edite os campos no cartão do produto e toque em Guardar	Products Edit
Alterar o estado do produto	Toque no menu suspenso do ícone de estado	Products Edit
Editar peso/dimensões	Expandir o menu em acordeão, editar os campos, tocar em Guardar	Products Edit
Editar descrições	Expandir secção, editar conteúdo, tocar em Guardar	Products Edit
Criar novo produto	Digitalize o código de barras desconhecido e toque em «Criar produto»	Products Edit
Adicionar variação	Digitalize o código de barras desconhecido e toque em «Adicionar variação»	Products Edit