API передачи заказов Qnits

Основная информация

Для обмена данными с API Qnits используется формат JSON.

Запросы в формате JSON передаются методом HTTP POST на следующий адрес: http://api.qnits.ru/api либо http://ваш_домен/api

Запрос всегда содержит:

ключ method с именем вызываемого метода
ключ qnit_id с номером витрины
ключ token - авторизационный токен
ключ params - список параметров для вызываемого метода

Параметры qnit_id и token можно узнать в менеджер панели по адресу http://panel.qnits.ru/manager_mvc/settings/api

Метод "CreateOrder"

Используется для передачи заказов в Qnits.

Пример запроса

{ «token»: «541c4a59bdad87039c7ae8df6af14785сaf7526f01a613f5bd894d615ee811e5», «qnit_id»: 1, «method»: «CreateOrder», «params»: { «name»: «Иванов Иван», «phone»: «79123211232», «external_id»: «2643», "products": [ { «id»: 1000587, «quantity»: 1, }, { «id»: 3044, «quantity»: 2 } ] } }

Параметры

Параметры метода передаются в массиве 'params'. Параметры, помеченные звездочкой* обязательны, остальные можно не передавать.

Ключ	Тип	Описание
name*	Строка	Имя клиента в свободной форме
phone*	Строка	Номер телефона клиента в свободной форме
external_id*	Строка	Идентификатор заказа на внешней витрине, необходим для защиты от дублирования заказов. Если вы не храните на внешней витрине заказы, то можно передавать в данный параметр текущие дату+время
products*		Массив	Массив списка товаров для заказа состоит из списка объектов с полями:
		Ключ	Тип	Описание
		id*	Число	Артикул товара, можно узнать в библиотеке товаров
		quantity*	Число	Количество товаров в заказе
		price	Число	Желаемая<font 14px/inherit;;inherit;;inherit></font> цена<font 14px/inherit;;inherit;;inherit></font> товара Если<font 14px/inherit;;inherit;;inherit>не</font> передана<font 14px/inherit;;inherit;;inherit>или</font> передан<font 14px/inherit;;inherit;;inherit></font> ноль<font 14px/inherit;;inherit;;inherit>/</font> пустое<font 14px/inherit;;inherit;;inherit></font> значение<font 14px/inherit;;inherit;;inherit>, то</font> устанавливается<font 14px/inherit;;inherit;;inherit></font> текущая<font 14px/inherit;;inherit;;inherit></font> розничная<font 14px/inherit;;inherit;;inherit></font> цена<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>+ доп.</font> наценка<font 14px/inherit;;inherit;;inherit></font> витрины<font 14px/inherit;;inherit;;inherit>.</font> Может<font 14px/inherit;;inherit;;inherit></font> быть<font 14px/inherit;;inherit;;inherit></font> выше<font 14px/inherit;;inherit;;inherit></font> текущей<font 14px/inherit;;inherit;;inherit></font> розничной<font 14px/inherit;;inherit;;inherit></font> цены<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>,</font> соответственно<font 14px/inherit;;inherit;;inherit></font> партнерский<font 14px/inherit;;inherit;;inherit></font> бонус<font 14px/inherit;;inherit;;inherit>с</font> продажи<font 14px/inherit;;inherit;;inherit></font> будет<font 14px/inherit;;inherit;;inherit></font> выше<font 14px/inherit;;inherit;;inherit>.</font> Может<font 14px/inherit;;inherit;;inherit></font> быть<font 14px/inherit;;inherit;;inherit></font> ниже<font 14px/inherit;;inherit;;inherit></font> текущей<font 14px/inherit;;inherit;;inherit></font> розничной<font 14px/inherit;;inherit;;inherit></font> цены<font 14px/inherit;;inherit;;inherit>по</font> платформе<font 14px/inherit;;inherit;;inherit>, за</font> счет<font 14px/inherit;;inherit;;inherit></font> партнерского<font 14px/inherit;;inherit;;inherit></font> бонуса<font 14px/inherit;;inherit;;inherit>.</font> <font 14px/inherit;;inherit;;inherit>Но не</font> ниже<font 14px/inherit;;inherit;;inherit></font> уровня<font 14px/inherit;;inherit;;inherit>, при</font> котором<font 14px/inherit;;inherit;;inherit></font> бонус<font 14px/inherit;;inherit;;inherit></font> равен<font 14px/inherit;;inherit;;inherit></font> нулю<font 14px/inherit;;inherit;;inherit>.</font>

		name	Строка	Название товара в вашем магазине

address	Строка	Адрес клиента в свободной форме
secondaryPhone	Строка	Дополнительный телефон клиента, на случай если первый телефон не доступен
email	Строка	Email клиента
comments	Строка	Комментарий(Виден клиенту)

В ответ на запрос сервер вернёт:

Код	Описание
201	Заказ успешно создан, в ответе будет JSON массив со следующими полями:

Ключ		Тип	Описание
status	Строка	статус создания «Ок»
order_id	Число	Номер созданного заказа
order_url	Строка	ссылка на заказ на витрине платформы, по данной ссылке можно делать редирект для клиента, чтобы он мог выбрать способ оплаты или ознакомиться с заказом

Код	Описание
400	Ошибка во вводных данных, в ответе будет JSON массив со следующими полями:

Ключ	Тип	Описание
status	Строка	статус создания, «ERROR»
errors	Массив	массив ошибок в формате JSON

Qnits

Инструменты пользователя

Инструменты сайта

Боковая панель

Содержание

API передачи заказов Qnits

Основная информация

Метод "CreateOrder"

Параметры

Инструменты страницы