> For the complete documentation index, see [llms.txt](https://ajuda.comandaxis.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.comandaxis.com.br/pedidos/configurar-impressora-agente.md). # Configurar impressora com o agente > Baixe o agente Windows, pareie, teste a impressora e escolha os setores de impressão. Em **Configurações › Impressões**, a seção **Agente de impressão** mostra no topo se há agente online: **Agente conectado** (verde) ou **Agente de impressão não encontrado** (vermelho). Use **Atualizar** para consultar de novo; a tela também se atualiza sozinha a cada 15 segundos. Na mesma seção, na linha **Baixe e instale o agente de impressão (Windows x64)**, clique em **Clique para baixar** (painel de produção). Em homologação, a tela informa que o instalador está disponível apenas como artefato interno do GitHub Actions; solicite o arquivo à equipe responsável. O agente não está disponível para macOS ou Linux. Se aparecer **Download indisponível neste ambiente. Fale com o suporte.**, não use o instalador de outro ambiente. 1. Instale o agente no computador Windows da loja e abra **Comanda Xis Printer Agent** pelo atalho. O endereço do ambiente já vem configurado. 2. Compare o código mostrado no agente com **Código do agente** na seção **Agente de impressão**. Só então clique em **Parear agente**. 3. Em **Impressoras**, clique em **Adicionar impressora** (o formulário abre na própria seção), selecione **Fila descoberta** e clique em **Continuar**, ou use **Adicionar por IP** para uma impressora de rede. Finalize em **Criar impressora**. 4. No cartão da impressora, clique em **Testar** para enviar uma impressão de teste. O cartão mostra **Impressora disponível** quando a impressora está ativa e o agente online, ou **Impressora indisponível**. 5. Em **Setores de impressão**, clique em **Adicionar setor de impressão**, dê o **Nome do setor** (ex.: Cozinha), escolha a **Impressora**, o **Movimento**, as **Categorias** e o **Template**. Use o lápis da coluna **Editar** para alterar e **Pausar** para parar de imprimir nele. Nas **Configurações** do agente, a seção **Conexao com o SaaS** mantém **Testar HTTP** e **Reconectar agora**. A URL é definida pelo instalador e não pode ser alterada. Se uma instalação anterior tinha outra URL salva, pareie novamente no endereço do instalador. O indicador ao lado de **Conectado** ou **Reconectando** mostra a situação do agente. **Iniciar ao entrar no Windows** é ativado em cada abertura do agente, inclusive após atualizar. Se desligar nas **Configurações**, ele será ligado novamente na próxima abertura. Em **Configurações › Impressões › Templates**, o modelo **Pedido completo** contém o bloco **Pedido completo (80 mm)** com cliente, endereço, cobrança, itens e totais. Você pode conferir em **Preview** e usar **Personalizar** para ter um modelo próprio; o modelo padrão publicado vale também para o envio manual em **Imprimir pedido › Térmica 80mm**. Em **Configurações › Impressões › Templates**, use **Editar** ou **Personalizar**. Na aba **Blocos**, clicar num bloco realça sua posição no **Preview** com borda azul tracejada; a marcação não sai no papel. Em telas pequenas, abra a aba **Preview** depois de selecionar o bloco. Em **Adicionar bloco**, escolha **Imagem** e clique em **Adicionar**. Envie o **Arquivo da imagem** (PNG, JPG ou WebP), ajuste **Largura (mm)**, **Altura máxima (mm)** e **Alinhamento**. A proporção é mantida. A imagem pertence ao template, não precisa ser a **Logo** da loja; na impressão sai em preto e branco. Envie o arquivo antes de **Salvar rascunho**, **Publicar** ou **Teste físico**. Para uma faixa preta com letras brancas no comprovante e no **Preview**, escolha **Bloco de destaque** em **Adicionar bloco**. Digite no campo **Texto**; ele aceita variáveis do documento, por exemplo `{{order.number}}`. Use **Alinhamento** para posicionar o texto. Confira no **Teste físico** antes de **Publicar**. Para imprimir um dado do documento, como o número do pedido, escolha **Campo / variável** em **Adicionar bloco**. Selecione a **Variável**, escreva um **Rótulo** opcional (por exemplo `Pedido #`) e ajuste **Alinhamento** e **Negrito**. O **Preview** mostra o alinhamento igual à impressão. Ao abrir o agente de produção, se houver uma atualização, escolha **Continuar** para baixar ou **Cancelar** para continuar imprimindo. A janela **Atualizando Printer Agent** mostra o percentual do download e a instalação sem abrir PowerShell. O Windows pode pedir permissão; ao concluir, o agente reabre automaticamente. Se a consulta, o download ou a verificação falhar, ele continua na versão atual; se a instalação falhar após fechar, tenta reabrir a versão instalada. Se não abrir, use o atalho **Comanda Xis Printer Agent**. Em homologação, peça à equipe responsável o novo artefato e instale manualmente; não há aviso automático. Se trocar de ambiente, pareie novamente. A atualização no mesmo ambiente mantém o pareamento e a fila pendente. {% hint style="info" %} Ficou com dúvida? No painel, pergunte ao **Chefe X**, o assistente no canto inferior direito da tela. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://ajuda.comandaxis.com.br/pedidos/configurar-impressora-agente.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.