W poniższym artykule szczegółowo przedstawimy rekomendowany sposób łączenia poszczególnych strumieni danych w ramach API połączenia Twojej firmy.

Środowisko testowe: Jest tylko jedno środowisko do testowania i realnej sprzedaży, a jest nim produkcja. Klucz API, który otrzymasz po rejestracji, jest zatem niezmieniony i ostateczny. Niemniej jednak połączenie można najpierw przetestować. Twoje konto jest w trybie testowym tylko do momentu aktywacji. Ostateczne wyświetlenie Twojej oferty na stronie nastąpi dopiero po akceptacji działu onboardingu, po więcej informacji skontaktuj się ze swoim specjalistą ds. onboardingu.

Bardzo ważne jest, aby przestrzegać poniższych zaleceń. Skutki nieprzestrzegania zalecanych praktyk mogą być ograniczające dla funkcjonowania wywołań API Twojej firmy, w odniesieniu do obciążenia systemu MALL. Mając to na uwadze, platforma obsługuje Ogranicznik stawki MALLwięcej na ten temat w artykule tutaj. Wszelkie przekroczenia umowy SLA spowodowane nieprawidłową implementacją interfejsu API i przekroczeniami limitu stawek są ponoszone przez partnera.

Należy pamiętać, że API MALL ma charakter źródła informacji w momencie ich potrzeby, nie jest bazą danych, która służyłaby do przechowywania danych historycznych. Wywołania API tego rodzaju mogą być ograniczone.


Zawartość


Zamówienia

W kontekście punktów końcowych dla zleceń należy zwrócić szczególną uwagę na kolejność kroków. Jest on podzielony na dwie podstawowe opcje w zależności od tego, czy używasz webhook w celu uzyskania informacji o zmianach w zamówieniach. Możesz przeczytać więcej o webhooku tutaj.

W tym artykule dowiesz się, jak poprawnie ustalać poszczególne metody i przełączać poszczególne stany w ramach API, zalecamy również zapoznanie się z artykułem wyjaśniającym szczegółowo poszczególne stany, które zamówienie może nabyć i co mają na myśli tutaj.

Należy również pamiętać, że w przypadku korzystania z usług MALL Delivery proces różni się od pobrania przesyłki i aktualizacji statusu w kolejnych krokach.

Ważny: Wysyłaj aktualizacje statusu zamówienia tylko w przypadku zmian w zamówieniach. Wielokrotne wysyłanie tych samych informacji jest wysoce niepożądane i uciążliwe dla platformy.


Sekwencja wywołań zamówień za pomocą webhooka

Najpierw należy włączyć webhooka i wstawić przygotowany przez siebie URL do odpowiedniej zakładki w portalu partnera w menu Partnera, następnie w logu widać poszczególne powiadomienia wychodzące.

1. Otrzymasz powiadomienie z książki internetowej ze zmienionym numerem zamówienia.

2. Połączenie Uzyskaj szczegóły zamówienia dla zamówień w statusie ZABLOKOWANY do rezerwacji towarów. Przejmij tylko informacje o towarach. Otrzymuj informacje finansowe tylko dla zamówień w statusie OTWARTY. Rezerwacja towaru nie jest obowiązkowa, ale jest wysoce zalecana w przypadku towarów o wysokiej zbywalności i związanym z tym ryzykiem wyprzedania.

3. Otrzymujesz powiadomienie webhook o zamówieniu, którego status uległ zmianie OTWARTY lub ANULOWANY.

4. Połączenie Zaktualizuj zamówienie z potwierdzone = prawda dla OTWARTY lub ANULOWANY zamówienia, dla których zgodnie z informacją z webhooka status zmienił się z ZABLOKOWANY do OTWARTY lub ANULOWANY (jest to stan końcowy i ponowne otwarcie zamówienia nie jest już możliwe).

5. Połączenie Uzyskaj szczegóły zamówienia na OTWARTY potwierdzone zlecenia importu danych końcowych do Twojego systemu. W tym momencie nie ma już możliwości ingerencji w zamówienie z jakiejkolwiek strony, wszystkie informacje takie jak adres i kwota gotówki przy odbiorze są w tym momencie ostateczne.

6. Połączenie Zaktualizuj zamówienie zamówienia od państwa OTWARTY do WYSYŁKA  dla wszystkich zamówień, dla których rozpocząłeś proces wysyłki. Jeśli stwierdzisz, że zamówienie nie może zostać wysłane, istnieje możliwość zmiany statusu zamówienia na ten moment ANULOWANY.

7a. Korzystając z dostawy MALL, zadzwoń Generuj etykiety dla wybranych zamówień MDP do drukowania etykiet dla zamówień MALL Delivery.

7b. Jeśli nie korzystasz z MALL Delivery, konieczne jest spełnienie warunków wysyłki określonych przez Twojego przewoźnika.

8. Dostawa przesyłki do firmy transportowej.

9a. Korzystając z dostawy MALL, zadzwoń Zaktualizuj zamówienie zmienić status zamówienia z WYSYŁKA  na WYSŁANE (zmiana statusu na WYSYŁANA musi zawsze nastąpić dopiero po przekazaniu przesyłki firmie transportowej).

9b. Jeśli nie korzystasz z dostawy MALL, zadzwoń Zaktualizuj zamówienie zamówienia od WYSYŁKA  na WYSŁANE, w tym adres URL śledzenia i numer przesyłki przewoźnika. Wszystkie informacje muszą być przesłane w jednym połączeniuaby spełnić kryteria jakości usług - wskaźnik śledzenia.

Opcjonalny: Korzystając z MALL Delivery, możesz zadzwonić na podstawie powiadomienia webhook o zmianie w zamówieniu POBIERZ szczegóły zamówienia dla zamówień w stanie DOSTARCZONE / ZWRÓCONE / ZGUBIONE, w celu dokręcenia ostatecznego statusu zamówień do Twojego systemu.

10. Jeśli nie korzystasz z MALL DELIVERY, zadzwoń Zaktualizuj zamówienie z WYSŁANE na DOSTARCZONE z dokładną datą dostawy na podstawie informacji od Twojego przewoźnika. Jeżeli posiadasz informację od przewoźnika o pierwszej próbie doręczenia, również możesz ją dodać, informacja ta jest opcjonalna. Aktualizacja musi zostać wysłana w jednym połączeniu. Jeśli zamówienie nie mogło zostać dostarczone i zostało zwrócone do nadawcy, zmień status zamówienia z WYSŁANE na ZWRÓCONY.


SLA i doświadczenie klienta: W przypadku obu form łączenia zamówień jest to pożądane w stosunku do klienta, a także ostateczne SLA, tak aby przesyłanie statusów zamówień było zgodne z prawdą i było jak najbardziej aktualne. Niewłaściwa implementacja statusu wysyłki może prowadzić do negatywnych doświadczeń klientów i anulowania zamówień.


Sekwencja wywołań zamówień bez użycia webhooka

1. Połączenie Pobierz listę niepotwierdzonych zamówień przy regularnej częstotliwości zalecamy dostosowanie częstotliwości do średniej liczby zamówień. Przekraczaj częstotliwość tylko raz na godzinę dla ponad 100 zamówień dziennie. Używaj filter = basic podczas dzwonienia.

2. Oparte na Lista niepotwierdzonych zamówień połączenie Uzyskaj szczegóły zamówienia dla zamówień w statusie ZABLOKOWANY do rezerwacji towarów. Przejmij tylko informacje o towarach. Otrzymuj informacje finansowe tylko dla zamówień w statusie OTWARTY. Rezerwacja towaru nie jest obowiązkowa, ale jest wysoce zalecana w przypadku towarów o wysokiej zbywalności i związanym z tym ryzykiem wyprzedania.

3. Połączenie Zaktualizuj zamówienie z potwierdzone = prawda dla OTWARTY/ANULOWANY zamówienia, które zostały zarejestrowane przez Twój system w wezwaniu.

4. Połączenie Uzyskaj szczegóły zamówienia na OTWARTY potwierdzone zlecenia importu danych końcowych do Twojego systemu. W tym momencie nie ma już możliwości ingerencji w zamówienie z jakiejkolwiek strony, wszystkie informacje takie jak adres i kwota gotówki przy odbiorze są w tym momencie ostateczne.

5. Połączenie Zaktualizuj zamówienie zamówienia od państwa OTWARTY do WYSYŁKA  dla wszystkich zamówień, dla których rozpocząłeś proces wysyłki. Jeśli stwierdzisz, że zamówienie nie może zostać wysłane, istnieje możliwość zmiany statusu zamówienia na ten moment ANULOWANY.

6a. Korzystając z dostawy MALL, zadzwoń Generuj etykiety dla wybranych zamówień MDP do drukowania etykiet dla zamówień MALL Delivery.

6b. Jeśli nie korzystasz z MALL Delivery, konieczne jest spełnienie warunków wysyłki określonych przez Twojego przewoźnika.

Rekomendacje: Przed wysłaniem zamówienia zalecamy sprawdzenie statusu zamówienia. W stanie WYSYŁKA  istnieje możliwość anulowania zamówienia przez klienta. Taka kolejność zostanie następnie zmieniona na stan przez system ANULOWANY. Ta zmiana pojawi się również na liście Pobierz listę niepotwierdzonych zamówień i musi zostać potwierdzony w kroku 3.

7. Dostarczenie przesyłki do firmy transportowej.

8a. Korzystając z dostawy MALL, zadzwoń Zaktualizuj zamówienie zmienić status zamówienia z WYSYŁKA  na WYSŁANE (zmiana statusu na WYSYŁANA musi zawsze nastąpić dopiero po przekazaniu przesyłki firmie transportowej).

8b. Jeśli nie korzystasz z dostawy MALL, zadzwoń Zaktualizuj zamówienie zamówienia od WYSYŁKA  na WYSŁANE, w tym adres URL śledzenia i numer przesyłki przewoźnika. Wszystkie informacje muszą być przesłane w jednym połączeniu, aby spełnić kryteria jakości usługi - Tracking rate.

Opcjonalny: Możesz korzystać z połączeń podczas korzystania z dostawy MALL Pobierz listę zamówień według statusu używanie filtra czasu dla DOSTARCZONE / ZWRÓCONE / ZGUBIONE zamówień w celu dokręcenia ostatecznego statusu zamówień do Twojego systemu.

9. Jeśli nie korzystasz z dostawy MALL, zadzwoń Zaktualizuj zamówienie z WYSŁANE na DOSTARCZONE z dokładną datą dostawy na podstawie informacji od Twojego przewoźnika. Jeżeli posiadasz informację od przewoźnika o pierwszej próbie doręczenia, również możesz ją dodać, informacja ta jest opcjonalna. Aktualizacja musi zostać wysłana w jednym połączeniu. Jeśli zamówienie nie mogło zostać dostarczone i zostało zwrócone do nadawcy, zmień status zamówienia z WYSŁANE na ZWRÓCONY.

Weryfikacja wsteczna danych: Jeśli zaistnieje sytuacja, w której musisz odzyskać dane zamówienia, zawsze dzwoń do poszczególnych zamówień, których danych potrzebujesz. Jeśli nadal konieczne jest wywołanie listy zamówień, skorzystaj z niej filtry przedziałów czasowych i unikaj jednoczesnego wywoływania całej historii zamówień. Korzystaj z samofakturowania do celów fakturowania i rozliczeń odpowiednie punkty końcowe.

Powrót do góry


Produkty

W przypadku produktów musisz skupić się na dwóch rodzajach połączeń, tworzeniu produktów i ich aktualizowaniu.

Tworzenie produktów i wariantów

W tworzenie produktu proszę zawsze zwracać uwagę na nasze warunki dotyczące zawartości produktu, szczegóły można znaleźć tutaj. Następnie ucz się uważnie warunki wyświetlania produktu w poszczególnych kategoriach w artykule tutaj aby uniknąć konieczności kolejnych napraw produktu poprzez kolejne telefony.

Ważny: Jeśli Twoje produkty mają warianty, zawsze twórz warianty produktów na podstawie parametrów dostępnych w danej kategorii. Wysyłanie produktów wariantowych jako pojedynczych rekordów jest niepożądane i może prowadzić do pobierania ofert z sieci.

Produkty bez wariantów twórz dzwoniąc Utwórz nowy produkt, w przypadku wystąpienia błędu w tym wezwaniu, przygotowaliśmy dla Państwa artykuł wyjaśniający poszczególne błędy oraz możliwy sposób zapobiegania tym błędom i ich poprawiania. Artykuł można znaleźć pod linkiem tutaj. Struktura wywołania jest obowiązkowa z wyjątkiem elementów, które są wyraźnie określone w dokumentacji. Utworzony w ten sposób produkt można następnie znaleźć na liście produktów w portalu, a także na stronie internetowej w liście produktów, można użyć przycisku konto piaskownicy.

W produkty wariantowe najpierw użyj metody Utwórz nowy produkt stworzyć główny produkt. Następnie do tego produktu przy użyciu metody Utwórz nowy wariant dodać warianty. Warianty muszą być rozróżniane za pomocą parametrów wariantu. Możesz użyć maksymalnie dwóch parametrów dostępnych w danej kategorii. Warianty przypisane do produktu głównego są następnie zawsze wyświetlane w szczegółach produktu z odpowiednim parametrem jako zmienną opcjonalną dla klienta.

Aktualizacje produktów

W przypadku produktów dzielimy aktualizację na kilka typów.

  • Aktualizacja danych produktów (etykiety, obrazy, parametry, ..)
  • Aktualizacja cen
  • Aktualizacja dostępności

Ważny: Wysyłaj aktualizacje produktów tylko w przypadku zmian. Wielokrotne wysyłanie tych samych informacji jest wysoce niepożądane i uciążliwe dla platformy.

Aktualizacja danych produktu

Użyj odpowiedniej metody UPDATE podczas aktualizacji danych produktu niewariantowy produkt lub warianty. Zmieniaj dane tylko w przypadku ich zmiany lub konieczności uzupełnienia. Za każdym razem, gdy aktualizujesz produkt, zawsze musisz przesłać wszystkie elementy, a nie tylko te, które się zmieniły.

Aktualizacja cen

Aby zaktualizować cenę, nie korzystaj z metody aktualizacji produktu lub wariantu opisanej powyżej. Aby zmienić cenę, dostępna jest osobna rozmowa, przez którą można wysłać zmianę, zarówno dla niewariantowy produkt, więc dla warianty. W przypadku aktualizacji ceny o więcej niż 30%, zmiana ceny musi zostać potwierdzona tokenem wymuszającym. Więcej informacji na temat tej funkcji znajdziesz w naszej dokumentacji tutaj.

Aktualizacja dostępności

Nie używaj metody aktualizacji produktu lub wariantu do aktualizacji dostępności opisane powyżej. Aby zmienić dostępność, użyj metody zbiorczej zmiany dostępności produktów poprzez product Partia zaktualizowanye dostępności produktu / wariantu. Prosimy o jak najczęstsze korzystanie z tej opcji aktualizacji, poprzez zbiorczą aktualizację można zaktualizować jednocześnie do 1000 produktów/wariantów.

Alternatywnie, jeśli wymagane są zmiany jednostek jednostkowych, można skorzystać z metody aktualizacji dostępności zapasów produkt którego warianty.

Weryfikacja wsteczna danych: Jeśli istnieje przypadek, w którym musisz odzyskać dane o produkcie, dzwoń do nich tylko wtedy, gdy jest to konieczne i tylko przez odpowiedni punkt końcowy dla ceny lub dostępności. Wszelkie regularne masowe lub indywidualne wezwania do podania danych produktów są wysoce niepożądane i uciążliwe dla naszego systemu i mogą prowadzić do ograniczenia Twojego połączenia z MALL.

Powrót do góry

Punkty końcowe partii

W ramach API MALL niektóre akcje można wykonywać zbiorczo. Korzystając z punktów końcowych partii, znacznie zmniejszysz wykorzystanie limitu wywołań interfejsu API w ramach ogranicznika szybkości, dlatego zaleca się używanie ich w jak największym stopniu.

Dostępne punkty końcowe partii to:

  • Dostępność partii aktualizacja - Tak jak opisano powyżej dla aktualizacji dostępności, jest to zbiorcza aktualizacja dostępności produktów i wariantów. Ta metoda pozwala na aktualizację do 1000 zmian w jednym wywołaniu.
  • Aktywne wybrane produkty - Masowa zmiana wybranych produktów z wersji roboczej na żywą.
  • Aktywuj produkty - Masowo zmień wszystkie produkty z wersji roboczej na żywą.

Dezaktywacja i usuwanie produktów

Istnieje kilka metod pobierania produktu z sieci Web, w zależności od powodu, dla którego produkt jest pobierany.

  • Tymczasowa sprzedaż produktu, który zostanie uzupełniony - w takim przypadku w ramach aktualizacji dostępności produktu wystarczy zmniejszyć stan magazynowy produktu do „0”, nie będzie można go kupić na stronie, a klienci nadal będą mogli oglądać trochę czasu, aby sprawdzić, czy produkt ponownie pojawi się w ofercie.
  • Tymczasowa potrzeba pobrania produktu z sieci - ponownie aktualizując dostępność produktu można skorzystać z pola statusu, gdzie ustawienie wartości „N” powoduje, że produkt lub wariant staje się „nieaktywny”.
  • Usunięcie produktu - jeśli wiesz, że produkt lub wariant nie będzie dostępny dłużej niż 2 miesiące, polecamy produkt którego wariant przez odpowiedni punkt końcowy. MALL przechowuje historyczne dane sprzedaży Twoich produktów, jeśli następnie prześlesz produkt pod tym samym identyfikatorem, dane sprzedaży zostaną ponownie sparowane.

Ważny: Nie aktualizuj żadnego produktu, który jest nieaktywny. Retransmisja aktualizacji dla nieaktywnych produktów jest wysoce niepożądana i uciążliwa dla platformy. Przekroczenie limitu może prowadzić do przeciążenia systemu, jedynie częściowej akceptacji danych, co może skutkować zarówno negatywnym doświadczeniem klienta, jak i potencjalną stratą ze strony partnera.

Powrót do góry


Kategoria

W naszym API użyj dwóch podstawowych punktów końcowych, aby pobrać dane kategorii. W pierwszym Drzewo kategorii według kraju otrzymasz drzewo kategorii dostępne dla tego kraju. Zmieniając kod kraju w adresie URL wywołania, możesz uzyskać informacje o innych drzewach kategorii krajów przy użyciu tego samego klucza API.

Wynikiem wywołania API są zawsze dane niezbędne do integracji.

  • ID pozycji menu (= "Id pozycji menu") - unikalny kod kategorii, którego możesz użyć dzwoniąc Szczegóły kategorii Aby uzyskać listę wszystkich parametrów i wartości, wywołanie jest opisane poniżej.
  • Identyfikator typu produktu (= "Identyfikator TypuProduktu") - kod kategorii technicznej potrzebny do sklasyfikowania produktu, kod ten może być zgodny z wieloma identyfikatorami menuitemID.
  • Ograniczenia menu (= "Więzy menu") - obowiązkowe parametry z wartościami, które należy uwzględnić w danym menuitemID, aby uzyskać szczegółowe informacje na temat warunków kategorii, przeczytaj szczegółowy artykuł tutaj.

Weryfikacja wyświetleń w sieci: Produkt przesłany do systemu, który nie spełnia Ograniczenia menu, może pokazywać błąd podczas wyświetlania i nie będzie dostępny dla klientów.

Poprzez wywołania API Szczegóły kategorii wtedy otrzymasz listę danych. Pierwsza część zawiera warunki wyświetlania w danej kategorii.

  • Identyfikator SAP (= "Identyfikator SAP") - kod techniczny kategorii, jest to ten sam kod, który został podany w poprzednim zaproszeniu jako Identyfikator typu produktu, jest to kod techniczny kategorii potrzebny do sklasyfikowania produktu.
  • Kategoria Warunki (= "Warunki kategorii") - tutaj znajdziesz te same dane co w Ograniczenia menu w poprzednim wezwaniu. Aby umieścić produkt w dowolnej kategorii, należy zawsze poprawnie wpisać te warunki.

Weryfikacja wyświetleń w sieci: Produkt przesłany do systemu, który nie spełnia Warunków Kategorii, może pokazywać błąd wyświetlania i nie będzie dostępny dla klientów.

  • Inne parametry (= "Inne parametry"): Tutaj znajdziesz wszystkie inne parametry z wartościami, które możesz wykorzystać i dodać do swoich produktów. W przypadku parametrów zawsze konieczne jest skorzystanie z listy wartości, którą znajdziesz tutaj, nie ma możliwości wpisania własnych wartości w parametrach. Zawsze dodawaj nazwę parametru do produktu w nazwach technicznych, polach Wartość. Zawsze wpisuj wartości w nazwie docelowego kraju sprzedaży, czyli wartości z pola "tekst". W przypadku wartości liczbowych zawsze używaj jednostki podanej w polu Jednostka. Jeśli parametr nie zawiera potrzebnych wartości, wyślij zapytanie do onboarding@mallgroup.com.

Powrót do góry


Marki

Korzystanie z połączenia Zdobądź wszystkie marki Otrzymasz kompletną listę dostępnych marek we wszystkich krajach. Lista ta nie jest unikalna dla każdego kraju, więc możesz ją wykorzystać do połączenia się z dowolnym rynkiem partnerskim MALL. Zawsze dodawaj pole "brand_id" do produktów w dopasowaniu 100%, także z dużych liter.

Dla dodawanie tagu użyj odpowiedniej zakładki w portalu partnerskim zgodnie z instrukcjami tutaj.


Etykiety

Korzystanie z połączenia Pobierz wszystkie etykiety zawsze otrzymasz pełną listę etykiet w naszej bazie danych. Etykiety są używane w kampaniach marketingowych i innych procesach wewnętrznych. Etykiety te mogą być używane bez uprzedniej zgody przedstawiciela handlowego MALL.

  • FDEL - bezpłatna dostawa
  • WYPRZEDAŻ - wyprzedaż
  • Nowy nowy

Powrót do góry

Jak przydatny był ten post?

Kliknij gwiazdkę, aby ocenić post!

Średnia ocena: / 5. Liczba głosów:

Nie ma jeszcze głosów! Oceń ten post jako pierwszy.