Integrace obchodu Agilix s Allegro

• vystavování produktů obchodu agilix.dog jako nabídek na Allegro a aktualizace jejich názvu, popisu, fotografií a ceny;
• udržování jednoho společného stavu skladu - prodej v obchodě snižuje počet kusů v nabídce na Allegro a prodej na Allegro snižuje stav v obchodě, obvykle do jedné minuty;
• stahování zaplacených objednávek z Allegro do panelu objednávek obchodu, aby se vyřizovaly společně s objednávkami z obchodu;
• předávání stavu vyřízení objednávky a čísla zásilky do Allegro.

Aplikaci používá výhradně administrátor obchodu agilix.dog, a to v nastavení obchodu v administračním panelu. Propojuje s aplikací jeden prodejní účet Allegro - ten, ze kterého obchod prodává. Kupující a ostatní uživatelé Agilix se přes tuto aplikaci do Allegro nepřihlašují a k jejímu nastavení nemají přístup.

Administrátor u produktu zaškrtne pole "Synchronizovat s Allegro" a zvolí kategorii, povinné parametry a cenu na Allegro. Po uložení produktu server Agilix na pozadí nahraje fotografie do Allegro, vytvoří nebo aktualizuje nabídku (produkt, kategorie a parametry, údaje o výrobci a odpovědné osobě podle GPSR, cena, počet kusů, ceník dopravy, podmínky vrácení a reklamací) a zveřejní ji.

• Odškrtnutí pole, deaktivace produktu nebo vyprodání zásob nabídku ukončí; opětovná dostupnost ji obnoví.
• Změny se řadí do fronty úloh na pozadí, takže úprava v obchodě nečeká na odpověď Allegro.
• Pokud Allegro nabídku odmítne, administrátor vidí u produktu kód a chybovou zprávu z Allegro a může synchronizaci zopakovat.

• Jednou za minutu server načte deník událostí objednávek od poslední zpracované události.
• Objednávka se do obchodu dostane teprve tehdy, když je připravena k vyřízení (READY_FOR_PROCESSING) a nebyla zrušena; každá objednávka se importuje právě jednou a stav skladu se sníží o objednané kusy.
• Zrušení objednávky na Allegro ji zruší i v obchodě a vrátí stav skladu.
• Když administrátor změní stav objednávky nebo odešle zásilku, aplikace aktualizuje stav vyřízení v Allegro a doplní číslo zásilky.
• Vrácení peněz za objednávky z Allegro se řeší v panelu Allegro, mimo aplikaci.

Aplikace využívá standardní tok OAuth 2.0 (Authorization Code), který poskytuje Allegro. Nikoho nežádá o přihlašovací jméno, heslo, Client ID ani Client Secret.

1. Administrátor klikne v nastavení obchodu na "Propojit s Allegro". Server vytvoří podepsaný parametr state, platný 15 minut a vázaný na tohoto administrátora.
2. Prohlížeč přejde na přihlašovací stránku Allegro (https://allegro.pl/auth/oauth/authorize), kde se prodejce přihlásí ke svému účtu a udělí souhlas s oprávněními aplikace.
3. Allegro přesměruje na registrovanou adresu https://api.agilix.dog/allegro/oauth/callback. Server ověří podpis a platnost state a také to, že uživatel je stále administrátorem obchodu, a poté vymění kód za tokeny (https://allegro.pl/auth/oauth/token), přičemž se ověřuje vlastním Client ID a Client Secret aplikace.
4. Server načte přihlašovací jméno propojeného účtu a uloží propojení. Obnovovací token je uložen výhradně na serveru, zašifrovaný algoritmem AES-256-GCM. Přístupový token se obnovuje automaticky a nový obnovovací token okamžitě nahrazuje předchozí.

Client Secret a tokeny se nikdy nedostanou do prohlížeče, mobilní aplikace ani k jiným subjektům.

Aplikace zpracovává pouze data potřebná k prodeji: data nabídek obchodu a data objednávek z Allegro - jméno a příjmení, doručovací adresu nebo výdejní místo, telefon, e-mailovou adresu v doméně allegromail.pl, fakturační údaje, objednané produkty a zprávu pro prodejce.

Data objednávek slouží výhradně k vyřízení a odeslání dané objednávky. Obchod kupujícím z Allegro neposílá žádné e-maily - transakční ani marketingové - a jejich data nepoužívá k marketingu.

• Aplikace používá výhradně vlastní Client ID a Client Secret, uložené jako tajné údaje serveru; nikomu je nezpřístupňuje a nikdy nežádá uživatele o jejich klíče.
• K účtu prodejce získává přístup pouze přes OAuth 2.0, se souhlasem prodejce a v rozsahu výše popsaných oprávnění.
• Každý požadavek obsahuje stálou hlavičku User-Agent identifikující aplikaci: Agilix-Sklep/1.0.0 (+https://agilix.dog/).
• Aplikace dodržuje limity: deník objednávek dotazuje jednou za minutu, nabídky aktualizuje jen po změně produktu a po odpovědi 429 čeká tak dlouho, jak udává hlavička Retry-After.
• Hromadně nestahuje nabídky ani data jiných prodejců a kupujících; data z API používá výhradně k obsluze prodeje propojeného účtu.
• Komunikace probíhá výhradně přes HTTPS a tokeny jsou uloženy v zašifrované podobě.

Administrátor může kdykoli kliknout v nastavení obchodu na "Odpojit" - server pak smaže uložené tokeny a vazby nabídek a aplikace přestane pro tento účet odesílat požadavky. Přístup lze zrušit také na straně Allegro, v nastavení účtu; aplikace pak propojení označí jako odpojené a zobrazí to administrátorovi.

Dotazy k aplikaci: adam@agilix.dog.