Order Invoicer
Woocommerce

WooCommerce pour Sellsy

Configurez un connecteur Sellsy pour WooCommerce

Vue d'ensemble

Cette intégration permet de synchroniser automatiquement vos commandes WooCommerce vers Sellsy, transformant vos commandes e-commerce en factures, devis, bons de commande ou bons de livraison selon vos besoins.

Fonctionnalités principales

  • Synchronisation en temps réel : Les nouvelles commandes sont récupérées instantanément
  • Réconciliation intelligente : Clients et produits existants sont automatiquement liés
  • Gestion des taxes : Les informations de taxes WooCommerce sont préservées
  • Workflows configurables : Choisissez les types de documents à créer dans Sellsy
  • Support multiboutique : Compatible avec les configurations WooCommerce multiples

Installation

Inscription et connexion

  1. Créez votre compte sur Order Invoicer
  2. Connectez-vous à votre espace client

Note : L'inscription est gratuite et vous permet de tester l'intégration.

Créer un nouveau connecteur

  1. Dans votre dashboard, cliquez sur "Ajouter un connecteur"
  2. Sélectionnez "WooCommerce" comme plateforme e-commerce
  3. Sélectionnez "Sellsy" comme logiciel de facturation
  4. Cliquez sur "Créer le connecteur"

Important : Cette étape crée la base de votre intégration. Vous pourrez modifier les paramètres plus tard.

Configurer WooCommerce

  1. URL de votre boutique : Entrez l'URL complète de votre WooCommerce (ex: https://votre-boutique.com)
  2. Clé consommateur : Entrez la clé consommateur générée dans WooCommerce
  3. Clé secrète : Entrez la clé secrète générée dans WooCommerce
  4. Cliquez sur "Tester la connexion" pour vérifier l'accès
  5. Cliquez sur "Enregistrer" pour valider la configuration

Vérification : Assurez-vous que l'URL se termine bien par votre domaine (sans / final).

Configurer Sellsy

Il est très fortement recommandé que l'utilisateur qui configure cette étape soit un administateur du compte Sellsy, afin d'avoir automatiquement toutes les permissions nécessaires au connecteur.

Sinon veuillez vous assurer que le profil de privilèges du collaborateur possède au moins les permissions suivantes :

  • Clients / Niveau de visualisation des clients : Tous
  • Clients / Créer des clients
  • Contacts / Niveau de visualisation des contacts : Tous
  • Contacts / Créer des contacts
  • Facturation / Accès au module Facturation
  • Facturation / Niveau de visualisation des factures : Toutes
  • Facturation / Créer des factures
  • Facturation / Valider des factures
  • Facturation / Niveau de visualisation des avoirs : Tous
  • Facturation / Créer des avoirs
  • Facturation / Valider des avoirs
  • Facturation / Niveau de visualisation des bons de commande : Tous
  • Facturation / Créer des bons de commande
  • Facturation / Autoriser la création des bons de commande pour un client ayant une facture en retard
  • Facturation / Niveau de visualisation des modèles : Tous
  • Facturation / Autoriser à ajouter des lignes simples dans les documents
  • Catalogue / Créer des produits et services
  • Catalogue / Modifier des produits et services
  • Catalogue / Gestion des déclinaisons

Voir les profils de privilèges sur Sellsy

Cliquez sur "Connecter Sellsy" et accepter les droits.

Note : La configuration Sellsy est identique pour toutes les plateformes e-commerce.

Activer vos workflows

Une fois l'application Sellsy installée, vous serez redirigé automatiquement à cette étape.

Attention à la date de démarrage de vos flux (par défault, la date de configuration du connecteur).

Nous recommandons de générer des "brouillons" plutôt que des factures finalisées pendant la phase de test

Vous pouvez configurer :

  • Le propriétaire du document (par défaut, l'utilisateur qui a configuré Sellsy)
  • Un modèle de document
  • Une catégorie tarifaire

Il vous manque un réglage qui vous semble indispensable ? Veuillez nous contacter par mail à contact@orderinvoicer.com.

Il est nécessaire d'activer au moins un flux pour passer à l'étape suivante.

Workflows recommandés pour WooCommerce

Workflow 1 - Création de factures (Recommandé)

  • Convertit automatiquement les commandes en factures Sellsy
  • Déclenchement configurable selon le statut de commande
  • Envoi automatique des factures par email

Workflow 2 - Création de bons de commande

  • Pousse les commandes vers Sellsy en tant que bons de commande
  • Utile pour la gestion des stocks et la préparation

Workflow 3 - Création de devis

  • Convertit les commandes en devis Sellsy
  • Idéal pour les commandes en attente de validation

Workflow 7 - Création de bons de livraison

  • Génère automatiquement les bons de livraison
  • Parfait pour la logistique et l'expédition

Activer votre abonnement

Pour le moment veuillez contacter contact@orderinvoicer.com pour activer votre abonnement.

Note : Nous proposons différents plans adaptés à votre volume de commandes.

Vérifier la conversion de vos commandes

Les conversions sont effectuées en instantanées (au pire quelques minutes d'attente).

Réconciliation automatique

Clients

  • Les clients déjà présents sur Sellsy sont réconciliés automatiquement par e-mail
  • Les nouveaux clients sont créés automatiquement dans Sellsy
  • Les informations de contact sont préservées

Produits

  • Les produits déjà présents sur Sellsy sont réconciliés automatiquement par la référence (Sellsy) et le SKU (WooCommerce)
  • Les nouveaux produits sont créés automatiquement dans Sellsy
  • Les informations de prix et de stock sont synchronisées
  • Important : Le SKU doit contenir au minimum 2 caractères pour être synchronisé

Taxes

  • Les informations de taxes sont récupérées à partir de WooCommerce
  • Veuillez vous assurer qu'elles sont configurées correctement dans WooCommerce
  • Les taux de TVA sont préservés dans Sellsy

Configuration avancée

Paramètres de synchronisation

Fréquence de synchronisation

  • Nouvelles commandes : Instantanée (webhook)
  • Mises à jour : Toutes les 5 minutes
  • Synchronisation manuelle : Disponible via le dashboard

Gestion des erreurs

  • Les commandes en erreur sont marquées dans le dashboard
  • Les tentatives de reconversion sont automatiques
  • Les logs d'erreur sont disponibles pour le diagnostic

Personnalisation des workflows

Conditions de déclenchement

Vous pouvez configurer quand déclencher chaque workflow :

  • Commande confirmée : Dès que la commande est validée
  • Commande payée : Après réception du paiement
  • Commande expédiée : Après mise à jour du statut d'expédition
  • Commande complétée : Une fois la commande finalisée

Mappage des statuts

Configurez la correspondance entre les statuts WooCommerce et Sellsy :

  • WooCommerceSellsy
  • En attente → Brouillon
  • Expédiée → Expédiée
  • Complétée → Finalisée

Configuration multiboutique

Si vous utilisez WooCommerce en mode multiboutique :

  1. Créer un connecteur par boutique : Chaque boutique nécessite sa propre configuration
  2. Clés API distinctes : Utilisez des clés API différentes pour chaque boutique
  3. Workflows personnalisés : Adaptez les workflows selon les besoins de chaque boutique

Intégration avec des plugins

Plugins de paiement

Order Invoicer est compatible avec les principaux plugins de paiement WooCommerce :

  • Stripe
  • PayPal
  • Square
  • Et bien d'autres...

Plugins de livraison

  • Les informations de livraison sont préservées
  • Les frais de livraison sont inclus dans les factures
  • Les méthodes de livraison sont synchronisées

Dépannage

Problèmes courants

Synchronisation ne fonctionne pas

  • Vérifiez que les clés API sont correctes
  • Assurez-vous que WooCommerce est activé
  • Vérifiez les permissions de l'utilisateur API

Clients non réconciliés

  • Vérifiez que les emails correspondent entre WooCommerce et Sellsy
  • Assurez-vous que les clients existent dans Sellsy
  • Vérifiez la casse des emails

Produits non réconciliés

  • Vérifiez que les références/SKU correspondent
  • Assurez-vous que les produits existent dans Sellsy
  • Vérifiez la configuration des références

Erreurs de taxes

  • Vérifiez la configuration des taxes dans WooCommerce
  • Assurez-vous que les taux de TVA sont corrects
  • Vérifiez la configuration des règles de taxes

Webhooks non fonctionnels

  • Vérifiez que les permaliens WordPress sont configurés
  • Désactivez temporairement les plugins de sécurité
  • Vérifiez la configuration du serveur web

Logs et diagnostics

Accéder aux logs

  1. Dans votre dashboard, allez dans "Paramètres"
  2. Cliquez sur "Logs"
  3. Consultez les erreurs et avertissements

Informations de diagnostic

  • Dernière synchronisation : Heure de la dernière récupération
  • Commandes en attente : Nombre de commandes en cours de traitement
  • Erreurs récentes : Détails des dernières erreurs
  • Statut des webhooks : État des webhooks WooCommerce

Bonnes pratiques

Préparation des données

Avant la première synchronisation

  • Vérifiez que vos clients Sellsy ont des emails valides
  • Assurez-vous que vos produits Sellsy ont des références uniques
  • Vérifiez la configuration des taxes

Maintenance continue

  • Surveillez régulièrement les logs d'erreur
  • Vérifiez la qualité des données synchronisées
  • Testez les workflows après les mises à jour

Performance

Optimisation WooCommerce

  • Maintenez votre WordPress et WooCommerce à jour
  • Optimisez votre base de données WordPress
  • Utilisez un cache pour améliorer les performances

Optimisation Sellsy

  • Organisez vos produits avec des références claires
  • Maintenez vos clients à jour
  • Utilisez les modèles de documents pour standardiser

Sécurité

Gestion des clés API

  • Changez régulièrement vos clés API
  • Utilisez des descriptions claires pour vos clés
  • Désactivez les clés non utilisées
  • Surveillez l'utilisation de vos clés API

Configuration HTTPS

  • Utilisez HTTPS pour toutes les communications
  • Vérifiez que votre certificat SSL est valide
  • Configurez les redirections HTTPS correctement

Support

Ressources d'aide

  1. Documentation : Consultez cette documentation pour les questions courantes
  2. Support technique : Contactez contact@orderinvoicer.com pour l'assistance
  3. Communauté : Rejoignez notre communauté d'utilisateurs

Contact

  • Email : contact@orderinvoicer.com
  • Réponse : Sous 24h en jours ouvrables
  • Urgences : Support prioritaire pour les clients actifs

Métadonnées des commandes

Order Invoicer ajoute automatiquement des métadonnées à vos commandes WooCommerce pour maintenir la traçabilité avec Sellsy.

Métadonnées ajoutées

Chaque commande traitée reçoit des meta_data contenant les URLs des documents générés dans Sellsy :

  • orderinvoicer.invoice_url - URL de la facture Sellsy
  • orderinvoicer.order_url - URL du bon de commande Sellsy
  • orderinvoicer.estimate_url - URL du devis Sellsy
  • orderinvoicer.creditnote_url - URL de la note de crédit Sellsy
  • orderinvoicer.delivery_url - URL du bon de livraison Sellsy
  • orderinvoicer.proforma_url - URL du document proforma Sellsy

Accès aux métadonnées

Dans l'interface WordPress :

  1. Allez dans WooCommerce > Commandes
  2. Cliquez sur une commande traitée
  3. Dans l'onglet Données personnalisées, vous verrez les métadonnées Order Invoicer

Via l'API REST :

GET /wp-json/wc/v3/orders/{id}

Via PHP :

$order = wc_get_order($order_id);
$invoice_url = $order->get_meta('orderinvoicer.invoice_url');

En savoir plus : Consultez notre documentation complète sur les métadonnées pour plus de détails.

Configuration

Vous pouvez à tout moment modifier les réglages du connecteur via votre dashboard Order Invoicer.

Note : Les modifications de configuration sont appliquées immédiatement pour les nouvelles commandes.