При конфигурации приложения настройщик проекта указывает URL, на который POST-запросом будет приходить от системы информация о заказе, произошедшем в приложении.
Тело POST-запроса представляет из себя JSON-объект следующего формата:
{
"version": "1.4.1",
"method" : "neworder",
"platform" : "android",
"appId" : "appId",
"user" : "fingerprint",
"data" : {
"order_info" : {...},
"payment" : {
"type" : "тип платежа",
"transactionId" : "только для онлайн-платежей, идентификатор транзакции"
},
"deliveryType" : "single",
"items" : [...],
"fake" : true
},}
"access_token": "TOKEN"
Поля корневого объекта имеет значение обрабатывать лишь при расширении функционала связи между системой и клиентом.
Название
|
Описание
|
---|---|
version |
Версия приложения |
method | Тип запроса системы к клиенту — neworder |
platform |
Платформа приложения, с которого был выполнен заказ, одна из
|
appId |
Идентификатор приложения, с которого был выполнен заказ |
data |
Сведения о заказе |
user |
Fingerprint, метка, определяющая магазин, от которого пришёл заказ на обработчик |
access_token |
Токен пользователя, если он зашел в личный кабинет |
Параметры заказа
Тип доставки
В поле deliveryType указан тип доставки, выбранный пользователем. Если была осуществлена выгрузка типов доставки, то это один из идентификаторов выгруженных типов доставки, иначе это поле имеет значение single.
Сопроводительные сведения
Блок order_info, вложенный в блок data, представляет из себя совокупность полей, обязательных к заполнению, — имя, телефон, адрес электронной почты и комментарий — и полей, определяемых при выгрузке способов доставки для данного типа доставки, указанного в поле deliveryType. Также, если был выбран самовывоз, в поле point передаётся уникальный идентификатор точки, из которой самовывоз осуществляется.
"order_info" : {}
"name" : "Аноним",
"phone" : "+79044153612",
"email" : "admin@mobiumapps.com",
"comments" : "Приложением доволен, хорошо сделали",
"pointId" : "crossIsland1",
"regionId" : "spb",
"bonuses_used" : 0
Название
|
Описание
|
---|---|
name | Имя пользователя |
phone | Телефон пользователя |
Адрес электронной почты пользователя | |
comments | Комментарии к заказу |
pointId | Если выбран самовывоз, в этом поле передаётся идентификатор пункта выдачи товара |
regionId | Если произведена конфигурация регионов, то в этом поле передаётся идентификатор того из них, в котором находится пользователь |
bonuses_used |
Сколько использовано бонусов, при оплате заказа. Для оплаты бонусами надо настроить личный кабинет. |
Формулировка заказа
Основной частью сведений о заказе является список предложений, которыми пользователь решил воспользоваться. Данный блок представляет из себя массив идентификаторов предложений с сопутствующими сведениями о количестве единиц каждого из них.
"items" : [
{
"id" : "15",
"count" : 1
},
{
"id" : "332",
"count" : 3
}
]
Название
|
Описание
|
---|---|
id | Уникальный идентификатор предложения, предоставленный клиентом в выгрузке |
count | Количество заказываемых единиц данного предложения |
Сведения об оплате
При оформлении заказа также передаются сведения о том, каким способом пользователь решил оплатить покупку. Сведения об этом передаются в поле payment.
Название
|
Описание
|
---|---|
|
Тип оплаты, один из
|
|
Если тип оплаты не offline, это поле предоставляется и является идентификатором транзакции |
Остальные поля
Название
|
Описание
|
---|---|
fake |
Булевское поле, определяющее, является ли заказ тестовым, фальшивым |
Ответ получателя
После получения POST-запроса необходимо на него ответить одним из двух способов:
Удачный приём заказа
|
Ошибка при приёме заказа
|
||
---|---|---|---|
Поле |
Поле |
Поле status
определяет успех (0
) или неудачу (всё помимо 0
) при обработке заказа.
Пример запроса с реальными данными
{
"version": "1.4.1",
"method": "neworder",
"platform": "android",
"appId": 112065,
"user": "mobium",
"data": {
"deliveryType": "Уточните у оператора",
"deliveryData": [],
"items": [
{
"count": 1,
"id": "577094"
}
],
"fake": 0,
"order_info": {
"name": "тест",
"phone": "999 999-99-99",
"email": "test@test.ru",
"comments": null,
"pointId": null,
"regionId": "rest_267874043",
"payment_type": {
"id": "158ad9287ed274",
"title": "Наличные",
"type": "cash"
}
},
"payment": {
"type": "offline",
"transactionId": null
}
},
"region_data": {
"full_title": "Москва, город Москва, Россия",
"google_place_id": "ChIJybDUc_xKtUYRTM9XV8zWRD0",
"id": "rest_267874043",
"is_selected": true,
"title": "Москва"
},
"access_token": null
}
Комментарии
0 комментариев
Войдите в службу, чтобы оставить комментарий.