WooCommerce

Paramétrage

Connecter un site WooCommerce à Dokos : clés d'API, webhooks, valeurs par défaut, taxes, livraison, stock et clients.

Paramétrer l'intégration WooCommerce

Le connecteur crée dans Dokos une commande client pour chaque commande passée sur WooCommerce. Il crée le client, son adresse et les articles s'ils n'existent pas encore. Il peut aussi créer la facture, le paiement et le bon de livraison, et renvoyer les niveaux de stock à WooCommerce.

Vous pouvez connecter plusieurs sites WooCommerce au même site Dokos. Créez un document Paramètres WooCommerce par site.

Prérequis

  • L'application WooCommerce installée sur votre site Dokos. Voir Introduction.
  • Un accès administrateur au site WordPress / WooCommerce.
  • Les articles, l'entrepôt, la liste de prix et les comptes de taxe à utiliser, créés dans Dokos.

Générer la clé et le secret de l'API WooCommerce

  1. Dans la barre latérale de WordPress, cliquez sur WooCommerce > Réglages.
  2. Cliquez sur l'onglet Avancé, puis sur API REST.

  1. Cliquez sur Ajouter une clé. Donnez les droits Lecture/Écriture, puis cliquez sur Générer la clé API.

  1. Copiez la clé client et le secret client. WooCommerce ne les affiche qu'une fois.

Créer les paramètres WooCommerce

  1. Dans l'espace WooCommerce, ouvrez Paramètres WooCommerce et créez un document.
  2. Dans l'onglet Informations générales, cochez Activer la synchronisation.
  3. Renseignez l'URL du serveur WooCommerce, par exemple https://boutique.example.com/.
  4. Collez la clé client dans Clé API publique et le secret client dans Clé API secrète.
  5. Dans l'onglet Valeurs par défaut, renseignez les champs obligatoires :
    ChampRôle
    Entrepôt par défautEntrepôt des lignes de commande et de la synchronisation du stock.
    Séries à utiliser pour les commandesSérie de numérotation des commandes client créées.
    Liste de prixListe de prix des commandes client.
    SociétéSociété des commandes client.
    Centre de coûtsCentre de coûts des commandes client.
    Groupe de clientsGroupe donné aux clients créés depuis WooCommerce.
    Unité de poidsUnité de poids utilisée par WooCommerce.
    Unité de mesure par défautUnité des articles créés depuis WooCommerce.
    Livrer après (Jours)Facultatif. Délai de la date de livraison des commandes. Sans valeur, Dokos prend 7 jours.
  6. Enregistrez.

À l'enregistrement, Dokos :

  • génère le Secret et remplit le Point de terminaison (l'URL qui reçoit les webhooks) ;
  • crée dans WooCommerce les webhooks des commandes, des clients, des produits et des coupons (création, modification, suppression et restauration) ;
  • ajoute aux clients, commandes, articles et adresses un champ WooCommerce ID propre à ce site WooCommerce. Il ajoute aussi à l'article une case Sync with WooCommerce.

Si un webhook ne peut pas être créé, Dokos affiche la liste des sujets en échec. Le bouton Générer un secret remplace le secret. Les webhooks qui utilisent l'ancien secret ne fonctionnent plus.

Voir les paramètres WooCommerce dans la démo

Compléter les comptes, la livraison et les statuts

Après le premier enregistrement, de nouveaux onglets apparaissent.

  1. Dans l'onglet Détails comptables, cliquez sur Obtenir les comptes de taxe. Pour chaque taxe WooCommerce, choisissez le compte de taxe Dokos.
  2. Dans l'onglet Livraison, cliquez sur Obtenir les méthodes de livraison. Pour chaque méthode, choisissez le compte de frais de port. Renseignez aussi le Compte de frais : Dokos y passe les frais ajoutés à la commande WooCommerce.
  3. Vérifiez le tableau Statuts d'expédition. Dokos crée le bon de livraison quand la commande WooCommerce prend un de ces statuts. Par défaut : shipped, completed, lpc_transit et lpc_delivered.
  4. Si vos prix WooCommerce sont saisis TTC, cochez Les prix sont enregistrés TTC sur WooCommerce.
  5. Dans la section Arrondi, choisissez un Compte d'arrondi. Dokos y passe l'écart entre le total WooCommerce et le total de la commande client, dans la limite de la Tolérance d'arrondi (0,05 par défaut). Au-delà, la commande passe en erreur.

Paramètres de synchronisation

ChampRôle
Créer les factures et les paiementsCoché par défaut. Dokos crée la facture et le paiement quand la commande WooCommerce est payée.
Synchroniser les niveaux de stockDokos envoie le stock de l'entrepôt par défaut à WooCommerce.
Synchroniser sur la base deQté projectée (par défaut) ou Qté actuelle.
Fuseau horaire du site WooCommerceFuseau horaire des dates reçues de WooCommerce. Sans valeur, Dokos prend UTC.
Précision de la deviseNombre de décimales des prix dans les commandes et les factures.
Passerelle de paiement StripeSection Paramètres Stripe. Pour une commande payée par Stripe sur WooCommerce, Dokos lit les frais Stripe de la commande. Il passe le paiement au montant net et les frais sur le compte de frais de cette passerelle.

L'onglet Métadonnées relie une métadonnée de commande WooCommerce à un champ de la commande client Dokos.

Suivre les commandes reçues

Chaque commande reçue crée une Commande WooCommerce. Son statut indique où en est le traitement :

StatutSignification
En attenteLa commande est reçue, mais pas encore traitée.
Commande créeeLa commande client est créée.
Commande mise à jourLa commande client a été mise à jour à partir de WooCommerce.
ErreurLe traitement a échoué. Le message est dans le champ Message d'erreur.
FerméLa commande est annulée sur WooCommerce.

Les cases Commande créee, Facture créée, Paiement créé et Bon de livraison créé montrent les documents déjà créés.

Dokos rejoue les commandes à intervalles réguliers :

  • toutes les heures, les commandes En attente et Commande créee, et les commandes modifiées sur WooCommerce ;
  • chaque jour, les commandes en Erreur ;
  • chaque semaine, les commandes incomplètes de plus d'un mois.

Quand une commande est modifiée sur WooCommerce, Dokos annule et recrée la commande client, si elle n'est ni livrée ni facturée. Une commande annulée sur WooCommerce annule la commande client.

Synchroniser les articles

Le menu Actions des Paramètres WooCommerce propose deux synchronisations :

  • Get WooCommerce products crée dans Dokos les produits publiés sur WooCommerce. Dokos récupère aussi chaque heure les produits modifiés.
  • Pousser les articles dans WooCommerce envoie à WooCommerce les articles où la case Sync with WooCommerce est cochée.

Synchroniser le stock

Si Synchroniser les niveaux de stock est coché, la mise à jour a lieu :

  1. à chaque mouvement de stock d'un article de l'entrepôt par défaut ;
  2. chaque heure, pour les articles modifiés récemment.

Si l'article est une variante, Dokos met aussi à jour son modèle. Le stock du modèle est la somme des stocks de ses variantes actives.

Synchroniser les stocks des variations de produits

Pour les variations de produits WooCommerce, créez dans Dokos un modèle d'article et ses variantes. Chaque variante doit porter l'ID de la variation WooCommerce. Le modèle doit porter l'ID du produit parent.

Synchroniser les clients

Dans l'onglet Clients, ajoutez des lignes au tableau Groupes de clients à synchroniser. Dokos envoie alors chaque heure à WooCommerce les clients de ces groupes. Le bouton Actions > Envoyer les clients dans WooCommerce lance l'envoi tout de suite.

  • Synchroniser le numéro de TVA envoie le numéro de TVA du client.
  • Synchroniser les rôles donne à l'utilisateur WordPress le rôle de la ligne. Il faut alors renseigner le Nom d'utilisateur pour l'API et le Mot de passe d'application de WordPress.

Créer les webhooks à la main

Dokos crée les webhooks à l'enregistrement. Si la création échoue, créez-les dans WooCommerce :

  1. Dans WordPress, ouvrez WooCommerce > Réglages > Avancé > Webhooks, puis cliquez sur Ajouter un webhook.
  2. Donnez un nom au webhook et choisissez le statut Actif.
  3. Choisissez le sujet, par exemple Commande créée.
  4. Dans URL de livraison, collez le Point de terminaison des Paramètres WooCommerce.
  5. Dans Secret, collez le Secret des Paramètres WooCommerce.
  6. Gardez la version de l'API et enregistrez.
  7. Recommencez pour Commande mise à jour, et pour les autres sujets utiles.