API de commande

Automatisez vos commandes avec Mouser

Présentation générale

Besoin d'aide ?

Vous ne trouvez pas ce dont vous avez besoin ? Contactez-nous dès maintenant et nous vous aiderons.

Contacter Mouser maintenant

Description

L'API de commande vous permet de passer des commandes avec Mouser tout en restant dans votre application. Comme nous vous demandons d'utiliser les références Mouser, nous vous recommandons de créer votre liste de commande avec l'API de recherche Mouser. Vous trouverez ci-dessous des explications et de la documentation concernant l'API de commande.

Générer une clé API

Dans votre compte My Mouser, vous trouverez une nouvelle section appelée API, dans laquelle vous pourrez vous inscrire et consulter votre clé API.

Générer une clé

À l'aide de l'API de commande

L'API de commande vous permet de consulter les détails d'une commande, d'obtenir la liste des pays, des États et des devises pris en charge et, surtout, de passer une commande.

Comme pour l'API de panier, les règles de tarification et de commande sont déterminées en fonction de l'adresse de facturation associée à votre compte et de l'adresse de livraison par défaut ou de l'adresse de livraison envoyée avec la requête API.

Vous trouverez ci-dessous les étapes à suivre pour utiliser l'une des API Mouser :

  1. Si vous ne disposez pas encore d'un compte My Mouser, créez-en un.

  2. Générez une clé API si vous n'en avez pas. Pour ce faire, rendez-vous sur la page de gestion des API de votre compte My Mouser.

  3. Découvrez les tenants et aboutissants de l'utilisation des API Mouser et obtenez des exemples de code en consultant notre guide API étape par étape.

    Lire le guide

  4. Consultez la page de l'explorateur d'API qui répertorie toutes les API disponibles, les points de terminaison de chaque API et vous fournit une zone de test facile à utiliser pour effectuer des requêtes d'API.

    Consulter la page de l'explorateur d'API

  5. Créer une requête

  6. Passer une commande

Points de terminaison

L'API de commande fournit les points de terminaison indiqués ci-dessous.

Le point de terminaison /options/query renvoie votre adresse de facturation et d'expédition, le code de la devise, une liste des modes d'expédition ainsi que les tarifs, les modes de paiement, les comptes de fret, les certificats fiscaux, les comptes de TVA et les cartes de crédit enregistrées pour votre compte.

Une adresse de facturation et de livraison est nécessaire pour utiliser le point de terminaison options/query.

Les cartes de crédit ne sont prises en charge par l'API de commande que si vous avez une carte de crédit enregistrée sur votre compte. Pour gérer les cartes sauvegardées, rendez-vous ici.

Renvoie toutes les devises disponibles en fonction de votre adresse de facturation/livraison. Une adresse de facturation et de livraison est nécessaire pour utiliser le point de terminaison /currencies.

Un code de pays d'expédition peut être saisi pour remplacer l'adresse d'expédition par défaut sur votre compte

Pour passer une commande, vous devrez envoyer un code de devise pour la commande. Comme le montre l'image ci-dessous, si je veux choisir la devise Dollars américains pour ma commande, j'enverrai la valeur à 3 chiffres du code ISO du dollar américain.

Renvoie tous les pays disponibles ainsi que tous les États/provinces dont le pays dispose. Permet à l'utilisateur de filtrer les pays par code pays. Les valeurs renvoyées par ce point de terminaison peuvent être utilisées lorsque vous passez une commande et que vous souhaitez remplacer l'adresse de livraison par défaut sur votre compte.

Par exemple, si vous souhaitez expédier une commande en Arizona, vous devez indiquer « AZ » comme code ISO de l'État et « US » comme code ISO du pays lorsque vous passez la commande.

Utilisez ce point de terminaison pour passer une nouvelle commande. Comme mentionné précédemment, toutes les commandes créées ici seront placées sur votre compte et un panier devra être créé avant de passer une commande.

S'il y a des erreurs dans l'adresse de facturation/l'adresse d'expédition/le mode d'expédition/le paiement/le pays ou la devise/les envois planifiés, vous ne pourrez pas passer de commande. Si vous avez des doutes quant à la présence d'une erreur, consultez la section relative à la tolérance aux erreurs.

Si des articles du panier sont erronés, vous devrez soit corriger l'erreur, soit retirer l'article du panier avant de passer commande.

Un numéro de commande sera renvoyé si une commande est passée avec succès.

Passe une nouvelle commande à partir d'une ancienne commande si la propriété "SubmitOrder" est définie sur true. Si la propriété "SubmitOrder" est définie sur false, alors un récapitulatif de commande sera renvoyé.

Utilisez ce point de terminaison pour afficher les détails d'une commande que vous avez créée. Pour utiliser la requête, vous devez fournir le numéro de commande, qui est renvoyé dans le corps de la réponse pour le point de terminaison utilisé pour créer une commande, /api/v{version}/order.