getOrdersStatus и getOrdersInfo
Массив на входе должен состоять из:
├──action -> название метода (строка)
├──data -> данные необходимые для того или иного метода. (массив)
│ │ для получения статуса заказа (getOrdersStatus), или информации о заказе (getOrdersInfo), массив data должен содержать следующее обязательное поле:
│ ├──id -> *идентификационная строка, полученная у представителя Voltmarket.ru (строка)
│ │ и не обязательных:
│ ├──orders -> Массив из идентификаторов заказов, информация о которых запрашивается (массив)
│ │ ├──id заказа
│ │ ├──id заказа
│ │ ├──...
│ ├──limit -> Лимит заказов. (число)
В случае если orders присуствуют, обработка limit
упускается,
если orders отсутствует, проверяется наличие limit
, и выдаются информация о
всех заказах совершенных через партнера в количестве не превышающий строку limit
,
при отсутствии limit
, по умолчанию выдается не более 100 заказов
ПРИМЕР для получения статуса заказа (getOrdersStatus
), или информации о заказе (getOrdersInfo
)
{
"action":"getOrdersStatus",
"data":{
"id":"f57jde7ec7ed9d27i0bca988ca6f5ca8",
"orders":[
10326,
10268,
10300
],
"limit":5000
}
}
результат выполнения запроса на получение статуса getOrdersStatus
заказов будет выглядеть так:
{
"success":true,
"data":{
"10326":{
"id":"M",
"description":"Принят, обрабатывается"
},
"10306":{
"id":"R",
"description":"Отказ"
},
"10300":"Заказ с кодом 10300 не найден"
}
}
где ключи в первом уровне это id
заказов:
далее id
статуса
description описание статуса
при отсудствии заказа с запрошенным id
:
Ответ "Заказ с кодом id не найден"
образцы статусов:
"id":"M", "description":"Принят, обрабатывается"
"id":"F", "description":"Выполнен"
"id":"R", "description":"Отказ"
результат выполнения запроса на получение информации о заказе getOrdersInfo будет выглядеть так-же как и массив на оформление заказа, разделенный на под-массивы, ключами которых являются id заказов, а также дополненный информацией о статусе заказа:
{
"10448": {
"order": {
"price": "25200.00",
"comment": "",
"delivery_price": "1200.00",
"payed": "Y"
},
"status": {
"id": "N",
"description": "Новый заказ"
},
"order_props": {
"fio": "Иванов Иван Иванович",
"email": "test@test.pu",
"phone": "+11111111111",
"adres": "19"
},
"basket": [
{
"productId": "459688",
"price": "12600.00",
"quantity": "3.00",
"name": "Инвертор навесной Энергия ПН-750"
},
{
"productId": "459689",
"price": "12600.00",
"quantity": "3.00",
"name": "Инвертор навесной Энергия ПН-750"
}
]
}
}
где:
"order": {
"price": "25200.00",
"comment": "",
"delivery_price": "1200.00",
"payed": "Y"
}
Цена
всего заказа.
Комментарий
покупателя.
Цена доставки
заказа.
Флаг оплаты
заказа.
"status": {
"id": "N",
"description": "Новый заказ"
}
Статус
заказа код статуса и описание
"order_props": {
"fio": "Иванов Иван Иванович",
"email": "test@test.pu",
"phone": "+11111111111",
"adres": "19"
},
ФИО
клиента,
Email
клиента,
Телефон
клиента,
Адрес доставки
заказа,
"basket": [
{
"productId": "459688",
"price": "12600.00",
"quantity": "3.00",
"name": "Инвертор навесной Энергия ПН-750"
},
id
товара,
цена
1 товара,
количество
товара в заказе,
Название
товара.
*Звездочкой отмечены обязательные поля
В случае выявления ошибок во входных данных, выдаются список выявленных ошибок
{
"code": "error",
"data": [
"Не указана стоимость заказа",
"Не указано ФИО клиента",
"Не указан Email клиента",
"Не указан номер телефона клиента",
"Не указан PRODUCT_ID Товара",
"Не указана цена товара",
"Не указано количество товара",
"Не указано название товара"
]
}