Ce guide vous aidera à configurer l'intégration entre votre boutique Shopify et Orderry. Vous apprendrez comment préparer votre compte Shopify et connecter votre boutique afin d'importer automatiquement les commandes, les clients et les produits.
Une fois la configuration effectuée, les données seront synchronisées toutes les minutes, et le traitement des commandes deviendra rapide et pratique.
Important : les nouvelles boutiques Shopify sont connectées via l'API GraphQL Admin. Les boutiques qui étaient auparavant connectées à l'aide de l'API héritée continuent de fonctionner correctement — aucune action supplémentaire n'est requise.
Étape 1. Préparez votre compte Shopify
Vous devez créer et installer l'application à partir du compte du propriétaire de la boutique dans Shopify.
1. Dans votre boutique Shopify, accédez à My store > Dev Dashboard.
2. Cliquez sur Create app.
3. Entrez le nom de l'application (par exemple, Orderry) et cliquez sur Create.
4. Sur la page suivante (Versions), dans le bloc Access, dans le champ Scopes, saisissez le texte suivant :
read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,read_customer_data_erasure,read_customer_merge,read_delivery_customizations,read_price_rules,read_discounts,read_discounts_allocator_functions,read_discovery,read_files,read_fulfillment_constraint_rules,read_fulfillments,read_gift_card_transactions,read_gift_cards,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_delivery_option_generators,read_locations,read_marketing_integrated_campaigns,read_marketing_events,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,write_order_edits,read_order_edits,read_orders,write_orders,read_payment_customizations,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,read_returns,write_returns,read_shopify_payments_provider_accounts_sensitive,read_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,read_content,write_content,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations
5. Cliquez sur Release en bas de la page, ajoutez le nom de la version (par exemple, 1) dans la fenêtre contextuelle, puis cliquez sur Release.
6. Accédez à la section Home et cliquez sur Install app dans le bloc Installs.
7. Sélectionnez la boutique pour laquelle vous souhaitez installer cette application.
❗ Si vous avez plusieurs boutiques, vous devez créer une application distincte pour chacune d'elles.
8. Cliquez sur Install.
9. Revenez à My store > Dev Dashboard et ouvrez l'application que vous avez créée.
10. Allez dans la section Settings et copiez le Client ID et le Secret dans le bloc Credentials.
La configuration de l'application dans Shopify est terminée ! Ensuite, vous devez connecter Shopify à Orderry.
Étape 2. Connexion de votre boutique Shopify à Orderry
1. Accédez à Settings > E-commerce Connect.
2. Cliquez sur + Boutique et cochez la case Intégration activée.
3. Dans le champ Source, sélectionnez Shopify.
4. Remplissez tous les champs obligatoires :
Nom — nom de la boutique ;
URL du site web — lien vers votre site web Shopify (par exemple, gadgetlytest.myshopify.com)
Client ID — collez le Client ID copié depuis les paramètres de l'application dans Shopify ;
Client Secret — collez le Secret copié depuis les paramètres de l'application dans Shopify ;
Emplacement — sélectionnez l'emplacement où les commandes provenant de Shopify seront créées ;
Type de commande — sélectionnez le type de commandes importées depuis Shopify ;
💡 Astuce
Créez un type de commande spécial uniquement pour les commandes provenant de Shopify et configurez les champs dont vous avez besoin.
Vous pouvez également définir des valeurs par défaut pour ces champs. Si la plateforme ne fournit pas de valeur pour un champ spécifique lors de l’importation des commandes, celui-ci sera automatiquement renseigné avec la valeur spécifiée dans l’éditeur de formulaire.
Identifier les produits par — sélectionnez le paramètre (nom, SKU ou ID produit) qui permettra d'identifier les produits de la plateforme lorsqu'ils seront mis à jour dans les commandes de Orderry. Cela est nécessaire pour éviter la duplication des produits.
Gestionnaires — sélectionnez les employés qui seront attribués en tant que gestionnaires aux commandes importées.
Remarque : pour que l'intégration fonctionne correctement, les employés attribués par les gestionnaires à ces commandes doivent avoir le droit Afficher l'employé dans la liste des gestionnaires activé.
5. Configurer les correspondances fiscales.
Les correspondances fiscales vous permettent de relier les taux d’imposition transmis depuis une commande Shopify aux taxes configurées dans Orderry. Par la suite, lors de l’importation ou de la mise à jour d’une commande, le système appliquera automatiquement les taxes Orderry correspondantes aux lignes de la commande.
La colonne « Taxes Shopify » affiche les taxes configurées dans votre compte Shopify. Vous trouverez les paramètres fiscaux à l’adresse suivante : Shopify Admin → Paramètres → Taxes et droits. Vous pouvez configurer les taux d’imposition pour chaque région fiscale.
TVA — Taxe sur la valeur ajoutée ;
GST — Taxe sur les biens et services ;
Taxe sur les ventes — Taxe sur les ventes ;
En d’autres termes, l’ensemble spécifique de taxes dépend du pays et de la région où le vendeur est enregistré et vend ses produits.
Le nom de la taxe à utiliser pour le mappage se trouve dans les commandes. Copiez-le et collez-le dans le champ Taxes Shopify dans Orderry.
Quelles taxes sont transférées de Shopify vers Orderry ?
Seules les taxes générales configurées pour l’ensemble de la commande sont transférées. Les taxes supplémentaires définies pour des produits individuels ne sont pas transférées.
La colonne Taxes Orderry affiche toutes les taxes configurées et activées sur la page Paramètres > Finances. Si une taxe est désactivée dans Orderry après la synchronisation, elle ne sera plus appliquée aux commandes.
6. Cliquez sur Enregistrer et importer les commandes.
Ensuite, une importation unique des commandes, des produits et des clients depuis Shopify vers Orderry aura lieu. Le processus peut prendre un certain temps, selon le nombre de commandes importées. Grâce à une synchronisation supplémentaire, toutes les nouvelles commandes provenant de la plateforme Shopify seront automatiquement envoyées à Orderry, et les données de toutes les commandes importées seront mises à jour toutes les minutes.
Remarque : toutes les commandes créées au cours des deux derniers mois seront importées, à l'exception des commandes exécutées, annulées et remboursées.
Comment modifier et supprimer une intégration
Pour modifier les paramètres d'intégration, ouvrez l'intégration souhaitée, apportez les modifications et enregistrez les paramètres.
Pour supprimer une intégration avec une boutique, ouvrez-la, cliquez sur le bouton Supprimer et confirmez l'action.