Aller au contenu
Printaya

Support

Questions fréquentes

Ce que font réellement Printaya et son agent aujourd'hui. Si votre question n'est pas là, écrivez-nous - elle finira probablement sur cette page.

Comprendre Printaya

Qu'est-ce que Printaya, en une phrase ?

Une API qui permet à votre application d'envoyer un document vers une imprimante physique située n'importe où, à travers un petit programme (l'agent) installé sur le poste Windows relié à cette imprimante.

En quoi c'est différent d'un pilote d'impression ?

Un pilote suppose que l'imprimante est sur le même réseau que la machine qui imprime. Printaya ne fait pas cette hypothèse : votre application tourne sur un serveur, l'imprimante est chez votre client, et les deux ne se voient jamais directement. Seul l'agent fait le lien.

Faut-il ouvrir un port ou installer un VPN chez le client ?

Non, et c'est le point central du produit. L'agent ouvre lui-même une connexion sortante vers Printaya et la garde ouverte. Rien n'entre depuis Internet vers le poste du client : aucune règle de pare-feu, aucune redirection de port, aucun VPN à maintenir.

Le document passe-t-il par vos serveurs ?

Le fichier est stocké le temps de l'impression, et c'est tout : l'ordre envoyé à l'agent ne contient jamais le document, seulement une adresse de téléchargement signée et valable 15 minutes.

Installer l'agent

Quelles versions de Windows sont prises en charge ?

Windows 10 et Windows 11, en 64 bits. L'agent utilise le spouleur d'impression de Windows, il n'existe pas de version macOS ou Linux.

Faut-il laisser une fenêtre ouverte sur le poste ?

Non. À la fin de la connexion, l'agent s'installe comme service Windows : il démarre avec le poste, tourne sans session ouverte, et la fenêtre d'installation se referme. Si vous refusez l'élévation Windows, l'agent continue dans la fenêtre - mais il s'arrête quand vous la fermez, et il vous le dit.

Windows affiche « Windows a protégé votre ordinateur ». Est-ce normal ?

Oui. L'exécutable n'est pas encore signé par un certificat d'éditeur, et SmartScreen avertit sur tout programme qu'il voit peu. Cliquez sur Informations complémentaires, puis Exécuter quand même.

Un poste peut-il servir plusieurs imprimantes ?

Oui, et c'est le cas normal : l'agent déclare tout seul l'inventaire des imprimantes du poste, puis le met à jour toutes les 30 minutes. Vous n'avez rien à déclarer à la main.

Combien de postes faut-il installer ?

Un par site physique où se trouvent des imprimantes. Plusieurs postes peuvent appartenir au même compte, et chacun a son propre jeton, révocable séparément.

Imprimantes et états

Mon imprimante n'apparaît pas dans le tableau de bord. Pourquoi ?

L'agent ne retient que les imprimantes dont il sait vérifier l'état par le réseau. Une imprimante en USB, ou installée par un port que l'agent ne sait pas interroger, est écartée. Le tableau de bord affiche sous chaque poste le compte rendu du scan : toutes les files vues, celles qui ont été écartées, et pour quelle raison.

Pourquoi l'état d'une imprimante ne vient-il pas de Windows ?

Parce que le spouleur Windows répond « prête » pour une imprimante éteinte depuis trois jours. Un état faux est pire qu'un état absent : il fait envoyer un document qui ne sortira jamais. L'agent teste donc l'imprimante sur le réseau, à son adresse, et ne déclare que ce qu'il a vérifié.

Que veulent dire les trois états ?

En ligne : vue et prête. Éteinte : vue, mais elle ne répond pas - elle reviendra d'elle-même. Plus détectée : le poste ne la déclare plus du tout (débranchée, supprimée de Windows) - aucune raison de revenir seule, il y a un geste à faire.

Pourquoi mes files « PDF » ou « Fax » ne sont-elles pas listées ?

Parce qu'elles ne produisent pas de papier. « Microsoft Print to PDF », « Fax », « OneNote » et leurs équivalents sont masqués : un document envoyé là n'arrive nulle part, et pire, une file PDF interactive bloque un poste sans écran.

Fiabilité des impressions

Que se passe-t-il si le poste est éteint au moment de l'envoi ?

Le document attend. Il est accepté, stocké, et mis en file. Dès que l'agent se reconnecte, il demande ce qui lui a échappé et imprime. Rien n'est perdu parce qu'un poste a redémarré.

Et si le réseau tombe pendant l'impression ?

L'agent garde les statuts qu'il n'a pas pu remonter dans un journal local et les rejoue dès que l'API répond. Vous recevez l'information en retard, mais vous la recevez.

Un document peut-il sortir deux fois ?

C'est le risque que tout le système est construit pour éviter, parce qu'une feuille sortie ne se rattrape pas. La prise en charge d'un document est exclusive : c'est la base de données qui arbitre, et un second agent qui tenterait le même document est refusé. Printaya ne réimprime jamais automatiquement.

Que veut dire le statut « à vérifier » ?

Que l'agent a pris un document en charge, puis a disparu avant de conclure (poste éteint en pleine impression, processus tué). Personne ne peut savoir si la feuille est sortie ou non - alors personne ne le devine. Vous allez regarder le bac, puis vous tranchez depuis le tableau de bord : le document est sorti, ou il n'est pas sorti. Dans le second cas, renvoyez le document depuis votre application : Printaya ne le conserve plus.

Comment éviter un doublon si mon application réessaie un envoi ?

En envoyant une idempotency_key de votre choix. Si Printaya a déjà vu cette clé pour votre compte, il renvoie le document existant au lieu d'en créer un second. C'est la protection à utiliser dans toute logique de réessai.

Intégration et API

Quelle est l'adresse de l'API ?

https://api.printaya.com. Elle ne changera pas : chaque agent installé et chaque application cliente la connaît.

Comment mon application s'authentifie-t-elle ?

Par un jeton porté dans l'en-tête Authorization: Bearer …. Vous les créez et les révoquez depuis l'écran Intégration du tableau de bord ; vous pouvez en avoir plusieurs, nommés, pour distinguer la production d'un script de test.

Quels formats et quelle taille de fichier ?

PDF, jusqu'à 50 Mo. Le PDF est le seul format dont le rendu ne dépend ni des polices ni de la version du logiciel installé sur le poste du client.

Comment suivre un document après son envoi ?

En interrogeant GET /api/v1/jobs/{id}, qui rend l'état courant. Il n'y a pas encore de notification par webhook.

Y a-t-il un bac à sable pour tester ?

Il n'y a pas d'environnement séparé. Pour un essai sans papier, créez un compte, installez l'agent sur votre propre poste et imprimez chez vous : c'est exactement le chemin que suivra votre client.

Sécurité et données

Où sont stockés les documents ?

Dans un stockage objet privé, jamais accessible publiquement. L'agent y accède par une adresse signée à durée limitée, émise pour ce document et ce poste.

Combien de temps gardez-vous les documents ?

Le temps de l'impression, pas une minute de plus. Dès qu'un document a un sort connu - imprimé, en échec, annulé, ou passé « à vérifier » - le fichier est supprimé du stockage. Il ne reste que la trace de l'impression (quoi, où, quand, par qui), jamais le document. La seule copie qui subsiste est la vôtre, dans votre application.

Un client peut-il voir les documents ou les postes d'un autre ?

Non. Chaque poste, imprimante, flux et document appartient à un compte, et toute demande portant sur ce qui n'appartient pas à l'appelant répond « introuvable » - sans même confirmer que la ressource existe.

Comment sont conservés les jetons ?

Les jetons d'agent ne sont stockés que sous forme d'empreinte : nous ne pouvons pas les relire, seulement les vérifier. Un jeton se révoque individuellement, sans toucher aux autres postes.

Que faire si un jeton a fuité ?

Révoquez-le depuis le tableau de bord et créez-en un autre : la coupure est immédiate, et les autres jetons du compte continuent de fonctionner.

Offre et support

Combien coûte Printaya ?

Il y a trois profils d'offre, détaillés sur la page des tarifs. La grille chiffrée, elle, n'est pas encore publiée : le service est en phase pilote, et ce sont les volumes réels des premiers partenaires qui décideront des paliers. En attendant, chaque offre se chiffre au cas par cas.

Puis-je héberger Printaya moi-même ?

Pas en libre-service. C'est l'offre installation dédiée : nous en discutons cas par cas, parce que le périmètre décide du prix autant que du délai. Décrivez votre contrainte dans votre message.

Comment obtenir de l'aide sur un problème précis ?

Par le formulaire de contact, en indiquant le nom du poste et, si vous l'avez, le compte rendu du scan affiché sous ce poste dans le tableau de bord : il dit exactement ce que l'agent voit, et fait gagner un aller-retour.

Pas de réponse à votre question ? Le guide d'intégration détaille les quatre étapes d'un premier document imprimé, et le formulaire de contact arrive directement chez nous.