Instalar o PDV num computador da loja (PDV offline)

Cadastros > Terminais > editar o caixa > quadro Instalar este caixa no computador da loja. Copie o link ou use Enviar por WhatsApp para o técnico, e abra o link no computador do caixa (Windows).

• Na página, Baixar o instalador baixa um arquivo só (já com tudo dentro, inclusive o .NET) com o CNPJ e o código deste caixa no nome. Não renomeie o arquivo - é dele que o instalador lê a configuração; não precisa digitar CNPJ nem código.
• Abra o arquivo baixado. Se aparecer "O Windows protegeu o computador": Mais informações > Executar assim mesmo. Quando o Windows perguntar se permite alterações, clique em Sim (o instalador pede sozinho; não precisa "Executar como administrador").
• Escolha o que o computador vai ser e clique em Concluir e instalar:
  • O computador principal da loja (servidor + caixa) - um por loja, e o primeiro a ser instalado. O sistema é baixado da nuvem durante a instalação (precisa de internet nessa hora; sem internet, coloque o pacote-app.zip na mesma pasta do instalador). O instalador libera a porta no firewall para os outros caixas e deixa o computador sem suspender na tomada - deixe-o sempre ligado.
  • Um caixa a mais - acha o computador principal sozinho (pelo nome do computador ou pelo IP). Não precisa digitar endereço. Se disser que o principal "não respondeu", confira se ele está ligado e na mesma rede e clique em Concluir de novo; se disser que o sistema "ainda não conhece o computador principal", instale o principal antes e espere uns minutos.
  • Pré-venda / balcão - monta pedidos, sem NFC-e; também acha o principal sozinho.
  • Personalizado - para combinações diferentes (as opções técnicas antigas).
  • Marque Este computador tem o pinpad no caixa que tem o TEF.
• No fim, a tela de conferência mostra o que está funcionando: servidor local (ou o computador principal) respondendo, ligação com a nuvem, impressora instalada e atalho do PDV. Item em vermelho precisa ser corrigido antes de vender (a linha diz o que fazer); em laranja é aviso - por exemplo "Sem internet agora": o caixa vende assim mesmo e as vendas sobem quando a internet voltar. Abrir o PDV agora abre a tela de venda; Ver registro da instalação mostra o passo a passo técnico.
• Atalhos na Área de Trabalho, com o ícone da JE: JE PDV (ou JE Pré-venda) - abre a tela de venda e também abre sozinho ao ligar o computador; JE Sincronizador - no computador principal, abre a janela do sincronizador (o mesmo ícone fica ao lado do relógio); JE ERP Web - abre o sistema completo (retaguarda) em janela própria, direto na tela de login (antes abria a página de apresentação do site, sem login; nos computadores já instalados o atalho é corrigido sozinho na atualização do agente). Nos computadores que já tinham o PDV, os atalhos antigos "Slym PDV" e "Sincronizador Slym" são trocados pelos novos sozinhos depois da atualização do agente.
• O link vale para uma instalação. Se der "CNPJ ou código de instalação inválidos", o código já foi usado: o quadro em Terminais já mostra o link novo (ou use Gerar novo código).
• "O PDV já está aberto neste computador": feche-o pelo ícone ao lado do relógio (botão direito > Sair) e abra o instalador de novo.
• Caixa recém-instalado dá "Credencial(s) incorreta(s)" com a senha certa: os usuários chegam ao caixa logo no começo da primeira carga do catálogo (a janela do JE Sincronizador mostra "Recebendo cadastros da nuvem: 3 de 18 - Usuários"; nas versões antigas do agente, "Recebendo catálogo (x/18)"). Espere passar de Usuários e tente de novo. Se a barra ficar parada nos clientes, era um defeito já corrigido: a correção entra na próxima atualização do caixa e a carga continua sozinha.
• "Falha ao rodar migrations do banco local" com drop_cliente_padrao_prevenda_from_config_notas ... FAIL no fim da lista: era um defeito do sistema, já corrigido. Basta rodar o instalador de novo - o que já foi instalado é aproveitado. Se ele disser "CNPJ ou código de instalação inválidos", use Gerar novo código em Terminais e baixe o instalador outra vez.

Não feche. As etapas mais longas são Extraindo o sistema (milhares de arquivos; o registro mostra o andamento, ex.: "Extraindo o sistema: 40% (3.920 de 9.800 arquivos)") e as migrations do banco local. Quando uma etapa fica mais de 20 segundos sem novidade, o registro escreve "... ainda trabalhando nesta etapa (há 1 min 20 s) - aguarde, não feche". Com antivírus, a extração pode passar de 10 minutos. Nos instaladores antigos a janela ficava em "Não está respondendo" nessa hora, mas continuava trabalhando; desde 19/10/2026 ela não congela mais.

Ao clicar em JE PDV (ou ao ligar o computador), aparece primeiro a tela "Abrindo o PDV...": ela espera o servidor da loja responder e vai sozinha para a tela de entrada (usuário e senha). Não precisa clicar em nada.

• Logo depois de ligar o computador é normal levar alguns segundos: o servidor local (JE Sincronizador) ainda está ligando. A tela mostra há quantos segundos está esperando.
• Se passar de 1 minuto e meio, a própria tela diz o que conferir: no computador principal, se o JE Sincronizador está aberto (ícone ao lado do relógio); num caixa a mais, se o computador principal está ligado e na mesma rede. O botão Tentar abrir agora vai direto para o PDV.
• Antes, a janela ficava toda escura, sem nada, até o servidor responder - e cada abertura era mais lenta porque o servidor local não guardava o sistema já preparado na memória. Isso foi corrigido: a tela de abertura e o servidor mais rápido chegam sozinhos com a atualização do agente; a parte da velocidade vale a partir do próximo reinício do computador.
• No caixa, a tela de entrada é a do próprio servidor da loja e ficou mais leve: um cartão pequeno no meio da tela só com usuário e senha (sem o painel de apresentação e sem o "Cadastrar minha empresa"). Pelo navegador, o sistema na nuvem continua com a tela de sempre.
• A tela de entrada e o PDV também não esperam mais a internet para aparecer (fontes e ícones da internet carregam depois, sem segurar a tela).

• Ao clicar em Entrar, o botão mostra "Entrando..." com um círculo girando enquanto o caixa confere a senha - a primeira entrada depois de ligar pode levar alguns segundos. Não precisa clicar de novo.
• Antes, algumas empresas levavam "403 - Página não permitida!" logo depois da senha no PDV offline, mesmo com o usuário certo na nuvem: o caixa conferia as telas por uma lista antiga da empresa, que não tinha o PDV. Agora no caixa vale só o perfil de acesso do usuário (o plano continua sendo conferido na nuvem). Chega com a atualização do sistema no caixa.
• Usuário "caixa livre": antes, no PDV offline, ele levava esse 403 logo depois da senha, porque os funcionários não chegavam ao caixa e o PDV pedia "cadastre ao menos um funcionário". Agora os funcionários descem da nuvem com os outros cadastros (só nome, usuário e comissão - salário e documentos ficam na nuvem) e o PDV abre. Se ainda não houver funcionário no caixa, o PDV abre com um aviso: cadastre o funcionário na nuvem, vincule ao usuário e espere a próxima atualização dos cadastros.
• Se aparecer "Este usuário não tem acesso ao PDV": o perfil de acesso do usuário não tem a tela do PDV (Frente de caixa) marcada. Ajuste o perfil no sistema na nuvem e espere o caixa receber a próxima atualização dos cadastros pela janela do JE Sincronizador; depois clique em Voltar ao login e entre de novo.

A pasta C:\SlymSincronizador agora se limpa sozinha: quando o JE Sincronizador abre e depois de cada atualização do sistema, ele apaga as cópias de segurança antigas das atualizações (pastas app_backup_... e app_falhou_... com mais de 7 dias) e os arquivos de instalação já usados (pacote-app.zip). A cópia mais recente de cada tipo sempre fica, para voltar a versão se precisar.

• Nunca são apagados a pasta app (o sistema), a pasta database (o banco da loja) nem os backups do banco, que já guardam só os 7 últimos dias.
• Antes, cada atualização deixava uma cópia inteira do sistema (centenas de MB) que quase nunca era apagada. A limpeza chega com a atualização do agente; nas lojas que já têm muitas pastas antigas, elas somem na primeira abertura depois disso.

O certificado digital A1 cadastrado no sistema na nuvem (Configurar Emitente) chega sozinho ao caixa, com a senha, junto com os outros cadastros. Não precisa instalar à mão no caixa.

• Se aparecer em vermelho na janela do JE Sincronizador "O certificado digital cadastrado na nuvem não abre com a senha cadastrada lá", a senha gravada na nuvem está errada: corrija no Configurar Emitente (anexe o arquivo e a senha juntos). Enquanto isso, o caixa continua com o certificado que já tinha.
• Ainda dá para instalar no próprio caixa: Configuração do caixa > aba Fiscal (pede a senha de gerente). Se depois o certificado for trocado na nuvem, o da nuvem passa a valer no caixa.
• Antes, o certificado nunca descia e cada caixa mostrava "Sem certificado" até alguém instalar à mão.
• XML das NFC-e: o XML da nota autorizada no caixa sobe para a nuvem com a venda (Baixar XML e pacote do contador).

• O caixa anota no log tudo o que demora mais de 1,5 segundo, com o nome da tela e o tempo: linhas "[pdv-offline] requisição lenta" em C:\SlymSincronizador\app\storage\logs\laravel-AAAA-MM-DD.log (um arquivo por dia). Mande esse arquivo ao suporte quando estiver lento.
• No cartão pelo TEF, o PDV offline confere a resposta do gerenciador de meio em meio segundo (antes, a cada 2 segundos em cada etapa).

• Desde 21/10/2026, o sincronizador da loja roda só as tarefas da loja: subir as vendas, trazer os cadastros, reenviar NFC-e em contingência e Farmácia Popular, e o backup do banco local. Antes ele rodava também as tarefas da nuvem (marketplaces, fila da NF-e, consulta da SEFAZ…), uma de cada vez e várias por minuto, e o processo CLI (PHP) tomava uns 25% do processador.
• O relógio do caixa e da pré-venda passou a ser atualizado uma vez por segundo, em vez de dez.
• A melhora chega à loja quando o sistema do caixa é atualizado (JE Sincronizador > Atualização disponível).
• Outras coisas que pesam no computador do caixa e não são do sistema: a otimização de disco do Windows, o indexador de pesquisa e o antivírus examinando a pasta do sincronizador. Peça ao técnico de informática para agendar a otimização fora do horário da loja.

• O agente se cadastra numa tarefa do Agendador de Tarefas chamada SlymPdvAgente. Desde 21/10/2026 ela vale para qualquer usuário que entrar no Windows (inclusive nome com espaço, como "tecelagem loja"), abre também com o notebook na bateria e não tem mais o limite de 3 dias ligado.
• Para recriar a tarefa: feche o agente (ícone ao lado do relógio > Sair) e abra o JE Sincronizador uma vez com o botão direito > Executar como administrador. Na próxima vez que entrar no Windows, ele abre sozinho.
• O que aconteceu fica anotado em C:\SlymPdvAgente\logs\atualizacao-AAAAMMDD.log, nas linhas [inicializacao]. Mande esse arquivo ao suporte se o agente continuar sem abrir.
• Sem administrador, o agente abre pelo registro do Windows (Configurações > Apps > Inicialização: deixe ligado).

• Reimprimir, cupom fiscal e não fiscal: antes davam erro ("Failed to open stream" ou 500) porque a logo do emitente não está no computador do caixa. Agora o documento sai sem a logo.
• Comprovantes do TEF: saem a via do estabelecimento e a via do cliente, as duas completas. Antes a segunda via saía reduzida.

A atualização precisa do JE Sincronizador aberto como administrador (ele para e religa os serviços do servidor local). Ao clicar no aviso de atualização sem essa permissão, a janela pergunta "Reabrir agora como administrador?": clique Sim, aceite o aviso do Windows e clique de novo no aviso de atualização. Na versão antiga do agente aparecia só "Falha ao aplicar a atualização"; o jeito era fechar o agente, clicar com o botão direito no atalho JE Sincronizador > Executar como administrador e aplicar de novo. Depois da primeira vez ele passa a abrir como administrador sozinho.

• Menu > NFC-e em contingência mostra as notas emitidas em contingência nos últimos 30 dias: Aguardando a SEFAZ, Autorizada ou Rejeitada. O caixa reenvia sozinho a cada 5 minutos; Reenviar agora tenta na hora.
• O cupom sai na hora, mesmo em contingência, com "EMITIDA EM CONTINGÊNCIA - Pendente de autorização" impresso. A nota é enviada sozinha para a SEFAZ quando ela voltar; não precisa fazer nada.
• Venda no cartão (TEF) e só saíram os comprovantes do cartão? O navegador só abre o cupom logo depois de um toque ou tecla, e na venda no cartão (e na espera da SEFAZ fora) esse tempo passa. Agora o caixa mostra "O cupom fiscal está pronto": tecle S ou Enter (ou toque em Imprimir) e o cupom sai. Se a tela já foi limpa, reimprima pelo F7 (Consulta de vendas) > F4.
• Ao imprimir uma NFC-e sem o arquivo no caixa, a tela diz a situação: "Esta venda ainda não tem NFC-e" (confira o certificado em Configuração do caixa > Fiscal e emita pelo F7), em contingência aguardando a SEFAZ, ou de outro caixa. Antes aparecia só "Arquivo XML não encontrado!!".

Quando os códigos internos dos produtos são trocados na nuvem (por exemplo, quando o suporte ajusta os códigos de uma loja vinda de outro sistema), o PDV offline recebe os códigos novos na próxima conferência de cadastros da janela JE Sincronizador - não precisa reinstalar nem apagar nada no caixa.

• Antes desta versão, quando um produto descia com um código que outro produto ainda tinha no caixa, a carga dos produtos parava e a janela mostrava "Não foi possível receber Produtos" em vermelho; os códigos antigos continuavam no caixa. O sincronizador agora troca os códigos sozinho.
• Etiquetas impressas com o código antigo ficam desatualizadas: imprima de novo as que a loja usa.
• Se depois de alguns minutos o código continuar o antigo, mande para o suporte um print da janela do JE Sincronizador.

Até 27/10/2026, no PDV offline, a busca por nome com acento ou Ç (ex.: algodão, cetim çarau) mostrava "Nenhum produto encontrado" para produtos cadastrados em maiúsculas com acento (ex.: TECIDO ALGODÃO), que a nuvem achava normalmente. Corrigido: o caixa acha o produto como a nuvem, depois que o computador do PDV recebe a atualização do sistema. Enquanto isso, buscar pelo código ou por uma palavra sem acento também acha.

Logo depois de instalar o computador principal, o sincronizador baixa da nuvem os cadastros da loja (cidades, empresa, usuários, produtos, estoque, clientes...). A janela JE Sincronizador (ícone ao lado do relógio) diz em palavras o que está fazendo:

• Cada barra fica num cartão com uma seta dentro de um círculo colorido (para cima = envio, para baixo = recebimento). A cor diz como está: verde = em dia, azul = trabalhando agora, cinza = esperando a primeira conferência, vermelha = precisa de atenção (a mensagem em vermelho embaixo dos cartões diz o quê). A barra fica na mesma cor da seta.
• Barra de cima (↑) - vendas para a nuvem: "Vendas para a nuvem: todas enviadas (conferido às 19:01)" ou "Vendas para a nuvem: 3 aguardando envio". A contagem é conferida a cada 5 minutos. Enquanto o caixa manda um pagamento com cartão, aparece "Enviando pagamentos com cartão para a nuvem: 1 de 2".
• Barra de baixo (↓) - cadastros da nuvem: durante a carga, "Recebendo cadastros da nuvem: 15 de 18 - Produtos (1.234 itens)"; quando termina, "Cadastros em dia - conferidos às 19:01". De tempos em tempos o sincronizador confere se há cadastro novo na nuvem e a barra anda de novo por alguns segundos - é normal.
• Bolinha verde/vermelha no rodapé (nas versões antigas do agente, um quadradinho): verde com "Conectado à nuvem"; vermelho com "Sem conexão com a nuvem - as vendas ficam guardadas aqui e sobem quando voltar". Sem internet o caixa continua vendendo.
• "Última conferência com a nuvem" mostra a última vez que o sincronizador falou com a nuvem.
• Os usuários descem logo no começo, junto com a empresa: dá para entrar no PDV com o mesmo login e senha da nuvem poucos segundos depois da instalação, sem esperar os produtos. Se aparecer "Credencial(s) incorreta(s)" bem no início, espere a janela passar de Usuários e tente de novo.
• A primeira carga ficou bem mais rápida: as 5.570 cidades, que podiam levar mais de um minuto em computador com disco lento, descem em poucos segundos.
• Mensagem em vermelho (numa faixa vermelha clara) embaixo das barras = algo precisa de atenção. Ex.: "Não foi possível receber Clientes. O sistema tenta de novo sozinho em alguns minutos." (o resto dos cadastros continua descendo), venda recusada pela nuvem ou sem conexão. Nas versões antigas do agente a mensagem era "Falha ao receber o catálogo". Se o vermelho continuar, mande para o suporte um print da janela e o arquivo C:\SlymSincronizador\app\storage\logs\laravel.log.
• Antes a janela mostrava só as setas, "Nenhuma pendência" e "WEB" - e "Nenhuma pendência" aparecia mesmo com a barra de baixo ainda andando, porque era da barra de cima. Agora cada barra tem a sua frase.

• Atualização pedida pelo ícone perto do relógio com a janela minimizada: a janela reabria estreita, com os quadros cortados. Corrigido em 27/10/2026, com o agente novo. Até lá, arraste a borda da janela ou feche e abra o JE Sincronizador depois que a atualização terminar - ela continua normalmente.

• Logo depois de uma atualização, o JE Sincronizador podia mostrar esse aviso em vermelho por alguns minutos com o caixa vendendo normalmente: o primeiro acesso ao sistema novo é mais lento. Corrigido em 27/10/2026, com o agente novo. Se o aviso continuar e o PDV não abrir, clique no aviso para reiniciar o servidor local.

O JE Sincronizador abre uma vez só por computador. Se ele já está aberto (mesmo escondido ao lado do relógio) e alguém clica no atalho de novo, aparece o aviso "O JE Sincronizador já está aberto neste computador": clique em OK e a janela que já estava aberta vem para a frente. Se ela não aparecer, dê dois cliques no ícone do JE Sincronizador ao lado do relógio (canto de baixo da tela, perto da data e hora).

• Antes dava para abrir duas cópias, e o computador ficava com dois ícones ao lado do relógio disputando a impressora e a fila de vendas. Agora a segunda não abre.
• Depois de atualizar o agente ou de trocar a pasta do TEF, ele se reabre sozinho e espera a cópia antiga fechar - não aparece o aviso nesse caso.

Na janela do JE Sincronizador, o botão Verificar equipamentos (também no menu do ícone ao lado do relógio) mostra de uma vez como estão os aparelhos deste computador: impressora do cupom, balança, TEF e pinpad, scanner, as pastas de PBM e, no computador principal, o servidor local. Cada um tem uma bolinha: verde funcionando, amarela precisa de atenção, vermelha não responde e cinza não é usado neste caixa. Ao lado, o botão que resolve: Imprimir teste, Usar esta impressora, Procurar balança, Escolher pasta (TEF) ou Reiniciar (servidor local).

• Trocou o cabo de porta USB? O agente confere sozinho a cada 5 minutos. Se algo parar, aparece uma linha em vermelho na janela do JE Sincronizador dizendo qual aparelho.
• Balança: se o cabo mudar de porta e o Windows der outro número (era COM3, virou COM5), o agente acha a balança na porta nova e grava sozinho e mostra o aviso "Balança encontrada" ao lado do relógio. Se ela estiver desligada, nada muda: ligue e tecle Alt+B de novo.
• Impressora: mudar o cabo de porta USB costuma criar outra impressora no Windows ("... (Cópia 1)") e deixar a antiga offline. A verificação mostra isso e o botão Usar esta impressora troca para a que está funcionando; o agente reabre sozinho. Imprimir teste manda um cupom curto para conferir.
• TEF e pinpad: quem conversa com o pinpad é o programa do TEF (Gerenciador Padrão). A verificação diz se a pasta do TEF está no lugar e se o programa está pegando os pedidos; se o pinpad mudou de porta USB, quem acha é o programa do TEF.
• Pedido antigo na pasta do TEF: linha amarela "Há um pedido antigo na pasta" = sobrou em Req um intpos.001 de dias atrás (outro programa ou uma queda). Com o caixa parado, apague esse arquivo. Arquivos de outro sistema na pasta não contam mais como parado.
• A verificação não manda nada para o TEF nem imprime sozinha: dá para usar com o caixa vendendo.

Cadastros > Terminais > Novo Terminal: nome (ex.: Caixa 1), tipo (PDV vende e emite NFC-e; Pré-venda só monta pedidos), filial e a série de NFC-e (já vem sugerida a próxima livre). Clique em Salvar no fim da tela.

• Filial: escolha Sem filial específica quando o caixa é da matriz/empresa; antes a tela já vinha com a primeira filial escolhida.
• A série de NFC-e não muda depois de criada (evita nota duplicada): na edição ela aparece travada. Para outra série, cadastre outro terminal.
• Na edição dá para ajustar os últimos números de NFC-e (com a senha do gerente e o motivo), ligar o TEF do caixa e ver o quadro de instalação.
• Terminal não se exclui: Desativar (na lista) tira o caixa de uso sem nunca reaproveitar a série.