Ir para o conteúdo
clabor Manual do ERPia

Primeiro acesso ao PDV#

Como preparar, instalar, ativar e usar o caixa pela primeira vez. Para quem instala o sistema na loja — dono, gerente ou técnico — e para o primeiro operador que vai vender.

Antes de começar — nesta ordem, e sem pular etapa:

  1. A loja precisa estar cadastrada na retaguarda, com tipo (matriz ou filial), regime tributário, UF e município preenchidos. Sem isso o caixa não tem identidade fiscal.
  2. O terminal precisa estar cadastrado na retaguarda como um caixa daquela loja.
  3. O operador precisa existir como usuário do PDV, com o papel (perfil) dele definido.
  4. A carga precisa estar publicada para a loja, senão o caixa abre sem produto e sem preço.

Passo a passo#

1Cadastrar a loja#

  1. Na retaguarda, abra Administração > Lojas.
  2. Clique em Nova loja.
  3. Preencha Código, Tipo (matriz ou filial), Nome da loja, Regime tributário, UF e Município. Se for filial, informe a Matriz vinculada.
  4. Se esta loja vai nascer com os mesmos preços de outra, escolha-a em Espelhar preços de. Essa escolha só existe na criação: depois, ou você edita os preços, ou a loja fica sem preço.
  5. Abra a aba NFE/NFCe e confira Ambiente, Fuso horário fiscal e Prazo contingência (h). O CSC só é necessário para NFC-e.
  6. Abra a aba Certificado e envie o Certificado A1 (.pfx / .p12) com a senha. O certificado e a senha ficam armazenados criptografados, e a senha nunca é exibida — ela só é aberta em memória durante uma operação fiscal.

2Cadastrar o terminal na retaguarda#

  1. Abra Operação e PDV > Checkout — caixas.
  2. Clique em Incluir e informe o nome e a loja do caixa.
  3. Salve. O caixa passa a existir, ainda como aguardando ativação.
  4. Abra a aba Pareamento. Se o cartão estiver sem chave, clique em Gerar chave de ativação.
  5. O cartão mostra o QR Code, a chave em texto e a validade. Use Copiar chave se o caixa não tiver câmera.

A chave é de uso único: vale para o primeiro pareamento daquele terminal. Para parear outro terminal, clique em Reemitir — e note que a chave atual deixa de funcionar imediatamente.

3Cadastrar o operador do PDV#

  1. Abra Administração > Usuários do PDV.
  2. Clique em Incluir usuário do PDV.
  3. Preencha Nome, Código (matrícula) — único, é o que o operador usa para entrar no caixa — e PIN do caixa (4 dígitos). O PIN é opcional, mas é o que responsabiliza quem operou.
  4. Escolha a Loja e o Papel (perfil). O papel define o que a pessoa pode fazer no caixa: vender, dar desconto, cancelar, autorizar.
  5. Marque Ativo e salve.

Usuário do PDV não consome licença: você cadastra quantos precisar. A licença cobra o usuário da retaguarda.

4Publicar a carga para os caixas#

  1. Abra Operação e PDV > Carga PDV.
  2. Escolha a loja que vai receber a carga. Sem loja escolhida, a carga não é enviada.
  3. Revise os preços pendentes. Se houver preço alterado, imprima as etiquetas e troque as etiquetas da gôndola antes de enviar — assim a prateleira e o caixa passam a cobrar o mesmo preço.
  4. Marque a confirmação de que as etiquetas e os preços da gôndola foram conferidos.
  5. Envie a carga aos caixas.

O envio é recusado sem essa confirmação. É deliberado: evita que o caixa cobre um preço que a prateleira ainda não mostra.

5Instalar o PDV#

No Windows

  1. Obtenha o pacote do PDV. Gerado a partir da origem, ele sai em dist\pdv-windows-mvp.zip, com o arquivo de conferência pdv-windows-mvp.sha256.txt ao lado.
  2. Extraia todo o conteúdo do ZIP em uma pasta local da máquina do caixa.
  3. Mantenha os arquivos juntos: o executável, o nfce-assinador-local.exe e a pasta data. O assinador local precisa ficar na mesma pasta do executável — é dele que depende a NFC-e em contingência.
  4. Execute o INICIAR_PDV_WINDOWS.bat. Não abra o pdv_flutter.exe diretamente.
  5. Antes de usar, garanta que a API e a retaguarda estão no ar acessíveis por este computador.

O ZIP traz um arquivo LEIA-ME-PDV-WINDOWS.txt com essas instruções e a API configurada no build. O certificado A1 não acompanha o pacote — ele é cadastrado pela retaguarda, como no passo 1.

No Android

O pacote Android é gerado pelo script de empacotamento SmartPOS, que exige um alvo explícito: ou o parâmetro de produção, ou um endereço de API informado, ou a variável de ambiente API_BASE. Sem alvo definido, a geração para com erro. Essa etapa é técnica: quem executa é quem gera os pacotes do sistema, não o operador da loja.

6Ativar (parear) o terminal#

  1. Abra o 3A PDV no computador deste caixa.
  2. Na tela de ativação, aponte a câmera para o QR do cartão de pareamento. Se o caixa não tiver câmera, cole a chave que você copiou da aba Pareamento.
  3. Deixe o aplicativo aberto até o caixa aparecer na retaguarda como comunicando.
  4. Volte em Operação e PDV > Checkout — caixas e confira o estado do terminal na lista.

Os estados pelos quais o caixa passa até estar operando são: aguardando ativação, aguardando primeiro contato, comunicando, carga atrasada e sem sinal. Um caixa inativo não opera.

7Primeiro login do operador no caixa#

  1. Na tela do PDV, informe o Código (a matrícula do operador) e o PIN.
  2. Se o operador entrar sem PIN cadastrado, o acesso é sem autenticação forte — funciona, mas não identifica quem operou.
  3. Confirme. O aplicativo mostra o nome de quem entrou.
  4. Se o caixa ainda não tiver fundo de troco, abra o caixa: a abertura pede o fundo de troco com que o caixa começa o dia.

Abrir o caixa abre a jornada e o primeiro turno ao mesmo tempo. Não são duas operações.

8Primeira venda#

O caminho mais curto, pelas teclas de função padrão:

  1. F2 — Abrir caixa, informando o fundo de troco (se ainda não abriu).
  2. F6 — posiciona o cursor no campo de produto. Bipe o código de barras ou digite o código e confirme.
  3. Repita para os demais itens.
  4. F10 — Receber. Escolha a forma de pagamento e informe o valor.
  5. Confirme para finalizar a venda e imprimir o cupom.

Outras teclas do padrão de fábrica, úteis já no primeiro dia: F1 consultar preço, F3 ajustar item, F4 subtotal, F5 CPF na nota, F7 cancelar venda, F8 sangria, F11 fechar caixa, F12 pagamento em cartão.

Para o dia a dia completo — sangria, suprimento, despesa do caixa, devolução, reimpressão — use Operação do PDV.

9Ordem correta, resumida#

OrdemO que fazerOndePor quê
1ºCadastrar a loja, com fiscal e certificadoRetaguarda > Lojassem isso o caixa não emite documento fiscal
2ºCadastrar produto, preço e regra fiscalRetaguarda > Produtos, Precificaçãoo caixa vende o que existe no catálogo
3ºCadastrar o terminalRetaguarda > Checkout — caixasé o cadastro que dá identidade ao caixa
4ºCadastrar o operador e o papel deleRetaguarda > Usuários do PDVsem operador ninguém abre turno
5ºPublicar a cargaRetaguarda > Carga PDVé o que leva produto e preço ao terminal
6ºInstalar e parear o PDVMáquina do caixasem pareamento o aplicativo não opera
7ºAbrir o caixa com o fundo de troco e venderPDVa operação em si

Campos e o que significam#

CampoO que éObservação
Código (matrícula)o identificador do operador no caixaÚnico na empresa. É metade da credencial de entrada no PDV.
PIN do caixa (4 dígitos)o segredo do operador no terminalOpcional. Em branco, o operador entra sem PIN. Validado no próprio terminal, inclusive offline.
QR Code de loginalternativa ao PIN, lida por leitorOpcional. Também é único: não pode repetir na empresa.
Papel (perfil)o conjunto de direitos do operador no caixaSó aparecem perfis de escopo de frente de loja (PDV).
Lojaa loja do operadorEm branco significa todas as lojas.
Tipo (da loja)matriz ou filialSó uma matriz por empresa; as demais são filiais vinculadas a ela.
Série NF-e (modelo 55)a série da NF-e da lojaNão é a série da NFC-e. A série da NFC-e é de cada caixa.
Prazo contingência (h)quanto tempo a loja aceita trabalhar com notas em fila de transmissãoÉ configuração do sistema, com padrão 24 horas. Não é o prazo legal: quem define o prazo legal é a legislação, e quem decide sobre ele é o seu contador.
Chave de ativação do caixaa chave selada que o PDV apresenta para se parearUso único, vale para o primeiro pareamento. Reemitir invalida a atual.

Resultado esperado#

  • Na retaguarda, em Checkout — caixas, o terminal aparece como comunicando, e não mais como aguardando ativação.
  • No PDV, o aplicativo aceita o código e o PIN do operador e mostra o nome dele.
  • Ao abrir o caixa, o PDV aceita o fundo de troco e libera a tela de venda.
  • Ao bipar um produto da carga, o preço aparece e a venda finaliza com cupom.

Se algo der errado#

SintomaCausa provávelO que fazer
O PDV não ativa: a chave é recusadaChave já consumida por um pareamento anterior, chave reemitida (a anterior morre na hora) ou validade vencidaVolte em Checkout — caixas > aba Pareamento e clique em Reemitir. No PDV, use a chave nova.
O caixa aparece como aguardando ativação e não sai dissoO aplicativo não foi aberto naquele computador, ou não alcança a APIAbra o 3A PDV na máquina do caixa e deixe-o aberto. Confirme que a API está acessível a partir dali.
O caixa aparece como sem sinalO aplicativo está fechado, ou a máquina perdeu a redeVerifique internet e se o aplicativo está aberto.
O caixa aparece como carga atrasadaExiste carga nova publicada que aquele terminal ainda não baixouEle baixa na próxima conexão. Se precisar agora, confirme a conexão do terminal.
"Codigo ou PIN invalido." / "Código ou PIN inválido."Matrícula ou PIN erradosConfira a matrícula na retaguarda, em Usuários do PDV. Se o PIN foi esquecido, ele é redefinido no cadastro do usuário do PDV.
"Informe o PIN do operador."A ação exige credencial e o campo está vazioInforme o PIN. Se o operador não tem PIN, quem administra precisa cadastrar um.
"PDV bloqueado. Informe o PIN do operador do turno."O caixa ficou bloqueado (pausa, ou queda de energia) com um turno abertoInforme o PIN do mesmo operador do turno. Outro operador não retoma um turno bloqueado.
Nenhum produto aparece no caixaCarga não publicada para a loja, ou produto fora do PDVConfira Carga PDV e a fila de decisão do produto. Ver Dados e sincronização.
O botão de enviar a carga não funcionaA confirmação de conferência das etiquetas e dos preços da gôndola está desmarcadaMarque a confirmação. A mensagem é "Confirme que as etiquetas e os preços da gôndola foram conferidos antes de enviar a Carga PDV".
A venda não finalizaFalta item ou falta pagamento suficienteA venda é bloqueada localmente sem item, sem pagamento ou com dinheiro insuficiente. Confira o cupom.

Como funciona por dentro#

  • O PIN é validado no próprio terminal. O PDV recebe o hash da credencial na carga de segurança e confere localmente, com o mesmo esquema do servidor. É isso que torna o login offline verdadeiro. O terminal não guarda o PIN em claro.
  • A chave de pareamento é de uso único. O pareamento é o único ponto público que aceita um segredo e devolve credencial, então ele tem um limite próprio de tentativas, mais generoso que o do login, porque um técnico ativa vários caixas seguidos do mesmo endereço de rede.
  • O aplicativo não conversa com a retaguarda para vender. Ele usa o catálogo e o preço que já estão no terminal, grava a venda localmente e cria uma fila de sincronização. Se a retaguarda rejeitar a sincronização, a venda continua pendente e não é descartada.
  • A carga é o único caminho de preço novo. Enquanto um preço não for enviado pela carga, o caixa continua cobrando o preço antigo.

O que é do terminal, não do manual#

PontoDe onde vem
Nome do aplicativo no instalador e no menu Iniciarvem do pacote gerado: o produto o chama de "3A PDV" nas instruções de ativação e "3A Digital PDV — MVP Windows" no pacote Windows
Versão instalada e endereço de API compiladoficam gravados no terminal. Leia na própria máquina — o pareamento pode ter gravado endereço diferente do padrão do build
Lacre do maloteparâmetro Exigir lacre do malote, desligado de fábrica — o lacre é opcional, e obrigatório só quando o parâmetro está ligado e sobra dinheiro para o malote
Primeiro pareamento em Android SmartPOSdepende do modelo do aparelho: o pareamento envolve o sistema operacional, não só o aplicativo

Onde aprofundar#