Interfejs Order API

Zautomatyzuj zamówienia z witryny Mouser

Przegląd

Potrzebujesz pomocy?

Nie możesz znaleźć tego, czego szukasz? Skontaktuj się z nami — chętnie pomożemy.

Skontaktuj się teraz z firmą Mouser

Opis

Interfejs Order API umożliwia składanie zamówień w witrynie Mouser z poziomu aplikacji. Ponieważ wymagamy używania numerów katalogowych Mouser, zalecamy tworzenie listy zamówień za pomocą interfejsu Search API Mouser. Objaśnienia i dokumentacja związana z interfejsem Order API znajdują się poniżej.

Generowanie klucza API

Na koncie My Mouser znajduje się nowa sekcja „Interfejsy API”, w której można się zarejestrować i wyświetlić swój klucz API.

Wygeneruj klucz

Korzystanie z interfejsu Order API

Interfejs Order API umożliwia przeglądanie szczegółów zlecenia, pobieranie listy obsługiwanych krajów, stanów i walut, a co najważniejsze — wysłanie zlecenia.

Podobnie jak w przypadku interfejsu Cart API, zasady wyceny i zamawiania są określane na podstawie adresu rozliczeniowego powiązanego z kontem użytkownika oraz na podstawie domyślnego adresu wysyłki lub adresu wysyłki dołączonego w żądaniu API.

Poniżej znajdują się sugerowane czynności, które należy wykonać w przypadku używania jednego z interfejsów API firmy Mouser:

  1. Załóż konto My Mouser, jeśli jeszcze go nie masz.

  2. Wygeneruj klucz API, jeśli go nie masz. Aby to zrobić, należy wyświetlić stronę zarządzania interfejsem API na swoim koncie My Mouser.

  3. Poznaj tajniki korzystania z interfejsów API firmy Mouser i zapoznaj się z przykładowym kodem w naszym szczegółowym przewodniku po interfejsach API.

    Przeczytaj przewodnik

  4. Odwiedź stronę Eksplorator API, która zawiera listę wszystkich dostępnych interfejsów API i ich punktów końcowych oraz oferuje łatwy w obsłudze obszar do testowania żądań API.

    Przejdź do eksploratora API

  5. Utwórz żądanie

  6. Prześlij zamówienie

Punkty końcowe

Interfejs Order API oferuje wymienione niżej punkty końcowe.

Punkt końcowy /options/query zwraca adres rozliczeniowy i wysyłkowy, kod waluty, listę metod wysyłki oraz wszelkie stawki, metody płatności, rachunki przewozowe, certyfikaty podatkowe, rachunki VAT oraz zapisane na koncie karty kredytowe.

Aby skorzystać z punktu końcowego options/query, wymagane jest podanie adresu rozliczeniowego i wysyłkowego.

Karty kredytowe są obsługiwane przez interfejs Order API tylko wtedy, gdy karta kredytowa jest zapisana na koncie. Aby zarządzać zapisanymi kartami, przejdź tutaj.

Zwraca wszystkie dostępne waluty na podstawie adresu rozliczeniowego/wysyłkowego. Do korzystania z punktu końcowego /currencies wymagany jest adres rozliczeniowy i wysyłkowy.

W celu zmiany domyślnego adresu wysyłkowego można przekazać kod kraju wysyłki.

Aby złożyć zamówienie, należy wysłać kod waluty dotyczący zamówienia. Jak widać na obrazku poniżej, aby wybrać dla zamówienia walutę dolara amerykańskiego, należy wysłać 3-cyfrowy kod ISO o wartości „USD”.

Zwraca wszystkie dostępne kraje oraz wszystkie stany/prowincje właściwe dla kraju. Umożliwia filtrowanie krajów według kodu kraju. Wartości zwróconych za pomocą tego punktu końcowego można użyć podczas składania zamówienia, aby zmienić domyślny adres dostawy dotyczący konta.

Na przykład aby wysłać towar do Arizony, jako kod ISO stanu należy podać wartość „AZ”, a jako kod ISO kraju – „US”.

Tego punktu końcowego należy używać do przesyłania nowych zamówień. Jak wspomniano wcześniej, wszelkie utworzone tutaj zamówienia będą umieszczane na koncie użytkownika. Przed złożeniem zamówienia należy z kolei utworzyć koszyk.

Jeśli wystąpią jakiekolwiek błędy w adresie rozliczeniowym/wysyłkowym, metodzie wysyłki/płatności, kraju lub walucie albo zaplanowanych dostawach, złożenie zamówienia nie będzie możliwe. W przypadku, gdy nie ma pewności, czy występuje błąd, zapoznaj się z sekcją Tolerancja błędów.

Jeśli jakakolwiek pozycja koszyka zgłasza błąd, przed złożeniem zamówienia należy usunąć błąd albo pozycję koszyka.

W przypadku pomyślnego złożenia zamówienia zostanie zwrócony numer zamówienia.

Wysyła nowe zamówienie na podstawie starego zamówienia, jeżeli właściwość „SubmitOrder” jest ustawiona na „true”. Jeżeli właściwość „SubmitOrder” jest ustawiona na „false”, zostanie zwrócone podsumowanie zamówienia.

Ten punkt końcowy pozwala wyświetlić szczegóły utworzonego zamówienia. Aby użyć zapytania, należy podać numer zamówienia, który jest zwracany w odpowiedzi na punkt końcowy użyty do utworzenia zamówienia, /api/v{version}/order.