Интеграция по API
Все запросы к API сервисам МСМ ГРУПП осуществляются с обязательным параметром key - ключ авторизации, который вы можете узнать у вашего менеджера или в службе поддержки пользователей.
Ключ дает доступ к товарам, ценам и остаткам на складе, к которому привязан контрагент.
Если есть необходимость производить действия с другого склада, то в личном кабинете необходимо создать компанию для другого региона, и запросить повторно ключ key для неё.
Получение товаров
Получение общего количества товаров
Рекомендуем сделать предворительный запрос количества товаров, чтобы иметь понимание сколько страниц вам нужно получать
GET/POST-запрос по адресу https://api.mcmauto.ru/v2/products/count
Параметры запроса:
key - ключ авторизации
limit=1000 - количество товаров на странице. По-умолчанию 1000 (максимальное значение)
all=1 - показывать товары, которых нет в наличии. По-умолчанию в результате запроса отображается только товар в наличии на складе, к которому привязан ключ авторизации key
Ответ JSON:
"count" - общее количество товаров
"limit" - текущее значение limit, сколько товара на странице
"pages" - количество страниц для текущего зачения параметра limit
Получение товаров
GET/POST-запрос по адресу https://api.mcmauto.ru/v2/products
Параметры запроса:
key - ключ авторизации
article - отбор по артиклю
category_id - отбор по категории
page - номер страницы
limit - количество товаров на странице. По-умолчанию 1000 (максимальное значение)
all - показывать товары, которых нет в наличии. По-умолчанию в результате запроса отображается только товар в наличии на складе, к которому привязан ключ авторизации key
Ответ JSON[]:
"id" - число, идентификатор товара, необходимый для запроса на цены и остатки, а так же при создании заказа
"name" - строка, название
"article" - строка, артикул
"brand" - строка, бренд
"image" - строка, изображение
"category_id" - число, id категории
"category" - строка, категория
"package" - число, количество шт. в упаковке
Получение цен и остатков
Получение цен и остатков для 1 товара
GET/POST-запрос по адресу https://api.mcmauto.ru/v2/products/123 где 123 - это id товара
Параметры запроса:
key - ключ авторизации
Ответ JSON:
"price" - ваша цена с учетом персональных скидок и акций
"stock" - количество товара на складе, к которому привязан контрагент
Получение цен и остатков для группы товаров
GET/POST-запрос по адресу https://api.mcmauto.ru/v2/stocks
Параметры запроса:
key - ключ авторизации
product_ids - массив из id товаров, до 100 штук в запросе
Ответ JSON[]:
"product_id" - число, id товара
"price" - строка, ваша цена с учетом персональных скидок и акций, например "1000.33"
"stock" - число, количество товара на складе, к которому привязан контрагент
Создание заказа
POST-запрос по адресу https://api.mcmauto.ru/v2/order
Параметры запроса:
key - ключ авторизации
items - массив объектов с параметрами "id" - это идентификатор товара и "qty" - количество
delivery_address_id - идентификатор точки доставки, который можно найти в личном кабинете в разделе "Мои точки доставки", можно не указывать либо указать null в случае самовывоза или если точка доставки всего одна.
Ответ от сервера будет в формате JSON и содержит объект с параметрами:
"number" - номер созданного заказа