Kiedy słyszysz „API Allegro”, możliwe, że myślisz: to sprawa dla programistów, nie dla mnie. Jeśli jednak prowadzisz sklep na Allegro i chcesz zautomatyzować import transakcji do Comarch ERP Optima, API Allegro jest fundamentem, na którym ta automatyzacja stoi. Nie musisz umieć go zaprogramować, ale warto rozumieć, co może dostarczyć, jakie ma ograniczenia i dlaczego jego…
Czym jest API i co robi API Allegro?
API to interfejs, przez który dwa systemy mogą się ze sobą komunikować bez udziału człowieka. Allegro udostępnia publiczne REST API, czyli zestaw adresów internetowych, tak zwanych endpointów, przez które zewnętrzna aplikacja może pobierać i wysyłać dane do systemu Allegro. Umożliwia to pobieranie listy zamówień wraz ze statusem, pozycjami i danymi kupującego, danych o płatnościach, raportów rozliczeniowych obejmujących prowizje, wypłaty i korekty, danych o zwrotach i reklamacjach, a także zarządzanie ofertami i wysyłką. Dla celów rozliczeniowych najważniejsze są trzy obszary: zamówienia, płatności i raporty rozliczeniowe, bo to właśnie z tych danych automatyczna integracja buduje dokumenty w Comarch ERP Optima.
Jak integracja z API Allegro pobiera dane o transakcjach?
Zanim integracja pobierze jakiekolwiek dane, musi się zautoryzować. Allegro korzysta z protokołu OAuth 2.0: sprzedawca raz autoryzuje dostęp, logując się na konto Allegro przez formularz integracji, a system otrzymuje token dostępu ważny przez określony czas, odnawiany potem automatycznie. Do pobierania zamówień integracja odpytuje endpoint zwracający listę zamówień z wybranego okresu lub ze statusem „nowe”, a każde zamówienie zawiera unikalny identyfikator, datę złożenia, dane kupującego, listę produktów z ilościami i cenami, wartość całkowitą, metodę płatności oraz adres dostawy.
Do rozliczenia prowizji i wypłat służy endpoint z wpisami rozliczeniowymi, obejmującymi prowizje od transakcji, korekty, opłaty za promocje i wypłaty, będący odpowiednikiem raportu rozliczeniowego z panelu sprzedawcy. Osobny endpoint dostarcza z kolei informacji o zwrotach: które zamówienia zostały zwrócone, w jakim zakresie i w jakiej kwocie.
Co API Allegro daje, a czego nie daje?
API Allegro jest rozbudowane, ale nie wszystko jest w nim dostępne w idealnej formie do celów rozliczeniowych. Dobrze dostarcza pełne dane o zamówieniach, statusy w czasie rzeczywistym, dane o płatnościach oraz szczegółowe wpisy rozliczeniowe z informacjami o prowizjach i opłatach.
Kilka rzeczy wymaga jednak dodatkowej obróbki. Dane kupujących: Allegro udostępnia imię i adres, ale NIP jest dostępny tylko wtedy, gdy kupujący sam go podał przy zamówieniu, co przy zakupach prywatnych jest opcjonalne, więc integracja musi umieć obsłużyć jego brak i dobrać właściwy typ dokumentu. Łączenie transakcji z wypłatami wymaga zestawienia wpisów rozliczeniowych z datami wypłat, bo nie jest to gotowy raport, tylko dane wymagające dodatkowego przetworzenia. Warto też pamiętać, że API Allegro ogranicza dostęp do danych historycznych, zwykle do ostatnich 3–12 miesięcy przez standardowe endpointy.
Limity API Allegro – o czym musi wiedzieć integracja?
API Allegro stosuje rate limiting, czyli ogranicza liczbę zapytań, które można wysłać w określonym czasie, a jeśli integracja wysyła je zbyt szybko, Allegro na jakiś czas blokuje dostęp. Dla typowego sklepu z kilkoma tysiącami transakcji miesięcznie limity te nie są problemem, bo integracja spokojnie mieści się w dozwolonych granicach. Przy bardzo dużych wolumenach, rzędu dziesiątek tysięcy transakcji dziennie, konieczne jest odpowiednie zarządzanie kolejką zapytań i cachowanie danych. Dobra integracja obsługuje rate limiting automatycznie, wykrywając odpowiedź o zbyt wielu zapytaniach i czekając odpowiedni czas przed ponowieniem próby, zamiast po prostu pomijać dane.
Dlaczego jakość API Allegro ma znaczenie dla Twojej ewidencji?
Może się wydawać, że API to sprawa techniczna, daleka od codziennej pracy przy rozliczeniach, ale jakość danych z niego bezpośrednio wpływa na jakość dokumentów w Comarch ERP Optima. Niekompletne dane kupującego przekładają się na brakujące lub błędne kartoteki kontrahentów, co utrudnia wystawianie faktur imiennych czy B2B. Opóźnienie danych oznacza, że integracja pobiera zamówienie z opóźnieniem, a dokument w Optimie dostaje błędną datę, co przekłada się na błąd w ewidencji VAT. Zmiana formatu danych po stronie Allegro, jeśli integracja nie zostanie zaktualizowana, może z kolei sprawić, że dane zaczną być mapowane niepoprawnie. Dlatego dobra automatyczna integracja nie tylko pobiera dane z API, ale też aktywnie monitoruje ich kompletność i jakość, informując administratora o wszelkich anomaliach.
Podsumowanie
API Allegro to fundament automatyzacji rozliczania sprzedaży na tej platformie. Przez API można pobierać dane o zamówieniach, płatnościach, prowizjach i zwrotach, a na ich podstawie automatycznie generować dokumenty w Comarch ERP Optima. Jakość integracji zależy od tego, jak dobrze obsługuje autoryzację, rate limiting, niekompletne dane kupujących i zmiany w samym API. Dobra integracja działa w tle, bez Twojego udziału, i powiadamia Cię tylko wtedy, gdy coś rzeczywiście wymaga uwagi.
Chcesz zobaczyć, jak EcomRail używa API Allegro do automatycznego rozliczania transakcji w Comarch ERP Optima? Umów bezpłatną prezentację i sprawdź integrację w praktyce.