order/get
Описание метода
URL метода: order/get
Запрос выполняется продавцомВАЖНО!
Продавец запрашивается детальную информацию по отправлению.
Важно
Наша система не является безотказной, и иногда она может быть недоступна. В таких случаях на запрос мерчанта будет ответ с кодом ошибки "500". Рекомендуем мерчантам на своей стороне предусмотреть функционал обработки ответов от маркетплейса и в случае необходимости автоматической повторной отправки запроса.
Параметры запроса:
| Структура данных в теле запроса | Описание | Обязательность | Тип данных |
|---|---|---|---|
| 1. data | Общий блок с данными | да | Object |
| 1.2 token | Уникальный ключ для аутентификации продавца | да | String |
| 1.3 shipments | Данные об отправлениях | да | Array |
| 2. meta | Исходная информация от продавца | да | Object |
Описание необходимых параметров в ответе:
| Структура данных в теле запроса | Описание | Тип данных |
|---|---|---|
| 1. data | Общий блок с данными | Object |
| 1.2 shipments | Данные об отправлениях | Array |
| 1.2.1 shipmentId | Номер отправления | string |
| 1.2.2 orderCode | Номер заказа продавца | string |
| 1.2.3 confirmedTimeLimit | Крайняя дата подтверждения мерчантом | string |
| 1.2.4 packingTimeLimit | Крайняя дата комплектации | string |
| 1.2.5 shippingTimeLimit | Крайняя дата доставки | string |
| 1.2.6 shipmentDateFrom | Отгрузка с | string |
| 1.2.7 shipmentDateTo | Отгрузка по | string |
| 1.2.8 packingDate | Дата до которой должна быть произведена комплектация | dateTime/string |
| 1.2.9 reserveExpirationDate | Дата истечения срока резерва | dateTime/string |
| 1.2.10 deliveryId | Номер доставки | string |
| 1.2.11 shipmentDateShift | Изменение даты отгрузки | boolean |
| 1.2.12 shipmentIsChangeable | Перекомплектация | boolean |
| 1.2.13 customerFullName | Имя клиента(вводится на чекауте) | string |
| 1.2.14 customerAddress | Адрес торговой точки | string |
| 1.2.15 shippingPoint | Идентификатор магазине по системе продава | string |
| 1.2.16 creationDate | Дата создания отправления | string |
| 1.2.17 deliveryDate | дата доставки до покупателя | dateTime/string |
| 1.2.18 deliveryDateFrom | Дата и время с которой клиент может выкупить товар | string |
| 1.2.19 deliveryDateTo | Дата и время до которой клиент должен выкупить товар | string |
| 1.2.20 items | Массов содержащий набор лотов в рамках отправления | array |
| 1.2.20.1 itemIndex | Порядковый номер лота | string |
| 1.2.20.2 status | Статусы лота:
| string |
| 1.2.20.2.1 subStatus | Детализация этапы отмены. В структуре данных параметр обязательно, но заполнение не обязательное Со стороны Мегамаркета придет информация причин:
| string |
| 1.2.20.3 price | Цена лота | Integer |
| 1.2.20.3 finalPrice | Цена лота с учетом скидки | Integer |
| 1.2.20.4 discounts | Массив содержащий набор параметров содержащих информацию о скидке | array |
| 1.2.20.4.1 discountType | Тип скидки | string |
| 1.2.20.4.2 discountDescription | Описание скидки | string |
| 1.2.20.4.3 discountAmount | Сумма скидки | Integer |
| 1.2.20.5 quantity | количество (всегда единица. Количество определяется в рамках объектов массива items) | Integer |
| 1.2.20.6 offerId | Артикул | string |
| 1.2.20.7 goodsId | Идентификатор карточки товара Мегамаркета | string |
| 1.2.20.8 goodsData | Объект содержащий информацию о карточке товара | object |
| 1.2.20.8.1 name | Наименования карточки товара Мегамаркет | string |
| 1.2.20.8.2 categoryName | Название категории | string |
| 1.2.20.9 boxIndex | Грузовое место | string |
| 1.2.21 deliveryMethodId | Схема доставки | string |
| 1.2.22 depositedAmount | Сумма, оплаченная Покупателем за товары на сайте Мегамаркета (если 0, то оплату нужно принять при выдаче, если = значению finalPrice, то дополнительно оплату при выдаче взимать не требуется) | Integer |
| 1.2.23 status | Общий статус отправления. Соответствует статусу лота с наименьшим из статусов (см. пункт 1.2.20.2). При работе с заказами рекомендуется ориентироваться на статус каждого отдельного лота, а не на данное поле. | string |
| 2. meta | Исходная информация | object |
Пример запроса
{
"meta": {},
"data": {
"token": "********-****-****-****-************",
"shipments": [
"863797039"
]
}
}
Пример ответа
{
"success": 1,
"meta": {},
"data": {
"shipments": [
{
"shipmentId": "863797039",
"orderCode": "888",
"confirmedTimeLimit": "2020-01-09T17:00:00+03:00",
"packingTimeLimit": "2020-01-09T17:00:00+03:00",
"shippingTimeLimit": "2020-01-09T17:00:00+03:00",
"shipmentDateFrom": "2020-01-09T17:00:00+03:00",
"shipmentDateTo": "2020-01-11T23:00:00+03:00",
"packingDate": "2020-01-09T17:00:00+03:00",
"reserveExpirationDate": "2020-01-12T09:00:00+03:00",
"deliveryId": "830786014",
"shipmentDateShift": true,
"shipmentIsChangeable": true,
"customerFullName": "Тестовыйол Клиентф",
"customerAddress": "м. Третьяковская, ул. Большая Ордынка, 21, стр. 2",
"shippingPoint": "73",
"creationDate": "2020-01-09T11:20:21+03:00",
"deliveryDate": "2020-01-09T00:00:00+03:00",
"deliveryDateFrom": "2020-01-09T17:00:00+03:00",
"deliveryDateTo": "2020-01-11T23:00:00+03:00",
"items": [
{
"itemIndex": "1",
"status": "MERCHANT_CANCELED",
"subStatus": "LATE_REJECT",
"price": 250,
"finalPrice": 125,
"discounts": [
{
"discountType": "LOY",
"discountDescription": "LOY",
"discountAmount": 125,
"discountPriceAdjustments": 125
}
],
"quantity": 1,
"offerId": "483097",
"goodsId": "100013204647",
"goodsData": {
"name": "Пазл TREFL Моя маленькая Пони. 60 деталей (17240)",
"categoryName": ""
},
"events": [
{
"eventDate": "2020-01-09T11:43:54+03:00",
"eventName": "СТАТУС_КАБИНЕТ_ЛОГИСТА",
"eventValue": "У продавца"
},
{
"eventDate": "2020-01-09T11:43:55+03:00",
"eventName": "СТАТУС_РЕЗУЛЬТАТ_ВЫПОЛНЕНИЯ",
"eventValue": "Выполняется"
},
{
"eventDate": "2020-01-09T11:43:56+03:00",
"eventName": "СТАТУС_ПРОДАВЦА",
"eventValue": "Не подтверждался продавцом"
},
{
"eventDate": "2020-01-09T11:43:56+03:00",
"eventName": "СТАТУС_ПОКУПАТЕЛЯ",
"eventValue": "Не подтверждался покупателем"
},
{
"eventDate": "2020-01-09T12:08:43+03:00",
"eventName": "ПОДТВЕРЖДЕНИЕ_МЕРЧАНТОМ",
"eventValue": "ОЖИДАЕТСЯ"
},
{
"eventDate": "2020-01-09T12:10:54+03:00",
"eventName": "КОМПЛЕКТАЦИЯ_МЕРЧАНТОМ",
"eventValue": "ОЖИДАЕТСЯ"
},
{
"eventDate": "2020-01-09T14:35:22+03:00",
"eventName": "СТАТУС_ПРОДАВЦА",
"eventValue": "Подтвержден продавцом"
},
{
"eventDate": "2020-01-09T14:35:23+03:00",
"eventName": "ПОДТВЕРЖДЕНИЕ_МЕРЧАНТОМ",
"eventValue": "ПОДТВЕРЖДЕН"
},
{
"eventDate": "2020-01-09T14:35:25+03:00",
"eventName": "КОМПЛЕКТАЦИЯ_МЕРЧАНТОМ",
"eventValue": "СКОМПЛЕКТОВАН"
},
{
"eventDate": "2020-01-09T14:35:26+03:00",
"eventName": "ОТГРУЗКА_МЕРЧАНТОМ",
"eventValue": "ОЖИДАЕТСЯ"
},
{
"eventDate": "2020-01-09T14:35:27+03:00",
"eventName": "СТАТУС_ПРОДАВЦА",
"eventValue": "Скомплектован продавцом"
},
{
"eventDate": "2020-01-09T14:51:04+03:00",
"eventName": "СТАТУС_ПОКУПАТЕЛЯ",
"eventValue": "Автоподтвержден с покупателем"
},
{
"eventDate": "2020-01-09T19:00:20+03:00",
"eventName": "СТАТУС_ПРОДАВЦА",
"eventValue": "Отменен продавцом после подтверждения"
},
{
"eventDate": "2020-01-09T19:00:21+03:00",
"eventName": "ОТГРУЗКА_МЕРЧАНТОМ",
"eventValue": "ОТКАЗ"
},
{
"eventDate": "2020-01-09T19:00:21+03:00",
"eventName": "СТАТУС_РЕЗУЛЬТАТ_ВЫПОЛНЕНИЯ",
"eventValue": "Отменен продавцом"
}
],
"boxIndex": null
}
],
"deliveryMethodId": "COURIER",
"serviceScheme": "DELIVERY_BY_GOODS",
"customer": null,
"depositedAmount": 0
}
]
}
}
}