Тип API: Безкоштовний
Для отримання списку замовлень, потрібно надіслати GET запит на адресу
URL
https://developers.ria.com/ria/basket/orders/?user_id=YOUR_USER_ID&api_key=YOUR_API_KEY.
де YOUR_USER_ID - ідентифікатор користувача, YOUR_API_KEY - персональний ключ доступу користувача.
URL
curl -X GET "https://developers.ria.com/ria/basket/orders/?user_id=YOUR_USER_ID&api_key=YOUR_API_KEY"
Перелік параметрів у відповіді
Параметр | Опис | Тип |
---|---|---|
ordersStatusId |
Cтатус замовлення (new) | Array of order statuses |
orders |
Інформація про замовлення | Collection of objects |
order_id |
id замовлення | integer |
status |
Статус замовлення | integer |
total_order_sum |
Загальна сума замовлення | integer |
created_at |
Час створення | datetime |
recipient |
Отримувач | array of recepient's data |
user_id |
id користувача | integer |
name |
ім'я | string |
електронна адреса | string | |
phone |
номер телефону | string |
delivery |
Доставка | array of delivery data |
state_id |
id Області | integer |
city_id |
id Міста | integer |
address |
Адреса | string |
service |
Служба доставки | string |
department |
Інформація про відділення | integer |
state_name |
Назва Області (new) | string |
city_name |
Назва Міста (new) | string |
items |
перелік товару в замовленні | array of items' data |
adv_id |
id оголошення | integer |
adv_link |
посилання на оголошення (new) | string |
count |
Кількість | integer |
price |
Ціна | integer |
name |
Назва товару | string |
note |
Коментар/примітка | string |
catalog_numbers |
Каталожний номер | string |
vendor_code |
Код постачальника | string |
status |
Статус відповіді на запит | |
total |
Загальна кількість замовлень | integer |
Інтерпретація статусів замовлень:
id статуса | Опис |
---|---|
0 | Нове |
1 | Виконане |
2 | Не виконане |
6 | Видалене |
Усі нові замовлення приходять зі статусом 0.
Для того щоб не вимимкався кошик на маркетплейсі необхідно змінювати статус замовлення.
Відповідно до того на якій стадії знаходиться замовлення потрібно змінювати статус з 0 на інший: 1, 2 або 6.
Зразок відповіді
{
"ordersStatusId": {
"0": "Нове",
"1": "Виконане",
"2": "Не виконане",
"6": "Видалене"
},
"orders": [
{
"order_id": 711777,
"status": 2,
"total_order_sum": 2596,
"created_at": "2023-08-10 10:54:58",
"recipient": {
"user_id": 505575,
"name": "Сергей Сергей",
"email": null,
"phone": "0500000005"
},
"delivery": {
"state_id": "7",
"city_id": "7",
"address": null,
"service": "Meest",
"department": null,
"state_name": "Харківська",
"city_name": "Харків"
},
"items": [
{
"adv_id": 129337999,
"adv_link": "<a href=\"https://zapchasti.ria.com/uk/kovryky-v-salon-dlya-porsche-cayenne-2018-2023-yz-eva-etylenvynylatsetat-129337999.html\" target=\"_blank\">Коврики в салон для Porsche Cayenne 2018-2023 из ЭВА (этиленвинилацетат)</a>",
"count": 1,
"price": 1597,
"name": "Коврики в салон для Porsche Cayenne 2018-2023 из ЭВА (этиленвинилацетат)",
"note": null,
"catalog_numbers": "",
"vendor_code": ""
}
]
}
],
"status": true,
"total": 2
}
Зразок відповіді до 21.03.2024
{
"status":true,
"total":2,
"orders":[
{
"order_id":212121,
"status":6,
"total_order_sum":100,
"created_at":"2023-01-11 03:39:30",
"recipient":{
"user_id":000000,
"name":"Андрій Сергійович",
"email":"mail@gmail.com",
"phone":"......"
},
"delivery":{
"state_id":1,
"city_id":1,
"address":"Вінницька область, Вінниця",
"service":"DHL"
"department":"Відділення №1: вулиця Соборна, 15; оф. 6"
},
"items":[
{
"adv_id":122724239,
"name":"Диффузор 1j0121207m",
"price":100,
"count":1,
"note":""
"vendor_code":"",
"catalog_numbers":""
}
]
},
...
]