Guides

Imprimer depuis n8n automatiquement avec le nœud HTTP Request

Imprimer des PDF depuis vos workflows n8n avec le nœud HTTP Request et Sealed Print, sans ouvrir de port. Tous les paramètres d’imprimante et d’impression.

Mis à jour le 21 octobre 2026

Beaucoup de workflows n8n produisent des documents dont quelqu’un aura besoin sur papier : factures de la boutique en ligne, bons de livraison pour l’entrepôt, étiquettes d’expédition, rapports pour la réunion d’équipe ou pièces jointes à viser. n8n n’a pas de nœud d’impression, et une imprimante du réseau du bureau n’est pas joignable depuis n8n Cloud ou depuis un serveur hébergé dans un centre de données. Cet article explique comment imprimer depuis n8n automatiquement avec le nœud standard HTTP Request et Sealed Print, sans redirection de port et sans script.

Comment fonctionne l’impression depuis n8n

Le workflow envoie le document en HTTPS à une URL secrète de Sealed Print, appelée point de terminaison API. Sealed Print en fait une tâche d’impression et la livre à l’imprimante :

  • par le client relais installé sur un ordinateur ou un NAS du bureau auquel l’imprimante est connectée,
  • directement aux imprimantes compatibles IPP INFRA, qui récupèrent elles-mêmes leurs tâches,
  • ou en IPP à une imprimante joignable depuis Internet.

Le client relais et les imprimantes INFRA n’établissent que des connexions sortantes. Rien n’est à ouvrir sur la box ou le routeur du bureau, et peu importe que n8n tourne dans le cloud, sur votre propre serveur ou sur un Raspberry Pi.

Prérequis

  • Un compte Sealed Print avec au moins une destination, c’est-à-dire une imprimante. Le guide Installer le client relais explique comment connecter une imprimante du bureau.
  • Un administrateur a activé le canal d’entrée REST API sous Paramètres → Canaux d’entrée. Il est désactivé par défaut.
  • Une version récente de n8n, en n8n Cloud ou auto-hébergée. Seul le nœud intégré HTTP Request est nécessaire, aucun nœud communautaire.
  • Le document est un PDF, un JPEG ou un PNG de 50 Mo au maximum.

Étape 1 : créer un point de terminaison API dans Sealed Print

  1. Allez dans Sources → Points de terminaison API et sélectionnez Nouveau point de terminaison API.
  2. Saisissez un Nom, par exemple « n8n factures ».
  3. Sous Cible, choisissez l’imprimante, le groupe de destinations ou le flux de travail qui doit recevoir les documents. Avec Cible par défaut, chaque tâche va à votre cible par défaut ; avec Aucune cible – garder dans Sealed Print, elle attend dans la file d’attente jusqu’à ce que quelqu’un la vérifie et l’envoie.
  4. Sélectionnez Créer et copiez l’URL du point de terminaison. Elle a cette forme : https://www.sealedprint.com/api/print/sp_ep_…

L’URL est la clé d’accès. Quiconque la connaît peut envoyer des documents à votre imprimante. Aucun jeton d’API ni mot de passe n’est nécessaire. Plus de détails dans le guide Points de terminaison API.

Étape 2 : fournir le document dans le workflow

Le nœud HTTP Request envoie un fichier issu des données binaires du nœud précédent. Sources fréquentes :

  • Gmail ou Microsoft Outlook avec les pièces jointes téléchargées (champ attachment_0),
  • Google Drive, Dropbox ou OneDrive avec l’opération de téléchargement d’un fichier (champ data),
  • un second HTTP Request qui récupère un PDF depuis votre boutique ou votre logiciel de comptabilité, avec Response Format réglé sur File,
  • Read/Write Files from Disk avec n8n auto-hébergé.

Notez le nom du champ binaire, en général data. Il apparaît dans la sortie du nœud sous Binary.

Étape 3 : configurer le nœud HTTP Request de n8n

Après le nœud qui fournit le document, ajoutez un nœud HTTP Request et réglez-le ainsi :

ParamètreValeur
MethodPOST
URLvotre URL de point de terminaison https://www.sealedprint.com/api/print/sp_ep_…
AuthenticationNone
Send Query Parametersactivé, avec les paramètres de la section suivante, par exemple name
Send Bodyactivé
Body Content Typen8n Binary File
Input Data Field Namele nom du champ binaire, par exemple data

n8n envoie le fichier comme corps de la requête et déduit le Content-Type du type MIME du fichier. S’il indique seulement application/octet-stream, comme pour certains téléchargements, activez Send Headers et définissez l’en-tête content-type sur application/pdf, image/jpeg ou image/png.

Exécutez le nœud une fois. Sealed Print répond par HTTP 201 et renvoie la tâche créée en JSON, avec notamment id, number, name et state. La tâche apparaît aussitôt dans la File d’attente de Sealed Print. Vous pouvez réutiliser ces champs dans la suite du workflow, par exemple pour inscrire le numéro de tâche dans votre CRM.

L’appel correspond à cette commande curl :

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

Paramètres de requête : nom, options d’impression et destination

Tous les paramètres sont facultatifs. Saisissez-les sous Query Parameters avec un nom et une valeur. Les valeurs peuvent venir de nœuds précédents, par exemple {{ $json.invoiceNumber }}.

Nom et options d’impression

ParamètreSignificationValeurs
nameNom de la tâche dans la file d’attentetexte de 200 caractères au plus ; « API job » par défaut
copiesNombre d’exemplaires1 à 999
sidesRecto ou recto versoone-sided, two-sided-long-edge, two-sided-short-edge
colorModeCouleurauto, color, monochrome
mediaFormat de papier (nom PWG)par exemple iso_a4_210x297mm, iso_a5_148x210mm, iso_a3_297x420mm
mediaSourceBac à papiernom du bac tel que l’imprimante le signale, par exemple tray-2
orientationOrientationportrait, landscape, reverse-landscape, reverse-portrait
qualityQualité d’impressiondraft, normal, high
pageRangesSeulement certaines pagespar exemple 1-3,5
scalingMise à l’échelleauto, auto-fit, fill, fit, none
finishingsFinition, plusieurs séparées par des virgulespar exemple staple, staple-top-left, punch, fold

Sealed Print adapte les options à l’appareil. Si une imprimante ne sait pas faire quelque chose, par exemple le recto verso, elle imprime quand même la tâche avec ce qu’elle sait faire.

Où va la tâche

Le plus simple pour diriger une tâche est le paramètre targets. Il prend les identifiants de destinations et de groupes de destinations, séparés par des virgules. L’identifiant figure dans Sealed Print dans la colonne Identifiant sous Cibles et sur chaque groupe. C’est le même nom court que dans l’URL d’imprimante …/ipp/print/<token>/<identifiant> et dans les adresses e-mail avec +<identifiant>.

Valeur de targetsEffet
entrepotimprime sur la destination d’identifiant entrepot au lieu de la destination du point de terminaison
entrepot,bureauimprime sur les deux destinations
toutes-imprimantesimprime sur toutes les imprimantes du groupe de destinations toutes-imprimantes

Pour un identifiant inconnu, Sealed Print répond par HTTP 404 et le cite dans la réponse.

Au lieu des identifiants, vous pouvez aussi passer des ID :

ParamètreSignification
destinationIdID d’une destination
destinationIdsplusieurs ID de destinations séparés par des virgules ; chaque destination imprime la tâche
groupIdID d’un groupe de destinations ; toutes les imprimantes du groupe impriment la tâche

Les ID ne changent jamais, même si quelqu’un renomme une destination. Les identifiants sont plus lisibles et se copient directement depuis l’interface.

Sealed Print décide dans cet ordre :

  1. Destinations de la requête : targets, destinationId, destinationIds ou groupId remplacent la destination du point de terminaison pour cette seule tâche.
  2. Cible du point de terminaison : si la requête n’indique aucune destination, la destination, le groupe ou le flux de travail choisi sur le point de terminaison s’applique.
  3. Cible par défaut : si le point de terminaison est réglé sur Cible par défaut, la tâche va à la cible par défaut de la personne à qui appartient le point de terminaison, sinon à celle de l’organisation. Voir Votre cible par défaut.

Plusieurs destinations dans une requête et les groupes de destinations font partie de l’offre Team. Sans elle, Sealed Print répond par HTTP 402. Le fonctionnement des groupes est décrit dans Groupes de destinations.

Le plus simple : un point de terminaison par destination

Si un workflow imprime toujours sur la même imprimante, aucun paramètre n’est nécessaire. Créez un point de terminaison par destination, par exemple « n8n entrepôt » pour l’imprimante d’étiquettes et « n8n comptabilité » pour l’imprimante du bureau, puis utilisez l’URL correspondante dans le workflow. Un nœud Switch peut aiguiller vers différents nœuds HTTP Request selon le type de document.

Trouver les ID des destinations et des groupes

Pour targets, l’identifiant de l’interface suffit. Les ID pour destinationId et groupId sont fournis par la REST API avec un jeton d’API :

  1. Créez un jeton sous Paramètres → Jetons d’API, voir Jetons d’API.
  2. Avec un nœud HTTP Request (Method GET, Send Headers activé, en-tête Authorization avec la valeur Bearer sp_api_…), appelez l’une de ces adresses :
    • https://www.sealedprint.com/api/destinations pour les destinations,
    • https://www.sealedprint.com/api/destination-groups pour les groupes de destinations.
  3. Chaque entrée a un id et un name. Copiez l’id dans le paramètre.

Le jeton d’API ne sert qu’à la consultation. Pour imprimer, l’URL du point de terminaison suffit, car les jetons d’API ne peuvent pas soumettre de tâches eux-mêmes.

Exemples

Facture en recto verso, deux exemplaires :

NomValeur
nameFacture {{ $json.number }}
sidestwo-sided-long-edge
copies2

Bon de livraison vers l’imprimante de l’entrepôt au lieu de la destination du point de terminaison :

NomValeur
targetsentrepot

Affiche sur toutes les imprimantes d’un groupe de destinations (offre Team) :

NomValeur
targetstoutes-imprimantes
colorModemonochrome

Imprimante selon le document : l’identifiant peut venir d’un nœud précédent, par exemple {{ $json.site === "Lyon" ? "entrepot-lyon" : "entrepot" }}.

Variante : formulaire au lieu d’un corps binaire

Au lieu d’envoyer le fichier comme corps de la requête, vous pouvez envoyer un formulaire. Réglez Body Content Type sur Form-Data, ajoutez un paramètre de type n8n Binary File nommé file et passez les options comme champs supplémentaires, par exemple name et copies. Important : avec un formulaire, Sealed Print lit les options dans les champs du formulaire, pas dans les paramètres de requête. Le fichier doit avoir un nom se terminant par .pdf, .jpg ou .png si n8n n’envoie pas de type MIME adapté.

Erreurs et leur signification

  • HTTP 400 : une option a une valeur invalide, par exemple sides=duplex. La réponse indique le champ.
  • HTTP 402 : plusieurs destinations ou un groupe de destinations sans l’offre Team.
  • HTTP 403 : le canal d’entrée REST API est désactivé, ou la personne à qui appartient le point de terminaison a quitté l’organisation.
  • HTTP 404 : l’URL est erronée ou a été remplacée avec Générer une nouvelle URL, ou un identifiant de targets n’existe pas. La réponse cite alors l’identifiant.
  • HTTP 413 : le fichier dépasse 50 Mo ou la taille autorisée par votre offre.
  • HTTP 415 : le fichier n’est ni un PDF, ni un JPEG, ni un PNG, ou le Content-Type manque. Définissez l’en-tête comme décrit à l’étape 3.

Attention à Retry On Fail dans les réglages du nœud : chaque appel réussi crée une nouvelle tâche. Si la connexion coupe alors que Sealed Print a déjà accepté la tâche, une nouvelle tentative imprime le document une deuxième fois. En cas de doute, vérifiez la File d’attente.

La même méthode fonctionne depuis tout programme capable d’envoyer une requête HTTP, voir le cas d’usage API d’impression.

Questions fréquentes

n8n a-t-il un nœud d’impression ?

Non. n8n ne fournit pas de nœud d’impression. Avec le nœud intégré HTTP Request, vous envoyez le document à un service d’impression cloud comme Sealed Print, qui le livre à l’imprimante. Il existe des nœuds communautaires, mais ils supposent en général que l’imprimante est sur le même réseau que n8n.

Est-ce que cela fonctionne avec n8n Cloud ?

Oui. Le workflow appelle seulement une adresse HTTPS. L’imprimante reste au bureau et récupère la tâche par le client relais ou en IPP INFRA. n8n et l’imprimante n’ont pas besoin d’être sur le même réseau.

Faut-il ouvrir un port sur le routeur du bureau ?

Non. Le client relais et les imprimantes INFRA n’établissent que des connexions sortantes vers Sealed Print. Aucune connexion entrante vers le réseau du bureau n’est nécessaire.

Comment imprimer sur plusieurs imprimantes depuis un même workflow ?

Soit avec un point de terminaison API par imprimante, soit avec le paramètre de requête targets et l’identifiant de l’imprimante pour chaque tâche. Avec l’identifiant d’un groupe de destinations, toutes les imprimantes du groupe impriment la même tâche.

Comment savoir si le document a été imprimé ?

Dans la file d’attente de Sealed Print, qui affiche le statut de livraison de chaque tâche. Dans le workflow, vous pouvez interroger la tâche à l’adresse https://www.sealedprint.com/api/jobs/<id> avec un jeton d’API ; l’id figure dans la réponse à la demande d’impression. Le champ state indique alors completed.

Combien coûte l’impression depuis n8n ?

Sealed Print facture par livraison, c’est-à-dire par tâche envoyée à une imprimante. Les offres sont détaillées sur la page Tarifs. n8n est en général gratuit en auto-hébergement avec la Community Edition, tandis que n8n Cloud a ses propres offres payantes.

Print and sign from anywhere

Les signataires signent par lien e-mail sans compte ; chacun reçoit le PDF scellé. Avec Free, vous payez uniquement par signature.

Autres guides et modèles