Інтеграція магазину Agilix з Allegro

• виставлення товарів магазину agilix.dog як пропозицій на Allegro та оновлення їхньої назви, опису, фотографій і ціни;
• підтримка одного спільного складського залишку - продаж у магазині зменшує кількість одиниць у пропозиції на Allegro, а продаж на Allegro зменшує залишок у магазині, зазвичай протягом хвилини;
• отримання оплачених замовлень з Allegro до панелі замовлень магазину, щоб виконувати їх разом із замовленнями, оформленими в магазині;
• передавання до Allegro статусу виконання замовлення та номера відправлення.

Застосунком користується виключно адміністратор магазину agilix.dog у налаштуваннях магазину в адмін-панелі. Він підключає до застосунку один обліковий запис продавця Allegro - той, з якого продає магазин. Покупці та інші користувачі Agilix не входять в Allegro через цей застосунок і не мають доступу до його налаштувань.

Адміністратор позначає біля товару поле "Синхронізувати з Allegro" та вибирає категорію, обов'язкові параметри й ціну на Allegro. Після збереження товару сервер Agilix у фоновому режимі завантажує фотографії до Allegro, створює або оновлює пропозицію (товар, категорія та параметри, дані виробника й відповідальної особи згідно з GPSR, ціна, кількість одиниць, прайс-лист доставки, умови повернення та рекламацій) і публікує її.

• Зняття позначки, деактивація товару або вичерпання залишку завершує пропозицію; коли товар знову доступний, вона відновлюється.
• Зміни потрапляють до черги фонових завдань, тому редагування в магазині не чекає на відповідь Allegro.
• Якщо Allegro відхилить пропозицію, адміністратор бачить біля товару код і повідомлення про помилку від Allegro та може повторити синхронізацію.

• Раз на хвилину сервер зчитує журнал подій замовлень, починаючи з останньої обробленої події.
• Замовлення потрапляє до магазину лише тоді, коли воно готове до виконання (READY_FOR_PROCESSING) і не було скасоване; кожне замовлення імпортується рівно один раз, а складський залишок зменшується на замовлену кількість.
• Скасування замовлення на Allegro скасовує його в магазині та відновлює складський залишок.
• Коли адміністратор змінює статус замовлення або відправляє посилку, застосунок оновлює статус виконання в Allegro і додає номер відправлення.
• Повернення коштів за замовлення з Allegro обробляються в панелі Allegro, поза застосунком.

Застосунок використовує стандартний потік OAuth 2.0 (Authorization Code), який надає Allegro. Він ні в кого не запитує логін, пароль, Client ID чи Client Secret.

1. Адміністратор натискає "Підключити до Allegro" в налаштуваннях магазину. Сервер створює підписаний параметр state, дійсний 15 хвилин і прив'язаний до цього адміністратора.
2. Браузер переходить на сторінку входу Allegro (https://allegro.pl/auth/oauth/authorize), де продавець входить у свій обліковий запис і надає згоду на дозволи застосунку.
3. Allegro перенаправляє на зареєстровану адресу https://api.agilix.dog/allegro/oauth/callback. Сервер перевіряє підпис і термін дії state, а також те, що користувач досі є адміністратором магазину, після чого обмінює код на токени (https://allegro.pl/auth/oauth/token), автентифікуючись власними Client ID і Client Secret застосунку.
4. Сервер зчитує логін підключеного облікового запису та зберігає підключення. Токен оновлення зберігається виключно на сервері, зашифрований алгоритмом AES-256-GCM. Токен доступу оновлюється автоматично, а новий токен оновлення одразу замінює попередній.

Client Secret і токени ніколи не потрапляють до браузера, мобільного застосунку чи інших сторін.

Застосунок обробляє лише дані, потрібні для продажу: дані пропозицій магазину та дані замовлень з Allegro - ім'я та прізвище, адресу доставки або пункт видачі, телефон, адресу електронної пошти в домені allegromail.pl, дані для рахунку-фактури, замовлені товари та повідомлення для продавця.

Дані замовлень використовуються виключно для виконання та відправлення відповідного замовлення. Магазин не надсилає покупцям з Allegro жодних електронних листів - ні транзакційних, ні маркетингових - і не використовує їхні дані для маркетингу.

• Застосунок використовує виключно власні Client ID і Client Secret, які зберігаються як секрети сервера; він нікому їх не передає і ніколи не запитує в користувачів їхні ключі.
• Доступ до облікового запису продавця він отримує лише через OAuth 2.0, за згодою продавця та в межах описаних вище дозволів.
• Кожен запит містить незмінний заголовок User-Agent, що ідентифікує застосунок: Agilix-Sklep/1.0.0 (+https://agilix.dog/).
• Застосунок дотримується лімітів: опитує журнал замовлень раз на хвилину, оновлює пропозиції лише після зміни товару, а після відповіді 429 чекає стільки, скільки вказує заголовок Retry-After.
• Він не завантажує масово пропозиції чи дані інших продавців і покупців; дані з API використовує виключно для обслуговування продажів підключеного облікового запису.
• Зв'язок відбувається виключно через HTTPS, а токени зберігаються в зашифрованому вигляді.

Адміністратор може будь-коли натиснути "Відключити" в налаштуваннях магазину - тоді сервер видаляє збережені токени та зв'язки пропозицій, а застосунок припиняє надсилати запити для цього облікового запису. Доступ також можна відкликати на боці Allegro, у налаштуваннях облікового запису; тоді застосунок позначає підключення як розірване і показує це адміністраторові.

Питання щодо застосунку: adam@agilix.dog.