Integracja z Allegro przez API
Sprzedaż na Allegro generuje zamówienia, wiadomości i zmiany stanów w kilku miejscach naraz. Własna integracja zbiera to w jeden obieg z Twoim magazynem i dokumentami.
Autor: Szymon Łakomy. Aktualizacja:
Czy na pewno potrzebujesz własnej integracji
Wielu sprzedawców obsługuje Allegro przez pośrednika, taki jak BaseLinker, który zbiera kanały sprzedaży w jednym panelu. To dobre rozwiązanie i często wystarcza. Bezpośrednia integracja ma sens, gdy masz własny system magazynowy lub produkcyjny, kilka kont Allegro i nietypową logikę albo chcesz zbudować coś, czego pośrednik nie robi. Opisuję też wariant pośredni na stronie integracja BaseLinker.
Co robi taka integracja
- Zamówienia. Pobieranie nowych zamówień i zmian ich statusu, bez odpytywania ręcznego.
- Stany i ceny. Aktualizacja ilości w ofertach po sprzedaży w innym kanale lub zmianie w magazynie.
- Dokumenty. Wystawienie faktury w programie księgowym i przekazanie jej kupującemu.
- Wysyłka. Przekazanie numerów przesyłek do zamówień.
- Wiadomości. Zbieranie pytań od kupujących do jednego miejsca, a przy prostych sprawach także przygotowanie odpowiedzi do akceptacji.
Szczegóły techniczne, które decydują o stabilności
Autoryzacja i odświeżanie tokenów
Dostęp do konta wymaga zgody sprzedawcy, a tokeny wygasają. Integracja odnawia je sama i zgłasza problem, gdy się nie uda.
Zdarzenia zamiast ciągłego odpytywania
Zamiast pobierać całą listę zamówień, korzystam z mechanizmu zdarzeń, który ogranicza liczbę zapytań i zmniejsza ryzyko przekroczenia limitów.
Środowisko testowe
Allegro oferuje środowisko testowe, w którym sprawdzam przepływ bez ruszania prawdziwych zamówień.
Odporność na duplikaty
To samo zdarzenie nie może wystawić dwóch faktur. Każdy krok jest zabezpieczony przed ponownym wykonaniem.
Typowe błędy w integracjach z marketplace
- ten sam egzemplarz sprzedany w dwóch kanałach, bo stan zaktualizował się z opóźnieniem,
- zamówienie wielopozycyjne zapisane w magazynie jako osobne sprawy,
- zmiana adresu dostawy po złożeniu zamówienia, która nie dociera do systemu wysyłki,
- nazwa pozycji w ofercie inna niż w magazynie, przez co dokument sprzedaży nie zgadza się z ofertą.
Dlatego przy każdym z tych przypadków ustalam, który system jest źródłem prawdy i co się dzieje, gdy dane się rozjadą.
Zakres i cena
Najprostszy wariant, czyli pobieranie zamówień do jednego systemu i przekazywanie statusów, zaczyna się od około 800 zł netto. Dwukierunkowa synchronizacja stanów i ofert z wieloma magazynami i wyjątkami to zwykle projekt od około 2000 zł netto. Ogólne zasady wyceny opisuję w poradniku ile kosztuje integracja API.
Najczęstsze pytania
Czy integracja narusza regulamin Allegro?
Korzystam wyłącznie z oficjalnego API, które jest do tego przeznaczone. Zasady użycia, w tym limity, uwzględniam w projekcie.
Czy mogę obsługiwać kilka kont Allegro naraz?
Tak. Każde konto autoryzuje się osobno, a dane trafiają do wspólnego obiegu z oznaczeniem źródła.
Co z opisami ofert i zdjęciami?
Zarządzanie ofertami z poziomu własnego systemu jest możliwe, ale to osobny, większy zakres. Zaczynamy zwykle od zamówień i stanów, bo tam jest największa oszczędność czasu.
Czy integracja zadziała, gdy na Allegro jest dużo zamówień?
Tak, przy odpowiedniej architekturze. Zdarzenia przetwarzam w kolejce, a limity API uwzględniam w tempie pobierania.
Powiązane strony
Chcesz zautomatyzować obsługę Allegro?
Napisz, w jakich systemach pracujesz i ile zamówień obsługujesz. Odpowiem z propozycją.