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
- Allez dans Sources → Points de terminaison API et sélectionnez Nouveau point de terminaison API.
- Saisissez un Nom, par exemple « n8n factures ».
- 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.
- 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ètre | Valeur |
|---|---|
| Method | POST |
| URL | votre URL de point de terminaison https://www.sealedprint.com/api/print/sp_ep_… |
| Authentication | None |
| Send Query Parameters | activé, avec les paramètres de la section suivante, par exemple name |
| Send Body | activé |
| Body Content Type | n8n Binary File |
| Input Data Field Name | le 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ètre | Signification | Valeurs |
|---|---|---|
name | Nom de la tâche dans la file d’attente | texte de 200 caractères au plus ; « API job » par défaut |
copies | Nombre d’exemplaires | 1 à 999 |
sides | Recto ou recto verso | one-sided, two-sided-long-edge, two-sided-short-edge |
colorMode | Couleur | auto, color, monochrome |
media | Format de papier (nom PWG) | par exemple iso_a4_210x297mm, iso_a5_148x210mm, iso_a3_297x420mm |
mediaSource | Bac à papier | nom du bac tel que l’imprimante le signale, par exemple tray-2 |
orientation | Orientation | portrait, landscape, reverse-landscape, reverse-portrait |
quality | Qualité d’impression | draft, normal, high |
pageRanges | Seulement certaines pages | par exemple 1-3,5 |
scaling | Mise à l’échelle | auto, auto-fit, fill, fit, none |
finishings | Finition, plusieurs séparées par des virgules | par 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 targets | Effet |
|---|---|
entrepot | imprime sur la destination d’identifiant entrepot au lieu de la destination du point de terminaison |
entrepot,bureau | imprime sur les deux destinations |
toutes-imprimantes | imprime 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ètre | Signification |
|---|---|
destinationId | ID d’une destination |
destinationIds | plusieurs ID de destinations séparés par des virgules ; chaque destination imprime la tâche |
groupId | ID 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 :
- Destinations de la requête :
targets,destinationId,destinationIdsougroupIdremplacent la destination du point de terminaison pour cette seule tâche. - 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.
- 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 :
- Créez un jeton sous Paramètres → Jetons d’API, voir Jetons d’API.
- Avec un nœud HTTP Request (Method
GET, Send Headers activé, en-têteAuthorizationavec la valeurBearer sp_api_…), appelez l’une de ces adresses :https://www.sealedprint.com/api/destinationspour les destinations,https://www.sealedprint.com/api/destination-groupspour les groupes de destinations.
- Chaque entrée a un
idet unname. Copiez l’iddans 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 :
| Nom | Valeur |
|---|---|
name | Facture {{ $json.number }} |
sides | two-sided-long-edge |
copies | 2 |
Bon de livraison vers l’imprimante de l’entrepôt au lieu de la destination du point de terminaison :
| Nom | Valeur |
|---|---|
targets | entrepot |
Affiche sur toutes les imprimantes d’un groupe de destinations (offre Team) :
| Nom | Valeur |
|---|---|
targets | toutes-imprimantes |
colorMode | monochrome |
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
targetsn’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-Typemanque. 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.