🚀 Инструкция по подключению к маркетплейсу «Любимчик»

Эта инструкция поможет подключить ваш магазин к маркетплейсу «Любимчик» через API: получать заказы, обновлять цены и остатки товаров.

1️⃣ Получите токен доступа

Для подключения используется уникальный API-токен.

Как получить токен:

1. Войдите в личный кабинет поставщика.

2. Перейдите в раздел Профиль → Настройки → Магазины / Склады → API-токен.

3. Нажмите Создать токен, если его нет.

4. Скопируйте токен и храните в надёжном месте.

🔒 Токен — ваш личный ключ к API. Не делитесь им с третьими лицами.

2️⃣ Сопоставьте ваши товары с эталонными

Перед обновлением цен и остатков нужно связать свои товары с эталонными товарами маркетплейса.

Что нужно сделать:

1. В личном кабинете откройте раздел Мой каталог.

2. Выгрузите файл с эталонными товарами (кнопка Экспорт товаров).

3. В выгрузке найдите колонку с ID эталонных товаров.

4. В своей системе (1С, CRM или Excel) добавьте поле для хранения этих ID.

5. Для каждого товара укажите соответствующий эталонный ID.

💡 Это необходимо, чтобы маркетплейс корректно обновлял цены и остатки по вашим позициям.

3️⃣ Подготовьте данные для обновления

Создайте JSON-файл с перечнем товаров и актуальными данными:

{
  "items": [
    {
      "reference_modification_id": 12345,
      "price": 800.00,
      "old_price": 1800.00,
      "stock_quantity": 50
    },
    {
      "reference_modification_id": 12346,
      "price": 2500.00,
      "stock_quantity": 25
    }
  ]
}

4️⃣ Отправьте данные в маркетплейс

Передайте подготовленный JSON-файл через API, используя ваш токен авторизации.

Передача выполняется методом POST, аутентификация — по токену в заголовке запроса.

Важно:

• Все запросы выполняются по защищённому протоколу HTTPS.

• В теле запроса должен быть корректный JSON-объект.

• В ответ система возвращает уникальный идентификатор задачи обновления.

5️⃣ Проверьте статус задачи

После отправки данных можно отследить выполнение обновления по возвращённому идентификатору.

Система сообщит, когда обновление завершено и есть ли ошибки.

Пример ответа:

{
  "success": true,
  "result": {
    "status": "completed",
    "has_errors": false
  }
}

Если has_errors = true, можно получить подробный отчёт об ошибках и исправить данные.

6️⃣ Проверьте результат обновления

После успешного завершения задачи можно запросить итоговый отчёт.

В нём будет указано, какие товары были созданы или обновлены.

Пример результата:

{
  "created_for": [179616, 179610],
  "updated_for": [190806, 190807]
}

7️⃣ Работа с заказами

API маркетплейса позволяет:

• получать новые заказы,

• проверять их статус,

• обновлять статус после обработки (например, “Подтверждён”, “Отправлен”, “Завершён”).

При обновлении статуса необходимо передавать:

{
  "order_id": 12345,
  "status": "confirmed"
}

Доступные статусы:

new_order — Новый заказ  
confirmed — Подтвержден  
processing — В обработке  
dispatched_to_courier — Отправлен курьеру  
awaiting_pickup — Ожидает самовывоза  
completed — Завершен  
cancelled — Отменен

8️⃣ Возможные ошибки и решения

9️⃣ Краткая схема подключения

1. Получить токен доступа

2. Выгрузить эталонные товары

3. Сопоставить товары с эталонными ID

4. Подготовить JSON с ценами и остатками

5. Отправить данные в API

6. Проверить статус выполнения

7. Получить отчёт с результатом

8. Принимать и обновлять заказы через API