Agilix parduotuvės integracija su Allegro

Kaip programa Agilix Sklep naudoja Allegro REST API: paskirtis, veikimas, autorizacija, leidimai, duomenys ir atitiktis taisyklėms.

Aktualu 2026 m. rugsėjo 29 d.

Agilix Sklep - tai Allegro Developer Apps užregistruota programa, kuri sujungia internetinę parduotuvę agilix.dog (žaislai, skanėstai ir aksesuarai šunims) su pardavėjo paskyra Allegro. Jos dėka parduotuvė turi vieną produktų katalogą, vieną sandėlio likutį ir vieną užsakymų tvarkymą - nereikia palaikyti antros administravimo sistemos Allegro skydelyje.

Programą kuria ir prižiūri:

Hackerman Consulting - Adam Gajzlerowicz

NIP 7772841677

Regon 380997651

Hebanowa 16E, 62-020 Zalasewo, woj. wielkopolskie

+48 737 909 076

adam@agilix.dog

Programos paskirtis

  • parduotuvės agilix.dog produktų kėlimas kaip pasiūlymų į Allegro ir jų pavadinimo, aprašymo, nuotraukų bei kainos atnaujinimas;
  • vieno bendro sandėlio likučio palaikymas - pardavimas parduotuvėje sumažina vienetų skaičių Allegro pasiūlyme, o pardavimas Allegro sumažina likutį parduotuvėje, dažniausiai per minutę;
  • apmokėtų Allegro užsakymų perkėlimas į parduotuvės užsakymų skydelį, kad jie būtų vykdomi kartu su parduotuvėje pateiktais užsakymais;
  • užsakymo vykdymo būsenos ir siuntos numerio perdavimas į Allegro.

Kas naudoja programą

Programą naudoja tik parduotuvės agilix.dog administratorius, administravimo skydelio parduotuvės nustatymuose. Jis susieja su programa vieną Allegro pardavėjo paskyrą - tą, per kurią parduotuvė parduoda. Pirkėjai ir kiti Agilix naudotojai per šią programą neprisijungia prie Allegro ir neturi prieigos prie jos nustatymų.

Kaip keliami pasiūlymai

Administratorius prie produkto pažymi laukelį "Sinchronizuoti su Allegro" ir pasirenka kategoriją, privalomus parametrus bei kainą Allegro. Išsaugojus produktą, Agilix serveris fone įkelia nuotraukas į Allegro, sukuria arba atnaujina pasiūlymą (produktas, kategorija ir parametrai, gamintojo ir atsakingo asmens duomenys pagal GPSR, kaina, vienetų skaičius, pristatymo kainoraštis, grąžinimo ir pretenzijų sąlygos) ir jį paskelbia.

  • Nužymėjus laukelį, išjungus produktą arba pasibaigus likučiui pasiūlymas baigiamas; produktui vėl tapus prieinamam, jis atnaujinamas.
  • Pakeitimai patenka į foninių užduočių eilę, todėl redagavimas parduotuvėje nelaukia Allegro atsakymo.
  • Jei Allegro atmeta pasiūlymą, administratorius prie produkto mato Allegro klaidos kodą ir pranešimą ir gali pakartoti sinchronizavimą.

Kaip tvarkomi užsakymai

  • Kartą per minutę serveris nuskaito užsakymų įvykių žurnalą nuo paskutinio apdoroto įvykio.
  • Užsakymas patenka į parduotuvę tik tada, kai jis paruoštas vykdyti (READY_FOR_PROCESSING) ir nėra atšauktas; kiekvienas užsakymas importuojamas lygiai vieną kartą, o sandėlio likutis sumažėja užsakytų vienetų skaičiumi.
  • Atšaukus užsakymą Allegro, jis atšaukiamas ir parduotuvėje, o sandėlio likutis atkuriamas.
  • Kai administratorius pakeičia užsakymo būseną arba išsiunčia siuntą, programa atnaujina vykdymo būseną Allegro ir prideda siuntos numerį.
  • Pinigų grąžinimai už Allegro užsakymus tvarkomi Allegro skydelyje, už programos ribų.

Naudotojo autorizacija

Programa naudoja standartinį Allegro teikiamą OAuth 2.0 (Authorization Code) srautą. Ji niekieno neprašo prisijungimo vardo, slaptažodžio, Client ID ar Client Secret.

  1. Administratorius parduotuvės nustatymuose spusteli "Susieti su Allegro". Serveris sukuria pasirašytą parametrą state, galiojantį 15 minučių ir susietą su šiuo administratoriumi.
  2. Naršyklė pereina į Allegro prisijungimo puslapį (https://allegro.pl/auth/oauth/authorize), kuriame pardavėjas prisijungia prie savo paskyros ir sutinka su programos leidimais.
  3. Allegro nukreipia į užregistruotą adresą https://api.agilix.dog/allegro/oauth/callback. Serveris patikrina state parašą ir galiojimą bei tai, kad naudotojas vis dar yra parduotuvės administratorius, o tada iškeičia kodą į žetonus (https://allegro.pl/auth/oauth/token), autentifikuodamasis nuosavais programos Client ID ir Client Secret.
  4. Serveris nuskaito susietos paskyros prisijungimo vardą ir išsaugo susiejimą. Atnaujinimo žetonas saugomas tik serveryje, užšifruotas AES-256-GCM algoritmu. Prieigos žetonas atnaujinamas automatiškai, o naujas atnaujinimo žetonas iš karto pakeičia ankstesnį.

Client Secret ir žetonai niekada nepatenka į naršyklę, mobiliąją programėlę ar kitiems subjektams.

Programos leidimai

Programa prašo tik tų leidimų, kurių reikia aprašytoms funkcijoms:

allegro:api:profile:read
susietos paskyros prisijungimo vardo skaitymas, kad administratorius matytų, kuri Allegro paskyra prijungta.
allegro:api:sale:offers:read
parduotuvės pasiūlymų ir jų kūrimo operacijų rezultatų, taip pat kategorijų pasiūlymų ir jų parametrų skaitymas.
allegro:api:sale:offers:write
parduotuvės pasiūlymų kūrimas, redagavimas, skelbimas ir baigimas bei jų nuotraukų įkėlimas.
allegro:api:sale:settings:read
pristatymo kainoraščių, grąžinimo ir pretenzijų sąlygų bei gamintojų ir atsakingų asmenų duomenų (GPSR) skaitymas, kad administratorius galėtų juos pasirinkti pasiūlymams.
allegro:api:sale:settings:write
atsakingo gamintojo duomenų (GPSR) pridėjimas, jei paskyroje jų dar nėra.
allegro:api:orders:read
užsakymų įvykių ir informacijos, vežėjų ir siuntų skaitymas.
allegro:api:orders:write
užsakymo vykdymo būsenos atnaujinimas ir siuntos numerio pridėjimas.

Naudojami REST API ištekliai

Visos užklausos siunčiamos iš Agilix serverio į https://api.allegro.pl (nuotraukos - į https://upload.allegro.pl) susietos paskyros vardu:

Pasiūlymai ir jų skelbimas

  • POST /sale/product-offers
  • PATCH /sale/product-offers/{offerId}
  • GET /sale/product-offers/{offerId}
  • GET /sale/product-offers/{offerId}/operations/{operationId}
  • PUT /sale/offer-publication-commands/{commandId}
  • GET /sale/offer-publication-commands/{commandId}

Nuotraukos

  • POST /sale/images

Kategorijos ir parametrai

  • GET /sale/matching-categories
  • GET /sale/categories/{categoryId}/parameters

Pardavimo nustatymai

  • GET /sale/shipping-rates
  • GET /after-sales-service-conditions/return-policies
  • GET /after-sales-service-conditions/implied-warranties
  • GET /after-sales-service-conditions/warranties
  • GET /sale/responsible-producers
  • POST /sale/responsible-producers
  • GET /sale/responsible-persons

Užsakymai

  • GET /order/events
  • GET /order/event-stats
  • GET /order/checkout-forms/{checkoutFormId}

Vykdymas ir siuntos

  • PUT /order/checkout-forms/{checkoutFormId}/fulfillment
  • GET /order/checkout-forms/{checkoutFormId}/shipments
  • POST /order/checkout-forms/{checkoutFormId}/shipments
  • GET /order/carriers

Paskyra

  • GET /me

Tvarkomi duomenys

Programa tvarko tik pardavimui reikalingus duomenis: parduotuvės pasiūlymų duomenis ir Allegro užsakymų duomenis - vardą ir pavardę, pristatymo adresą arba atsiėmimo punktą, telefoną, el. pašto adresą allegromail.pl domene, sąskaitos faktūros duomenis, užsakytus produktus ir žinutę pardavėjui.

Užsakymų duomenys naudojami tik konkrečiam užsakymui įvykdyti ir išsiųsti. Parduotuvė Allegro pirkėjams nesiunčia jokių el. laiškų - nei operacinių, nei rinkodaros - ir nenaudoja jų duomenų rinkodarai.

Asmens duomenų tvarkymo taisyklės: Privatumo politika

Atitiktis Allegro REST API taisyklėms

  • Programa naudoja tik savo Client ID ir Client Secret, saugomus kaip serverio paslaptys; ji niekam jų neatskleidžia ir niekada neprašo naudotojų jų raktų.
  • Prieigą prie pardavėjo paskyros ji gauna tik per OAuth 2.0, pardavėjui sutikus ir aukščiau aprašytų leidimų apimtimi.
  • Kiekvienoje užklausoje yra pastovi User-Agent antraštė, identifikuojanti programą: Agilix-Sklep/1.0.0 (+https://agilix.dog/).
  • Programa laikosi limitų: užsakymų žurnalą tikrina kartą per minutę, pasiūlymus atnaujina tik pasikeitus produktui, o gavusi atsakymą 429 laukia tiek, kiek nurodo Retry-After antraštė.
  • Ji masiškai nesisiunčia kitų pardavėjų ir pirkėjų pasiūlymų ar duomenų; API duomenis naudoja tik susietos paskyros pardavimams aptarnauti.
  • Ryšys vyksta tik per HTTPS, o žetonai saugomi užšifruoti.

Paskyros atjungimas

Administratorius bet kada gali parduotuvės nustatymuose spustelėti "Atjungti" - tada serveris ištrina išsaugotus žetonus ir pasiūlymų susiejimus, o programa nustoja siųsti užklausas šiai paskyrai. Prieigą taip pat galima atšaukti Allegro pusėje, paskyros nustatymuose; tada programa pažymi ryšį kaip atjungtą ir parodo tai administratoriui.

Klausimai apie programą: adam@agilix.dog.