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

  1. Na mesma aba Diretivas de Sistema, clique em Gerar código do agente.
  2. 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.
  3. Abra o programa nesse computador. No Windows, dê dois cliques em EstoqfyPrint.exe. No Mac, dê dois cliques em Abrir Estoqfy Print.command.
  4. 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.
  5. 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):

  1. Feche o Estoqfy Print se ele estiver aberto.
  2. Pressione a tecla Windows + R, digite shell:startup e confirme.
  3. Abre a pasta Inicializar do seu usuário. Em outra janela, abra a pasta onde está o EstoqfyPrint.exe.
  4. Clique com o botão direito no EstoqfyPrint.exe, escolha Mostrar mais opções se precisar, e Criar atalho.
  5. 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):

  1. Abra o Agendador de Tarefas.
  2. À direita, Criar Tarefa... (não use a tarefa básica).
  3. Nome: Estoqfy Print. Marque Executar somente quando o usuário estiver conectado.
  4. 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.
  5. 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).
  6. Aba Condições: desmarque Iniciar a tarefa somente se o computador estiver ligado à energia elétrica, se o caixa for notebook.
  7. 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.

  1. Abra Ajustes do Sistema (ou Preferências do Sistema, em macOS mais antigo).
  2. Vá em Geral → Itens de Início e Extensões. Em macOS antigo: Usuários e Grupos → Itens de Início.
  3. Em Abrir no início da sessão, clique em +.
  4. 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.
  5. 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.

No mesmo módulo

Quer usar isso na operação?

Estoque, vendas, rotas e financeiro no mesmo sistema. O teste dura 7 dias.

Ver planos