Printags pour PrestaShop
Module PrestaShop pour vendre vos cartes PVC et NFC personnalisées
Votre client dépose le visuel de sa carte sur la fiche produit. La commande payée part chez Printags, qui l'imprime et l'expédie à votre client. Le numéro de suivi revient sur la commande PrestaShop.
Version 1.0.0 · PrestaShop 8.1, 8.2 et 9 · licence AFL-3.0 · S'installe avec le fichier zip, sans passer par PrestaShop Addons
Ce que fait le module
Que fait le module Printags dans votre boutique PrestaShop ?
Le visuel est déposé sur la fiche produit
Un bloc du module reçoit le fichier : PNG, JPEG ou PDF jusqu'à 25 Mo, envoyé directement du navigateur du client vers Printags, avec un aperçu et le contrôle des proportions de la carte (89,6 × 57,98 mm). PrestaShop garde seulement l'identifiant du fichier, dans la personnalisation de la ligne du panier.
Un lien encodé dans la puce NFC
Le client peut indiquer un lien à encoder dans la puce. Le verrouillage de la puce en lecture seule est une option par produit, désactivée par défaut et irréversible.
La commande payée devient une commande Printags
Quand la commande passe dans un statut payé, le module demande un devis à Printags et vérifie votre solde, puis crée la commande ferme. Jamais en double, et renvoyée automatiquement après une erreur réseau.
Le suivi revient sur la commande
Le numéro de suivi est inscrit sur le transporteur de la commande, comme depuis le back-office, en temps réel par webhook ou à chaque passage de la tâche cron. Par défaut, le client reçoit l'e-mail « en cours de livraison » et la commande passe en « Expédié ».
Un mode Test sur le bac à sable
En mode Test, les commandes sont créées sur le bac à sable Printags : ni facturées ni fabriquées. Le mode Test et le mode Production ont chacun leur connexion.
Une copie de la boutique n'envoie rien
La connexion est liée à l'adresse de la boutique. Sur une copie (préproduction), aucune commande ne part chez Printags et la connexion d'origine reste intacte.
Prérequis
De quoi avez-vous besoin pour installer le module ?
- PrestaShop 8.1, 8.2 ou 9
- PHP 7.2.5 ou plus récent, PHP 8.1 ou plus récent pour PrestaShop 9
- Une boutique servie en https
- Une tâche cron qui appelle une adresse toutes les 5 minutes, conseillée
- Un compte Printags avec un abonnement actif
- Interface du module en français, anglais, allemand, espagnol et italien
Les cartes commandées par le module sont facturées au tarif du plan de votre compte Printags, et débitées du solde du compte à chaque commande envoyée.
Installation
Comment installer et connecter le module PrestaShop ?
1
Téléchargez le module
Le fichier printags-prestashop.zip, avec le bouton en haut de cette page. Ne le décompressez pas.
2
Installez-le dans PrestaShop
Modules > Gestionnaire de modules, puis « Installer un module ». Déposez le fichier zip ou sélectionnez-le : PrestaShop installe le module.
3
Ouvrez la configuration du module
Cliquez sur « Configurer » à la fin de l'installation, ou sur le module Printags dans le gestionnaire de modules.
4
Choisissez le mode Test et enregistrez
Le module démarre en mode Production. Choisissez Test : les commandes passent par le bac à sable Printags et ne sont ni facturées ni fabriquées. Enregistrez avant de vous connecter, la connexion s'applique au mode choisi.
5
Cliquez sur « Connecter Printags »
Aucune clé API à copier : la connexion passe par une autorisation OAuth sur Printags. La boutique doit être en https.
6
Autorisez la boutique dans votre tableau de bord Printags
Connectez-vous à votre compte Printags et approuvez la connexion. En mode Production, seuls le propriétaire du compte et ses administrateurs peuvent connecter une boutique. De retour dans PrestaShop, la configuration affiche le compte connecté et son solde.
7
Déclarez vos produits Printags
Section « Produits Printags », « Ajouter ou modifier un produit » : indiquez l'ID du produit PrestaShop, choisissez le produit Printags dans le catalogue (le modèle de carte) et, si besoin, l'emballage. Cochez « Verrouiller la puce après encodage » seulement si la puce ne doit plus jamais être réécrite. Le bloc de dépôt du visuel apparaît alors sur la fiche du produit.
8
Programmez la tâche cron
La section « Envoi et suivi » affiche une adresse à appeler toutes les 5 minutes depuis le cron de votre serveur : c'est elle qui envoie les commandes payées. Sans cron, l'option « Envoyer aussi les commandes en attente après les pages du back-office », active par défaut, les envoie au plus toutes les 5 minutes tant que quelqu'un utilise le back-office.
9
Passez une commande de test
Commandez ce produit sur votre boutique en déposant un visuel, puis passez la commande dans un statut payé. La note « Printags : commande de TEST créée » apparaît sur la page de la commande dans le back-office.
10
Passez en Production
Choisissez le mode Production, enregistrez, puis cliquez à nouveau sur « Connecter Printags » : chaque mode a sa propre connexion. Les commandes payées sont alors imprimées, expédiées et facturées.
Questions fréquentes
Le module Printags pour PrestaShop
Comment les cartes commandées par le module sont-elles facturées ?
Au tarif du plan de votre compte Printags. Le montant est débité du solde prépayé du compte à chaque commande envoyée, après le devis que le module demande à Printags.
Que se passe-t-il si le solde de mon compte Printags est insuffisant ?
La commande n'est pas envoyée et reste en attente. Son statut PrestaShop ne change pas, votre client ne reçoit donc aucun e-mail. Une note indique le total et le solde, et un e-mail part à l'adresse de la boutique. Rechargez le compte, puis cliquez sur « Envoyer à Printags » sur la page de la commande ou dans la liste « Commandes en attente de votre action » de la configuration du module.
Une commande annulée ou remboursée dans PrestaShop est-elle annulée chez Printags ?
Pas automatiquement une fois envoyée : une note et un e-mail vous préviennent, et vous l'annulez depuis votre tableau de bord Printags si elle ne doit pas être fabriquée. Les cartes remboursées avant l'envoi ne sont pas commandées.
Les commandes en paiement à la livraison sont-elles envoyées à Printags ?
Oui, une fois payées : quand la commande passe en « Paiement accepté » ou « Livré », ou avec « Envoyer à Printags ». Le module ps_cashondelivery est reconnu d'office, d'autres modules de paiement à la livraison s'ajoutent dans les réglages. L'option « Envoyer automatiquement les commandes payées à la livraison », désactivée par défaut, les envoie sans attendre : votre solde Printags est alors débité avant que votre client paie.
Où va le fichier de mon client, et quelles données reçoit Printags ?
Le visuel part directement du navigateur du client vers Printags, par un lien signé à usage unique : il n'est pas stocké sur votre serveur et PrestaShop ne garde que l'identifiant du fichier. Une fois la commande payée, Printags reçoit les lignes de commande, l'identifiant du visuel, le lien NFC et l'adresse de livraison (nom, adresse, téléphone, e-mail) pour imprimer et expédier les cartes.
Faut-il une tâche cron ?
C'est conseillé : une tâche cron qui appelle toutes les 5 minutes l'adresse affichée dans la configuration du module envoie les commandes payées et relève le suivi. Si le module Gestionnaire de tâches cron (cronjobs) est installé, la tâche y est aussi enregistrée, toutes les heures. Sans cron, les commandes partent au plus toutes les 5 minutes pendant que quelqu'un utilise le back-office.
Ma boutique doit-elle être joignable depuis internet ?
Pour le suivi en temps réel, oui : Printags appelle un webhook sur votre boutique, en https. Sans webhook, la tâche cron relève le statut des commandes ouvertes toutes les heures.
Puis-je utiliser le module sur une copie de ma boutique ?
La connexion est liée à l'adresse de la boutique sur laquelle elle a été faite. Sur une copie (préproduction), aucune commande n'est envoyée et la connexion d'origine n'est ni rafraîchie ni révoquée. Si la boutique a vraiment changé d'adresse, connectez Printags de nouveau.
Le module est-il sur PrestaShop Addons ?
Non. Il s'installe avec le fichier zip de cette page : Modules > Gestionnaire de modules, « Installer un module ».
Vos premières cartes vendues depuis PrestaShop
Installez le module, connectez votre compte en mode Test et passez une commande d'essai avant d'ouvrir la vente.