PrintHap: impressão integrada ao Hap
Como ativar o PrintHap, instalar o Agent no computador das impressoras, parear, sincronizar as impressoras do Windows, rotear por produto e por usuário, ligar a impressão automática dos documentos fiscais e consultar a auditoria.
Quando usar
Use quando a loja ou o escritório imprime em impressoras térmicas, matriciais ou comuns ligadas a um computador local, quer imprimir NF-e/NFC-e/boleto automaticamente na emissão ou precisa separar a impressão por setor (cozinha, bar, expedição) e por caixa.
Antes de começar
- Computador Windows ligado fisicamente às impressoras, com acesso à internet
- Usuário administrador para as Configurações gerais
Visão geral
O PrintHap é a integração de impressão do Hap Gestor: um agente instalado no computador onde ficam as impressoras conecta esse PC ao Hap, e a partir daí qualquer tela do sistema imprime nelas, sem instalar nada em cada estação e sem criar conta separada.
- Lojas e escritórios com impressoras térmicas, matriciais ou comuns ligadas a um PC local.
- Impressão automática de NF-e, NFC-e, boletos e outros documentos fiscais na emissão.
- Roteamento por setor, computador, usuário ou produto (cozinha, bar e expedição em impressoras diferentes).
- Operações com mais de um caixa ou estação, cada uma com sua impressora.
Passo 1: ativar o provedor de impressão
Em Configurações gerais > Estoque, no campo Provedor de impressão, troque de PrintNode para PrintHap e clique em Salvar.
Passo 2: ativar a integração PrintHap
Em Configurações > Integrações, abra o card PrintHap (Abrir painel) e clique em Ativar PrintHap. A ativação cria automaticamente a conta de impressão da empresa, vinculada ao domínio partner.printhap.com.br; não há cadastro nem chave para copiar.
| Status | Significado |
|---|---|
| Pendente | A integração ainda não foi ativada para esta empresa |
| Ativa | Conta criada e pronta para conectar computadores; a tela passa a mostrar a conexão do primeiro PC |
Passo 3: instalar o PrintHap Agent
O Agent é o programa que fica em execução no computador ligado às impressoras. No painel, clique em Baixar instalador e execute no PC das impressoras (não precisa ser o servidor).
- 1
O Windows SmartScreen pode avisar que o aplicativo "não é reconhecido"; é esperado para instaladores novos, não é vírus. Clique em Mais informações > Executar assim mesmo.
SmartScreen do Windows: clique em Executar assim mesmo - 2
Deixe marcado Desktop UI mode (recomendado) e clique em Install.
Instalador do PrintHap Agent: modo de instalação e botão Install - 3
Ao concluir, clique em OK; o Agent abre automaticamente.
Instalação concluída com sucesso
Passo 4: conectar o computador
O pareamento liga o Agent à empresa por um código temporário, sem senha e sem chave de API.
- 1
No Agent, a aba Account mostra o computador ainda não pareado, com o campo Code vazio.
PrintHap Agent, aba Account: computador ainda não pareado - 2
No painel PrintHap, clique em Gerar código de conexão; o código vale 30 minutos.
Painel PrintHap: código de conexão gerado - 3
No Agent, cole o código em Code e clique em Connect with code.
PrintHap Agent: código colado e pronto para conectar - 4
No painel, clique em Atualizar computadores: o PC aparece Online em "Computadores conectados".
Computador pareado e Online em Computadores conectados
Passo 5: sincronizar as impressoras do Windows
No painel, selecione o computador no campo Computador e clique em Atualizar impressoras. A seção Impressoras sincronizadas lista cada impressora do Windows daquele PC, com status Online/Offline em tempo real.
A mesma lista aparece na aba Printers do Agent, com a caixa Active marcando quais estão disponíveis para o Hap.
| Aba | O que mostra |
|---|---|
| Jobs | Fila e status de cada trabalho enviado a este computador |
| Settings | Versão do Agent e pastas de dados e de logs, úteis em chamados |
| Logs | Histórico técnico de pareamento e sincronismo; o primeiro lugar para investigar falha de conexão |
Passo 6: vincular produtos a uma impressora
Quando a impressão é separada por setor, vincule cada categoria de produto à impressora certa e o roteamento fica automático. Em Vincular produtos a uma impressora, selecione a Impressora e clique em Vincular todos os produtos (ou Remover vínculo de todos para desfazer).
Passo 7: conectar mais de um computador
PDV em vários caixas, ou cozinha e balcão em máquinas separadas: instale o Agent no novo PC (Passo 3), gere um código novo no painel (Conectar outro computador ou Gerar novo código) e pareie como no Passo 4. Marque Sincronizar impressoras de todos os computadores para ver o parque inteiro numa tela.
Passo 8: auditoria de impressões
Toda impressão via PrintHap fica registrada. No painel, clique em Auditoria de impressões, filtre por Status e período (De/Até) e clique em Aplicar filtro. Cada linha traz Documento, Cópias, Impressora, Computador e Status; Ver logs mostra o detalhe de envio, impressão e erros.
Passo 9: impressão automática de documentos fiscais
Em Configurações gerais > Emissão de documentos, marque Ativar impressão automática na emissão. Desligada, nada muda. Para cada tipo de documento, marque a caixa, escolha a Impressora e o número de Cópias; tipos desmarcados ou sem impressora não imprimem. Salve.
| Documento | Quando |
|---|---|
| Nota Fiscal (NF-e) | DANFE ao confirmar a emissão |
| Cupom Fiscal (NFC-e) | O PDV já imprime localmente; ative só se quiser também pelo PrintHap |
| Nota de Serviço (NFS-e) | DANFSe ao confirmar a emissão |
| Boleto | Após a emissão/registro |
| Conhecimento de Transporte (CT-e) | DACTE ao confirmar a emissão |
| Manifesto (MDF-e) | DAMDFE ao confirmar a emissão |
Passo 10: impressora por usuário e por produto
Por usuário: restringe quais impressoras a pessoa pode usar e qual sai por padrão. Em Cadastros > Pessoa, abra o usuário, aba Impressoras: marque as permitidas, escolha a principal e salve.
Por produto: ajuste fino por item, que sobrepõe o vínculo em massa do Passo 6 e define o roteamento para o KDS. Em Cadastros > Produto, abra o produto, aba Impressoras: se o item vai para uma tela de produção, escolha em Destino KDS (Nenhum se imprime em papel). Marque as impressoras, escolha a principal e salve.
Boas práticas
- Mantenha o Agent sempre aberto. Para não depender de alguém logar no Windows, instale em Windows Service mode; o ícone fica na bandeja.
- Não precisa criar conta no site do PrintHap: "Ativar PrintHap" cria tudo.
- SmartScreen não é alerta de vírus: "Mais informações" > "Executar assim mesmo".
- Impressora Offline: PC ligado, impressora conectada ou compartilhada no Windows, e "Atualizar impressoras".
- Use a Auditoria de impressões (e a aba Jobs do Agent) para investigar falhas.
Problemas comuns
- O Hap não imprime nada - o PrintHap Agent não está aberto no computador das impressoras; ele precisa ficar sempre em execução (ou instalado em Windows Service mode).
- O código de conexão não funcionou - ele vale 30 minutos; gere um novo no painel e cole de novo no Agent.
- Uma impressora aparece Offline - confira se o PC com o Agent está ligado e a impressora conectada ou compartilhada no Windows; clique em "Atualizar impressoras" (o status vem do driver do Windows).
- O Agent não abriu depois de instalar - clique com o botão direito no atalho e escolha "Executar como administrador".
- O cliente recebe cupom duplicado - a impressão automática do Cupom Fiscal (NFC-e) está ligada além da impressão local do PDV; desmarque uma delas.