Инструкция по подключению к API
Что такое API?
API (Application Programming Interface) - это набор методов и инструментов, которые позволяют компьютерной программе обмениваться данными с личным кабинетом на маркетплейсе Детского мира. Простыми словами, это такой "почтальон", который поможет перенести данные из вашей системы к нам на площадку. Например, вы создали новый товар в 1C, и с помощью API этот товар создастся в личном кабинете, при этом вам не придется заходить в личный кабинет и вручную дублировать создание этого товара.
В чем преимущества?
Использование API для работы на маркетплейсе Детский мир дает вам ряд важных преимуществ:
- Автоматизация и экономия времени: API исключает рутинные ручные операции. Вам больше не нужно скачивать и загружать файлы Excel с характеристиками товаров, остатками, ценами. Все операции могут выполняться автоматически в фоновом режиме .
- Скорость работы и отсутствие ошибок: человеческий фактор (опечатки, пропуски, забывчивость) сводится к нулю. API обрабатывает запросы за доли секунды. Например, как только вы обновите цену в вашей системе учета, цена обновится на товаре в Личном кабинете
- Актуальность данных в реальном времени: благодаря API информация в личном кабинета маркетплейса и в вашей учетной системе всегда синхронизирована. Цены и остатки обновляются моментально, что исключает продажу товара, которого нет в наличии.
Что возможно подключить?
Через API вы получаете полный контроль над товарами и процессами. Вот основные блоки, которые можно автоматизировать:
- Создание и редактирование товаров. Вы можете добавлять новые товары в каталог, менять описания, характеристики и изображения, добавлять сертификаты, не заходя в личный кабинет.
- Работа с ценами. Вы можете гибко управлять ценообразованием, менять цены в карточке товара, устанавливать скидку.
- Объединение карточек товаров. Если несколько ваших товаров являются одним и тем же продуктом (например, одежда разных цветов), то через API вы можете объединить их в одну карточку на сайте. Это удобно для покупателя и повышает вероятность покупки, так как все варианты товара собраны в одном месте.
- Управление остатками по модели работы FBS. Самый востребованный сценарий. Количество доступного товара на вашем складе синхронизируется с личным кабинетом в реальном времени и на витрине всегда актуальное количество остатков.
- Управление FBO и FBS поставками. Вы можете контролировать работу с поставками в вашей системе, синхронизировать с вашей складской обработкой все этапы от создания поставки до получения закрывающих документов.
Список всех возможностей, которые доступны по API:
Управление товарами и ценами
- Архивирование товаров из Личного кабинета
- Создание продуктов
- Удаление товаров
- Обновление цен продуктов
- Получение списка товаров из Личного кабинета
- Отправить товары на модерацию
- Разархивация товаров
- Редактирование товаров из Личного кабинета
- Получение товара из Личного кабинета
Управление сертификатами
Управление объединениями товаров
- Получить заявки на объединения по поставщику
- Cоздание объединений
- Поиск объединений товаров по поставщику
- Удаление вариантов из объединения
Управление поставками FBO
- Получение списка поставок FBO
- Создание заявки на поставку
- Получение ссылки на УПД версии 5.03
- Отправка поставки на проверку
- Отправка поставки на согласование модератору
- Бронирование слота для поставки в расписании склада
- Получение товаров в поставке
- Добавление товарной позиции в поставку
- Получение информации по ЕО и вложенным товарам
- Добавление товара в ЕО
- Заполнение данных водителя и автомобиля
- Отмена поставки
- Получение ссылки на АПП xlsx
- Получение АПП (pdf)
- Создание файла с этикетками ЕО
- Генерация номеров ЕО для этикеток
- Получение поставки поставщика по ид
- Получение свободных слотов для поставки
Получение информации о складах
Управление поставками FBS
- Получение УПД по поставке FBS
- Скачать этикетки для ЕО по поставке FBS
- Заполнение/изменение информации о водителе и машине
- Отмена поставки FBS
- Заполнение всех данных для поставки и отправки поставки на проверку
- Получение АПП по поставке FBS
- Получение списка поставок FBS
Управление заказами FBS
- Скачать этикетки для ЕО по заказу
- Разбиение товаров в заказе на ЕО
- Получение списка заказов.
- Получение FBS заказа по идентификатору
Управление остатками FBS
Получение расписания складов
Как подключить?
Подключение к API маркетплейса - техническая задача, которая обычно выполняется программистом. Процесс выглядит следующим образом:
Шаг 1. Получение доступа
Для работы с API вам необходимо иметь действующий аккаунт. Для подключения потребуются специальные учетные данные, а именно необходимо сгенерировать API ключ и Client ID. Для этого откройте Профиль поставщика и перейдите в раздел API.
Шаг 2. Настройка интеграции в вашей системе
Полученные данные (API ключ и Client ID) необходимо ввести в настройках вашей учетной системы (1С, МойСклад и т.д.) или в специальном программном обеспечении для интеграции, которое вы используете. Именно там указываются параметры подключения к API.
IT cпециалист пропишет в вашей программе настройки подключения, и обмен данными начнется. Все необходимые технические параметры и методы работы с API описаны в официальной документации.
Резюме
Подключение API - это не просто «техническая опция», а необходимый инструмент для масштабирования ваших продаж. Он избавляет вас от рутины, ускоряет оборот товаров и защищает от ошибок, связанных с человеческим фактором.