HandyCafe Docs
owner cashier

Cartões de Membro

O membro pode abrir uma sessão aproximando um cartão da estação em vez de digitar nome de usuário e senha.

Nada é gravado no cartão. O leitor digita o número de série de fábrica do próprio cartão, que o HandyCafe vincula a um cadastro de membro. É por isso que um cartão perdido é cancelado em um clique enquanto o membro mantém o saldo e o histórico.


O Que Você Precisa

O leitor

Um leitor USB no modo emulação de teclado, também vendido como HID keyboard wedge ou keyboard-out. Ao aproximar um cartão, ele digita o número de série e pressiona Enter, exatamente como se alguém tivesse digitado. Não há driver para instalar nem porta para configurar.

Leitores PC/SC não são compatíveis. Eles precisam de um driver e de um aplicativo que converse com o cartão. O ACR122U de fábrica é o que mais gente compra por engano. Alguns leitores PC/SC vêm com um utilitário que os coloca em modo teclado. Nesse caso funcionam.

Um teste resolve: abra o Bloco de Notas e aproxime um cartão. Se aparecer um número, o HandyCafe também vai ver. Se não aparecer nada, nenhuma configuração dentro do HandyCafe vai ajudar.

A frequência

Leitor e cartão precisam estar na mesma faixa. Um leitor de 125 kHz não lê um cartão de 13,56 MHz. O contrário também vale. Existem leitores de banda dupla que cobrem as duas.

Faixa Cartões comuns
125 kHz EM4100, EM4102, T5577, HID Prox. Os cartões brancos baratos e os chaveiros vendidos a granel
13,56 MHz MIFARE Classic 1K e 4K, MIFARE Ultralight, NTAG213, NTAG215, NTAG216, MIFARE DESFire, ISO 15693 / ICODE

As duas faixas funcionam. Qual comprar é uma questão de preço e disponibilidade, não uma questão do HandyCafe.

Os cartões

Qualquer cartão ou chaveiro cujo número de série de fábrica o leitor consiga ler. Depois de removida a pontuação, o número precisa ter entre 8 e 32 caracteres, o que todos os cartões acima cumprem.

Cartões em branco servem. Nada é gravado neles. Não há etapa de codificação nem codificador para comprar. Cartões impressos e personalizados funcionam do mesmo jeito.

Celulares não funcionam. O Android e o iOS entregam um número de série aleatório diferente a cada aproximação. Um celular aproximado duas vezes parece por isso dois cartões diferentes.

Configurações do leitor

A maioria dos leitores chega pronta para usar. Quando são configuráveis, estas são as configurações que importam:

Configuração O que usar
Formato de saída Hexadecimal ou decimal, os dois são aceitos
Sufixo Enter ou Tab. Sem sufixo a leitura nunca é enviada
Separadores Dois-pontos, hifens e espaços entre bytes são removidos sozinhos. Não precisa desativar
Layout de teclado do leitor Deixe em US ou QWERTY

O último merece uma frase. O layout de teclado do Windows no seu PC não importa. O HandyCafe lê posições físicas de tecla. Uma máquina com F turco, AZERTY ou QWERTZ lê os cartões corretamente sem mudar nada. O que importa é o layout salvo dentro do próprio leitor. Um leitor definido para QWERTZ alemão envia Y onde quer dizer Z. O mesmo cartão produz então um número diferente.

Use o mesmo modelo de leitor em todos os lugares

Dois modelos de leitor podem reportar o mesmo cartão de formas diferentes. Um envia hexadecimal onde o outro envia decimal. Outro inverte a ordem dos bytes. Um cartão registrado no caixa com um modelo pode não ser reconhecido em uma estação que usa outro. Compre o mesmo modelo para cada máquina que lê cartões.


Ativando o Login por Cartão

Abra Configurações, depois Clientes. Localize o bloco Login com cartão NFC.

Ligue Permitir que membros entrem com cartão e escolha um modo:

Modo Comportamento
Qualquer cartão Vincule a um membro, no balcão, qualquer cartão que você tiver em mãos. Nada precisa ser preparado antes
Somente os meus cartões Os cartões precisam estar cadastrados no estoque primeiro. Um cartão fora do estoque não pode ser entregue a um membro

Somente os meus cartões existe para impedir que o cartão de transporte ou do prédio do cliente vire a credencial de acesso dele. Escolha esse modo quando você compra e entrega os seus próprios cartões.


Estoque de Cartões

O estoque de cartões é a lista dos cartões que você possui. Chega-se a ele por Estoque de cartões, no bloco de configurações ou na página de Membros.

Para cadastrar cartões, selecione Estoque de cartões e comece a aproximar os cartões. Cada leitura entra no estoque na hora. Uma pilha inteira pode ser cadastrada de uma vez. A contagem aparece enquanto você trabalha. Uma observação de lote pode ser digitada antes da leitura para identificar o grupo.

Cada cartão no estoque tem um status:

Status Significado
Em estoque Cadastrado e disponível para entrega
Com um membro Atribuído a um membro e apto a abrir sessões
Perdido Informado como perdido. Ele para de funcionar na hora
Retirado de uso Fora de operação, por exemplo por estar danificado

A lista mostra o número do cartão, o status, o membro, a observação, a data de cadastro e o último uso. Ela é limitada aos cartões mais recentes. Use a busca para chegar aos mais antigos.


Entregando um Cartão a um Membro

Abra o membro na página Membros e selecione Atribuir um cartão. Aproxime o cartão do leitor. O cartão é vinculado no momento em que é lido.

Um membro pode ter mais de um cartão. Os cartões que o membro tem aparecem no painel dele com a data de emissão de cada um.

Se o login por cartão estiver desligado, a atribuição funciona mesmo assim. Um aviso explica que o cartão não vai abrir sessão até o recurso ser habilitado.


Recolhendo um Cartão

Três ações estão disponíveis em um cartão atribuído:

  • Devolver ao estoque: o cartão volta para o estoque e para de abrir sessões. O membro mantém o saldo e o histórico.
  • Informar perda: o cartão para de funcionar na hora. Entregue um novo ao membro quando ele estiver pronto.
  • Retirar de uso: o cartão para de abrir sessões e sai de operação. Use para um cartão danificado.

Um cartão retirado de uso ou perdido pode voltar ao estoque com Devolver o cartão ao estoque. Só faça isso quando o cartão estiver fisicamente de volta com você.

Um cartão só pode ser excluído se nunca tiver sido entregue. Um cartão que já circulou precisa ser retirado de uso.


Permissões

Emitir, recolher e cancelar um cartão exige a permissão Alterar senha de membro. Entregar a alguém um cartão que abre a conta dessa pessoa tem o mesmo peso que redefinir a senha dela.

A função padrão de operador de caixa não inclui essa permissão. Em uma instalação já existente, os operadores não conseguem emitir cartões enquanto você não conceder a permissão. Consulte Funções e Permissões de Operadores de Caixa.


Como o Login por Cartão Se Comporta na Estação

O login por cartão passa exatamente pelas mesmas verificações do login por senha: status do anticheat, bloqueio de dispositivo, se o membro está ativo, se o membro tem saldo e a regra de um único lugar. Um cartão não abre uma sessão que a senha não abriria.

O caminho do cartão tem o próprio limite de 12 leituras falhas por minuto por estação. As recusas de cartão não contam para o contador de tentativas de senha, porque um punhado de aproximações erradas travava a estação para todo mundo.

Login da Equipe por Cartão

Um operador ou um administrador abre o servidor do mesmo jeito que um membro abre uma estação. Aproxima o cartão, sem senha.

Isso fica desligado até você ligar. Abra Configurações e depois Equipe. Ligue Permitir que a equipe entre no servidor com cartão. A tela de login passa então a ouvir o leitor e mostra um aviso de cartão abaixo dos campos de senha.

Entregando um cartão a um operador

Nessa mesma página Equipe, escolha o botão de cartão na linha do operador e aproxime o cartão. O cartão fica ligado a esse operador no instante em que é lido.

Os cartões da equipe saem do mesmo estoque dos cartões de membro. Tudo desta página vale para eles: mesmo cadastro, recolhimento com Devolver ao estoque, cancelamento com Informar perda. Na lista de estoque, um cartão da equipe mostra como portador o nome do operador seguido de "(equipe)".

Um operador pode ter mais de um cartão. Só um administrador pode entregar, porque um cartão que abre a tela do operador é uma senha sem a digitação.

Um cartão não serve a duas pessoas. O cartão de um operador não pode ser dado a um membro e o cartão de um membro não pode ser entregue a um operador.

O que um cartão da equipe não faz

O cartão de um membro não abre a tela do operador. Um cartão da equipe não abre sessão em uma estação. A tela de login responde a toda recusa com o mesmo texto. Passar cartões no leitor não revela, portanto, quais existem.

Um cartão entregue a um operador que depois foi desligado ou excluído para de funcionar na hora.

Se os cartões forem recusados

Depois de 10 cartões recusados em dez minutos, o leitor é ignorado por quinze minutos. Entre com nome de usuário e senha nesse período. Um cartão que não pôde ser verificado porque o banco de dados não respondeu não é contado. Um disco com defeito não consegue assim travar o leitor sozinho.

Cada login por cartão, cada recusa e cada cartão entregue a um operador vai para o log. Lá o número do cartão aparece mascarado, menos os últimos dígitos, porque o número de um cartão da equipe é uma senha que abre a tela do operador.


Mensagens Comuns

Mensagem O que significa
Este cartão já pertence a um membro Devolva ao estoque antes de atribuir a outra pessoa
Este cartão não está no seu estoque Você está no modo "Somente os meus cartões". Cadastre o cartão em Estoque de cartões primeiro
Este cartão foi informado como perdido O cartão está cancelado. Emita um novo
Este cartão foi retirado de uso Devolva ao estoque se o cartão estiver com você
O leitor enviou um número de cartão ilegível O leitor está digitando algo que não é um número de série de cartão. Verifique o layout de teclado dele e o formato de saída
Nada foi lido ainda O leitor não está conectado ou não está em modo de emulação de teclado. Aproxime um cartão no Bloco de Notas para confirmar
O mesmo cartão não é reconhecido em outra estação Aquela estação tem outro modelo de leitor. Nem todos os leitores reportam um cartão do mesmo jeito
Este cartão já foi entregue antes, então não pode ser excluído Retire-o de uso
Este cartão não abre a tela do operador O cartão é de um membro ou de ninguém. Só entra no servidor um cartão entregue a um operador ativo
O login por cartão para a equipe está desligado Ligue na chave em Configurações, Equipe
Muitos cartões foram recusados O leitor fica ignorado por quinze minutos. Entre com nome de usuário e senha
Não foi possível verificar o cartão O banco de cartões não respondeu. Tente de novo e confira o disco se continuar

Páginas Relacionadas