Dokumentacja integracji
SellBasis a Allegro API
Do czego służy aplikacja, dla kogo jest przeznaczona, w jaki sposób korzysta z Allegro API i gdzie zgłosić problem techniczny albo niestandardową aktywność.
Czym jest SellBasis
Aplikacja do prowadzenia sprzedaży internetowej: kartoteka towarów, stany magazynowe, zamówienia, kompletacja i pakowanie, dokumenty sprzedaży oraz nadawanie przesyłek. Działa w przeglądarce, w modelu SaaS — każdy sprzedawca ma osobną bazę danych.
Dla kogo
Dla sprzedawców prowadzących sprzedaż w kilku kanałach naraz (Allegro, własny sklep, sprzedaż bezpośrednia), którzy chcą mieć jedną kartotekę i jeden magazyn zamiast kilku. Z aplikacji korzysta sprzedawca i jego pracownicy — nie jest to narzędzie dla kupujących.
Po co nam Allegro API
Żeby oferty odpowiadały temu, co sprzedawca ma na półce, a zamówienia z Allegro trafiały do tego samego obiegu, co pozostałe. Aplikacja działa wyłącznie na koncie sprzedawcy, który sam ją autoryzował.
Jak korzystamy z API
| Obszar | Co robimy | Po co |
|---|---|---|
| Oferty (sale/product-offers) | wystawianie i aktualizacja ofert, kończenie oferty przy zerowym stanie | oferta ma odpowiadać kartotece sprzedawcy — cenie, opisowi, zdjęciom i stanowi magazynowemu |
| Stany i ceny | cykliczna aktualizacja ilości i cen wystawionych ofert | sprzedawca prowadzi magazyn w jednym miejscu; bez tego oferta sprzedaje towar, którego nie ma |
| Zamówienia (order/checkout-forms) | pobieranie zamówień wraz z danymi kupującego, dostawą i pozycjami | zamówienie trafia do kompletacji, magazynu i dokumentów sprzedaży |
| Przesyłki (shipments) | przekazywanie numeru listu przewozowego po nadaniu paczki | kupujący śledzi paczkę w Allegro, a numer jest dowodem wysyłki przy sporze |
| Słowniki | kategorie, parametry kategorii, metody dostawy, cenniki, warunki zwrotów i gwarancji, dane GPSR | oferta musi być zgodna z wymaganiami kategorii; słowniki pobieramy na żądanie operatora |
Zasady, których się trzymamy
- Żądania idą wyłącznie w reakcji na działanie operatora albo z zaplanowanego zadania w tle — aplikacja nie odpytuje API w pętli.
- Cykliczna aktualizacja ofert chodzi w godzinach wskazanych przez sprzedawcę, domyślnie kilka razy na dobę; aktualizacja cen jest osobna i domyślnie rzadsza.
- Aktualizacje wysyłamy tylko dla ofert powiązanych z kartoteką danego sprzedawcy.
- Każde żądanie niesie nagłówek User-Agent z nazwą aplikacji, wersją, adresem serwisu i adresem kontaktowym.
Nagłówek, którym przedstawiają się nasze żądania: SellBasis/1.0.0 (+https://sellbasis.com; hello@sellbasis.com)
Autoryzacja i dane
Dostęp do konta sprzedawcy
Autoryzacja idzie ścieżką device code: sprzedawca dostaje kod, wpisuje go na allegro.pl i sam zatwierdza dostęp. Hasło do konta Allegro nigdy nie przechodzi przez naszą aplikację. Token dostępowy odświeżamy sami; sprzedawca może cofnąć dostęp w każdej chwili po swojej stronie, a my przestajemy wtedy odpytywać API.
Co robimy z danymi
Dane zamówień i kupujących trafiają wyłącznie do bazy tego sprzedawcy, którego dotyczą, i służą realizacji zamówienia: kompletacji, wystawieniu dokumentu i nadaniu przesyłki. Nie łączymy danych między sprzedawcami, nie profilujemy i nie udostępniamy ich dalej poza serwisami, które sprzedawca sam włączył (przewoźnicy, serwis faktur). Szczegóły opisuje polityka prywatności.
Kontakt techniczny
Tu prosimy zgłaszać niestandardową aktywność, podejrzenie nadużycia albo problem techniczny z integracją.
Zgłoszenia techniczne
E-mail: hello@sellbasis.com
Zgłoszenia przyjmujemy całą dobę; odpowiadamy w dni robocze, zwykle tego samego dnia. W pilnych sprawach dotyczących ruchu do API prosimy o dopisek „API" w temacie.
Podmiot odpowiedzialny
Gabor Grzybek Handel i Usługi
ul. Sosnowa 9/91, 32-310 Klucze
NIP 6372214433, wpisana do CEIDG, REGON 389680743
Serwis: sellbasis.com
Pozostałe dokumenty: regulamin, polityka prywatności, polityka plików cookies, dokumentacja API aplikacji.