erp4me

Como configurar e utilizar o Serviço de Impressão Local

Introdução


O Serviço de Impressão Local é uma solução desenvolvida para garantir a comunicação estável entre o sistema web (que opera em ambiente seguro HTTPS) e as impressoras físicas instaladas na sua máquina.

Essa modernização substitui as antigas conexões via IP de rede local exposto, eliminando bloqueios de segurança dos navegadores e garantindo que suas impressões (como cupons e relatórios) saiam instantaneamente e sem falhas de comunicação.



Configuração do Ambiente


Para que a comunicação funcione, o sistema exige um ambiente seguro de operação. A autenticação e o tráfego de dados ocorrem localmente de forma protegida.

Antes de iniciar as etapas, certifique-se de que a sua impressora está devidamente ligada, com os drivers instalados no Windows e conectada ao computador (via cabo USB ou cabo de rede).

Pré Requisito antes de começar a instalação


Para que o instalador do Serviço de Impressão funcione corretamente, o Windows do seu computador precisa ter o .NET Runtime 6.0 (x64) instalado.

Se você executar o arquivo e receber um alerta informando que o componente não foi detectado, faça o download e a instalação prévia através do link oficial da Microsoft abaixo:

Após concluir a instalação desse componente da Microsoft, você poderá prosseguir normalmente para a Etapa 1 abaixo.

Clique para visualizar a mensagem
https://ajuda.alterdata.com.br/download/attachments/349241909/servi%C3%A7o%20de%20impress%C3%A3o.jpg?version=1&modificationDate=1783105795058&api=v2

Passo a Passo


Etapa 1: Instalação do Serviço de Impressão

Antes de configurar o sistema, é necessário baixar e instalar o aplicativo responsável por fazer a ponte com a sua impressora.

  1. Faça o download do arquivo de instalação clicando no link a seguir: Baixar Instalador do Serviço de Impressão.

  2. Após o término do download, abra o arquivo baixado e siga as instruções na tela para concluir a instalação padrão.

Clique para conferir a instalação do serviço
serviço de impressão.gif



Etapa 2: Verificação do Serviço no Windows

Com o aplicativo instalado, precisamos garantir que ele esteja ativo e operando em segundo plano no seu computador.

  1. No teclado do seu computador, pressione as teclas Windows + R simultaneamente para abrir a janela "Executar".

  2. Na barra de pesquisa que aparecer, digite services.msc e clique em OK (ou pressione Enter).

  3. Na lista de serviços do Windows que será exibida, localize o item chamado: AlterdataServicoImpressao.

  4. Verifique o status na coluna correspondente:

    • Se o status estiver "Em Execução" (Running): O serviço já está pronto para receber comandos. Avance para a próxima etapa.

    • Se o status estiver "Parado" (Stopped): Clique com o botão direito sobre o nome do serviço e selecione a opção Iniciar.

https://ajuda.alterdata.com.br/download/attachments/349241909/image-2026-6-22_15-1-11.png?version=1&modificationDate=1782151271254&api=v2

Dica

Para evitar que o serviço pare nas próximas vezes que você ligar o computador, clique com o botão direito no serviço > Propriedades > aba Geral > mude o campo Tipo de inicialização para Automático e clique em Aplicar.


Etapa 3: Ajuste do Endpoint no Sistema

Agora vamos configurar o sistema para que ele saiba exatamente para onde enviar os documentos que você deseja imprimir.

  1. Acesse a tela de login do seu sistema Íntero.

  2. Vá até as opções de configurações.

  3. No campo destinado ao Endereço do Servidor de Impressão, insira a URL de Loopback recomendada abaixo para contornar restrições de segurança:

    • URL: https://127.0.0.1:19003 (Nota: Caso o seu TI tenha definido uma porta diferente da padrão, substitua o número 19003 pela porta correspondente).

  4. Salve as alterações realizadas.

https://ajuda.alterdata.com.br/download/attachments/349241909/image-2026-6-22_15-22-3.png?version=1&modificationDate=1782152523209&api=v2


Ativar configuração dos serviços x Servidor local
  1. Ativar Configuração de Servidor Local

  • O que é: Define o endereço IP ou caminho da máquina física (servidor interno) que está dentro da própria loja.

  • Quando usar: Quando o PDV Web precisa "conversar" com equipamentos físicos ou rodar funções que não podem parar se a internet cair.

  • Exemplos Práticos:

    • Acionar a impressora física de cupons (fiscal ou não-fiscal).

    • Abrir a gaveta de dinheiro, ler dados da balança ou do leitor de código de barras.

    • Garantir velocidade máxima (baixa latência) em comandos que dependem apenas da rede interna da loja.

  • Resumo: É a ponte entre o sistema web e os equipamentos físicos da loja.

2. Ativar Configuração dos Serviços

  • O que é: Define o endereço web (URL da API) dos servidores em nuvem/remotos.

  • Quando usar: Quando o PDV precisa consultar, validar ou enviar dados para fora da loja através da internet.

  • Exemplos Práticos:

    • Emitir notas fiscais (NFC-e / SAT via cloud).

    • Consultar se um cliente tem cadastro, verificar o estoque geral ou validar um cupom de desconto.

    • Processar pagamentos via TEF (cartão) homologados por APIs externas.

    • Conectar-se com qualquer microsserviço que esteja hospedado fora da rede local.

  • Resumo: É a ponte entre o PDV e as regras de negócio na nuvem (internet).

Tabela Comparativa (Rápida Consulta)

Característica

Servidor Local

Configuração dos Serviços

Onde roda?

Em uma máquina física dentro da loja.

Em servidores na nuvem (Internet).

Foco principal

Integração com Hardware e periféricos.

Integração com Dados, APIs e Fisco.

Depende de internet?

Não. Funciona mesmo offline.

Sim. Precisa de conexão ativa.


Atenção

  • Configuração por Estação: Como o endereço 127.0.0.1 refere-se estritamente à máquina local (localhost), este procedimento deve ser realizado individualmente em cada computador que possuir uma impressora física conectada.

  • Bloqueios de Segurança: Caso o serviço esteja rodando mas a comunicação falhe, verifique se o Firewall do Windows ou o seu antivírus não estão bloqueando a porta de comunicação (19003). Se necessário, solicite ao seu técnico de TI a liberação dessa porta específica.

Validação ou Conferência


Para confirmar que todo o processo foi executado com sucesso, realize o teste prático a seguir:

  1. Atualize a página do seu sistema pressionando a tecla F5 no teclado.

  2. Acesse qualquer tela do sistema que permita a impressão de documentos (como o módulo PDVUP).

  3. Na parte superior direita da tela, clique no ícone da Engrenagem e selecione a opção Impressora.

  4. Selecione a sua impressora na lista e clique no botão Impressão de Teste.

Se a sua impressora emitir a página de teste corretamente, parabéns! O seu serviço de impressão local está configurado e pronto para o trabalho diário.

Clique para conferir
https://ajuda.alterdata.com.br/download/attachments/349241909/image-2026-6-22_15-24-49.png?version=1&modificationDate=1782152691483&api=v2


Perguntas Frequentes (FAQ)


P: Por que não posso utilizar o IP comum da minha rede interna (ex: 192.168.1.74)?

R: Como o portal intero.alterdata.com.br opera sob o protocolo seguro HTTPS, o navegador bloqueia automaticamente qualquer requisição para endereços HTTP comuns por questões de segurança (Erro de Conteúdo Misto). O uso do endereço padrão 127.0.0.1 é a única diretriz homologada para contornar essa trava de forma legítima e segura.

P: Tenho mais de um funcionário que usa a mesma impressora compartilhada na rede, o que fazer?

R: Se a impressora está conectada diretamente na máquina daquele usuário, a configuração será idêntica utilizando o 127.0.0.1. O endereço sempre apontará para a própria estação de trabalho de onde o comando está partindo.