Guias

Imprimir a partir do n8n automaticamente com o nó HTTP Request

Imprima PDF a partir de workflows do n8n com o nó HTTP Request e o Sealed Print, sem abrir portas. Com todos os parâmetros de impressora e de impressão.

Atualizado a 21 de outubro de 2026

Muitos workflows do n8n produzem documentos que, no fim, alguém precisa em papel: faturas da loja online, guias de remessa para o armazém, etiquetas de envio, relatórios para a reunião de equipa ou anexos de email que têm de ser visados. O n8n não tem um nó próprio para imprimir, e uma impressora na rede do escritório não é acessível a partir do n8n Cloud nem de um servidor num centro de dados. Este artigo mostra como imprimir a partir do n8n automaticamente com o nó padrão HTTP Request e o Sealed Print, sem abrir portas e sem escrever scripts.

Como funciona imprimir a partir do n8n

O workflow envia o documento por HTTPS para um URL secreto do Sealed Print, chamado endpoint de API. O Sealed Print cria com ele um trabalho de impressão e entrega-o à impressora:

  • através do cliente relay num computador ou NAS do escritório onde a impressora está instalada,
  • diretamente a impressoras compatíveis com IPP INFRA, que vão buscar os trabalhos sozinhas,
  • ou por IPP a uma impressora acessível a partir da internet.

O cliente relay e as impressoras INFRA só abrem ligações de saída. Não é preciso abrir nada no router do escritório, e não importa se o n8n corre na cloud, num servidor próprio ou num Raspberry Pi.

Pré-requisitos

  • Uma conta no Sealed Print com pelo menos um destino, ou seja, uma impressora. O guia Instalar o cliente relay explica como ligar uma impressora do escritório.
  • Um administrador ativou o canal de entrada REST API em Definições → Canais de entrada. Está desativado por predefinição.
  • Uma versão atual do n8n, no n8n Cloud ou alojada pelo próprio. Basta o nó integrado HTTP Request, sem nós da comunidade.
  • O documento é um PDF, JPEG ou PNG com 50 MB no máximo.

Passo 1: criar um endpoint de API no Sealed Print

  1. Vá a Origens → Endpoints de API e selecione Novo endpoint de API.
  2. Introduza um Nome, por exemplo “n8n faturas”.
  3. Em Rota, escolha a impressora, o grupo de destinos ou o fluxo de trabalho para onde os documentos devem ir. Com Rota predefinida, cada trabalho vai para a sua rota predefinida; com Sem rota – manter no Sealed Print, aguarda na fila até alguém o verificar e enviar.
  4. Selecione Criar e copie o URL do endpoint. Tem este aspeto: https://www.sealedprint.com/api/print/sp_ep_…

O URL é a chave de acesso. Quem o conhecer pode enviar documentos para a sua impressora. Não é necessário um token de API nem uma palavra-passe. Mais detalhes no guia Endpoints de API.

Passo 2: disponibilizar o documento no workflow

O nó HTTP Request envia um ficheiro a partir dos dados binários do nó anterior. Origens habituais:

  • Gmail ou Microsoft Outlook com os anexos descarregados (campo attachment_0),
  • Google Drive, Dropbox ou OneDrive com a operação de descarregar um ficheiro (campo data),
  • um segundo HTTP Request que descarrega um PDF da loja ou do programa de faturação, com Response Format definido como File,
  • Read/Write Files from Disk no n8n alojado pelo próprio.

Tome nota do nome do campo binário, normalmente data. Aparece na saída do nó, em Binary.

Passo 3: configurar o nó HTTP Request do n8n

A seguir ao nó que fornece o documento, adicione um nó HTTP Request e configure-o assim:

DefiniçãoValor
MethodPOST
URLo URL do endpoint https://www.sealedprint.com/api/print/sp_ep_…
AuthenticationNone
Send Query Parametersativado, com os parâmetros da secção seguinte, por exemplo name
Send Bodyativado
Body Content Typen8n Binary File
Input Data Field Nameo nome do campo binário, por exemplo data

O n8n envia o ficheiro como corpo do pedido e define o Content-Type a partir do tipo MIME do ficheiro. Se indicar apenas application/octet-stream, o que acontece com alguns downloads, ative Send Headers e defina o cabeçalho content-type como application/pdf, image/jpeg ou image/png.

Execute o nó uma vez. O Sealed Print responde com HTTP 201 e devolve o trabalho criado em JSON, com campos como id, number, name e state. O trabalho aparece de imediato na Fila do Sealed Print. Estes campos podem ser usados mais à frente no workflow, por exemplo para registar o número do trabalho no CRM.

O pedido corresponde a este comando curl:

curl -X POST "https://www.sealedprint.com/api/print/sp_ep_…?name=Fatura%201042&sides=two-sided-long-edge" \
  -H "Content-Type: application/pdf" \
  --data-binary @fatura-1042.pdf

Parâmetros de consulta: nome, opções de impressão e destino

Todos os parâmetros são opcionais. Introduza-os em Query Parameters como nome e valor. Os valores podem vir de nós anteriores, por exemplo {{ $json.invoiceNumber }}.

Nome e opções de impressão

ParâmetroSignificadoValores
nameNome do trabalho na filatexto com até 200 caracteres; “API job” se omitido
copiesNúmero de cópias1 a 999
sidesUma face ou frente e versoone-sided, two-sided-long-edge, two-sided-short-edge
colorModeCorauto, color, monochrome
mediaFormato do papel como nome PWGpor exemplo iso_a4_210x297mm, iso_a5_148x210mm, iso_a3_297x420mm
mediaSourceTabuleiro de papelnome do tabuleiro tal como a impressora o indica, por exemplo tray-2
orientationOrientaçãoportrait, landscape, reverse-landscape, reverse-portrait
qualityQualidade de impressãodraft, normal, high
pageRangesApenas algumas páginaspor exemplo 1-3,5
scalingEscalaauto, auto-fit, fill, fit, none
finishingsAcabamento, vários separados por vírgulaspor exemplo staple, staple-top-left, punch, fold

O Sealed Print adapta as opções ao dispositivo. Se uma impressora não suportar algo, como frente e verso, imprime o trabalho na mesma com o que consegue fazer.

Para onde vai o trabalho

A forma mais simples de encaminhar um trabalho é o parâmetro targets. Aceita os identificadores de destinos e de grupos de destinos, vários separados por vírgulas. O identificador aparece no Sealed Print na coluna Identificador em Rotas → Destinos e em cada grupo. É o mesmo nome curto do URL da impressora …/ipp/print/<token>/<identificador> e dos endereços de email com +<identificador>.

Valor de targetsEfeito
armazemimprime no destino com o identificador armazem em vez do destino do endpoint
armazem,escritorioimprime nos dois destinos
todas-as-impressorasimprime em todas as impressoras do grupo de destinos todas-as-impressoras

Se um identificador não existir, o Sealed Print responde com HTTP 404 e indica-o na resposta.

Em vez de identificadores, também é possível indicar IDs:

ParâmetroSignificado
destinationIdID de um destino
destinationIdsvários IDs de destinos separados por vírgulas; cada destino imprime o trabalho
groupIdID de um grupo de destinos; todas as impressoras do grupo imprimem o trabalho

Os IDs nunca mudam, mesmo que alguém mude o nome de um destino. Os identificadores são mais fáceis de ler e copiam-se diretamente da interface.

O Sealed Print decide por esta ordem:

  1. Destinos no pedido: targets, destinationId, destinationIds ou groupId substituem o destino do endpoint para esse trabalho.
  2. Rota do endpoint: se o pedido não indicar nenhum destino, aplica-se a rota escolhida no endpoint.
  3. Rota predefinida: se o endpoint estiver em Rota predefinida, o trabalho vai para a rota predefinida da pessoa a quem o endpoint pertence ou, caso não exista, para a da organização. Consulte A sua rota predefinida.

Vários destinos num pedido e os grupos de destinos fazem parte do plano Team. Sem ele, o Sealed Print responde com HTTP 402. O funcionamento dos grupos está descrito em Grupos de destinos.

O mais simples: um endpoint por destino

Se um workflow imprime sempre na mesma impressora, não é preciso nenhum parâmetro. Crie um endpoint para cada destino, por exemplo “n8n armazém” para a impressora de etiquetas e “n8n contabilidade” para a impressora do escritório, e use o URL correspondente no workflow. Um nó Switch pode encaminhar para diferentes nós HTTP Request consoante o tipo de documento.

Obter os IDs de destinos e grupos

Para targets, basta o identificador da interface. Os IDs para destinationId e groupId são devolvidos pela REST API com um token de API:

  1. Crie um token em Definições → Tokens de API, consulte Tokens de API.
  2. Com um nó HTTP Request (Method GET, Send Headers ativado, cabeçalho Authorization com o valor Bearer sp_api_…), chame um destes endereços:
    • https://www.sealedprint.com/api/destinations para os destinos,
    • https://www.sealedprint.com/api/destination-groups para os grupos de destinos.
  3. Cada entrada tem um id e um name. Copie o id para o parâmetro.

O token de API só serve para consultar. Para imprimir basta o URL do endpoint, porque os tokens de API não podem submeter trabalhos.

Exemplos

Fatura em frente e verso, duas cópias:

NomeValor
nameFatura {{ $json.number }}
sidestwo-sided-long-edge
copies2

Guia de remessa para a impressora do armazém em vez do destino do endpoint:

NomeValor
targetsarmazem

Aviso em todas as impressoras de um grupo de destinos (plano Team):

NomeValor
targetstodas-as-impressoras
colorModemonochrome

Impressora consoante o documento: o identificador pode vir de um nó anterior, por exemplo {{ $json.local === "Porto" ? "armazem-porto" : "armazem" }}.

Alternativa: formulário em vez de corpo binário

Em vez de enviar o ficheiro como corpo do pedido, é possível enviar um formulário. Defina Body Content Type como Form-Data, adicione um parâmetro do tipo n8n Binary File com o nome file e indique as opções como campos adicionais, por exemplo name e copies. Importante: com um formulário, o Sealed Print lê as opções dos campos do formulário, não dos parâmetros de consulta. O ficheiro precisa de um nome terminado em .pdf, .jpg ou .png se o n8n não enviar um tipo MIME adequado.

Erros e o que significam

  • HTTP 400: uma opção tem um valor inválido, por exemplo sides=duplex. A resposta indica o campo.
  • HTTP 402: vários destinos ou um grupo de destinos sem o plano Team.
  • HTTP 403: o canal de entrada REST API está desativado, ou a pessoa a quem o endpoint pertence saiu da organização.
  • HTTP 404: o URL está errado ou foi substituído com Gerar novo URL, ou um identificador em targets não existe. Nesse caso, a resposta indica o identificador.
  • HTTP 413: o ficheiro tem mais de 50 MB ou excede o que o plano permite.
  • HTTP 415: o ficheiro não é um PDF, JPEG ou PNG, ou falta o Content-Type. Defina o cabeçalho como descrito no passo 3.

Atenção ao Retry On Fail nas definições do nó: cada chamada bem-sucedida cria um novo trabalho. Se a ligação cair depois de o Sealed Print já ter aceitado o trabalho, uma nova tentativa imprime o documento uma segunda vez. Em caso de dúvida, verifique a Fila.

O mesmo método funciona com qualquer programa que consiga enviar um pedido HTTP; consulte o caso de utilização API de impressão.

Perguntas frequentes

O n8n tem um nó para imprimir?

Não. O n8n não inclui um nó de impressão. Com o nó integrado HTTP Request, o documento é enviado para um serviço de impressão na cloud como o Sealed Print, que o entrega à impressora. Existem nós da comunidade para imprimir, mas em geral exigem que a impressora esteja na mesma rede que o n8n.

Funciona com o n8n Cloud?

Sim. O workflow só chama um endereço HTTPS. A impressora fica no escritório e vai buscar o trabalho através do cliente relay ou por IPP INFRA. O n8n e a impressora não precisam de estar na mesma rede.

É preciso abrir uma porta no router do escritório?

Não. O cliente relay e as impressoras INFRA só abrem ligações de saída para o Sealed Print. Não são necessárias ligações de entrada na rede do escritório.

Como imprimir em várias impressoras a partir do mesmo workflow?

Com um endpoint de API por impressora, ou com o parâmetro de consulta targets e o identificador da impressora em cada trabalho. Com o identificador de um grupo de destinos, todas as impressoras do grupo imprimem o mesmo trabalho.

Como saber se o documento foi impresso?

Na fila do Sealed Print, que mostra o estado de entrega de cada trabalho. No workflow, é possível consultar o trabalho em https://www.sealedprint.com/api/jobs/<id> com um token de API; o id vem na resposta ao pedido de impressão. O campo state indica então completed.

Quanto custa imprimir a partir do n8n?

O Sealed Print cobra por entrega, ou seja, por trabalho enviado a uma impressora. Os planos estão na página de preços. O próprio n8n é em geral gratuito quando alojado pelo próprio com a Community Edition, e o n8n Cloud tem planos pagos próprios.

Print and sign from anywhere

Os signatários assinam por ligação de e-mail sem conta; todos recebem o PDF selado. No Free paga apenas por assinatura.

Mais guias e modelos