Installer PrestaShop

Prérequis

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

• Votre PrestaShop est à jour (version 1.7.x recommandée)
• 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
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

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 configuration fonctionne :

1. Testez l'accès à l'API : https://votre-boutique.com/api/
2. Vous devriez voir une page XML avec les informations de l'API
3. Si vous obtenez une erreur, vérifiez que :
   • Le webservice est bien activé
   • Votre site est accessible
   • Les permissions sont correctement configurées

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

Note : Une fois cette configuration terminée, vous pourrez passer à l'étape suivante : la configuration du connecteur dans Order Invoicer.