Comment créer une application privée Shopify pour connecter Atoo-Sync?

https://dev.shopify.com/dashboard/<ID_PARTENAIRE>/apps/new

Comment Vérifier que les factures PDF sont bien exportés vers Shopify ?

Explications : Création et vérification du champ méta « Facture » dans Shopify

Lors de l’export des factures PDF depuis Atoo-Sync GesCom vers Shopify, le connecteur vérifie automatiquement l’existence d’un champ méta dédié au niveau des commandes.
Ce champ permet de stocker le lien vers la facture PDF. Si le champ n’existe pas, Atoo-Sync le crée automatiquement.

1. Où vérifier le champ méta dans Shopify ?

1. Connectez-vous à votre interface Shopify Admin.
2. Allez dans Paramètres (en bas à gauche).
3. Cliquez sur Métachamps et métaobjets.
4. Dans la liste des définitions, sélectionnez Commandes.

2. Détails du champ méta « Facture »

• Nom : Facture
• Namespace et clé : atoosync.invoice
  → Ce couple (namespace + clé) est utilisé par l’API pour identifier le champ.
• Type : Fichier (permet de stocker un lien vers le PDF).
• Caractère : Unique (un seul fichier par commande).

3. Vérification sur une commande

Pour confirmer que le champ est bien présent :

• Ouvrez une commande dans Shopify.
• Descendez jusqu’à la section Champs méta.
• Vous devez voir le champ Facture.
  Une fois la facture exportée, ce champ contiendra le lien vers le fichier PDF.

Cliquez sur la facture puis sur l'icone œil pour visualiser la facture

Shopify ne sait pas nativement visualiser des fichier  pdf. Si vous souhaitez voir la facture, cliquez sur l'icone télécharger en haut à droite .

4. Points clés à retenir

• Atoo-Sync crée automatiquement le champ méta si absent.
• Le champ est lié aux commandes et porte le namespace atoosync.invoice.
• Il est utilisé pour stocker le lien vers la facture PDF exportée.

Un pays n'est pas visible dans le paramétrage Zone / Pays Atoo-Sync

Explications : 

Des commandes associées à un pays spécifique sont bien importées, mais une catégorie comptable incorrecte leur est appliquée.

Après analyse de votre paramétrage dans Configurer le profil > Commandes > Mappage Zones / Pays, il apparaît que le pays concerné n’est pas présent dans la liste.

Exemple : la Finlande

Une commande expédiée vers la Finlande est bien créée, mais elle n’est pas associée à la zone géographique prévue, ce qui entraîne l'application d'une mauvaise catégorie comptable.

La commande a bien été récupérée, mais le pays concerné n’apparaît toujours pas dans la liste des zones mappées.

Solution :

Le pays n’est pas correctement pris en compte, car il n’existe pas dans la liste des pays d’expédition configurés.

Pour corriger cela, veuillez suivre les étapes ci-dessous :

1. Rendez-vous dans Applications > Paramètres des applications et canaux de vente

2. Vérifiez que le pays concerné (par exemple, la Finlande) est bien présent dans la liste des expéditions

3. Si ce n’est pas le cas, ajoutez-le ou modifiez les paramètres existants pour l’inclure

Dans Expédition et livraison

Dans Expéditions : 

Puis, sélectionnez votre tarif en vigueur, par exemple le tarif d’expédition général.

Vérifiez si le pays concerné est affecté à une zone unique qui lui est dédiée ou s’il a été ajouté à une zone regroupant plusieurs pays (par exemple : « Reste du monde »).

Ensuite, dans Atoo-Sync, assurez-vous que ce pays apparaît correctement dans la liste.
Après l’avoir ajouté et enregistré dans Shopify, il doit apparaître dans Atoo-Sync en cliquant sur Configurer le profil pour effectuer la lecture des paramètres Shopify et recharger la liste.

l’API de l’application privée Shopify pour le connecteur Atoo-Sync va devenir obsolète

Vous avez peut-être reçu un email qui ressemble à celui ci-dessous :

Nous vous envoyons cet e-mail, car une ou plusieurs applications privées installées sur votre boutique Shopify passent des appels à des API qui seront prochainement supprimées et ne seront bientôt plus prises en charge. Ces applications doivent être mises à jour par un(e) développeur(-euse) avant le avril 1, 2022 pour continuer à fonctionner normalement.

Nous vous encourageons à transmettre cet e-mail au/à la partenaire ou au/à la développeur(-euse) qui maintient vos applications et à lui demander de mettre à jour vos applications en fonction des informations ci-dessous. Si aucun(e) développeur(-euse) ne maintient actuellement vos applications, vous pouvez engager un(e) expert(e) Shopify.

Ce que votre développeur(-euse) doit savoir :

Au moins l'une de vos applications privées a effectué des appels à des API abandonnées au cours des 30 derniers jours. Ces versions ne seront plus prises en charge à compter du avril 1, 2022. Veuillez mettre à jour les applications figurant dans la liste ci-dessous en optant pour la version 2021-07 de l'API ou une version supérieure afin qu'elles continuent à fonctionner correctement.

Cela signifie que l’API de l’application privée Shopify pour le connecteur Atoo-Sync va devenir obsolète.

Voici la procédure à effectuer :

Pour mettre à jour la version de l’API il faut procéder comme suit :

Cliquer sur le lien « Applications » dans le back-office Shopify

Ensuite sur le lien Gérer les application privées

Cliquer sur l’application « Atoo-Sync » qui peut avoir un nom différent chez vous

Dans le bas de la page il faut changer la version de l’API

Et cliquer sur le bouton Enregistrer en bas.

Création d'une application privée dans Shopify (Ancienne documentation)

Les applications Atoo-Sync ont besoins d'une clé API pour pouvoir communiquer avec la boutique Shopify la création de cette clé API se fait depuis la gestion des applications privées dans l'administration de votre boutique Shopify.

Connectez vous à votre boutique Shopify et cliquez sur Applications dans la barre de menu latéral.

Cliquez sur développer des applications

Cliquez sur le bouton Créer une application

Renseignez un nom et l'email par défaut pour l'application puis cliquez sur créer une application :

Cliquez sur configurer les champs de l'API Admin :

Sélectionner tous les champs en lecture ET écriture :

Puis cliquez sur sauvegarder :

Cliquez sur Installer l'application :

Cliquer sur Installer :

L'application est désormais créé.

Cliquez sur révéler le jeton une fois afin de récupérer le mot de passe de l'API :

ATTENTION CE MOT DE PASSE N'EST VISIBLE QU'UNE SEULE FOIS.PENSEZ A LA SAUVEGARDER.

Récupérer ensuite la clé de l'API :

La zone de texte Clé API contient la clé API de votre application privée, c'est elle qu'il faut recopier dans les applications Atoo-Sync.

La zone de texte jeton d'accès à l'API contient le mot de passe de la Clé API à recopier dans les applications Atoo-Sync.

Configuration de la clé d'API pour Atoo-Sync Dashboards

Veuillez trouver ci-dessous la configuration qu'il faut pour pouvoir connecter la plateforme Atoo-Sync Dashboards à Shopify.