Czym jest i do czego służy Customer API?
Większość systemów posiada tzw. "API". Niektórzy myślą błędnie, że "API, to API". W IdoSell wychodzimy naprzeciw oczekiwaniom różnych grup developerów, dbając jednocześnie o najwyższe standardy bezpieczeństwa. Stąd w IdoSell znajdziesz różne APIs, każde dedykowane specjalistycznym celom:
- API Panelu Administracyjnego - umożliwia wykonywanie takich samych operacji jak w panelu administracyjnym. Przydzielanie do niego dostępu, które pozwala na wykonywanie operacji w taki sam sposób jak wykonuje je "ręcznie" w panelu administracyjnym IAI-Shop.com użytkownik. Tym samym, dostępu do tego API nie przydzielasz np. klientowi, który składa wiele zamówień. Mógłby bowiem np. dodać zamówienie i oznaczyć je jako opłacone, mimo iż takie nie jest.
- CustomerAPI - umożliwia wykonywanie takich samych operacji jak w części do której dostęp ma klient w sklepie lub hurtowni internetowej. To API zostało zaprojektowane z myślą o odzwierciedleniu procesu zakupowego (Checkout Process). Do CustomerAPI użytkownik loguje się tymi samymi danymi co do hurtowni internetowej. Osobne API, pozwoliło nam na dostosowanie budowy i przepływu komunikacji zgodnie z procesem sklepu, a nie obsługi zamówienia. Pozwala też na pełne bezpieczeństwo, poprzez odseparowanie operacji krytycznych (jnp. księgowanie wpłat czy zmiany statusów) od składania zamówienia. Pozwala też na odseparowanie poszczególnych użytkowników.
Składanie zamówień dropshippingowych w Customer API
Wykorzystując możliwości CustomerAPI-ICDF w zautomatyzowany sposób, przekażesz dane o zamówieniach ze sklepu internetowego do systemu dostawcy. CustomerAPI-ICDF umożliwia sklepom zrealizowanie następujących scenariuszy w systemie hurtowni:
- sprawdzenie, czy towary są dostępne w magazynach hurtowni już w momencie składania przez konsumenta zamówienia detalicznego w sklepie internetowym!
- przekazywanie listy zamawianych przez konsumenta towarów do koszyka hurtowni
- złożenie zamówienia dropshippingowego, przekazując:
- dane adresowe odbiorcy
- preferowany sposób dostawy
- dane billingowe sklepu składającego zamówienie
- pobranie informacji o wszystkich kurierach, których oferuje hurtownia - dzięki temu sklep może odwzorować w swoich profilach dostaw kurierów oferowanych przez hurtownię
- pobranie informacji tylko o kurierach dostępnych dla konkretnego zamówienia - brany jest pod uwagę koszyk klienta, adres dostawy i na tej podstawie zwracana jest lista dostępnych kurierów
- odpytanie o status zamówień w hurtowni - po co dzwonić do hurtowni, wystarczy odpytać API-ICDF aby dowiedzieć się, jaki status ma zamówienie
- pobranie i modyfikacja danych adresowych tych klientów, których sklep przekazał do hurtowni
Schemat obsługi zautomatyzowanych zamówień dropshippingowych z wykorzystaniem protokołu ICDF
Możliwość wysłania z hurtowni powiadomienia do sklepu, o wysłaniu zamówienia dropshippingowego (webhook)
Hurtownie IdoSell posiadają w standardzie wbudowany mechanizm wysyłki powiadomień tzw. webhook, który wykorzystujemy do powiadomienia sklepu, który złożył zamówienie dropshippingowe, o tym, że hurtownia wysłała już zamówienie. W ramach tego powiadomienia hurtownia przesyła także numer przesyłki zrealizowanego zamówienia, który po stronie sklepu powinien zostać połączony z linkiem do kuriera, tworząc w całości link do śledzenia przesyłki. Oczywiście w sklepach IAI-Shop.com to wszystko dzieje się automatycznie.
Jak zacząć?
Chcesz wypróbować CustomerAPI? Zapoznaj się z poniższymi wskazówkami, które ułatwią Tobie odkrywanie możliwości CustomerAPI i otrzymaj swój sandbox, rejestrując się na stronie: Kontakt dla Developerów.
- Komunikację z CustomerAPI rozpocznij od bramki Authenticate. W tym celu musisz podać login w systemie hurtowi (dostawcy) i parametr [systemKey]. W odpowiedzi z bramki Authenticate, otrzymasz klucz dostępu do pozostałych bramek [sessionKey]. Składowe parametru [systemKey] to:
sha1(date('YYYYMMDD') . sha1('hasło do konta sklepu w hurtowni')) (przykład dostępny w FAQ API Panelu Administracyjnego)
- Klucz [sessionKey] aktywny jest przez 15 minut. Po tym czasie konieczne jest wygenerowanie nowego.
- Do pozostałych bramek uwierzytelnisz się, podając [sessionKey] i [dropshippingKey] (w hurtowniach IAI dropshippingKey ustawia się w menu ADMINISTRACJA / Dropshipping i cross-docking).
- Maksymalny rozmiar żądania nie może przekroczyć 10 MB.
- Pamiętaj, gdy Twoja hurtownia korzysta z IAI-Shop.com, musisz włączyć możliwość składania zamówień dropshippingowych w panelu administracyjnym swojej hurtowni - bez tego CustomerAPI do składania tego typu zamówień będzie niedostępne.
Masz już niezbędne informacje, teraz poznaj możliwości CustomerAPI.
Dedykowane narzędzie do nasłuchu wywołań bramek API Customer
Tworząc indywidualne integracje działające w oparciu o nasze otwarte standardy integracji i nasze bramki API masz dostęp do gotowego dedykowanego narzędzia, które w określonym przez Ciebie czasie pozwoli Ci zebrać logi w postaci plików XML zawierających sumaryczne informacje o prędkości i czasie wykonania oraz treści wykonanych w danej bramce żądań i otrzymanych dla nich z tej bramki odpowiedzi.
Zebrane w trakcie nasłuchu dane są zapisywane i udostępniana do wglądu w formie raportu Raport prędkości działania nasłuchiwanych bramek API oraz do pobrania w formie zbiorczego archiwum ZIP.