Ir para o conteúdo
clabor Manual do ERPia

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#

  1. Abra o card Impressora e use Detectar.
  2. O PDV procura em três frentes: Procurando impressora (USB direto + Windows + portas COM)…
  3. 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.
  4. Clique em Testar para imprimir um cupom de teste.
  5. 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#

  1. Abra o card Balança e use Detectar.
  2. O PDV procura na serial: Procurando balança nas portas COM…
  3. 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.
  4. 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".
  5. 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#

  1. 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).
  2. 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.
  3. Aviso de falha: Balanca nao confirmou o peso automaticamente (leituras …).
  4. 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:

BloqueioQuando
peso_instavela mensagem indica instabilidade
peso_abaixo_minimopeso menor que 0,005 kg
peso_acima_maximopeso 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#

  1. Abra o card Scanner e use Detectar.
  2. O diálogo Testar leitor mostra a instrução Bipe um código de barras agora… e o campo com a dica aguardando o bip.
  3. Bipe com o leitor. Se o código aparecer no campo, o leitor está pronto.
  4. 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#

  1. Abra o card Gaveta e confira se está habilitada.
  2. 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:

  1. PC/SC (leitor de smart card, tipo ACR122U) — mensagem Aproxime o cartão no leitor "<leitor>"…; ao ler, responde RFID (PC/SC) OK — cartão <uid> em "<leitor>".
  2. 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.
  3. 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:

TextoSignifica
Scanner OK, Balanca OK, Impressora OKhabilitado e pronto
<periférico> offdesabilitado na configuração
<periférico> democonfigurado em modo simulado

IUsar o terminal TEF#

  1. Confirme na retaguarda qual plugin de pagamento este caixa usa.
  2. Ligue o terminal/pinpad antes de abrir o caixa.
  3. 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).
  4. 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#

CardTipo internoPara que serve
Balançabalancapeso de produto a granel, serial ou simulado
Gavetagavetaabertura da gaveta de dinheiro
Impressoraimpressoracupom, comprovante de turno e DANFE
RFIDrfidleitura de cartão/tag
Scannerscannerleitura 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#

ModoSignifica
tecladoo scanner emula teclado
pcteclado do próprio PDV
usbligado direto na USB (impressora) ou leitor USB
spoolerimpressora instalada no Windows (fila)
serialporta COM
simuladomodo demonstração: não toca hardware
desativadoperiférico desligado
Modelo mostradoBaud de fábrica
Elgin DP30 / DP30CK / DP-1502 / DP-30052400
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#

SintomaCausa provávelO que fazer
Nenhuma impressora encontradacabo, energia ou driverconfira o cabo USB e a energia; se for serial, confira cabo e porta
A impressora imprime cortando a última colunalargura da bobina declarada errada no cadastrocorrija largura_mm/largura_dots; as duas unidades precisam conferir
Porta <porta> ocupada: outro programa está usando a …outro programa segurou a porta serialfeche o outro programa e teste de novo
Sem resposta da balanca em <porta>balança desligada, cabo errado ou protocolo/baud diferenteconfira o menu da balança (na Elgin, RS-232 = 1030) e o cabo cruzado; reescaneie
Balanca capturando o zeroa balança está estabilizandoespere e leia de novo
Sobrecarga na balancapeso acima da capacidaderetire o excesso
Balanca nao confirmou o peso automaticamente (leituras …)leitura instável ou produto trocado durante a pesagemuse 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ávelconfirme o peso na balança e leia de novo
Informe ou leia um peso valido.peso vazio ou zeroinforme o peso
O bipe não aparece no teste do leitorleitor 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 tecladoaproxime 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 abrea impressora não está configurada ou falhouteste 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 arverifique o serviço do agente no terminal; a venda pelas outras formas continua
O card TEF não aparece em Periféricos do PDVé intencionalo TEF é identidade do caixa no servidor da adquirente e é configurado na retaguarda
Periferico desconhecido. no testetipo de periférico não suportado neste binárioremova 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_local e sobrevive à sincronização: o servidor manda no que ele envia, e o que o caixa configurou localmente é preservado. A exceção é a linha tef, que é sempre do servidor.
  • O TEF fica fora da tela por segurança. Se o operador pudesse desligar a linha tef no 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#

PontoPadrão de fábricaComo fica diferente
Impressoraso produto aceita ESC/POS em USB direto, spooler do Windows e serialquais modelos funcionam depende do parque instalado na loja
Balança Bluetoothexiste interpretador de mensagem com faixa validada de 0,005 a 60 kgisso não é pareamento de rádio pelo PDV: o pareamento é do sistema operacional ou da balança
Impressora fiscal dedicadao caminho suportado é impressora não fiscal com DANFE em contingêncianão há suporte a impressora fiscal neste guia
Smartcardo leitor é configurávelos 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.