Opis
Apiler to prywatne, wewnętrzne narzędzie operacyjne dla sklepu prowadzonego przez właściciela. Aplikacja działa jako backend wspomagający obsługę zamówień w systemie Apilo (xsklep.apilo.com) i automatyzuje dołączanie linków do dokumentów rozliczeniowych (e‑paragonów wystawianych przez kasę fiskalną z usługą eparagony.pl) do zamówień złożonych na Allegro.
Cykl pracy: po wystawieniu paragonu z kasy fiskalnej, integracja eparagony.pl publikuje komentarz w karcie zamówienia w Apilo z linkiem publicznym do dokumentu. Apiler wykrywa ten komentarz i — przez REST API Allegro — dołącza link do panelu kupującego, dzięki czemu klient ma dostęp do dowodu zakupu zaraz po wystawieniu.
Wykorzystanie API Allegro
-
dołączanie linków do dokumentów rozliczeniowych do zamówień —
POST /order/{orderId}/billing-documents/links -
autoryzacja OAuth2 (
authorization_code,refresh_token) — odświeżanie tokenu w tle co 12 godzin bez interakcji użytkownika
Aplikacja działa wyłącznie na zamówieniach własnego sprzedawcy. Nie wystawia ofert, nie modyfikuje cen ani parametrów oferty, nie obsługuje zwrotów ani komunikacji z kupującymi. Jedynym zapisem do API Allegro jest dołączenie URL dokumentu rozliczeniowego do konkretnego zamówienia po wystawieniu paragonu fiskalnego.
Zakres uprawnień (scope OAuth)
allegro:api:orders:read— odczyt zamówień własnego sprzedawcyallegro:api:orders:write— dołączanie dokumentów do tych zamówień
Zakres
Zakres: pojedynczy sprzedawca (właściciel).
Charakter: niekomercyjny, wewnętrzny — narzędzie operacyjne sklepu, nie SaaS.
Domena docelowa linków: wyłącznie hub.eparagony.pl (publiczne linki do e‑paragonów).
Identyfikacja w API
Aplikacja wysyła nagłówek
User-Agent: Apiler/1.0.0 (+https://api.wieja.eu/apiler)
we wszystkich żądaniach do api.allegro.pl oraz
allegro.pl/auth/oauth.
Kontakt
Norman Wieja — zamowienia@x-sklep.pl