Dokumentacja

Dokumentacja integracji — Molin / Magnificent Coffee & Allegro API

Nazwa aplikacji: Molin — Magnificent Coffee Allegro Sync

Właściciel konta: Magnificent Coffee (magnificentcoffee.pl)

Wersja dokumentu: 1.0 — październik 2026

1. Cel aplikacji

Aplikacja jest integracją wewnętrzną, tworzoną wyłącznie na potrzeby jednego konta sprzedawcy (Magnificent Coffee) i służy do synchronizacji danych pomiędzy sklepem internetowym sprzedawcy (platforma Shoper) a kontem sprzedawcy na Allegro. Aplikacja nie świadczy usług innym sprzedawcom i nie jest produktem komercyjnym oferowanym na rynku — jest wykorzystywana jedynie do automatyzacji pracy jednego, własnego konta Allegro.

2. Zakres funkcjonalny

Synchronizacja ofert: tworzenie i aktualizacja ofert na Allegro na podstawie danych produktowych ze sklepu Shoper (nazwa, cena, zdjęcia, opis, kategoria, parametry).

Aktualizacja opisów ofert: edycja treści opisowej ofert w celu utrzymania zgodności z aktualną kartą produktu w sklepie źródłowym oraz poprawy jakości prezentacji produktu.

Zarządzanie stanami magazynowymi: aktualizacja dostępnych ilości (stock) ofert na Allegro w oparciu o stan magazynowy w systemie sklepowym, w celu uniknięcia nadsprzedaży.

Obsługa zamówień: odczyt nowych zamówień złożonych na Allegro w celu ich dalszego przetworzenia (realizacja, wysyłka, aktualizacja statusu).

3. Wykorzystywane zasoby Allegro REST API

/sale/offers, /sale/product-offers — tworzenie i aktualizacja ofert, w tym opisów i parametrów

/sale/offers/ — edycja pojedynczej oferty (cena, stan, opis)

/order/checkout-forms — pobieranie i przetwarzanie zamówień

/order/shipments — aktualizacja statusu wysyłki

/sale/categories, /sale/categories//parameters — mapowanie kategorii i parametrów ofert

4. Autoryzacja użytkowników (OAuth 2.0)

Aplikacja korzysta z protokołu OAuth 2.0 w wariancie Authorization Code, zgodnie z wymaganiami Allegro REST API dla operacji wykonywanych w imieniu zalogowanego sprzedawcy. Właściciel konta jednorazowo loguje się na stronie Allegro i udziela aplikacji zgody na wskazane uprawnienia (odczyt/zapis ofert, odczyt zamówień). Aplikacja przechowuje wyłącznie token dostępowy (access token) oraz token odświeżający (refresh token) w zaszyfrowanym magazynie sekretów, nie przechowuje danych logowania (login/hasło) użytkownika Allegro. Tokeny są odświeżane automatycznie zgodnie z czasem ich wygasania, bez ponownej interakcji użytkownika.

5. Zgodność z regulaminem REST API Allegro

Aplikacja jest wykorzystywana wyłącznie na potrzeby jednego konta sprzedawcy (Magnificent Coffee) i nie jest redystrybuowana ani udostępniana innym podmiotom.

Dane pobierane z API (oferty, zamówienia) są wykorzystywane jedynie w celu realizacji procesów sprzedażowych właściciela konta i nie są przekazywane podmiotom trzecim.

Aplikacja respektuje limity zapytań (rate limiting) określone przez Allegro i stosuje mechanizmy ponownych prób (retry) zgodnie z dobrymi praktykami.

Tokeny dostępowe są przechowywane w bezpiecznym, szyfrowanym magazynie sekretów i nie są ujawniane publicznie.

6. Kontakt

W razie pytań dotyczących działania integracji: kontakt przez stronę magnificentcoffee.pl.