Intégrations e-commerce
Relier une boutique PrestaShop, WooCommerce ou votre propre site à Novadesko pour synchroniser le stock, les produits, les commandes et les factures.
Les intégrations e-commerce relient votre boutique en ligne à Novadesko : les commandes, les clients et les paiements arrivent dans Novadesko, et le stock et les prix de Novadesko repartent vers la boutique. Trois fiches sont proposées dans Intégrations : PrestaShop, WooCommerce et Novadesko Connect (pour un site que vous développez vous-même).
Les intégrations e-commerce demandent la formule E-commerce. Sans elle, la fiche affiche un bandeau qui le rappelle et les connexions restent inactives.
Ce que vous allez faire
- Télécharger le module PrestaShop ou l'extension WooCommerce depuis sa fiche.
- Connecter la boutique avec une clé API.
- Choisir qui fait foi pour le stock et le catalogue, et quand la facture est créée.
- Suivre la synchronisation dans le journal.
Ce qui est synchronisé
| Sens | Données |
|---|---|
| Boutique vers Novadesko | Commandes (bons de commande), clients, paiements (quand la commande passe « payée »), remboursements et avoirs (notes de crédit). |
| Novadesko vers boutique | Prix et stock disponible des produits, déclinaisons et variations comprises. |
| Les deux | Envoi du catalogue de la boutique vers Novadesko : les produits sont liés par référence ou EAN, et créés s'ils manquent. |
Le stock envoyé à la boutique est le stock disponible : stock réel moins les quantités réservées par les bons de commande ouverts. Le numéro et le PDF de la facture Novadesko s'affichent sur la fiche de la commande, dans PrestaShop comme dans WooCommerce.
Connecter une boutique PrestaShop ou WooCommerce
- Ouvrez Intégrations, puis la fiche PrestaShop ou WooCommerce.
- Dans le bloc du module, téléchargez le fichier ZIP (le numéro de version, le build et les nouveautés sont indiqués).
- Installez-le dans votre boutique : Modules > Téléverser un module dans PrestaShop, Extensions > Ajouter > Téléverser une extension dans WordPress.
- Dans la fiche Novadesko, créez une clé API. Le secret n'est affiché qu'une seule fois : copiez-le aussitôt.
- Collez la clé dans les réglages du module, dans votre boutique, et lancez la connexion.
- La boutique apparaît dans Boutiques connectées. Cliquez sur Modifier pour régler la synchronisation.
| Module | Compatibilité |
|---|---|
| PrestaShop « Novadesko Connect » | PrestaShop 8 et 9. |
| WooCommerce « Novadesko Connector » | WooCommerce récent, avec ou sans le stockage des commandes HPOS. |
Les réglages d'une boutique
| Réglage | Choix |
|---|---|
| Moment de la facture | Au paiement, à l'expédition, à la commande terminée, ou à la main. |
| Qui fait foi pour le stock | Novadesko (par défaut) ou la boutique. |
| Qui fait foi pour le catalogue | Novadesko (par défaut) ou la boutique. |
La facture suit la numérotation normale de votre entreprise. Une commande ne produit jamais deux factures, et aucune facture n'est envoyée automatiquement via Peppol. Une valeur refusée par la règle « qui fait foi » est notée conflit dans le journal.
La fiche permet aussi de mettre une connexion en pause, de la reprendre ou de la déconnecter, de révoquer une clé et de filtrer le journal de synchronisation.
Novadesko Connect, pour votre propre site
Novadesko Connect (anciennement « Shop Connect ») est l'API REST qui relie à Novadesko un site que vous développez vous-même. Elle couvre le stock (réel, réservé, disponible), les produits et variantes, les commandes, les clients, les paiements, les factures, les avoirs, les PDF et les webhooks signés.
- Ouvrez Intégrations > Novadesko Connect et créez une clé API.
- Suivez la documentation développeurs : web.novadesko.com/developers/connect (démarrage, authentification, référence, webhooks, exemples).
- Utilisez au besoin un SDK officiel : PHP, Laravel, Python ou JavaScript / Node. Ils se téléchargent depuis la documentation.
L'API accepte 300 requêtes par minute et par clé. Les webhooks sont regroupés (au plus un envoi toutes les 10 secondes par type) et mis en pause après une série d'échecs : surveillez le journal de la fiche.