API

    Останнє оновлення: 26.08.2026

    API — це інструмент для інтеграції вашої облікової системи з ROZETKA Маркетплейс. Обмін даними здійснюється за протоколом HTTPS із використанням методів POST та GET.

    За допомогою API ви можете:

    • отримувати у власну систему інформацію про замовлення та керувати ними;

    • вести листування з покупцями;

    • отримувати дані про власні товари;

    • керувати службами доставки;

    • отримувати інформацію про відгуки;

    • налаштовувати комплекти товарів.

    З усіма технічними можливостями можна ознайомитися в документації API ↗.

    Створення API-токена

    Для підвищення рівня безпеки під час роботи з API можна створити окремий API-токен відповідно до ролей співробітників магазину.

    Порядок дій:

    1. Перейдіть у розділ «Налаштування» → «Безпека API» та натисніть «Генерувати API-токен».

    2. Оберіть роль, до якої буде прив'язано токен (доступний перелік залежить від вашого рівня доступу).

    3. Натисніть «Згенерувати».

    Права доступу та обмеження:

    • Ролі «Власник» та «Адміністратор» можуть генерувати токени як для себе, так і для інших менеджерів магазину.

    • Ролі «Контент-менеджер», «Менеджер з фінансів» та «Менеджер з обробки замовлень» можуть створювати токени лише для своєї ролі.

    • Один менеджер може створити до 10 токенів.

    • Якщо токен не використовується понад 24 години, він автоматично стає неактивним.

    Покроковий процес опрацювання замовлення через API

    Обробляти замовлення за допомогою API можна виконавши прості 6 кроків:

    1. Отримання токена авторизації
      Виконайте запит авторизації https://api-seller.rozetka.com.ua/apidoc/#api-Authorization-PostSites.

      • Використовуйте логін і пароль від особистого кабінету продавця.

      • Пароль має бути закодований у Base64.

      • У заголовку запиту обов'язково передайте Content-Type: application/json.

      • Після успішної авторизації ви отримаєте тимчасовий токен (термін дії — 24 години). У подальших запитах використовуйте тип авторизації Bearer token.

    2. Отримання списку нових замовлень
      Надішліть запит https://api-seller.rozetka.com.ua/apidoc/#api-Orders-GetOrderSearch.

      • За замовчуванням повертаються замовлення у групі статусів «В обробці» (без виконаних чи скасованих).

      • Для зміни умов фільтрації та сортування використовуйте блок параметрів Parameters.

      • Навігація між сторінками здійснюється через параметр пагінації: page=<номер_сторінки>.

    3. Отримання деталей замовлення
      Отримайте розширені дані щодо конкретного замовлення за допомогою https://api-seller.rozetka.com.ua/apidoc/#api-Orders-GetOrderDetails. Спочатку ви побачите лише основну інформацію на замовлення. Для отримання повної інформації параметром expand.

    4. Перевірка доступних статусів
      Після опрацювання замовлення перевірте перелік статусів, доступних для встановлення, надіславши запит: https://api-seller.rozetka.com.ua/orders/<order_id>?expand=status_available

    5. Оновлення статусу замовлення
      Змініть статус замовлення за допомогою https://api-seller.rozetka.com.ua/apidoc/#api-Orders-OrderUpdateStatus. У тілі запиту вкажіть новий статус і номер ТТН (у разі передачі товару перевізникові).

    У разі виникнення питань або технічних збоїв під час роботи з API зверніться до служби підтримки за темою: «Акаунт, особистий кабінет, API» → «Питання по API».

    < Інструменти
    Чи була інформація корисною?