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


address

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


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

Email клиента


comment

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

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

Код	Описание
201

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

400

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

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

Qnits

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

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

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

Содержание

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

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

Метод "CreateOrder"

Параметры

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