Aller au contenu principal

Configuration

Une fois le module installé, il est nécessaire d'effectuer quelques réglages qui s'afficheront automatiquement à l'activation de celui-ci.

Le module est disponible aussi en anglais, il s'affichera en fonction de la langue de votre WordPress.

Capture d'écran de la page de configuration

Authentification​

astuce

Depuis la version 1.2.0 du module, l'authentification par clé API est la méthode recommandée. Si une clé API est renseignée, elle est utilisée en priorité ; l'ID de l'application et le mot de passe restent supportés.

L'authentification dépend de l'environnement choisi. Sélectionnez votre environnement ci-dessous pour obtenir les bonnes instructions.

info

Vous devez d'abord créer un compte développeur sur la production.

Clé API (recommandé) : créez une clé API depuis la page Clés API de votre compte Cocolis, puis renseignez-la dans le champ Clé API du module.

À défaut, vous pouvez utiliser l'authentification historique en renseignant les deux paramètres suivants :

  1. ID de l'application : Disponible une fois connecté à votre compte développeur sur www.cocolis.fr, dans le menu Intégration > Documentation de votre compte Cocolis.

  2. Mot de passe : Celui que vous avez utilisé lors de la création de votre compte. Si vous l'avez modifié depuis, utilisez tout de même le mot de passe initial.

Environnements​

Il existe deux environnements, l'environnement de test (sandbox) et l'environnement de production, vous pouvez en savoir plus ici.

Choisissez en fonction de votre utilisation le mode désiré.

Valeurs par défaut​

WooCommerce ne nous permettant pas de définir des valeurs par défaut pour tous les produits mis en ligne, certaines valeurs sont à renseigner.

Vos fiches produits doivent en temps normal comporter :

  • Le poids
  • La largeur
  • La longueur
  • La hauteur

Si certains produits sont absents de ces valeurs, le module ira chercher les valeurs par défaut définies dans la page de configuration du module, à appliquer pour les frais de livraison.

Expédition​

Pour calculer les frais de livraison, le module se base sur l'adresse d'expédition de votre entrepôt configuré dans WooCommerce nativement.

Numéro de téléphone​

Le numéro de téléphone du client et du vendeur est obligatoire pour le bon déroulé des livraisons.

info

Voici comment le rendre obligatoire dans WordPress : Rendre le numéro de téléphone obligatoire

Vous devez au préalable fournir un numéro de téléphone dans les paramètres du module dans le champ Téléphone.

Statut de commande pour la publication​

Depuis la version 1.3.0 du module, l'option « Statut de commande pour la publication » permet de choisir le statut de commande qui déclenche la création de l'annonce chez Cocolis.

La liste propose tous les statuts de commande de votre boutique, y compris les statuts personnalisés ajoutés par vos extensions. Par défaut, l'annonce est publiée au passage en « En cours » (processing), comme dans les versions précédentes.

info

Les développeurs peuvent aussi remplacer ce statut par code grâce au filtre cocolis_publish_order_status, qui est prioritaire sur l'option.

Configuration automatique des Webhooks​

Après avoir effectué toute la configuration et validé, les Webhooks se configureront automatiquement sans action de votre part.

En cas de changement de nom de domaine ou d'adresse IP, il suffit de revalider le formulaire et les modifications seront prises automatiquement en compte.

Cela veut dire qu'à chaque nouvelle étape de livraison, l'API de Cocolis vous enverra des "notifications" sous la forme de webhooks.

info

Depuis la version 1.2.0 du module, chaque webhook reçu est authentifié grâce à sa signature X-Cocolis-Signature : les requêtes non signées, falsifiées ou rejouées sont rejetées automatiquement.

Assurance​

L'assurance Cocolis est incluse automatiquement pour toutes les livraisons, sur la base de la valeur du panier. Depuis la version 1.2.0 du module, il n'existe plus de mode de livraison « avec assurance » distinct, et le client n'a plus d'informations supplémentaires à saisir au moment du paiement.