Hardware e periféricos do PDV#
Esta página ensina a instalar, configurar, testar e diagnosticar cada periférico do caixa: impressora não fiscal, balança, leitor de código de barras, gaveta, smartcard/RFID e terminal TEF. É para quem monta o terminal e para o operador que precisa saber se o problema é o equipamento ou a venda.
Antes de começar
- Permissão de Configuração de periféricos (
configurar_perifericos). Sem ela a tela Periféricos do PDV não abre. - Os equipamentos ligados e conectados. A detecção procura de verdade — não adivinha.
- O terminal TEF não se configura aqui: ele é identidade do caixa no servidor da adquirente e vem da retaguarda.
Como chegar na tela: painel Mais operacoes (Scroll Lock ou Alt+M) > Periféricos. O diálogo se chama Periféricos do PDV e tem Testar por card e Testar todos para rodar a bateria completa.
Passo a passo#
ATestar a impressora não fiscal#
- Abra o card Impressora e use Detectar.
- O PDV procura em três frentes:
Procurando impressora (USB direto + Windows + portas COM)… - Escolha o candidato:
- USB direto — sem fila do Windows (recomendado) — o caminho que funciona sempre que a térmica está plugada, sem depender da fila do Windows;
- Impressora do Windows (fila) — se você já usa a impressora instalada no sistema;
- Impressora ESC/POS em COM… — N bps · serial — para térmica serial.
- Clique em Testar para imprimir um cupom de teste.
- Em Testar todos, o teste da impressora é o único que imprime de verdade — os outros periféricos são validados pela configuração.
Se a detecção não achar nada, o PDV responde Nenhuma impressora encontrada com a orientação de
conferir o cabo USB e a energia da térmica.
Largura de papel. A bobina é declarada no cadastro do periférico, em milímetros ou em pontos
úteis: largura_mm (80 ou 58), largura_dots, colunas ou dpi. O ponto é a verdade física
e a coluna é consequência dele: informar as duas unidades que não conferem é recusado, porque
elas descrevem aparelhos diferentes — e um deles vai cortar a última coluna do cupom.
BTestar a balança#
- Abra o card Balança e use Detectar.
- O PDV procura na serial:
Procurando balança nas portas COM… - Escolha o modelo pelo nome comercial que está na etiqueta do equipamento, não por protocolo interno. Os modelos do catálogo são:
- Elgin DP30 / DP30CK / DP-1502 / DP-3005 — 2400 bps de fábrica; no menu da balança configure
RS-232 = 1030(protocolo 0) e use o cabo RJ45↔DB9 cruzado do fabricante; - Toledo (Prix 3/4/5, 9094) — 9600 bps;
- Filizola (MF, CS, Pluris) — 4800 bps. O baud sugerido vem do próprio modelo e é pré-preenchido.
- Elgin DP30 / DP30CK / DP-1502 / DP-3005 — 2400 bps de fábrica; no menu da balança configure
- Clique em Testar para pedir o peso. O teste mostra a leitura e a resposta bruta do equipamento, para separar "a balança não responde" de "a balança responde em outro formato".
- Confirme a mensagem de peso lido.
Respostas possíveis do teste: Sem resposta da balanca em <porta>, Balanca capturando o zero,
Sobrecarga na balanca e Porta <porta> ocupada: outro programa está usando a ….
CLançar item pesado usando a balança#
- Com a balança configurada, bipe o código do produto: o PDV busca o peso sozinho, exigindo duas leituras estáveis e iguais antes de lançar (protege contra leitura transitória e contra o produto trocado entre o bipe e a pesagem).
- Se não houver balança para ler sozinha, ou se ela não confirmar, abre o diálogo Peso da balanca, com os campos Leitura da balanca e Peso kg e o botão Ler balanca.
- Aviso de falha:
Balanca nao confirmou o peso automaticamente (leituras …). - Digite o peso e registre. Peso ausente ou inválido responde
Informe ou leia um peso valido.
DBalança Bluetooth#
O PDV traz um interpretador de mensagem de balança Bluetooth, com faixa aceita de 0,005 kg a 60 kg. Ele lê a mensagem do equipamento e recusa:
| Bloqueio | Quando |
|---|---|
peso_instavel | a mensagem indica instabilidade |
peso_abaixo_minimo | peso menor que 0,005 kg |
peso_acima_maximo | peso maior que 60 kg |
A mensagem Peso invalido: <bloqueios>. aparece no diálogo quando a leitura não passa.
ETestar o leitor de código de barras#
- Abra o card Scanner e use Detectar.
- O diálogo Testar leitor mostra a instrução
Bipe um código de barras agora…e o campo com a dicaaguardando o bip. - Bipe com o leitor. Se o código aparecer no campo, o leitor está pronto.
- O leitor comum opera emulando teclado (o modo
teclado), que é o modo esperado.
O PDV também conta com leitura de código pela câmera do aparelho, além do leitor físico.
FGaveta de dinheiro#
- Abra o card Gaveta e confira se está habilitada.
- A gaveta abre pelo comando ESC/POS enviado ao fim da impressão do comprovante.
Ou seja: gaveta sem impressora configurada não abre. Se a gaveta não abre, teste a impressora primeiro.
GRFID e smartcard#
O card RFID tenta três caminhos, nesta ordem:
- PC/SC (leitor de smart card, tipo ACR122U) — mensagem
Aproxime o cartão no leitor "<leitor>"…; ao ler, respondeRFID (PC/SC) OK — cartão <uid> em "<leitor>". - Serial D-Think 501A — o PDV sonda as portas COM e o próprio leitor bipa ao conectar; ao reconhecer, responde
Leitor <modelo> configurado em <porta> (bipou?). Use "Testar leitor" com um cartão pra confirmar a leitura. - HID — o leitor "digita" o número como teclado; o PDV captura com a instrução
Aproxime o cartão/tag RFID do leitor agora….
Se nenhum cartão for lido no caminho PC/SC, a orientação é
Não li nenhum cartão no leitor PC/SC "<leitor>" (8s). Aproxime o cartão e tente de novo. Se o seu
leitor "digita" o número (modo teclado), desconecte o leitor de smart card pra cair no teste por
teclado.
HConferir o resumo do estado no rodapé#
O rodapé do caixa mostra um resumo curto por periférico:
| Texto | Significa |
|---|---|
Scanner OK, Balanca OK, Impressora OK | habilitado e pronto |
<periférico> off | desabilitado na configuração |
<periférico> demo | configurado em modo simulado |
IUsar o terminal TEF#
- Confirme na retaguarda qual plugin de pagamento este caixa usa.
- Ligue o terminal/pinpad antes de abrir o caixa.
- Teste pelo caixa: painel Mais operacoes > Transações do TEF. O PDV abre o menu gerencial do terminal (teste de comunicação, reimpressão, cancelamento, carga de tabelas e registro de terminal).
- Resultado esperado:
Transação gerencial concluída.
Se o agente TEF estiver fora, o caixa avisa e não abre o menu — a venda pelas outras formas continua normal.
Campos e o que significam#
Tipos de periférico na tela Periféricos do PDV#
| Card | Tipo interno | Para que serve |
|---|---|---|
| Balança | balanca | peso de produto a granel, serial ou simulado |
| Gaveta | gaveta | abertura da gaveta de dinheiro |
| Impressora | impressora | cupom, comprovante de turno e DANFE |
| RFID | rfid | leitura de cartão/tag |
| Scanner | scanner | leitura de código de barras |
Tipos que podem chegar do servidor e aparecem no fim da lista: teclado, biometria e display.
A linha tef fica fora desta tela de propósito.
Modos (modo) que cada periférico aceita#
| Modo | Significa |
|---|---|
teclado | o scanner emula teclado |
pc | teclado do próprio PDV |
usb | ligado direto na USB (impressora) ou leitor USB |
spooler | impressora instalada no Windows (fila) |
serial | porta COM |
simulado | modo demonstração: não toca hardware |
desativado | periférico desligado |
Modelos de balança do catálogo#
| Modelo mostrado | Baud de fábrica |
|---|---|
| Elgin DP30 / DP30CK / DP-1502 / DP-3005 | 2400 |
| Toledo (Prix 3/4/5, 9094) | 9600 |
| Filizola (MF, CS, Pluris) | 4800 |
Resultado esperado#
- Cada Testar grava o resultado no histórico local de auditoria do terminal — o teste fica registrado, não só visto.
- Testar todos percorre a lista e mostra o resultado de cada card.
- A detecção de impressora aceita mais de um candidato e deixa você escolher; se houver apenas um, ele é aplicado.
- Ao mudar um periférico, a mensagem é
<periférico> atualizado.
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
Nenhuma impressora encontrada | cabo, energia ou driver | confira o cabo USB e a energia; se for serial, confira cabo e porta |
| A impressora imprime cortando a última coluna | largura da bobina declarada errada no cadastro | corrija largura_mm/largura_dots; as duas unidades precisam conferir |
Porta <porta> ocupada: outro programa está usando a … | outro programa segurou a porta serial | feche o outro programa e teste de novo |
Sem resposta da balanca em <porta> | balança desligada, cabo errado ou protocolo/baud diferente | confira o menu da balança (na Elgin, RS-232 = 1030) e o cabo cruzado; reescaneie |
Balanca capturando o zero | a balança está estabilizando | espere e leia de novo |
Sobrecarga na balanca | peso acima da capacidade | retire o excesso |
Balanca nao confirmou o peso automaticamente (leituras …) | leitura instável ou produto trocado durante a pesagem | use o diálogo Peso da balanca e digite o peso |
Peso invalido: peso_instavel, … | leitura fora da faixa aceita (0,005 kg a 60 kg) ou marcada como instável | confirme o peso na balança e leia de novo |
Informe ou leia um peso valido. | peso vazio ou zero | informe o peso |
| O bipe não aparece no teste do leitor | leitor não está em modo teclado (HID) | coloque o leitor em modo teclado ou use Detectar de novo |
Não li nenhum cartão no leitor PC/SC "<leitor>" (8s). | cartão não aproximado ou leitor em modo teclado | aproxime o cartão; se o leitor "digita" o número, desconecte o de smart card e use o teste por teclado |
| A gaveta não abre | a impressora não está configurada ou falhou | teste a impressora; a gaveta abre pelo comando ESC/POS no fim da impressão |
TEF indisponível (Agente offline). Transações gerenciais não abrem. | agente TEF fora do ar | verifique o serviço do agente no terminal; a venda pelas outras formas continua |
| O card TEF não aparece em Periféricos do PDV | é intencional | o TEF é identidade do caixa no servidor da adquirente e é configurado na retaguarda |
Periferico desconhecido. no teste | tipo de periférico não suportado neste binário | remova o item ou atualize o aplicativo |
Como funciona por dentro#
- A lista de tipos padrão é sempre completada. Mesmo que o servidor mande a configuração incompleta, os cards Balança, Gaveta, Impressora, RFID e Scanner aparecem com um padrão — nenhum card some.
- O hardware pertence ao terminal. A configuração feita aqui é gravada como
servidor_locale sobrevive à sincronização: o servidor manda no que ele envia, e o que o caixa configurou localmente é preservado. A exceção é a linhatef, que é sempre do servidor. - O TEF fica fora da tela por segurança. Se o operador pudesse desligar a linha
tefno caixa, um reinício offline antes do próximo sincronismo faria o PDV cobrar cartão como pagamento comum enquanto a retaguarda ainda exige TEF. - Teste com registro. Cada teste vira um evento de auditoria local (
teste_periferico…), visível no Histórico local. - A gaveta é um comando ESC/POS, não um periférico com porta própria: ela vem junto com a impressão (inicialização, codepage, linhas, avanço, gaveta e corte parcial).
O que é de fábrica e o que a sua loja pode ter mudado#
| Ponto | Padrão de fábrica | Como fica diferente |
|---|---|---|
| Impressoras | o produto aceita ESC/POS em USB direto, spooler do Windows e serial | quais modelos funcionam depende do parque instalado na loja |
| Balança Bluetooth | existe interpretador de mensagem com faixa validada de 0,005 a 60 kg | isso não é pareamento de rádio pelo PDV: o pareamento é do sistema operacional ou da balança |
| Impressora fiscal dedicada | o caminho suportado é impressora não fiscal com DANFE em contingência | não há suporte a impressora fiscal neste guia |
| Smartcard | o leitor é configurável | os usos efetivos (operador, fidelidade) dependem da configuração da loja |
Os valores vigentes da sua loja ficam em Administração › Parâmetros; a tabela completa está em Parâmetros e valores padrão.