Розпочати роботу з API

Опубліковано : 24.06.2020

Обробляти замовлення використовуючи API можна пройшовши прості 7 кроків:

  1. Насамперед необхідно отримати токен (https://api.seller.rozetka.com.ua/apidoc/#api-Authorization-PostSites). Багато хто про це забуває. Для отримання токена підійдуть логін і пароль від особистого кабінету. Зверніть увагу, що пароль повинен бути закодований в base64 і в Headers передати значення Content-Type: application/json
  2. Після успішної авторизації ви отримуєте тимчасовий токен (термін життя 24 години) використовуючи який, можна отримати доступ до всіх запитів. Для авторизації по токену слід використовувати тип авторизації Bearer token. Отримавши токен, його можна використовувати для всіх наступних викликів методів АПІ.
  3. Тепер перевіряємо чи є у нас замовлення (https://api.seller.rozetka.com.ua/apidoc/#api-Orders-GetOrderSearch). За замовчуванням ви побачите замовлення що в групі статусів "В обробці" (тобто не буде виконаних або скасованих). Щоб змінити принципи фільтрації або сортування — вивчіть блок Parameters (такий блок є для всіх методів).
  4. Також, звертайте увагу на те, що передбачена пагінація, для навігації між сторінками використовуйте параметр page=<номер сторінки>
  5. Переглянувши список замовлень переходимо в саме замовлення — https://api.seller.rozetka.com.ua/apidoc/#api-Orders-GetOrderDetails. Спочатку ви побачите лише основну інформацію що до замовлення. Для отримання деталей скористайтеся тегом expand.
  6. Після того як ви опрацювали замовлення і зв'язалися з клієнтом, необхідно актуалізувати його статус (насправді, статус замовлення повинен бути ЗАВЖДИ актуальним). Ось так, завжди можна перевірити в який статус можна перевести замовлення https://api.seller.rozetka.com.ua/orders/?expand=status_available
  7. Далі сама зміна статусу — https://api.seller.rozetka.com.ua/apidoc/#api-Orders-OrderUpdateStatus. Все дуже просто: вказуємо актуальний статус і номер ТТН, якщо віддаємо товар службі доставки.

Ось і все, ви авторизувалися, отримали замовлення та обробили його.