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
- Vá a Origens → Endpoints de API e selecione Novo endpoint de API.
- Introduza um Nome, por exemplo “n8n faturas”.
- 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.
- 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ção | Valor |
|---|---|
| Method | POST |
| URL | o URL do endpoint https://www.sealedprint.com/api/print/sp_ep_… |
| Authentication | None |
| Send Query Parameters | ativado, com os parâmetros da secção seguinte, por exemplo name |
| Send Body | ativado |
| Body Content Type | n8n Binary File |
| Input Data Field Name | o 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âmetro | Significado | Valores |
|---|---|---|
name | Nome do trabalho na fila | texto com até 200 caracteres; “API job” se omitido |
copies | Número de cópias | 1 a 999 |
sides | Uma face ou frente e verso | one-sided, two-sided-long-edge, two-sided-short-edge |
colorMode | Cor | auto, color, monochrome |
media | Formato do papel como nome PWG | por exemplo iso_a4_210x297mm, iso_a5_148x210mm, iso_a3_297x420mm |
mediaSource | Tabuleiro de papel | nome do tabuleiro tal como a impressora o indica, por exemplo tray-2 |
orientation | Orientação | portrait, landscape, reverse-landscape, reverse-portrait |
quality | Qualidade de impressão | draft, normal, high |
pageRanges | Apenas algumas páginas | por exemplo 1-3,5 |
scaling | Escala | auto, auto-fit, fill, fit, none |
finishings | Acabamento, vários separados por vírgulas | por 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 targets | Efeito |
|---|---|
armazem | imprime no destino com o identificador armazem em vez do destino do endpoint |
armazem,escritorio | imprime nos dois destinos |
todas-as-impressoras | imprime 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âmetro | Significado |
|---|---|
destinationId | ID de um destino |
destinationIds | vários IDs de destinos separados por vírgulas; cada destino imprime o trabalho |
groupId | ID 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:
- Destinos no pedido:
targets,destinationId,destinationIdsougroupIdsubstituem o destino do endpoint para esse trabalho. - Rota do endpoint: se o pedido não indicar nenhum destino, aplica-se a rota escolhida no endpoint.
- 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:
- Crie um token em Definições → Tokens de API, consulte Tokens de API.
- Com um nó HTTP Request (Method
GET, Send Headers ativado, cabeçalhoAuthorizationcom o valorBearer sp_api_…), chame um destes endereços:https://www.sealedprint.com/api/destinationspara os destinos,https://www.sealedprint.com/api/destination-groupspara os grupos de destinos.
- Cada entrada tem um
ide umname. Copie oidpara 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:
| Nome | Valor |
|---|---|
name | Fatura {{ $json.number }} |
sides | two-sided-long-edge |
copies | 2 |
Guia de remessa para a impressora do armazém em vez do destino do endpoint:
| Nome | Valor |
|---|---|
targets | armazem |
Aviso em todas as impressoras de um grupo de destinos (plano Team):
| Nome | Valor |
|---|---|
targets | todas-as-impressoras |
colorMode | monochrome |
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
targetsnã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.