Офферы:
Лендинги
Многостраничники
Товары:
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 | Число | Желаемая цена товара Если не передана или передан ноль/пустое значение, то устанавливается текущая розничная цена по платформе + доп. наценка витрины. Может быть выше текущей розничной цены по платформе, соответственно партнерский бонус с продажи будет выше. Может быть ниже текущей розничной цены по платформе, за счет партнерского бонуса. Но не ниже уровня, при котором бонус равен нулю. | ||
| name | Строка | Название товара в вашем магазине | ||
| Ключ | Тип | Описание | |
| 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 | Строка | ссылка на заказ на витрине платформы, по данной ссылке можно делать редирект для клиента, чтобы он мог выбрать способ оплаты или ознакомиться с заказом |
| Код | Описание |
| 400 | Ошибка во вводных данных, в ответе будет JSON массив со следующими полями: |
| Ключ | Тип | Описание | ||
| status | Строка | статус создания, «ERROR» | ||
| errors | Массив | массив ошибок в формате JSON |
api_передача_заказов.1496423138.txt.gz · Последние изменения: 2017/06/02 20:05 (внешнее изменение)
Инструменты страницы
