Agilix veikala integrācija ar Allegro

• veikala agilix.dog produktu izvietošana kā piedāvājumi Allegro un to nosaukuma, apraksta, attēlu un cenas atjaunināšana;
• viena kopīga krājumu atlikuma uzturēšana - pārdošana veikalā samazina vienību skaitu Allegro piedāvājumā, bet pārdošana Allegro samazina atlikumu veikalā, parasti minūtes laikā;
• apmaksātu Allegro pasūtījumu ielāde veikala pasūtījumu panelī, lai tos izpildītu kopā ar veikalā veiktajiem pasūtījumiem;
• pasūtījuma izpildes statusa un sūtījuma numura nodošana Allegro.

Lietotni izmanto tikai veikala agilix.dog administrators, veikala iestatījumos administrācijas panelī. Viņš savieno ar lietotni vienu Allegro pārdevēja kontu - to, no kura veikals pārdod. Pircēji un citi Agilix lietotāji caur šo lietotni nepiesakās Allegro un nepiekļūst tās iestatījumiem.

Administrators pie produkta atzīmē lauku "Sinhronizēt ar Allegro" un izvēlas kategoriju, obligātos parametrus un cenu Allegro. Pēc produkta saglabāšanas Agilix serveris fonā augšupielādē attēlus Allegro, izveido vai atjaunina piedāvājumu (produkts, kategorija un parametri, ražotāja un atbildīgās personas dati saskaņā ar GPSR, cena, vienību skaits, piegādes cenrādis, atgriešanas un sūdzību nosacījumi) un to publicē.

• Lauka atzīmes noņemšana, produkta deaktivizēšana vai krājumu izbeigšanās beidz piedāvājumu; kad produkts atkal ir pieejams, piedāvājums tiek atjaunots.
• Izmaiņas nonāk fona uzdevumu rindā, tāpēc rediģēšana veikalā negaida Allegro atbildi.
• Ja Allegro noraida piedāvājumu, administrators pie produkta redz Allegro kļūdas kodu un ziņojumu un var atkārtot sinhronizāciju.

• Reizi minūtē serveris nolasa pasūtījumu notikumu žurnālu, sākot no pēdējā apstrādātā notikuma.
• Pasūtījums nonāk veikalā tikai tad, kad tas ir gatavs izpildei (READY_FOR_PROCESSING) un nav atcelts; katrs pasūtījums tiek importēts tieši vienu reizi, un krājumu atlikums samazinās par pasūtīto vienību skaitu.
• Pasūtījuma atcelšana Allegro to atceļ arī veikalā un atjauno krājumu atlikumu.
• Kad administrators maina pasūtījuma statusu vai nosūta sūtījumu, lietotne atjaunina izpildes statusu Allegro un pievieno sūtījuma numuru.
• Naudas atmaksas par Allegro pasūtījumiem tiek apstrādātas Allegro panelī, ārpus lietotnes.

Lietotne izmanto standarta OAuth 2.0 (Authorization Code) plūsmu, ko nodrošina Allegro. Tā nevienam neprasa lietotājvārdu, paroli, Client ID vai Client Secret.

1. Administrators veikala iestatījumos noklikšķina "Savienot ar Allegro". Serveris izveido parakstītu parametru state, kas ir derīgs 15 minūtes un piesaistīts šim administratoram.
2. Pārlūks pāriet uz Allegro pieteikšanās lapu (https://allegro.pl/auth/oauth/authorize), kur pārdevējs piesakās savā kontā un piekrīt lietotnes atļaujām.
3. Allegro novirza uz reģistrēto adresi https://api.agilix.dog/allegro/oauth/callback. Serveris pārbauda state parakstu un derīgumu, kā arī to, vai lietotājs joprojām ir veikala administrators, un pēc tam apmaina kodu pret tokeniem (https://allegro.pl/auth/oauth/token), autentificējoties ar lietotnes paša Client ID un Client Secret.
4. Serveris nolasa savienotā konta lietotājvārdu un saglabā savienojumu. Atjaunošanas tokens tiek glabāts tikai serverī, šifrēts ar AES-256-GCM. Piekļuves tokens tiek atjaunots automātiski, un jaunais atjaunošanas tokens uzreiz aizstāj iepriekšējo.

Client Secret un tokeni nekad nenonāk pārlūkā, mobilajā lietotnē vai pie trešajām personām.

Lietotne apstrādā tikai pārdošanai nepieciešamos datus: veikala piedāvājumu datus un Allegro pasūtījumu datus - vārdu un uzvārdu, piegādes adresi vai saņemšanas punktu, tālruni, e-pasta adresi domēnā allegromail.pl, rēķina datus, pasūtītos produktus un ziņojumu pārdevējam.

Pasūtījumu dati tiek izmantoti tikai konkrētā pasūtījuma izpildei un nosūtīšanai. Veikals Allegro pircējiem nesūta nekādus e-pastus - ne darījumu, ne mārketinga - un neizmanto viņu datus mārketingam.

• Lietotne izmanto tikai savu Client ID un Client Secret, kas glabāti kā servera noslēpumi; tā tos nevienam neizpauž un nekad neprasa lietotājiem viņu atslēgas.
• Piekļuvi pārdevēja kontam tā iegūst tikai caur OAuth 2.0, ar pārdevēja piekrišanu un iepriekš aprakstīto atļauju apjomā.
• Katrs pieprasījums satur nemainīgu galveni User-Agent, kas identificē lietotni: Agilix-Sklep/1.0.0 (+https://agilix.dog/).
• Lietotne ievēro limitus: pasūtījumu žurnālu vaicā reizi minūtē, piedāvājumus atjaunina tikai pēc produkta izmaiņām, bet pēc atbildes 429 gaida tik ilgi, cik norāda galvene Retry-After.
• Tā masveidā nelejupielādē citu pārdevēju un pircēju piedāvājumus vai datus; API datus izmanto tikai savienotā konta pārdošanas apkalpošanai.
• Saziņa notiek tikai caur HTTPS, un tokeni tiek glabāti šifrētā veidā.

Administrators jebkurā brīdī var veikala iestatījumos noklikšķināt "Atvienot" - tad serveris dzēš saglabātos tokenus un piedāvājumu sasaistes, un lietotne pārtrauc sūtīt pieprasījumus šim kontam. Piekļuvi var atsaukt arī Allegro pusē, konta iestatījumos; tad lietotne atzīmē savienojumu kā atvienotu un parāda to administratoram.

Jautājumi par lietotni: adam@agilix.dog.