VulCode

Integracja z Allegro przez REST API

Zamówienia z Allegro trafiają do Twojego sklepu, hurtowni albo ERP same, a stany i ceny wracają na Allegro, zanim ktoś kupi towar, którego już nie ma.

Sprzedaż wielokanałowa
Panel integracji: zdarzenia zamówień Allegro pobrane od kursora, powtórzone READY_FOR_PROCESSING, zdarzenie poza kolejnością i BUYER_CANCELLED w trakcie realizacji ze stanem z checkout-form
Telefon w magazynie: zamówienie z Allegro anulowane w trakcie pakowania z komunikatem "Nie pakuj" i półką do odłożenia towaru, pod nim zamówienia do spakowania

Bezpośrednio czy przez BaseLinkera

Drogę dobieramy do Twojej sprzedaży: przy kilku kanałach łączymy przez BaseLinkera, a gdy Allegro jest głównym kanałem, bezpośrednio. Obie prowadzimy od mapy danych po utrzymanie.

  1. Twój system
  2. BaseLinker
  3. Allegro i inne kanały

Przez BaseLinkera

Wybierz, gdy
Kanały sprzedaży

Sprzedajesz w kilku kanałach naraz: Allegro, sklep, inne marketplace'y.

Na czym stoi sprzedaż

BaseLinker już obsługuje Twoje zamówienia, etykiety i dokumenty.

Funkcje i kontrola

Wystarcza to, co daje pośrednik.

Co budujemy

Łączymy Twój system z BaseLinkerem, a on z Allegro. Mniej kodu, jedno miejsce dla wszystkich kanałów.

  1. Twój system
  2. API Allegro

Bezpośrednio przez API Allegro

Wybierz, gdy
Kanały sprzedaży

Allegro jest głównym albo jedynym marketplace'em.

Na czym stoi sprzedaż

Integracja jest częścią Twojego systemu: hurtowni, ERP albo platformy.

Funkcje i kontrola

Potrzebujesz funkcji, których pośrednik nie daje, albo pełnej kontroli nad zdarzeniami.

Co budujemy

Aplikacja zarejestrowana w Allegro, autoryzowana przez sprzedawcę, z obsługą zdarzeń i limitów.

Jak sprzedawca łączy konto Allegro z aplikacją

Sprzedawca loguje się na stronie Allegro, a Twoja aplikacja nigdy nie widzi jego hasła.

Jak długo co działa

  • Jednorazowy kod10 s
  • Dostęp do konta12 h
  • Autoryzacja bez odświeżenia3 miesiące

Każda kreska to wielokrotnie dłuższy czas, żeby 10 sekund i 3 miesiące zmieściły się na jednej osi.

  1. Hasło zostaje u Allegro

    Sprzedawca loguje się i zgadza na dostęp na stronie Allegro, a nie w Twojej aplikacji. Do aplikacji wraca tylko jednorazowy kod, ważny 10 sekund.

  2. Dostęp na 12 godzin

    Dostęp na 12 godzin, odświeżanie do 3 miesięcy. Klucz do odświeżenia działa tylko raz, więc nowy zapisujemy od razu.

  3. Po trzech miesiącach bez odświeżenia

    Autoryzacja wygasa i sprzedawca musi połączyć konto ponownie. Panel ostrzega o tym z wyprzedzeniem.

Panel integracji: trzy konta Allegro z ważnością access tokena, jednorazowym refresh tokenem i terminem autoryzacji, ostrzeżenie o wygasającej autoryzacji, kroki łączenia konta przez OAuth 2.0 i limit zapytań Client ID

Zdarzenia zamówienia w Allegro

Allegro opisuje zamówienie kolejnymi zdarzeniami. Realizację zaczynamy dopiero, gdy zamówienie jest gotowe do realizacji.

  1. Kupione

    Klient kupił, ale jeszcze nie zapłacił. Rezerwujemy towar, nie wysyłamy.

  2. Dane dostawy podane

    Klient wypełnił formularz dostawy. Może się powtórzyć, np. gdy płatność się nie uda.

  3. Gotowe do realizacji

    Opłacone albo płatne przy odbiorze. Dopiero teraz widać ostateczny adres dostawy i ruszamy z realizacją.

  4. Wysłane

    Twój system zmienia status realizacji w Allegro i dodaje numer przesyłki.

  • Gotowe do realizacji: anulowanie przez kupującego

    Anulowane przez kupującego

    Kupujący może anulować przed opłaceniem albo już po nim, więc zatrzymujemy realizację, jeśli trwa.

  • Dane dostawy podane: brak płatności

    Anulowane przez Allegro

    Allegro anulowało zamówienie automatycznie. Zwalniamy rezerwację towaru.

Limity Allegro w szczycie sprzedaży

Allegro opisuje limity jawnie. Integracja ma się z nimi mieścić także w szczycie sprzedaży.

Zapytania aplikacji na minutę

Jeden licznik dla aplikacji, wspólny dla wszystkich połączonych kont sprzedawców.

09000
w limicieodmowa i blokada aplikacji na minutę

Zdarzenia w jednym pobraniu na zapytanie

Allegro oddaje najwyżej 1000 zdarzeń naraz, a kolejną porcję pobieramy od ostatniego zapisanego zdarzenia.

01000
jedna porcjakolejna porcja od ostatniego zdarzenia

Jak trzymamy integrację w limicie

Kolejka

Kolejka rozkłada zapytania w czasie, zamiast wysyłać je falami.

oddala od limitu

Limity dodatkowe

Niższe, dla wybranych zasobów i na użytkownika. Sprawdzamy opis każdego zasobu, z którego korzystamy.

obniża próg dla zasobu

Po przekroczeniu limitu

Odmowa i blokada aplikacji na minutę. Wstrzymujemy kolejkę zamiast ponawiać od razu.

oddala od blokady

Zamówienie z Allegro w Twoim systemie

Najważniejsze pola formularza zamówienia i to, gdzie trafiają.

Allegro
Co pilnujemy po drodze
Twój system
  1. Allegronumer zamówienia
    →po nim poznajemy zamówienie, więc nie zapisze się dwa razy
    Twój systemzewnętrzny numer zamówienia
  2. Allegrostan zamówienia
    →realizacja rusza dopiero, gdy zamówienie jest gotowe
    Twój systemstatus płatności
  3. Allegropozycje i oferty
    →oferta powiązana z produktem po SKU
    Twój systempozycje zamówienia
  4. Allegrodostawa i punkt odbioru
    →ostateczne dopiero, gdy zamówienie jest gotowe
    Twój systemadres i metoda wysyłki
  5. Allegrodane do faktury
    →NIP firmy, gdy kupujący prosi o fakturę
    Twój systemnabywca na fakturze
  6. Allegrostatus realizacji
    ←wraca do Allegro po spakowaniu i nadaniu
    Twój systemstatus realizacji
DaneKierunekKiedy
OfertyTwój system → AllegroNowy produkt albo zmiana opisu: powiązane z produktem w katalogu Allegro.
StanyTwój system → AllegroSprzedaż w dowolnym kanale: zanim ktoś kupi brakujący towar.
CenyTwój system → AllegroZmiana cennika: każda zmiana ceny dochodzi dokładnie raz.
ZamówieniaAllegro → Twój systemZdarzenia zamówień.
Status realizacji i przesyłkaTwój system → AllegroSpakowanie i nadanie.
Wiadomości od kupującychAllegro ↔ Twój systemNowa wiadomość: gdy obsługa ma odpowiadać z Twojego panelu.

Najczęstsze pytania o integrację z Allegro

Zamówienia, autoryzacja i limity Allegro

Ile czasu zajmuje Ci dziś przepisywanie zamówień?

Napisz, gdzie sprzedajesz i gdzie trzymasz stany. Odpowiemy w godzinę z propozycją integracji i wyceną.