Estoqfy Print — bobina no computador do caixa
Diretivas Comerciais
O Estoqfy Print é o programa que fica no computador onde a bobina está ligada (USB ou rede local, porta 9100). Ele escuta só a loja do código e imprime o resumo da venda, a nota promissória e, com o add-on fiscal, o cupom da NFC-e. Não é um instalador: a pasta descompactada é o programa. Vale para Windows e Mac. Não depende do add-on fiscal.
A escuta existe enquanto a janela do programa estiver aberta. Fechar a janela interrompe a impressão desse computador. Reiniciar o computador não apaga o código: ele fica no arquivo agent.json, ao lado do programa. O que o reinício faz é fechar o programa. Para a escuta voltar sozinha no próximo login, configure a abertura automática no fim deste guia.
O que preparar
- O computador do caixa, com a bobina no USB desse computador ou na mesma rede dele (porta 9100).
- O Estoqfy aberto nesse mesmo computador, no endereço habitual da loja (o mesmo https usado no dia a dia). Outro computador não enxerga essa bobina.
- Permissão de Configurações para gerar o código e baixar o programa.
- A opção Habilitar impressora de bobina térmica marcada em Configurações → Diretivas de Sistema. Ela já vem marcada.
Baixar e guardar a pasta
Em Configurações → Diretivas de Sistema, baixe o arquivo da máquina:
- Windows: Baixar para Windows (.exe).
- Mac com chip Apple (M1, M2, M3 ou mais novo): Baixar para Mac (Apple).
- Mac Intel: Baixar para Mac (Intel). No menu da Apple, Sobre este Mac mostra o tipo do processador.
Descompacte e deixe a pasta num lugar fixo. Não deixe dentro de Downloads se essa pasta for limpa, e não separe os arquivos.
- Windows: por exemplo
C:\\EstoqfyPrint\\, com EstoqfyPrint.exe e agent.json juntos. - Mac: por exemplo a pasta Estoqfy Print em Documentos, com EstoqfyPrint, Abrir Estoqfy Print.command e agent.json juntos.
O agent.json já traz o endereço do Estoqfy e o nome desta loja. O código ainda não está dentro dele.
Gerar o código e abrir a primeira vez
- Na mesma aba Diretivas de Sistema, clique em Gerar código do agente.
- Copie o código na hora. Ele aparece uma vez. Se sair da página sem copiar, gere de novo — e o código anterior deixa de valer em todos os caixas que já o usavam.
- Abra o programa nesse computador. No Windows, dê dois cliques em EstoqfyPrint.exe. No Mac, dê dois cliques em Abrir Estoqfy Print.command.
- Se o Windows mostrar uma faixa azul, clique em Mais informações e depois em Executar assim mesmo. Se o Mac disser que o desenvolvedor não pode ser verificado, feche o aviso, clique com o botão direito no arquivo, escolha Abrir e confirme Abrir.
- Na primeira abertura, cole o código e pressione Enter. O programa grava o código no agent.json e passa a escutar esta loja. A janela preta (Windows) ou o Terminal (Mac) precisa continuar aberta. Pode minimizar. Não feche.
Volte em Diretivas de Sistema nesse mesmo computador. Em Agentes ligados nesta loja deve aparecer o nome da máquina. Se houver mais de uma impressora, use Impressora deste computador e Usar nesta máquina. Com uma só bobina, a escolha automática serve.
Cada caixa repete o download e a primeira abertura. O mesmo código serve para os outros computadores desta loja, desde que ninguém clique em Gerar outro código. Esse botão desliga todos os programas que ainda usam o código anterior: é preciso informar o novo código em cada um.
Conferir a impressão
Na venda, use Imprimir na bobina. O resumo pode ser impresso em qualquer venda. Na aba Comercial do cliente, cada venda também tem esse botão e imprime só o resumo. Com mais de uma parcela, ele lista cada uma como paga, em atraso ou a vencer, soma os pagamentos já recebidos (entrada e parcelas pagas) e fecha com o saldo devedor, para o cliente levar como comprovante. A nota promissória entra sempre que a venda gera contas a receber: crediário com ou sem entrada, plano Livre ou Cheque. Com entrada, a 1ª parcela aparece como quitada e as demais com o vencimento. O cupom fiscal da NFC-e só aparece com o add-on fiscal e a nota já emitida. Com NF-e 55 já emitida, a mesma janela oferece Imprimir NFe simplificada. O papel sai na bobina deste computador, não no servidor. O resumo, a nota promissória e o comprovante de recebimento trazem a linha Emitido por com o usuário que mandou imprimir. O cupom da NFC-e e a NF-e simplificada não trazem essa linha.
No aplicativo, Configurações tem Impressora de bobina. O aparelho lista as impressoras Bluetooth já pareadas (no iPhone, as que estiverem por perto) e guarda a escolhida. A bobina de teste é de 58 mm. No detalhe da venda sincronizada, Compartilhar abre o compartilhamento do celular para qualquer aplicativo (WhatsApp, e-mail, redes e os demais). O usuário escolhe o que enviar: resumo da venda e, quando existirem, o PDF do cupom ou da NF-e e a nota promissória. Imprimir abre só as opções disponíveis na bobina Bluetooth: resumo, nota promissória (crediário, Livre ou cheque), cupom fiscal da NFC-e autorizada ou cancelada e NF-e simplificada quando a NF-e 55 já foi emitida. Com o add-on fiscal e permissão de emitir, depois que a venda sincroniza o app pergunta Emitir agora ou Depois (NF-e ou NFC-e, conforme o cliente). Sem internet a venda continua local e a nota só entra na fila depois do envio. Emitir NFC-e ou Emitir NF-e aparece enquanto o documento está Pendente ou Rejeitado. Sem add-on ou sem permissão de emitir, o app não mostra a pergunta nem o botão de emitir. CCe, e-mail da nota, devolução fiscal e a fila do Emissor continuam só na web. No título já baixado, o comprovante de recebimento. Logo depois de confirmar uma baixa no aparelho, o app também oferece esse comprovante, mesmo antes da sincronização.
Se a janela do Estoqfy Print estiver fechada, o Estoqfy não alcança essa bobina e a tela mostra o erro. A venda não é desfeita.
Abrir sozinho ao entrar no Windows
Faça isto depois que a primeira impressão já tiver funcionado, com o código já gravado. O programa precisa abrir na conta do Windows que usa o caixa e a impressora. Não configure para rodar sem ninguém logado: a bobina USB e o navegador estão nessa sessão.
Pasta de inicialização (o caminho mais simples):
- Feche o Estoqfy Print se ele estiver aberto.
- Pressione a tecla Windows + R, digite
shell:startupe confirme. - Abre a pasta Inicializar do seu usuário. Em outra janela, abra a pasta onde está o EstoqfyPrint.exe.
- Clique com o botão direito no EstoqfyPrint.exe, escolha Mostrar mais opções se precisar, e Criar atalho.
- Recorte o atalho e cole dentro da pasta Inicializar.
No próximo login dessa conta, a janela preta abre sozinha e a escuta volta, sem pedir o código. Pode minimizar a janela. Sair do Windows ou reiniciar fecha o programa; entrar de novo abre outra vez.
Agendador de Tarefas (se a pasta Inicializar não disparar, ou se a USB ainda não estiver pronta no instante do login):
- Abra o Agendador de Tarefas.
- À direita, Criar Tarefa... (não use a tarefa básica).
- Nome: Estoqfy Print. Marque Executar somente quando o usuário estiver conectado.
- Aba Disparadores: Novo..., comece a tarefa Ao fazer logon, usuário específico = a conta do caixa. Em atraso, pode marcar Atrasar tarefa por 30 segundos, para a impressora USB terminar de ligar.
- Aba Ações: Novo..., Iniciar um programa. Programa: o caminho completo do EstoqfyPrint.exe. Em Iniciar em, a pasta desse arquivo (a mesma do agent.json).
- Aba Condições: desmarque Iniciar a tarefa somente se o computador estiver ligado à energia elétrica, se o caixa for notebook.
- Confirme. Saia da conta e entre de novo. A janela preta deve aparecer.
Abrir sozinho ao entrar no Mac
Faça isto depois da primeira abertura manual, com o código já aceito. Use o arquivo Abrir Estoqfy Print.command, não o programa sem extensão: o .command abre o Terminal, onde dá para ver se a escuta está no ar.
- Abra Ajustes do Sistema (ou Preferências do Sistema, em macOS mais antigo).
- Vá em Geral → Itens de Início e Extensões. Em macOS antigo: Usuários e Grupos → Itens de Início.
- Em Abrir no início da sessão, clique em +.
- Escolha Abrir Estoqfy Print.command dentro da pasta que você guardou. Se a janela só listar aplicativos, mude o tipo para Todos os arquivos, ou arraste o .command do Finder para a lista.
- Feche a sessão (menu da Apple → Encerrar sessão) e entre de novo.
O Terminal abre sozinho e o programa escuta a loja sem pedir o código. Pode minimizar o Terminal. Fechar a janela do Terminal interrompe a escuta até o próximo login, ou até você abrir o .command de novo.
Se no login o Mac bloquear o arquivo, faça uma vez o botão direito → Abrir nesse .command, confirme, e teste de novo o encerrar sessão.
Quando o código é pedido de novo
- A pasta foi trocada e o agent.json antigo não foi junto.
- Alguém clicou em Gerar outro código. Informe o código novo em cada caixa e deixe o programa aberto (ou reinicie a sessão, se a abertura automática já estiver feita, depois de gravar o código uma vez).
- O programa foi aberto por um atalho que aponta para outra cópia, sem o agent.json ao lado.
Fora desses casos, reiniciar o computador não pede o código outra vez.
Aba Diretivas de uso de IA
Disponível para quem tem Configurações — Visualizar/Editar. Cada opção controla se o tenant pode usar modelos de IA (OpenAI) naquele ponto do produto. Ligado por padrão (checkbox marcado). Ao desmarcar, o recurso some da interface e as APIs de IA respondem 403 com código AI_FEATURE_DISABLED, mesmo que o perfil tenha permissão de Central de Inteligência. A cota mensal de tokens do plano continua aplicável aos pontos que permanecem ligados.
Consulte o estado atual pela API: GET /lookups/ai-directives ou aiFeatures em GET /me/permissions (JWT). App móvel: docs/MOBILE_AI_DIRECTIVES.md.

