Instalar, parear e atualizar o PDV#

AInstalar no Windows#

1. Extraia o pacote do PDV em uma pasta do terminal (por exemplo C:\PDV).
2. Dê duplo clique em INICIAR_PDV_WINDOWS.bat.
3. Na primeira execução, na mesma tela de ativação, o terminal mostra a linha Versão <versão do binário> — anote: é o que o suporte vai pedir.
4. Siga para o pareamento (passo C).

O launcher existe por um motivo técnico: ele provisiona, antes do aplicativo, uma chave aleatória de 256 bits exclusiva do diário local de recuperação. A chave fica estável no perfil do usuário Windows e é guardada apenas como blob protegido pelo próprio Windows, fora da pasta do pacote — por isso atualizar o binário no mesmo perfil preserva a chave, e por isso o pacote não pode ser movido para outro usuário do Windows sem refazer a ativação do diário.

Se a chave não puder ser autenticada pelo mesmo perfil, o launcher falha com orientação e não troca a chave em silêncio — trocá-la tornaria o diário anterior ilegível.

BInstalar no Android#

1. Instale o APK release gerado para SmartPOS/maquininha (build com ofuscação, API HTTPS e pinning de certificado).
2. No Android o PDV é sempre a pele Touch: não há escolha de pele nem teclado físico garantido.
3. Abra o aplicativo e siga para o pareamento.

O APK não recebe a chave do diário por parâmetro de build — embutir o segredo no pacote seria expor a chave. O canal nativo por instalação é o caminho previsto, e enquanto ele não estiver homologado a proteção adicional de recuperação fica desativada no pacote Android. Isso não reduz as validações funcionais do banco local nem do PIN.

CParear (ativar) o terminal#

1. Na tela Ativar este PDV, cole a chave de ativação gerada na retaguarda, no campo Código ou chave de ativação.
2. Alternativas para preencher o campo:
   • no Android, toque em Escanear QR e aponte a câmera para o QR da chave;
   • no Windows, use o leitor de código: o campo já está com o foco, então basta bipar (o leitor "digita" a chave e manda Enter).
3. Clique em Ativar PDV (ou deixe o Enter fazer isso).
4. A mensagem Validando e ativando este PDV… aparece e, em seguida, PDV ativado e confirmado pelo servidor.
5. O terminal passa a ter identidade própria (empresa, loja e PDV) e recebe a carga inicial.

DConfirmar que a carga chegou#

1. Abra Status do PDV.
2. Confira o painel Carga do servidor:
   • Completa — o caixa recebeu todas as tabelas e opera offline;
   • Parcial N/M — já dá para operar, e o restante chega no próximo ciclo;
   • Aguardando — o caixa ainda não pode operar.
3. Só depois disso o caixa aceita abrir a jornada.

Sem catálogo o PDV recusa a abertura com Aguardando a carga do servidor — o caixa recebe as tabelas (catálogo, operadores, perfis, config) antes de operar.

EConfigurar o hardware do terminal#

Siga Hardware e periféricos: impressora, balança, leitor, gaveta e RFID. O terminal TEF é configurado na retaguarda, não no caixa.

FAtualizar a versão do aplicativo#

1. A atualização não é pedida pelo operador: o servidor oferece a versão nova na resposta do ciclo de sincronização.
2. O terminal baixa o pacote apenas quando não há venda em andamento — um download grande não disputa banda nem disco com o caixa.
3. O pacote é conferido por SHA-256 e por assinatura digital antes de ser aceito.
4. O conteúdo verificado é estagiado numa pasta pending.
5. A troca dos binários acontece no próximo boot, pelo launcher — nunca pelo aplicativo em execução: o Windows não deixa sobrescrever um .exe rodando, e o caixa não pode parar no meio de uma venda.
6. No Android, a instalação é pedida ao sistema e pode exigir a confirmação do operador.

A versão só é oferecida se for mais nova. A comparação é pelo número de build (o carimbo numérico depois do + na versão), nunca por comparação de texto de versão.

GLer a versão instalada#

A versão aparece em dois lugares:

• na tela de ativação, antes mesmo de parear: Versão <versão>;
• no rodapé da tela do caixa: v<versão>.