Connecter Ordoro : vérifier vos identifiants API

Créez une clé API dans Ordoro sous Settings → Account Settings → API Keys, collez son Client ID et son Client Secret dans Integration, puis testez : le test utilise HTTP Basic pour lister vos shippers en lecture seule et confirmer que les identifiants fonctionnent.

Cette connexion Ordoro vérifie que vos identifiants API Ordoro fonctionnent dans Integration : elle contrôle le Client ID et le Client Secret d’une clé API Ordoro via HTTP Basic et lit votre liste de shippers. Gardez la portée en tête : cette connexion sert uniquement à la vérification des identifiants. Elle ne compare pas les tarifs, n’achète pas d’étiquettes et ne recherche pas un suivi par numéro, car chez Ordoro les tarifs et les étiquettes passent par des endpoints par commande. Un test réussi prouve seulement que vos identifiants sont utilisables, et rien de plus.

Prérequis#

• Un compte Ordoro auquel vous pouvez vous connecter, avec accès à Settings → Account Settings → API Keys.
• Le droit de créer une clé API sur cette page. Une clé vous donne les deux valeurs nécessaires : un Client ID et un Client Secret.
• Ne prévoyez pas d’utiliser ici votre e-mail et votre mot de passe de connexion Ordoro. Cette façon de s’authentifier à l’API a été abandonnée par Ordoro et ne fonctionnera pas dans ces champs : voir la première entrée de la FAQ.

Obtenir les identifiants#

1. Connectez-vous à Ordoro et allez dans Settings → Account Settings → API Keys.
2. Créez une clé API sur cette page.
3. Copiez le Client ID de la clé que vous venez de créer. Ce Client ID est le nom d’utilisateur pour l’authentification HTTP Basic.
4. Copiez le Client Secret de cette même clé API et conservez-le en lieu sûr. Ce Client Secret est le mot de passe pour l’authentification HTTP Basic, et il doit venir de la même clé que le Client ID ci-dessus.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Ordoro → Nouvelle connexion.
2. API Key Client ID (client_id) : collez le Client ID de votre clé API Ordoro, celui copié depuis Settings → Account Settings → API Keys. Il est traité comme un secret et n’est jamais réaffiché. Ne saisissez pas ici votre e-mail de connexion Ordoro.
3. API Key Client Secret (client_secret) : collez le Client Secret de cette même clé API. Il est traité comme un secret et n’est jamais réaffiché. Ne saisissez pas ici votre mot de passe de connexion Ordoro, et n’associez pas un Secret d’une autre clé au Client ID ci-dessus.
4. C’est tout : cette connexion n’a que ces deux champs. Il n’y a aucun champ de numéro de compte, de domaine de boutique ni d’environnement à remplir.

Tester la connexion#

Cliquez sur Tester la connexion. Le test vérifie d’abord que les deux champs sont remplis, puis utilise HTTP Basic — votre Client ID comme nom d’utilisateur et votre Client Secret comme mot de passe — pour lister vos shippers en lecture seule (GET /shipper/?limit=1). Si une liste de shippers revient, le test réussit. Lisez ce résultat au sens strict : un test réussi prouve seulement que les identifiants de la clé API peuvent s’authentifier et lire cette liste. Il ne prouve pas que tarifs, étiquettes, commandes ou suivi fonctionnent via cette connexion. En cas d’échec, notez l’erreur et consultez la FAQ ci-dessous.

Mapping / choisir un modèle#

Pour cette connexion, il n’y a aucun mapping à configurer et aucun modèle à choisir. Elle n’importe pas de commandes et ne renvoie rien, il n’y a donc aucun champ de commande à mapper. La comparaison de tarifs, l’achat d’étiquettes et le suivi par numéro ne font pas non plus partie de cette connexion : chez Ordoro, les tarifs et les étiquettes passent par des endpoints par commande qui partent d’une commande Ordoro, et les informations de suivi se trouvent sur la commande elle-même. Utilisez cette connexion pour la seule tâche qu’elle accomplit — vérifier que les identifiants de votre clé API Ordoro fonctionnent — et gérez tarifs et étiquettes via le flux par commande dans Ordoro.

Activer#

Une fois le test réussi, activez la connexion pour l’enregistrer dans Integration avec ces identifiants vérifiés, afin de pouvoir la retester plus tard avec les mêmes valeurs. L’activation ne démarre aucun flux de données : via cette connexion, aucune commande n’est importée, aucun tarif n’est coté, aucune étiquette n’est achetée et aucun suivi n’est synchronisé. Si vous créez plus tard une nouvelle clé API dans Ordoro, mettez à jour les deux champs ici avec les valeurs de la nouvelle clé et testez à nouveau avant de vous fier à la connexion.

FAQ#

J’ai saisi mon e-mail et mon mot de passe Ordoro, mais le test échoue

Ces deux champs n’acceptent pas vos identifiants de connexion. S’authentifier à l’API Ordoro avec un e-mail et un mot de passe a été abandonné par Ordoro : un e-mail de connexion dans le champ Client ID et un mot de passe de connexion dans le champ Client Secret sont donc rejetés à chaque fois.

Allez dans Ordoro → Settings → Account Settings → API Keys, créez une clé API, mettez son Client ID dans le champ client_id et le Client Secret de cette même clé dans le champ client_secret, puis testez à nouveau.

Le test échoue avec 401

Ordoro n’a pas accepté le couple Client ID et Client Secret. Les causes habituelles : une erreur de frappe ou de copie, les deux valeurs inversées entre les champs, des espaces supplémentaires copiés avec une valeur, ou un Client ID associé au Client Secret d’une autre clé API.

Ouvrez l’unique clé API que vous voulez utiliser dans Ordoro → Settings → Account Settings → API Keys, recopiez les deux valeurs de cette même clé sans espaces supplémentaires, vérifiez que le Client ID est dans client_id et le Client Secret dans client_secret, puis testez à nouveau.

Le test a réussi, mais je ne peux ni comparer les tarifs, ni acheter une étiquette, ni suivre un envoi ici

C’est la portée réelle de cette connexion, pas un défaut de votre configuration. Chez Ordoro, les tarifs et les étiquettes passent par des endpoints par commande : il n’y a donc aucun appel tarifaire ou d’étiquette indépendant que cette connexion puisse faire, et les informations de suivi se trouvent sur la commande Ordoro plutôt que derrière une recherche par numéro. Cette connexion ne fait que vérifier les identifiants avec une liste de shippers en lecture seule.

Considérez un test réussi comme la preuve que vos identifiants fonctionnent, et rien de plus. Pour les tarifs et les étiquettes, suivez le flux par commande dans Ordoro, en partant de la commande Ordoro ; pour le suivi, consultez les informations d’expédition de cette commande dans Ordoro.

Le test indique des identifiants manquants

L’un des deux champs, ou les deux, sont vides. Le test vérifie d’abord les champs et signale des identifiants manquants au lieu d’un succès, donc une connexion incomplète ne peut jamais sembler connectée.

Remplissez les deux champs — le Client ID d’une clé API Ordoro dans client_id et le Client Secret de cette même clé dans client_secret — enregistrez, puis testez à nouveau.