Статьи в этом разделе

Передача заказов

Avatar
Mobium Support
Обновлено
Подписаться

При конфигурации приложения настройщик проекта указывает 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

Платформа приложения, с которого был выполнен заказ, одна из

  • android
  • ios
appId Идентификатор приложения, с которого был выполнен заказ
data Сведения о заказе
user

Fingerprint, метка, определяющая магазин, от которого пришёл заказ на обработчик

Внимание

Icon

Пока что возвращается только одно значение — mobium

 
access_token
 Токен пользователя, если он зашел в личный кабинет

Параметры заказа

Тип доставки

В поле deliveryType указан тип доставки, выбранный пользователем. Если была осуществлена выгрузка типов доставки, то это один из идентификаторов выгруженных типов доставки, иначе это поле имеет значение single.

Сопроводительные сведения

Блок order_info, вложенный в блок data, представляет из себя совокупность полей, обязательных к заполнению, — имя, телефон, адрес электронной почты и комментарий — и полей, определяемых при выгрузке способов доставки для данного типа доставки, указанного в поле deliveryType. Также, если был выбран самовывоз, в поле point передаётся уникальный идентификатор точки, из которой самовывоз осуществляется.

Пример блока oder_info
"order_info" : {
    "name" : "Аноним",
    "phone" : "+79044153612",
    "email" : "admin@mobiumapps.com",
    "comments" : "Приложением доволен, хорошо сделали",
    "pointId" : "crossIsland1",
    "regionId" : "spb",
    "bonuses_used" : 0
         }
Название
Описание
name Имя пользователя
phone Телефон пользователя
email Адрес электронной почты пользователя
comments Комментарии к заказу
pointId Если выбран самовывоз, в этом поле передаётся идентификатор пункта выдачи товара
regionId Если произведена конфигурация регионов, то в этом поле передаётся идентификатор того из них, в котором находится пользователь 
bonuses_used
  Сколько использовано бонусов, при оплате заказа. Для оплаты бонусами надо настроить личный кабинет.

Формулировка заказа

Основной частью сведений о заказе является список предложений, которыми пользователь решил воспользоваться. Данный блок представляет из себя массив идентификаторов предложений с сопутствующими сведениями о количестве единиц каждого из них.

Пример блока items
"items" : [
  {
    "id" : "15",
    "count" : 1
  },
  {
    "id" : "332",
    "count" : 3
  }
]
Название
Описание
id Уникальный идентификатор предложения, предоставленный клиентом в выгрузке
count Количество заказываемых единиц данного предложения

Сведения об оплате

При оформлении заказа также передаются сведения о том, каким способом пользователь решил оплатить покупку. Сведения об этом передаются в поле payment.

Название
Описание

type

Тип оплаты, один из

  • yandex — оплата Яндекс.Деньгами
  • offline — оплата наличными

transactionId

 Если тип оплаты не offline, это поле предоставляется и является идентификатором транзакции

Остальные поля

Название
Описание
fake Булевское поле, определяющее, является ли заказ тестовым, фальшивым

Ответ получателя

После получения POST-запроса необходимо на него ответить одним из двух способов:

Удачный приём заказа
Ошибка при приёме заказа
{
  "status" : 0,
  "data" : { "order_id" : "34" }
}

Поле order_id должно содержать уникальный идентификатор заказа, по которому и будет производиться расчёт
{
  "status" : 1,
  "message" : "Критическая ошибка #59"
}

Поле message должно содержать формулировку сообщения об ошибке, которая возникла при обработке заказа

Поле 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 комментариев

Войдите в службу, чтобы оставить комментарий.