Dépannage de la synchronisation entre Shopify et Business Central

Vous pouvez vous trouver face à des situations où vous devez résoudre des problèmes lors de la synchronisation de données entre Shopify et Business Central. Cette page définit les étapes permettant de dépanner certains scénarios courants.

Exécuter des tâches au premier plan

  1. Sélectionnez l’icône Ampoule qui ouvre la fenêtre de recherche 1. saisissez Magasin Shopify, puis choisissez le lien associé.
  2. Sélectionnez le magasin pour lequel vous voulez résoudre les problèmes pour ouvrir la page Fiche magasin Shopify.
  3. Désactivez Autoriser les synchronisations en arrière-plan.

Désormais, lorsque l’action de synchronisation est déclenchée, la tâche s’exécute au premier plan. Si une erreur se produit, une boîte de dialogue d’erreur s’affiche, avec un lien Copier les détails. Utilisez le lien pour copier les informations dans un éditeur de texte pour une analyse plus approfondie.

Journaux

Les fonctionnalités de journalisation peuvent faciliter l’identification de la raison pour laquelle une erreur s’est produite. Sur la page Fiche magasin Shopify, dans le champ Mode journalisation, vous pouvez spécifier le niveau de détail que vous souhaitez capturer sur les erreurs. Le champ fournit les options suivantes :

  • Désactivé : n’enregistrez pas les informations sur les erreurs.
  • Erreur uniquement : enregistrez uniquement le message d’erreur, sans les paires demande/réponse. Ce paramètre est la valeur par défaut pour les nouveaux magasins.
  • Tout : enregistrez les paires demande/réponse pour toutes les transactions, y compris celles qui ont réussi. La journalisation continue toutes les erreurs peut ralentir Business Central. Utilisez ce mode lorsque l’échange de données n’entraîne pas d’erreur, mais que vous souhaitez obtenir plus d’informations sur les données qui ont été réellement envoyées et reçues. Notez que certaines données sont toujours journalisation soit activée ou pas. Pour plus d’informations, consultez Capture de données.

Pour vérifier les journaux

  1. Sélectionnez l’icône en forme d’Ampoule qui ouvre la fenêtre de recherche 1. , saisissez Écritures journal Shopify, puis choisissez le lien associé.
  2. Sélectionnez l’écriture journal associée, puis ouvrez la page Écriture journal Shopify.
  3. Examinez les valeurs de demande, de code statut et de description, et de réponse.

Conseil

Si vous devez contacter le support Shopify pour obtenir de l’aide pour résoudre les problèmes, notez les informations contenues dans le champ ID demande. Ces informations peuvent aider le support à résoudre le problème plus rapidement.

Vous pouvez télécharger les valeurs de demande et de réponse sous forme de fichiers au format texte.

Gérer les données des écritures journal

Pour vous aider à maintenir la taille de votre base de données sous contrôle, les écritures journal sont incluses dans une stratégie de rétention des données nommée Écriture journal Shopify. Les stratégies de rétention vous permettent de spécifier la durée pendant laquelle vous souhaitez stocker différents types de données. Par défaut, les écritures du journal Shopify sont conservées pendant un mois. Pour en savoir plus sur les stratégies de rétention, accédez à Définir des stratégies de rétention.

De même, dans la page Écritures journal Shopify, vous pouvez supprimer toutes les écritures journal ou seulement les écritures antérieures à 7 jours.

Capture de données

Que la journalisation soit activée ou pas, certaines réponses Shopify sont toujours journalisées. Vous pouvez inspecter ou télécharger les journaux à partir de la page Liste de capture de données.

Sélectionnez l’action Données Shopify récupérées dans l’une des pages suivantes :

  • Commande Shopify
  • Ligne de commande Shopify
  • Exécutions Shopify
  • Frais de livraison de la commande Shopify
  • Transactions commande Shopify
  • Retour Shopify
  • Ligne de retour Shopify
  • Remboursement Shopify
  • Ligne de remboursement Shopify
  • Règlements Shopify
  • Transactions de paiement Shopify
  • Transactions Shopify

Réinitialiser la synchronisation

Pour des performances optimales, le connecteur importe uniquement les clients, les produits et les commandes créés ou modifiés après la dernière synchronisation. Dans la page Fiche magasin Shopify, des fonctions sont disponibles pour modifier la date/l’heure de la dernière synchronisation ou la réinitialiser complètement. Cette fonction garantit que toutes les données sont synchronisées et pas uniquement les modifications apportées depuis la dernière synchronisation.

Cette fonction ne s’applique qu’aux synchronisations de Shopify à Business Central. Cette fonction peut être utile si vous voulez restaurer des données supprimées, comme les produits, les clients ou les commandes supprimées.

Demander le jeton d’accès

Si Business Central ne parvient pas à se connecter à votre compte Shopify, tentez de réinitialiser le jeton d’accès auprès de Shopify. Le jeton peut être nécessaire en cas de modifications des clés de sécurité ou des autorisations requises (étendues d’application).

  1. Sélectionnez l’icône en forme d’Ampoule qui ouvre la fenêtre de recherche 1. , saisissez Magasins Shopify et choisissez le lien associé.
  2. Sélectionnez le magasin pour lequel vous voulez obtenir le jeton d’accès pour ouvrir la page Fiche magasin Shopify.
  3. Sélectionnez l’action Demander l’accès.
  4. Si vous y êtes invité, connectez-vous à votre compte Shopify.

Le bouton bascule A une clé d’accès est activé.

Vérifier et activer les autorisations pour effectuer des requêtes HTTP dans un environnement hors production

Pour fonctionner correctement, l’extension de connecteur Shopify nécessite une autorisation pour effectuer des requêtes HTTP. Les requêtes HTTP sont interdites pour toutes les extensions lorsque vous exécutez des tests dans les environnements de bac à sable.

  1. Sélectionnez l’icône en forme d’Ampoule qui ouvre la fenêtre de recherche 1. entrez Gestion des extensions, puis sélectionnez le lien associé.
  2. Sélectionnez l’extension Connecteur Shopify.
  3. Choisissez l’action Configurer pour ouvrir la page Paramètres de l’extension.
  4. Assurez-vous que le bouton à bascule Autoriser les requêtes HTTPClient est activé.

Faire tourner le jeton d’accès Shopify

Les procédures suivantes décrivent comment faire tourner le jeton d’accès utilisé par le connecteur Shopify pour accéder à votre magasin en ligne Shopify.

Dans Shopify

  1. Depuis votre Administration Shopify, accédez à Applications.
  2. Sélectionnez Supprimer dans la ligne avec l’application Dynamics 365 Business Central.
  3. Sélectionnez Supprimer dans le message qui s’affiche.

Dans Business Central

  1. Sélectionnez l’icône en forme d’Ampoule qui ouvre la fenêtre de recherche 1. saisissez Magasins Shopify, puis sélectionnez le lien associé.
  2. Sélectionnez le magasin pour lequel vous voulez faire tourner le jeton d’accès pour ouvrir la page Fiche magasin Shopify.
  3. Sélectionnez l’action Demander l’accès.
  4. Si vous y êtes invité, connectez-vous à votre compte Shopify, passez en revue la confidentialité et les autorisations, puis cliquez sur le bouton Installer l’application.

Problèmes connus

Erreur : L’en-tête des ventes n’existe pas. Champs et valeurs d’identification : Document Type=’Quote’,No.=’YOUR SHOPIFY STORE’

Pour calculer les prix, le connecteur Shopify crée un document de vente temporaire (devis) pour un client temporaire (code de magasin) et utilise la logique de calcul du prix standard. Si une extension tierce s’abonne à des événements dans un document de vente temporaire, l’en-tête peut ne pas être disponible. Nous vous recommandons de contacter le fournisseur de l’extension. Demandez-lui de modifier son code pour rechercher des enregistrements temporaires. Dans certains cas, il lui suffit d’ajouter la méthode IsTemporary au bon endroit. Pour en savoir plus sur IsTemporary, consultez IsTemporary.

Pour vérifier que le problème est causé par une extension tierce, utilisez le lien Copier les informations dans le presse-papiers dans le message d’erreur et copiez le contenu dans un éditeur de texte. Les informations contiennent une pile d’appels AL, où la ligne supérieure est la ligne où l’erreur s’est produite. L’exemple suivant illustre une pile d’appels AL.

Pile d’appels AL :

[Object Name]([Object type] [Object Id]).[Function Name] line [XX] - [Extension Name] by [Publisher] 
...
"Sales Line"(Table 37)."No. - OnValidate"(Trigger) line 98 - Base Application by Microsoft
"Shpfy Product Price Calc."(CodeUnit 30182).CalcPrice line 20 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).CreateTempProduct line 137 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).CreateProduct line 5 - Shopify Connector by Microsoft
"Shpfy Create Product"(CodeUnit 30174).OnRun(Trigger) line 12 - Shopify Connector by Microsoft
"Shpfy Add Item to Shopify"(Report 30106)."Item - OnAfterGetRecord"(Trigger) line 2 - Shopify Connector by Microsoft
"Shpfy Products"(Page 30126)."AddItems - OnAction"(Trigger) line 5 - Shopify Connector by Microsoft

N’oubliez pas de partager les informations de la pile d’appels AL avec le fournisseur de l’extension.

Erreur : Gén. Groupe compta. marché doit comporter une valeur dans Client: ’YOUR SHOPIFY STORE’. La valeur ne peut pas être zéro et le champ ne peut pas être vide

Sur la page Fiche magasin Shopify, remplissez le champ Code modèle client dans la fenêtre Fiche magasin avec le modèle pour lequel Groupe compta. marché est renseigné. Le modèle client est utilisé pour créer des clients et pour calculer les prix de vente pour les documents de vente.

Erreur : L’importation de données dans votre boutique Shopify n’est pas activée. Accédez à la fiche magasin pour l’activer

Sur la page Fiche magasin Shopify, activez le bouton bascule Autoriser la synchronisation des données vers Shopify. Ce paramètre aide à empêcher la boutique en ligne d’obtenir des données de démonstration de Business Central.

Erreur : Oauth error invalid_request: Could not find Shopify API application with api_key

Vous avez peut-être utiilisé l’application intégrée, où l’URL du client a le format : https://[application name].bc.dynamics.com. Le connecteur Shopify ne fonctionne pas pour les applications intégrées. Pour en savoir plus, consultez Quels sont les produits Microsoft qui fonctionnent avec le connecteur Shopify ?.

Erreur : erreur interne. Il semble qu’un problème se soit produit de votre côté. ID de la demande : XXXXXXXX-XXXX-XXXX-XXXX-XXXX

Contactez le support Shopify dans les 7 jours suivant l’apparition de cette erreur, et fournissez l’ID de la demande. Pour en savoir plus, rendez-vous sur Options de support pour Shopify.

Erreur : Oauth erreur invalid_request : votre compte n’est pas autorisé à accorder l’accès demandé pour cette application.

L’utilisateur qui a demandé l’accès n’a pas le droit de gérer les applications (la possibilité de gérer et d’installer des applications et des canaux, ainsi que potentiellement d’approuver les frais des applications). Vous pourrez peut-être résoudre ce problème en installant l’application en tant que propriétaire du compte. Vous pouvez également vérifier les Autorisations de l’application pour l’utilisateur dans les paramètres Utilisateur et autorisations de votre administrateur Shopify.

[{"message":"Accès refusé au champ FIELD.","emplacements":[{"ligne":0,"colonne":0}],"chemin":["chemin"],"extensions":{"code":"ACCESS_DENIED","documentation":https://shopify.dev/api/usage/access-scopes}}]

Demandez un nouveau jeton parce que la version mise à jour du connecteur nécessite davantage d’autorisations (étendues d’application). Pour en savoir plus, rendez-vous sur Demander le jeton d’accès.

[API] Clé API ou jeton d’accès non valide (identifiant non reconnu ou mot de passe erroné)

Demandez un nouveau jeton parce que la version mise à jour du connecteur nécessite davantage d’autorisations (étendues d’application). Pour en savoir plus, rendez-vous sur Demander le jeton d’accès.

Voir aussi

Mise en route du connecteur pour Shopify