# Configurações de Código de Barras

Configure como o POS detecta e processa a entrada do leitor de código de barras.

![Configurações de Leitura de Código de Barras nas Configurações do POS](/img/barcode-scanning-settings.png)

Configurações de Leitura de Código de Barras

## Como Funciona a Detecção de Código de Barras[​](#how-barcode-detection-works "Link direto para Como Funciona a Detecção de Código de Barras")

A maioria dos leitores de código de barras funciona como um teclado conectado ao dispositivo. Ao ler um código de barras, o POS detecta que os caracteres foram inseridos mais rápido do que a digitação normal. Ele usa essas "teclas pressionadas rapidamente" para identificar a entrada como uma leitura de código de barras.

## Configurações[​](#settings "Link direto para Configurações")

| Configuração               | Descrição                                                                                                                             |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Tempo médio de entrada** | A velocidade da entrada (em milissegundos) para ser considerada um código de barras. Valores menores = entrada mais rápida necessária |
| **Comprimento mínimo**     | O tamanho mínimo da sequência contínua de caracteres para ser tratada como um código de barras                                        |
| **Remoção de prefixo**     | Caracteres a remover do início dos códigos de barras lidos                                                                            |
| **Remoção de sufixo**      | Caracteres a remover do final dos códigos de barras lidos                                                                             |

## Remoção de Prefixo/Sufixo[​](#prefixsuffix-removal "Link direto para Remoção de Prefixo/Sufixo")

Se o seu leitor adiciona caracteres extras (como um prefixo ou sufixo), é possível removê-los automaticamente para que apenas o código de barras principal seja mantido.

**Exemplo:** Se o seu leitor adiciona "A" antes de cada código de barras e "Z" depois, configure:

* Remoção de prefixo: `A`
* Remoção de sufixo: `Z`

## Teste Seu Leitor[​](#test-your-scanner "Link direto para Teste Seu Leitor")

Abaixo das configurações há um painel **Teste de Leitura de Código de Barras** — a maneira mais rápida de calibrar o leitor e confirmar que as configurações de prefixo/sufixo/comprimento estão corretas:

* **Evento de tecla** — exibe os caracteres brutos enviados pelo leitor, permitindo visualizar qualquer prefixo ou sufixo adicionado.
* **Código de barras detectado** — exibe o valor final que o WCPOS detectou *após* aplicar as configurações.

Leia um código de barras conhecido e compare os dois campos. Se o **Código de barras detectado** permanecer vazio, a leitura não está sendo reconhecida — ajuste o **Tempo médio de entrada** ou o **Comprimento mínimo** e tente novamente. Se caracteres extras aparecerem, configure a **Remoção de prefixo** / **Remoção de sufixo** correspondente.

## Solução de problemas[​](#troubleshooting "Link direto para Solução de problemas")

Código de barras não detectado

* **Leitor muito lento**: Tente aumentar o valor de "Tempo médio de entrada"
* **Código de barras muito curto**: Tente diminuir o valor de "Comprimento mínimo"
* **Caracteres extras**: Verifique se o leitor está adicionando prefixos/sufixos

Digitação normal detectada como código de barras

* **Digitação muito rápida**: Tente diminuir o valor de "Tempo médio de entrada"
* **Entrada muito longa**: Tente aumentar o valor de "Comprimento mínimo"

## Documentação relacionada[​](#related-documentation "Link direto para Documentação relacionada")

[Leitura de código de barrasComo a leitura de código de barras funciona no POS](/pt-BR/pos/product-panel/barcode-scanning.md)