Shopify

L'application Dokos Shopify connecte une boutique Shopify à Dokos. Elle crée dans Dokos les commandes client des commandes Shopify, puis les factures, les paiements, les bons de livraison et les avoirs. Elle envoie aussi à Shopify le stock, les produits et les clients B2B.

Vous pouvez connecter plusieurs boutiques. Créez un document Shopify Settings par boutique.

Prérequis

• L'application Dokos Shopify installée sur le site. Voir Installer une application.
• Un accès administrateur à la boutique Shopify.
• L'entrepôt, la liste de prix, le centre de coûts et les groupes de clients à utiliser, créés dans Dokos.

Créer l'application dans Shopify

1. Dans l'administration Shopify, ouvrez Paramètres > Applications et canaux de vente > Développer des applications.
2. Cliquez sur Créer une application, par exemple « Dokos ».
3. Dans Configuration > Intégration de l'API Admin, donnez les droits suivants : read_orders, write_orders, read_products, write_products, read_inventory, write_inventory, read_customers, write_customers et read_locations.
4. Installez l'application. Copiez le jeton d'accès de l'API Admin (shpat_…) et la clé secrète de l'API (shpss_…).

Configurer la boutique dans Dokos

1. Dans l'espace Shopify, ouvrez Shopify Settings et créez un document.
2. Dans l'onglet General Details, renseignez :

   Champ	Contenu
   Shopify URL	Adresse de la boutique, par exemple https://ma-boutique.myshopify.com.
   Admin API Access Token	Jeton d'accès de l'API Admin (shpat_…).
   Webhook Secret	Clé secrète de l'API (shpss_…). Dokos vérifie avec elle chaque webhook reçu.
   Shopify API Version	Version de l'API Shopify. Par défaut : 2026-04.

3. Dans l'onglet Defaults, renseignez les champs obligatoires : Default Warehouse, Sales Order Series, Price List, Company, Cost Center et Customer Group.
4. Facultatif : renseignez le B2B Customer Group et les B2B Customer Tags (par défaut B2B, Pro).
5. Dans l'onglet Accounting & Sync, vérifiez les options :

   Champ	Rôle
   Create Payments and Sales Invoices	Coché par défaut. Dokos crée la facture et le paiement des commandes payées.
   Create Delivery Notes on Fulfillment	Coché par défaut. Dokos crée le bon de livraison quand la commande est expédiée sur Shopify.
   Default Shipping Account	Compte des frais de port. Sans valeur, Dokos prend le premier compte de taxe de la société.
   Rounding Adjustment Account	Compte qui reçoit l'écart entre le total Shopify et le total Dokos.
   Rounding Tolerance	Écart maximum passé sur le compte d'arrondi. Par défaut : 0,05.

   
   Dans la section Taxes, le tableau Tax Accounts associe chaque taxe Shopify à un compte de taxe de la société :

   Colonne	Rôle
   Shopify Tax Title	Le nom de la taxe dans Shopify, par exemple TVA. Obligatoire. Les majuscules et les espaces au début et à la fin ne comptent pas.
   Tax Rate	Le taux en %. Facultatif : vide, la ligne vaut pour tous les taux de ce nom.
   Tax Account	Le compte de taxe de la société. Obligatoire.

   
   Dokos cherche d'abord une ligne avec le même nom et le même taux, puis une ligne avec le même nom et sans taux. Sans ligne correspondante, la taxe va sur le premier compte de taxe de la société.
6. Cochez Enable Sync et enregistrez.
7. Cliquez sur Actions > Test Connection pour vérifier l'accès à Shopify.

À l'enregistrement, Dokos remplit la Webhook Delivery URL et déclare chez Shopify les webhooks orders/create, orders/updated et refunds/create. Il ajoute aussi aux clients, articles et commandes des champs propres à cette boutique, dont la case de synchronisation de l'article.

Si les webhooks ne peuvent pas être créés, déclarez-les dans Shopify avec l'adresse suivante :

https://{votre_site}/api/method/dokos_shopify.dokos_shopify.api.webhooks.receive

Suivre les commandes

Chaque commande reçue crée une Shopify Order. Son statut est Pending, Order Created, Order Updated, Error ou Closed. Les cases Order Created, Sales Invoice Created, Payment Created et Delivery Note Created montrent les documents déjà créés. En cas d'erreur, le message est dans Error Message.

Dokos traite chaque commande ainsi :

1. Il crée ou retrouve le client. Un client avec un nom de société, ou avec l'étiquette b2b ou pro, est créé comme société dans le B2B Customer Group. Une commande sans client ni adresse est rattachée à un client invité.
2. Il crée la commande client.
3. Si la commande est payée, il crée la facture et le paiement.
4. Si la commande est expédiée, totalement ou en partie, il crée le bon de livraison.
5. Si la commande est remboursée, il crée un avoir sur la facture. Si elle est annulée, il passe la commande client au statut Clôturé.

Dokos rejoue les commandes en erreur chaque heure et chaque jour. Pour récupérer les commandes récentes à la main, cliquez sur Actions > Sync Orders (Shopify ➔ Dokos).

Synchroniser les produits et le stock

• Actions > Sync Products (Shopify ➔ Dokos) crée dans Dokos les produits de Shopify.
• Actions > Push Products (Dokos ➔ Shopify) envoie à Shopify les articles synchronisés, avec leurs variantes et leurs prix.

Si Synchronize Stock Levels est coché (par défaut), Dokos envoie le stock de l'entrepôt par défaut à Shopify. L'envoi a lieu à chaque mouvement de stock et chaque heure. Synchronize Based On choisit Actual Qty (par défaut) ou Projected Qty. Dokos garde l'emplacement Shopify utilisé dans Shopify Location ID.

Synchroniser les clients B2B

Chaque heure, Dokos envoie à Shopify les clients du B2B Customer Group. Sans ce groupe, il envoie les clients de type société. Le bouton Actions > Push B2B Customers (Dokos ➔ Shopify) lance l'envoi tout de suite.

Limites

• Une taxe Shopify sans ligne dans Tax Accounts est passée sur le premier compte de taxe de la société.
• Dokos ne crée pas de commande dans Shopify.