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

Cochez au minimum les droits suivants pour chaque ressource :

Commandes (Orders)

• ✅ Voir
• ✅ Modifier

Clients (Customers)

• ✅ Voir

Addresses

• ✅ Voir

Transporteurs (carriers)

• ✅ Voir

Produits (Products)

• ✅ Voir

Catégories (Categories)

• ✅ Voir

Taxes (Taxes)

• ✅ Voir

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

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.