Интеграция по API

Все запросы к API сервисам МСМ ГРУПП осуществляются с обязательным параметром key - ключ авторизации, который вы можете узнать у вашего менеджера или в службе поддержки пользователей.

Ключ дает доступ к товарам, ценам и остаткам на складе, к которому привязан контрагент.

Если есть необходимость производить действия с другого склада, то в личном кабинете необходимо создать компанию для другого региона, и запросить повторно ключ key для неё.

Не забывайте использовать заголовок Content-Type: application/json при передаче параметров в теле запроса.

1. Получение товаров


Получение общего количества товаров

Рекомендуем сделать предворительный запрос количества товаров, чтобы иметь понимание сколько страниц вам нужно получать

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" - число, количество шт. в упаковке

2. Получение цен и остатков

Получение цен и остатков для 1 товара

GET/POST https://api.mcmauto.ru/v2/products/{product_id}, где product_id - это 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" - число, количество товара на складе, к которому привязан контрагент

3. Заказ

Создание заказа

POST https://api.mcmauto.ru/v2/orders

POST https://api.mcmauto.ru/v2/order - в будущем будет удален

Параметры запроса:
test - укажите test=1 или ("test": 1), чтобы сделать тестовый заказ. В ответ сгенерируется рандомное значение number. Информация о заказе нигде не сохраняется. По такому заказу невозможно получить информацию.
key - ключ авторизации
items - массив объектов с параметрами "id" - это идентификатор товара и "qty" - количество
delivery_address_id - идентификатор точки доставки, который можно найти в личном кабинете в разделе "Мои точки доставки", можно не указывать либо указать null в случае самовывоза или если точка доставки всего одна.

Ответ JSON:

"number" - номер созданного заказа, Также будут возвращены все отправленные параметры запроса


Информация по заказу

GET/POST https://api.mcmauto.ru/v2/orders/{number}, где number - идентификатор заказа

Параметры запроса:
key - ключ авторизации
test - укажите test=1, чтобы получить тестовый вариант информации по заказу.

Ответ JSON:

"number" - номер созданного заказа,
"status" - статус,
"status_text" - описание статуса,
"items" - элементы заказа,
"confirmed_items" - подтвержденные элементы заказа