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> нулю
name	Строка	Название товара в вашем магазине


price	Число	Желаемая цена товара Если не передана или передан ноль/пустое значение, то устанавливается текущая розничная цена по платформе + доп. наценка витрины. Может быть выше текущей розничной цены по платформе, соответственно партнерский бонус с продажи будет выше. Может быть ниже текущей розничной цены по платформе, за счет партнерского бонуса. Но не ниже уровня, при котором бонус равен нулю.
name*	Строка

<font 9.0pt/inherit;;inherit;;inherit>Название товара в вашем магазине</font> |



address	Строка	Адрес клиента, в свободной форме

secondaryPhone

Строка

Дополнительный телефон клиента, на случай если первый телефон не доступен
email	Строка

email клиента


comment	Строка	Комментарий (Виден клиенту)

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

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

400

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

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

Qnits

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

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

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

Содержание

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

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

Метод "CreateOrder"

Параметры

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