Интеграция по 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" - подтвержденные элементы заказа