Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
- Un abonnement actif à Inclusive Pricing avec Zonos.
- Une clé API GraphQL Secret depuis votre Zonos Dashboard. Accédez à Settings -> Integrations pour trouver vos clés API. La clé doit avoir le préfixe
credential_liveet ne doit pas être expirée.
Configuration initiale
Suivez ces étapes pour configurer le modèle de rapport Inclusive Pricing pour la première fois.
Copier le modèle Google Sheet
Ouvrez le modèle de rapport Inclusive Pricing et créez votre propre copie en allant dans File -> Make a copy. Ne demandez pas l'accès en tant qu'éditeur à la feuille originale.
Connecter votre clé API
Dans votre feuille copiée, cliquez sur Zonos -> Update GraphQL API Key dans la barre de menu (à côté de Help). Cette option de menu peut mettre une minute à apparaître après l'ouverture de la feuille.
Autoriser le script
Pour les nouveaux utilisateurs, une boîte de dialogue d'autorisation s'affichera. Cliquez sur OK, puis suivez les invites pour autoriser le script avec votre compte Google :
- Cliquez sur Select all pour accorder les autorisations requises.
- Cliquez sur Continue pour terminer l'autorisation.
Saisir votre clé API Secret
Après l'autorisation, une boîte de dialogue vous invitera à saisir votre clé API GraphQL Secret Zonos. Vous la trouverez dans votre Zonos Dashboard sous Settings -> Integrations.
Assurez-vous de copier une clé Secret valide avec le préfixe credential_live. Les clés expirées ou les clés Public provoqueront des erreurs.
Récupérer les commandes
Cliquez sur Zonos -> Fetch Orders dans la barre de menu.
Sélectionner une plage de dates
Saisissez une date de début et de fin dans la boîte de dialogue, ou utilisez l'une des options prédéfinies (Last 30 days, This month, Last month, This year), puis cliquez sur Fetch Orders.
Une fois terminé, vos commandes seront renseignées dans l'onglet Orders de la feuille.
Note : Pour enregistrer un rapport pour référence ultérieure, cliquez avec le bouton droit sur l'onglet Orders et sélectionnez Duplicate, puis renommez-le selon vos besoins. Vous pouvez également exporter ou faire une copie de l'intégralité de la feuille de calcul.
Utilisation quotidienne
Après avoir terminé la configuration initiale, la génération de nouveaux rapports est simple :
- Ignorez les étapes 1 à 3 — Il s'agit d'un processus unique.
- Ignorez l'étape 4 sauf si votre clé API a expiré ou si vous devez extraire des données d'une autre boutique Zonos.
- Répétez les étapes 5 et 6 pour récupérer les commandes d'une nouvelle plage de dates.
Erreur 401 Unauthorized
Vous pouvez voir une erreur contenant HTTP fetch failed from 'order': 401: Unauthorized.
Correction : Assurez-vous d'utiliser une clé API GraphQL Secret valide depuis votre Zonos Dashboard. Cette erreur se produit lorsque la clé est manquante, invalide ou n'est pas de type Secret.
Erreur Security requirement failed
Vous pouvez voir une erreur contenant Security requirement failed.
Correction : Assurez-vous d'utiliser la clé API GraphQL Secret (et non une clé Public) et qu'elle n'a pas le statut Expired. Accédez à Settings -> Integrations dans votre Zonos Dashboard pour vérifier le statut de votre clé.
Aucune commande n'apparaît
Aucune commande n'est renseignée malgré une clé API GraphQL Secret valide.
Correction : Ce rapport ne génère des données que pour les commandes avec des attributs Inclusive Pricing. Si vos articles ne contiennent pas de champs reverseAmountDetail, ils ne seront pas inclus. Vérifiez que vous avez traité des commandes Inclusive Pricing dans la plage de dates sélectionnée.
Exporter un rapport Inclusive Pricing
Générez une ventilation Inclusive Pricing au niveau des articles à l'aide d'une Google Sheet.
Le modèle de rapport Inclusive Pricing est une Google Sheet avec un script intégré qui interroge l'API GraphQL Zonos pour vos commandes et génère un rapport affichant les ventilations au niveau des articles des montants de base et inclusifs. Cela est utile pour tout marchand qui souhaite une visibilité sur la répartition des droits, taxes et frais entre les articles de ses commandes Inclusive Pricing.