Bestel-API

Automatiseer uw bestellingen met Mouser

Overzicht

Heeft u hulp nodig?

Kunt u niet vinden wat u zoekt? Neem contact met ons op en wij helpen u met uw verzoek.

Neem nu contact op met Mouser

Beschrijving

Met de Bestel-API kunt u bij Mouser bestellen zonder uw bedrijfsapplicatie te verlaten. Omdat we hier de Mouser-onderdeelnummers voor nodig hebben, stellen we voor om de bestellijst op te bouwen met behulp van de Mouser zoek-API. Hieronder geven we wat uitleg en bieden we documentatie aan over de Bestel-API.

Een API-sleutel genereren

In uw My Mouser-account vindt u een nieuw gedeelte, genaamd API's, waar u zich voor uw API-sleutel kunt aanmelden en deze kunt bekijken.

Sleutel genereren

Gebruik van de Bestel-API

De Bestel-API geeft u de mogelijkheid om de bestelgegevens van een bestelling te bekijken, om een lijst met ondersteunde landen, staten of valuta te raadplegen en natuurlijk vooral om een bestelling te plaatsen.

Net als bij de Winkelwagen-API, worden de prijs- en bestelregels bepaald door het met uw account verbonden factuuradres en het standaard verzendadres of het op de API-aanvraag vermelde verzendadres.

Onderstaand vindt u de aanbevolen stappen voor het gebruik van een van de API's van Mouser:

  1. Maak een My Mouser-account aan, als u er nog geen heeft.

  2. Genereer een API-sleutel als u er nog geen heeft. U doet dit door naar de API-beheerpagina te gaan in uw My Mouser-account.

  3. Ontdek alle slimme kneepjes bij het gebruik van de API's van Mouser en ontvang voorbeeldcode tijdens een bezoek aan onze stap-voor-stap API-gids.

    De gids lezen

  4. Op de API-verkennerpagina vindt u een overzicht van alle beschikbare API's, van de eindpunten van elke API en een gebruiksklaar testgebied om aanvragen met de API te doen.

    De API-verkenner bezoeken

  5. Een aanvraag aanmaken

  6. Een bestelling indienen

Eindpunten

De Bestel-API biedt de hieronder vermelde eindpunten.

Het /options/query-eindpunt geeft uw factuur- en verzendadres, de valutacode, een lijst met verzendmethoden plus de geldende tarieven, betalingsmethoden, mogelijke vrachtrekeningen, eventuele fiscale attesten, bestaande btw-rekeningen en alle voor uw account opgeslagen creditcards.

Voor het gebruik van het options/query-eindpunt is een factuur- en verzendadres vereist.

Creditcards worden alleen door de Bestel-API ondersteund als er een creditcard op uw account is opgeslagen. Beheer opgeslagen creditcards hier.

Geeft alle beschikbare valuta aan op basis van uw factuur-/verzendadres. Voor het gebruik van het /currencies-eindpunt is een factuur- en verzendadres vereist.

Er kan een verzend-landcode worden ingevoegd om het standaard verzendadres van uw account te overschrijven

Om een bestelling in te kunnen dienen heeft u dan bovendien deze valutacode nodig. Zoals u in onderstaande afbeelding kunt zien, moet ik, als ik als valuta voor Amerikaanse dollar wil kiezen, de 3-cijferige ISO-code USD verzenden.

Geeft alle beschikbare landen terug plus de staten/provincies waaruit het land bestaat. De gebruiker kan landen op landcode filteren. De door dit eindpunt geretourneerde waarden kunnen worden gebruikt als u een bestelling indient en u het standaard verzendadres van uw account wilt overschrijven.

Als ik bijvoorbeeld naar Arizona wilde verzenden, zou ik ‘AZ’ als ISO-code voor de staat en ‘US’ als ISO-code voor het land doorgeven om een bestelling te kunnen indienen.

Gebruik dit eindpunt om een nieuwe bestelling in te dienen. Zoals eerder vermeld, worden de hier aangemaakte bestellingen belast op uw account en moet er eerst een winkelwagen worden aangemaakt voordat u een bestelling plaatst.

Bij fouten in het factuuradres/verzendadres/de verzendmethode/betaling/het land of de valuta/geplande releases, kunt u geen bestelling plaatsen. Als u niet zeker weet of er sprake is van een fout, raadpleeg het hoofdstuk over Fouttolerantie.

Bij foutmeldingen door winkelwagenartikelen moet u hetzij de fout corrigeren of het artikel uit de winkelwagen halen voordat u de bestelling indient.

Bij een geslaagde bestelling komt er een bestelnummer terug.

Maakt een nieuwe bestelling aan vanuit een oude bestelling zolang het "SubmitOrder" kenmerk op waar (true) is gezet. Indien het "SubmitOrder"-kenmerk op onwaar (false) staat, komt er echter een overzicht van de bestelling terug.

Gebruik dit eindpunt om de detailgegevens van een door u aangemaakte bestelling te bekijken. Om deze zoekvraag te gebruiken moet u het bestelnummer opgeven dat in het antwoord van het eindpunt voor het aanmaken van een bestelling wordt geretourneerd, /api/v{version}/order.