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:
- 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.
- O terminal precisa estar cadastrado na retaguarda como um caixa daquela loja.
- O operador precisa existir como usuário do PDV, com o papel (perfil) dele definido.
- 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#
- Na retaguarda, abra Administração > Lojas.
- Clique em Nova loja.
- Preencha Código, Tipo (matriz ou filial), Nome da loja, Regime tributário, UF e Município. Se for filial, informe a Matriz vinculada.
- 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.
- 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.
- 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#
- Abra Operação e PDV > Checkout — caixas.
- Clique em Incluir e informe o nome e a loja do caixa.
- Salve. O caixa passa a existir, ainda como aguardando ativação.
- Abra a aba Pareamento. Se o cartão estiver sem chave, clique em Gerar chave de ativação.
- 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#
- Abra Administração > Usuários do PDV.
- Clique em Incluir usuário do PDV.
- 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.
- Escolha a Loja e o Papel (perfil). O papel define o que a pessoa pode fazer no caixa: vender, dar desconto, cancelar, autorizar.
- 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#
- Abra Operação e PDV > Carga PDV.
- Escolha a loja que vai receber a carga. Sem loja escolhida, a carga não é enviada.
- 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.
- Marque a confirmação de que as etiquetas e os preços da gôndola foram conferidos.
- 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
- Obtenha o pacote do PDV. Gerado a partir da origem, ele sai em
dist\pdv-windows-mvp.zip, com o arquivo de conferênciapdv-windows-mvp.sha256.txtao lado. - Extraia todo o conteúdo do ZIP em uma pasta local da máquina do caixa.
- Mantenha os arquivos juntos: o executável, o
nfce-assinador-local.exee a pastadata. O assinador local precisa ficar na mesma pasta do executável — é dele que depende a NFC-e em contingência. - Execute o
INICIAR_PDV_WINDOWS.bat. Não abra opdv_flutter.exediretamente. - 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#
- Abra o 3A PDV no computador deste caixa.
- 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.
- Deixe o aplicativo aberto até o caixa aparecer na retaguarda como comunicando.
- 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#
- Na tela do PDV, informe o Código (a matrícula do operador) e o PIN.
- Se o operador entrar sem PIN cadastrado, o acesso é sem autenticação forte — funciona, mas não identifica quem operou.
- Confirme. O aplicativo mostra o nome de quem entrou.
- 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:
- F2 — Abrir caixa, informando o fundo de troco (se ainda não abriu).
- F6 — posiciona o cursor no campo de produto. Bipe o código de barras ou digite o código e confirme.
- Repita para os demais itens.
- F10 — Receber. Escolha a forma de pagamento e informe o valor.
- 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#
| Ordem | O que fazer | Onde | Por quê |
|---|---|---|---|
| 1º | Cadastrar a loja, com fiscal e certificado | Retaguarda > Lojas | sem isso o caixa não emite documento fiscal |
| 2º | Cadastrar produto, preço e regra fiscal | Retaguarda > Produtos, Precificação | o caixa vende o que existe no catálogo |
| 3º | Cadastrar o terminal | Retaguarda > Checkout — caixas | é o cadastro que dá identidade ao caixa |
| 4º | Cadastrar o operador e o papel dele | Retaguarda > Usuários do PDV | sem operador ninguém abre turno |
| 5º | Publicar a carga | Retaguarda > Carga PDV | é o que leva produto e preço ao terminal |
| 6º | Instalar e parear o PDV | Máquina do caixa | sem pareamento o aplicativo não opera |
| 7º | Abrir o caixa com o fundo de troco e vender | PDV | a operação em si |
Campos e o que significam#
| Campo | O 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 terminal | Opcional. Em branco, o operador entra sem PIN. Validado no próprio terminal, inclusive offline. |
| QR Code de login | alternativa ao PIN, lida por leitor | Opcional. Também é único: não pode repetir na empresa. |
| Papel (perfil) | o conjunto de direitos do operador no caixa | Só aparecem perfis de escopo de frente de loja (PDV). |
| Loja | a loja do operador | Em branco significa todas as lojas. |
| Tipo (da loja) | matriz ou filial | Só 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 loja | Nã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 caixa | a chave selada que o PDV apresenta para se parear | Uso ú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#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O PDV não ativa: a chave é recusada | Chave já consumida por um pareamento anterior, chave reemitida (a anterior morre na hora) ou validade vencida | Volte 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 disso | O aplicativo não foi aberto naquele computador, ou não alcança a API | Abra 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 sinal | O aplicativo está fechado, ou a máquina perdeu a rede | Verifique internet e se o aplicativo está aberto. |
| O caixa aparece como carga atrasada | Existe carga nova publicada que aquele terminal ainda não baixou | Ele 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 errados | Confira 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á vazio | Informe 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 aberto | Informe o PIN do mesmo operador do turno. Outro operador não retoma um turno bloqueado. |
| Nenhum produto aparece no caixa | Carga não publicada para a loja, ou produto fora do PDV | Confira Carga PDV e a fila de decisão do produto. Ver Dados e sincronização. |
| O botão de enviar a carga não funciona | A confirmação de conferência das etiquetas e dos preços da gôndola está desmarcada | Marque 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 finaliza | Falta item ou falta pagamento suficiente | A 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#
| Ponto | De onde vem |
|---|---|
| Nome do aplicativo no instalador e no menu Iniciar | vem 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 compilado | ficam gravados no terminal. Leia na própria máquina — o pareamento pode ter gravado endereço diferente do padrão do build |
| Lacre do malote | parâ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 SmartPOS | depende do modelo do aparelho: o pareamento envolve o sistema operacional, não só o aplicativo |
Onde aprofundar#
- Instalação, atualização e pareamento em detalhe: Instalar e atualizar o PDV.
- A primeira venda, passo a passo: Vender.
- Treinar quem vai operar: Treinar o operador.
- Abrir e fechar caixa, turno e jornada: Abrir e fechar o caixa.
- Configurar a loja na retaguarda: Primeiros passos da loja.