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

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


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

Офферы:

​Лендинги

Многостраничники

Товары:

FAQ:

Вывод средств:

Рефералы и ученики:

Подключение и передача заказов с внешних витрин:

Юридическая информация:

Обучающая литература:

Вебинар QNITS:

api_передача_заказов

Это старая версия документа.


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

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

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


api_передача_заказов.1496419567.txt.gz · Последние изменения: 2017/06/02 19:06 — Максим