Passer au contenu principal

[Order Intake - GCW] Comment utiliser les points de terminaison API de commande indépendants du client

S
Écrit par Styrbjörn Holmberg
Mis à jour il y a plus d'un mois

Vous pouvez récupérer et rechercher toutes les commandes clients grâce aux points de terminaison de l’API, et pas seulement celles d’un client en particulier. Voici comment faire:

1. Créer un connecteur

  1. Allez dans Order Intake → Connectors.

  2. Créez un nouveau connecteur.

  3. Choisissez API Connector.

  4. Sélectionnez tous les clients.

  5. Donnez-lui un nom, par exemple, Connecteur indépendant du client.

  6. Copiez votre X-API-KEY.

  7. Cliquez sur Créer.

Maintenant, vos points de terminaison sont prêts.


2. Configurez vos requêtes API

A. Obtenir une commande individuelle

  • Méthode : GET

  • Point de terminaison : Utilisez le point de terminaison Get Order depuis votre connecteur.

  • En-têtes :

    • X-API-KEY : [votre clé copiée]

  • Corps : Aucun requis.

  • Étapes :

    1. Remplacez le {orderId} dans l’URL par un véritable identifiant de commande.

    2. Cliquez sur Envoyer.

    3. Vous recevrez les détails de la commande.

B. Rechercher plusieurs commandes

  • Méthode : POST

  • Point de terminaison : Utilisez le point de terminaison Search Orders depuis votre connecteur.

  • En-têtes :

    • X-API-Key : [votre clé copiée]

  • Corps : Incluez vos filtres de recherche en JSON.

Étapes :

  1. Collez le point de terminaison de recherche.

  2. Définissez la méthode sur POST.

  3. Ajouter le corps JSON.

  4. Cliquez sur Envoyer.

  5. Vous obtiendrez une liste des commandes correspondantes.


Erreurs courantes à éviter

  • Mauvaise méthode : GET pour une commande couture fine, POST pour une recherche.

  • Pas de clé API : N'oubliez pas d'inclure votre X-API-KEY dans l'en-tête.

  • Corps manquant pour la recherche : La recherche nécessite un corps JSON avec vos filtres.

Avez-vous trouvé la réponse à votre question ?