Installer PrestaShop

Prérequis

Avant de commencer l'installation, assurez-vous que :

• Vous utilisez PrestaShop 1.6 ou une version ultérieure — toutes les versions, de la 1.6 aux dernières 8.x et 9.x, sont prises en charge (nous recommandons de maintenir votre boutique à jour)
• Vous avez accès au back-office administrateur
• Votre site est accessible via HTTPS

Générer une clé d'accès API dans PrestaShop

Pour utiliser l'API Webservice de PrestaShop avec Order Invoicer, vous devez d'abord activer la fonctionnalité puis générer une clé d'accès sécurisée.

1. Activer le Webservice

1. Accédez au back office PrestaShop avec vos identifiants administrateur
2. Naviguez vers Paramètres avancés > Webservice (libellé Web service sur PrestaShop 1.6)
3. Activez l'option Activer le service web de PrestaShop en sélectionnant "Oui"
4. Cliquez sur Enregistrer pour valider les modifications

Important : L'activation du webservice est nécessaire pour que Order Invoicer puisse récupérer vos commandes et données clients.

2. Créer une clé d'accès sécurisée

1. Toujours dans Paramètres avancés > Webservice, cliquez sur Ajouter une nouvelle clé webservice
2. Configurez la clé avec les paramètres suivants :

Configuration de base

• Clé : Cliquez sur Générer pour obtenir une clé unique de 32 caractères (ou saisissez-en une personnalisée)
• Description de la clé : Ajoutez une description claire (ex: "Order Invoicer - Intégration Sellsy")
• Statut : Activez la clé en sélectionnant "Activé"

Permissions requises

Order Invoicer vérifie ces permissions à la connexion et refuse la configuration si l'une manque. Cochez au minimum Voir (GET) pour chaque ressource ci-dessous :

• ✅ addresses — adresses de facturation et de livraison
• ✅ carriers — transporteurs utilisés sur les commandes
• ✅ combinations — déclinaisons produit (tailles, couleurs, etc.)
• ✅ countries — pays des adresses client
• ✅ currencies — devises des commandes
• ✅ customers — clients
• ✅ order_details — lignes de commande
• ✅ order_payments — paiements des commandes
• ✅ order_slip — avoirs / remboursements
• ✅ orders — commandes
• ✅ products — produits
• ✅ shops — boutiques (nécessaire pour identifier votre installation)
• ✅ taxes — taxes appliquées aux commandes

Astuce : dans l'écran PrestaShop, utilisez le lien Tout cocher en haut de la colonne Voir (GET) pour gagner du temps, puis décochez uniquement les ressources dont vous ne voulez pas exposer l'accès.

Permissions optionnelles

Nécessaires uniquement si vous utilisez ces fonctionnalités :

• stock_availables — Voir + Modifier (PUT) si vous synchronisez les stocks depuis votre outil de facturation vers PrestaShop
• customer_threads, customer_messages, contacts — Voir + Ajouter (POST) si vous souhaitez que Order Invoicer crée des tickets de service client lors d'événements de facturation
• groups — Voir (GET) si vous utilisez les groupes de clients PrestaShop comme grilles tarifaires et souhaitez les synchroniser sur vos clients (affichés sur les commandes). Sans cette permission, la synchronisation fonctionne quand même — les groupes sont simplement ignorés.
• tax_rule_groups, tax_rules — Voir (GET) pour enregistrer le taux de TVA que votre boutique applique réellement, au lieu de le déduire des montants de la commande. Sans ces permissions, la synchronisation fonctionne quand même — le taux est déduit des totaux.

Configuration multiboutique (si applicable)

• Association de boutique : En mode multiboutique, choisissez les boutiques auxquelles la clé donne accès
• Si vous avez plusieurs boutiques, sélectionnez uniquement celles que vous souhaitez connecter

3. Cliquez sur Enregistrer pour créer la clé

3. Récupérer les informations de connexion

Après avoir créé la clé, notez les informations suivantes :

• URL de votre boutique : https://votre-boutique.com
• Clé API : La clé générée (32 caractères)

Important : Gardez ces informations en sécurité. Vous en aurez besoin pour configurer le connecteur dans Order Invoicer.

Vérification de la configuration

Test de l'API

Pour vérifier que votre clé fonctionne, interrogez une ressource unique avec celle-ci — la clé se passe dans le paramètre de requête ws_key :

https://votre-boutique.com/api/orders?ws_key=VOTRE_CLE&limit=1

Vous devriez obtenir une réponse XML contenant une commande. Si vous obtenez :

• 401 ou 403 : la clé est désactivée ou ne dispose pas du droit Voir (GET) sur cette ressource — vérifiez le statut de la clé et ses permissions.
• une erreur sur https://votre-boutique.com/api/ (la racine) : cela ne signifie pas à soi seul que la clé est cassée. Sur de nombreuses installations, la racine du webservice renvoie une 500 ou une page HTML alors que les endpoints de ressources fonctionnent parfaitement ; testez donc toujours une ressource précise comme ci-dessus plutôt que l'URL /api/ seule.

Dépannage courant

Erreur "Webservice non activé"

• Vérifiez que le webservice est activé dans Paramètres avancés
• Redémarrez le cache PrestaShop si nécessaire

Erreur "Clé API invalide"

• Vérifiez que la clé est exactement de 32 caractères
• Assurez-vous que la clé est active
• Vérifiez les permissions accordées

Erreur "Accès refusé"

• Vérifiez que l'URL de votre boutique est correcte
• Assurez-vous que votre site est accessible en HTTPS
• Vérifiez les permissions de la clé API

Erreur "Missing permissions: …" Order Invoicer indique précisément les ressources manquantes. Retournez sur la clé webservice et cochez Voir (GET) pour chacune des ressources listées, puis relancez la configuration.

Support

Si vous rencontrez des difficultés :

1. Vérifiez la section de dépannage ci-dessus
2. Consultez la documentation officielle PrestaShop
3. Contactez notre support : contact@orderinvoicer.com

Étapes suivantes

Une fois votre clé configurée et le connecteur créé dans Order Invoicer :

• Installez le module PrestaShop pour une synchronisation quasi instantanée des commandes (optionnel).
• Désactivez les factures PrestaShop afin que votre outil de facturation gère la numérotation des factures.