VulCode

Integracja Shoper z hurtowniami, ERP i Allegro

Produkty z hurtowni trafiają do sklepu na Shoperze same, zamówienia płyną do Subiekta albo innego ERP, a stany zgadzają się z Allegro. Przez REST API Shopera, z poszanowaniem jego limitów.

Platformy sklepowe
Panel integracji sklepu na Shoperze: jeden produkt z trzech hurtowni połączony po EAN, reguła wyboru hurtowni i cena sprzedaży z marżą i VAT

Dwie drogi do API Shopera

Shoper rozróżnia integrację jednego sklepu i aplikację dla wielu sklepów. Od tego zależy autoryzacja.

Użytkownik WebAPI

Integracja jednego sklepu. Login i hasło użytkownika z dostępem WebAPI wymieniamy na token.

Aplikacja w Shoper App Store

Aplikacja dla wielu sklepów. Autoryzacja przez OAuth z kodem autoryzacyjnym i tokenem odświeżającym.

  • Użytkownik WebAPI: Login i hasło na token

    Użytkownik z dostępem WebAPI wymienia je na token pod /webapi/rest/auth. Bez tego dostępu Shoper odmawia autoryzacji.

    Aplikacja w Shoper App Store: Kod autoryzacyjny i token odświeżający

    OAuth z grant_type authorization_code. Dostęp odnawia token odświeżający, bez loginu i hasła sklepu.

  • Użytkownik WebAPI: Instalujesz Ty

    Użytkownika zakładasz w panelu swojego sklepu, z dostępem tylko do potrzebnych zasobów.

    Aplikacja w Shoper App Store: Instaluje każdy sklep

    Każdy sklep, który doda aplikację, łączy się z nią osobno.

  • Użytkownik WebAPI: Hurtownie, ERP i kurierzy

    Pasuje do integracji Twojego sklepu z hurtowniami, ERP i kurierami.

    Aplikacja w Shoper App Store: Narzędzie dla innych sklepów

    Budujemy ją, gdy integracja ma trafić do wielu sklepów.

Dla jednego sklepu zwykle wystarcza użytkownik WebAPI z ograniczonymi uprawnieniami. Aplikację budujemy, gdy integracja ma trafić do wielu sklepów.

Token i limit zapytań w praktyce

Shoper liczy zapytania w modelu cieknącego wiadra i mówi w nagłówkach, ile zostało. Dziennik importu pokazuje, jak kolejka z tego korzysta.

Dziennik zapytań importu do Shopera: zapełnienie wiadra zapytań z nagłówków, odmowa 429 z Retry-After, ponowienie i użytkownik WebAPI z uprawnieniami

  1. Zmiana z hurtowni

    np. nowy stan albo cena

  2. Token dla użytkownika WebAPI

    POST /webapi/rest/auth

    Własne konto integracji, z dostępem tylko do potrzebnych zasobów, nie konto administratora.

  3. Licznik z nagłówków

    X-Shop-Api-Calls / X-Shop-Api-Limit

    Nagłówki mówią, ile zapytań zużyto i jaki jest limit. Przy pełnym wiadrze kolejka zwalnia.

  4. Odmowa i ponowienie

    Retry-After

    Po przekroczeniu Shoper podaje w Retry-After, ile czekać. Kolejka czeka dokładnie tyle i ponawia, jak oficjalna biblioteka, domyślnie do 5 razy.

  5. Zapis w sklepie

    pod adresem sklepu, w /webapi/rest

Produkt z hurtowni w sklepie na Shoperze

Najczęstsza integracja przy Shoperze. Mapowanie decyduje, czy klient zobaczy porządny opis, czy chaos.

Klocki konstrukcyjne, zestaw 480 el.

Ten sam produkt jest w trzech hurtowniach. Reguła wybrała Hurtownię 01, najtańszą z co najmniej 5 sztukami.

Wiersz z pliku Hurtowni 01

Kod hurtowni
H1-KL480
EAN
5901234300028
Cena zakupu netto
82,40 zł
Stan w hurtowni
46 szt.
Kategoria w pliku
Zabawki > Klocki

Wspólny klucz

Produkt w sklepie
KLC-480, ten sam EAN
Reguła

Kod produktu i EAN bez duplikatów. Gdy ten sam EAN ma kilka hurtowni, reguła wybiera jedną.

Marża i VAT

Po marży 35%
111,24 zł netto
Z VAT 23%
136,83 zł
Z końcówką ceny
136,99 zł
Reguła

Marża kategorii, stawka VAT i końcówka ceny według Twoich reguł.

Stan i kategoria

Stan w sklepie
46 szt., bez bufora przy takim stanie
Kategoria w sklepie
Zabawki > Klocki konstrukcyjne
Reguła

Bufor stanu przy małej ilości, kategoria z mapy ustalonej raz.

Produkt na Shoperze

Klocki konstrukcyjne, zestaw 480 el.
  • 136,99 zł z VAT
  • Dostępny, 46 szt.
  • 4 zdjęcia pobrane i dodane przez API, nie linkowane

Co płynie między Shoperem a zapleczem

Każdy kierunek ma swój zasób w REST API Shopera.

Karta produktu w sklepie na Shoperze na telefonie: cena z VAT, dostępność, kod produktu, EAN, zdjęcia i przycisk dodania do koszyka
ShoperERP, hurtownie, kurierzy
  • Zamówienia i ich pozycjeOrderOrderProductWebhook albo odpytywanie zasobów Order i OrderProduct.
  • Produkty i zdjęciaProductProductImageNowy plik albo zmiana w API hurtowni.
  • StanyProductStockDokument w ERP albo sprzedaż na Allegro, przy małej ilości z buforem.
  • PrzesyłkiParcelNadanie paczki u kuriera, z numerem przesyłki.
  • Status zamówieniaZmiana w sklepie albo w ERP.

Na co uważamy przy Shoperze

Rzeczy, które decydują o tym, czy integracja wytrzyma duży katalog.

  • Osobny użytkownik WebAPI

    Integracja ma własne konto z dostępem tylko do potrzebnych zasobów, a nie konto administratora.

    BasicAuth.php w bibliotece Shopera

  • Licznik zapytań z nagłówków

    Przy dużym imporcie wiadro szybko się zapełnia. Kolejka czyta nagłówki i zwalnia, zanim Shoper odmówi.

    Http.php w bibliotece Shopera

  • Ukrywanie zamiast usuwania

    Usunięty produkt zostawia martwy adres. Ukryty zachowuje adres i pozycję w Google.

    Migracja strony i sklepu

  • Przekierowania przy zmianach

    Shoper ma zasób przekierowań w API, więc zmiana adresu produktu może od razu dostać przekierowanie.

    Redirect.php w bibliotece Shopera

Najczęstsze pytania o Shopera

Odpowiedzi o gotowych aplikacjach, imporcie, migracji i wycenie.

Czytaj dalej

Inne platformy i integracje dla sklepów.

Skąd bierzesz towar do sklepu na Shoperze?

Napisz, z jakich hurtowni i jakiego ERP korzystasz. Odpowiemy w godzinę z pytaniami i wyceną.