Agilix-kaupan integraatio Allegroon
Miten Agilix Sklep -sovellus käyttää Allegron REST API:a: tarkoitus, toiminta, valtuutus, käyttöoikeudet, tiedot ja käyttöehtojen noudattaminen.
Tilanne 1.10.2026.
Agilix Sklep on Allegro Developer Appsiin rekisteröity sovellus, joka yhdistää agilix.dog-verkkokaupan (leluja, namipaloja ja tarvikkeita koirille) Allegron myyjätiliin. Sen ansiosta kaupalla on yksi tuoteluettelo, yksi varastosaldo ja yksi tilausten käsittely - ilman toista hallintaa Allegron paneelissa.
Sovellusta kehittää ja ylläpitää:
Hackerman Consulting - Adam Gajzlerowicz
NIP 7772841677
Regon 380997651
Hebanowa 16E, 62-020 Zalasewo, woj. wielkopolskie
+48 737 909 076
Sovelluksen tarkoitus
- agilix.dog-kaupan tuotteiden listaaminen Allegron tarjouksiksi sekä niiden nimen, kuvauksen, kuvien ja hinnan päivittäminen;
- yhden yhteisen varastosaldon ylläpitäminen - myynti kaupassa vähentää Allegron tarjouksen kappalemäärää ja myynti Allegrossa vähentää kaupan saldoa, yleensä minuutin kuluessa;
- Allegron tilausten tuominen kaupan tilauspaneeliin, jotta ne toimitetaan yhdessä kaupassa tehtyjen tilausten kanssa;
- tilauksen toimitustilan ja lähetyksen seurantanumeron välittäminen Allegroon.
Kuka sovellusta käyttää
Sovellusta käyttää ainoastaan agilix.dog-kaupan ylläpitäjä hallintapaneelin kaupan asetuksissa. Ylläpitäjä yhdistää sovellukseen yhden Allegron myyjätilin - sen, jolta kauppa myy. Ostajat ja muut Agilixin käyttäjät eivät kirjaudu Allegroon tämän sovelluksen kautta, eikä heillä ole pääsyä sen asetuksiin.
Miten tarjousten listaaminen toimii
Ylläpitäjä valitsee tuotteen kohdalla ruudun "Listaa Allegroon" ja valitsee kategorian, vaaditut parametrit sekä Allegron hinnan. Tuotteen tallentamisen jälkeen Agilixin palvelin lähettää taustalla kuvat Allegroon, luo tai päivittää tarjouksen (tuote, kategoria ja parametrit, GPSR:n mukaiset valmistajan ja vastuuhenkilön tiedot, hinta, kappalemäärä, toimitushinnasto, palautus- ja reklamaatioehdot) ja julkaisee sen.
- Ruudun valinnan poistaminen, tuotteen poistaminen käytöstä tai saldon loppuminen päättää tarjouksen; kun tuote on taas saatavilla, tarjous jatkuu.
- Muutokset menevät taustatehtävien jonoon, joten muokkaus kaupassa ei odota Allegron vastausta.
- Jos Allegro hylkää tarjouksen, ylläpitäjä näkee tuotteen kohdalla Allegron virhekoodin ja -viestin ja voi yrittää synkronointia uudelleen.
Miten tilausten käsittely toimii
- Kerran minuutissa palvelin lukee tilausten tapahtumalokin viimeksi käsitellystä tapahtumasta alkaen.
- Tilaus tulee kauppaan vasta, kun se on valmis käsiteltäväksi (READY_FOR_PROCESSING) eikä sitä ole peruttu; jokainen tilaus tuodaan täsmälleen kerran, ja varastosaldo pienenee tilattujen kappaleiden verran.
- Tilauksen peruminen Allegrossa peruu sen kaupassa ja palauttaa varastosaldon.
- Kun ylläpitäjä muuttaa tilauksen tilaa tai lähettää paketin, sovellus päivittää toimitustilan Allegroon ja lisää seurantanumeron.
- Allegron tilausten rahojen palautukset käsitellään Allegron paneelissa sovelluksen ulkopuolella.
Käyttäjän valtuutus
Sovellus käyttää Allegron tarjoamaa tavallista OAuth 2.0 -kulkua (Authorization Code). Se ei pyydä keneltäkään käyttäjätunnusta, salasanaa, Client ID:tä eikä Client Secretiä.
- Ylläpitäjä napsauttaa kaupan asetuksissa "Yhdistä Allegroon". Palvelin luo allekirjoitetun
state-parametrin, joka on voimassa 15 minuuttia ja sidottu kyseiseen ylläpitäjään. - Selain siirtyy Allegron kirjautumissivulle (
https://allegro.pl/auth/oauth/authorize), jossa myyjä kirjautuu tililleen ja hyväksyy sovelluksen käyttöoikeudet. - Allegro ohjaa rekisteröityyn osoitteeseen
https://api.agilix.dog/allegro/oauth/callback. Palvelin tarkistaastate-parametrin allekirjoituksen ja voimassaolon sekä sen, että käyttäjä on edelleen kaupan ylläpitäjä, ja vaihtaa sitten koodin tunnuksiin (https://allegro.pl/auth/oauth/token) tunnistautuen sovelluksen omalla Client ID:llä ja Client Secretillä. - Palvelin lukee yhdistetyn tilin käyttäjätunnuksen ja tallentaa yhteyden. Päivitystunnusta säilytetään ainoastaan palvelimella AES-256-GCM-algoritmilla salattuna. Käyttötunnus päivitetään automaattisesti, ja uusi päivitystunnus korvaa edellisen välittömästi.
Client Secret ja tunnukset eivät koskaan päädy selaimeen, mobiilisovellukseen eivätkä muille tahoille.
Sovelluksen käyttöoikeudet
Sovellus pyytää vain yllä kuvattujen toimintojen tarvitsemia käyttöoikeuksia:
-
allegro:api:profile:read - yhdistetyn tilin käyttäjätunnuksen lukeminen, jotta ylläpitäjä näkee, mikä Allegro-tili on yhdistetty.
-
allegro:api:sale:offers:read - kaupan tarjousten ja niiden luomisen tulosten lukeminen sekä kategoriaehdotukset ja kategorioiden parametrit.
-
allegro:api:sale:offers:write - kaupan tarjousten luominen, muokkaaminen, julkaiseminen ja päättäminen sekä niiden kuvien lähettäminen.
-
allegro:api:sale:settings:read - toimitushinnastojen, palautus- ja reklamaatioehtojen sekä valmistajien ja vastuuhenkilöiden (GPSR) tietojen lukeminen, jotta ylläpitäjä voi valita ne tarjouksille.
-
allegro:api:sale:settings:write - vastuullisen valmistajan (GPSR) tietojen lisääminen, jos tilillä ei vielä ole niitä.
-
allegro:api:orders:read - tilausten tapahtumien ja tietojen, kuljetusyhtiöiden ja lähetysten lukeminen.
-
allegro:api:orders:write - tilauksen toimitustilan päivittäminen ja seurantanumeron lisääminen.
Käytetyt REST API -resurssit
https://api.allegro.pl (kuvat osoitteeseen https://upload.allegro.pl) yhdistetyn tilin puolesta:Tarjoukset ja niiden julkaisu
- POST /sale/product-offers
- PATCH /sale/product-offers/{offerId}
- GET /sale/product-offers/{offerId}
- GET /sale/product-offers/{offerId}/operations/{operationId}
- GET /sale/offers
- PUT /sale/offer-publication-commands/{commandId}
- GET /sale/offer-publication-commands/{commandId}
- GET /sale/offer-publication-commands/{commandId}/tasks
Kuvat
- POST /sale/images
Kategoriat ja parametrit
- GET /sale/matching-categories
- GET /sale/categories/{categoryId}
- GET /sale/categories/{categoryId}/parameters
Myyntiasetukset
- 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
Tilaukset
- GET /order/events
- GET /order/event-stats
- GET /order/checkout-forms/{checkoutFormId}
Toimitus ja lähetykset
- PUT /order/checkout-forms/{checkoutFormId}/fulfillment
- GET /order/checkout-forms/{checkoutFormId}/shipments
- POST /order/checkout-forms/{checkoutFormId}/shipments
- GET /order/carriers
Tili
- GET /me
Käsiteltävät tiedot
Sovellus käsittelee vain myyntiin tarvittavia tietoja: kaupan tarjousten tiedot sekä Allegron tilausten tiedot - nimi, toimitusosoite tai noutopiste, puhelinnumero, allegromail.pl-verkkotunnuksen sähköpostiosoite, laskutustiedot, tilatut tuotteet ja viesti myyjälle.
Tilausten tietoja käytetään ainoastaan kyseisen tilauksen toimittamiseen ja lähettämiseen. Kauppa ei lähetä Allegron ostajille mitään sähköposteja - ei tapahtumaviestejä eikä markkinointia - eikä käytä heidän tietojaan markkinointiin.
Henkilötietojen käsittelyn periaatteet: Tietosuojaseloste
Allegron REST API -ehtojen noudattaminen
- Sovellus käyttää ainoastaan omaa Client ID:tään ja Client Secretiään, joita säilytetään palvelimen salaisuuksina; se ei jaa niitä kenellekään eikä koskaan pyydä käyttäjiltä heidän avaimiaan.
- Pääsyn myyjätiliin se saa ainoastaan OAuth 2.0:n kautta, myyjän suostumuksella ja yllä kuvattujen käyttöoikeuksien rajoissa.
- Jokainen pyyntö sisältää kiinteän sovelluksen tunnistavan User-Agent-otsakkeen:
Agilix-Sklep/1.0.0 (+https://agilix.dog/). - Sovellus noudattaa rajoja: se kyselee tilauslokia kerran minuutissa, päivittää tarjouksia vain tuotteen muututtua ja odottaa vastauksen 429 jälkeen niin kauan kuin Retry-After-otsake ilmoittaa.
- Se ei lataa joukoittain muiden myyjien ja ostajien tarjouksia tai tietoja; API:n tietoja käytetään ainoastaan yhdistetyn tilin myynnin hoitamiseen.
- Kaikki tiedonsiirto tapahtuu ainoastaan HTTPS:n kautta, ja tunnukset säilytetään salattuina.
Tilin yhteyden katkaiseminen
Ylläpitäjä voi milloin tahansa napsauttaa kaupan asetuksissa "Katkaise yhteys" - palvelin poistaa silloin tallennetut tunnukset ja tarjousten linkitykset, ja sovellus lakkaa lähettämästä pyyntöjä kyseisen tilin puolesta. Pääsyn voi peruuttaa myös Allegron puolella tilin asetuksissa; sovellus merkitsee silloin yhteyden katkaistuksi ja näyttää tämän ylläpitäjälle.
Sovellusta koskevat kysymykset: adam@agilix.dog.
