Просмотр списка заказов (API версия 2): различия между версиями

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
(Новая страница: «Для просмотра списка заказов нужно отправлять следующий запрос: <pre> GET https://order24-api.utr.ua/api/o...»)
 
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
Для просмотра списка заказов нужно отправлять следующий запрос:  
<languages/>
<translate>
Для перегляду списка замовлень потрібно відправити наступний запит:  
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}
GET https://order24-api.utr.ua/api/order-list/{date}
</pre>
</pre>
{date} - дата начала периода для выборки заказов (конец периода - текущая дата)<br>
'''{date}''' - дата початку періоду для выборки замовлень (кінець періоду - поточна дата)<br>
добавив при этом в headers<br>
додавши при цьому в headers<br>
<pre>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
Где в Authorization после ключевого слова Bearer нужно передать полученный при прохождении аутентификации token  
</pre>
Де в '''Authorization''' після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token  
<br><br>
<br><br>
Также запрос может быть уточнен путем указания текущей страницы и количества элементов на странице:
Також запит може бути уточнено шляхом вказання поточної сторінки та кількості елеметів на сторінці:  
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period
GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period
</pre>
</pre>
Возможно также выполнить поиск заказов, которые содержат определенный товар
Можливо також виконати пошук замовлень, які містять певну деталь
<pre>
<pre>
GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}
GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}
</pre>
</pre>
где: {detail_id} – код товара
де: '''{detail_id}''' – код товара
<br><br>
<br><br>
В результате вы получите один из следующих ответов:  
В результаті ви отримаєте одну із наступних відповідей:  
 
== Помилка аутентифікації ==


Можливі відповіді API при помилці аутентифікації приведено в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Помилка аутентификації]]


== Ошибка аутентификации ==
== Замовлення не знайдено ==
Возможные ответы API при ошибке аутентификации приведены в разделе [[Ошибка аутентификации (API версия 2)|Ошибка аутентификации]]


== Заказы не найдены ==
* Status Code: 200 OK
* Status Code: 200 OK
* Body:
* Body:
Строка 31: Строка 36:
</pre>
</pre>


== Список заказов ==
 
== Список замовлень ==
 
* Status Code: 200 OK
* Status Code: 200 OK
* Body:
* Body:
Строка 37: Строка 44:
[
[
     {
     {
         "id": 4303,
         "id": 6802274,
         "externalCode": "УЮТ706690",
         "externalCode": "УЭТ000008",
         "date": "2019-12-18T15:59:51+02:00",
         "date": "2024-02-13T08:31:22+02:00",
         "orderItems": [
         "orderItems": [
             {
             {
                 "detail": {
                 "detail": {
                     "id": 58023,
                    "multiplicity": 1,
                     "id": 1022206,
                     "brand": {
                     "brand": {
                         "name": "MAHLE FILTERS"
                         "name": "SACHS",
                        "externalCode": "00005"
                     },
                     },
                     "article": "OC90",
                    "displayBrand": "SACHS",
                     "title": "Фильтр масляный Mahle Lanos/Aveo",
                     "article": "317 577",
                     "title": "Амортизатор",
                     "quantity": 1,
                     "quantity": 1,
                     "remains": [
                     "remains": [
                         {
                         {
                             "storage": {
                             "storage": {
                                 "id": 5,
                                 "id": 15,
                                 "name": "ОД"
                                 "name": "Kиїв Правий",
                                "originalName": "Kиев Правый"
                             },
                             },
                             "remain": "6"
                             "remain": "6"
                         },
                         },
                        ...
                    ],
                    "category": {
                        "name": "Фильтр масляный"
                    }
                },
                "storage": {
                    "id": 5,
                    "name": "ОД"
                },
                "quantity": 1,
                "price": {
                    "amount": 81.54
                }
            }
        ],
        "status": "processing",
        "delivery": {
            "name": "До 10-30 заказ \\ Выезд 11-00 ЛЕНИНГРАДКА - КИЕВ2 (Доставка с 11:00 до 13:30)"
        },
        "paymentType": "beznal",
        "amount": {
            "amount": 81.54,
            "currency": {
                "code": "UAH"
            }
        }
    },
  {
        "id": 4297,
        "externalCode": "УЮТ706564",
        "date": "2019-11-27T14:12:19+02:00",
        "orderItems": [
            {
                "detail": {
                    "id": 4106,
                    "brand": {
                        "name": "BOSCH"
                    },
                    "article": "0451103079",
                    "title": "Фильтр масляный Lanos/Lacetti",
                    "quantity": 1,
                    "remains": [
                         {
                         {
                             "storage": {
                             "storage": {
                                 "id": 5,
                                 "id": 23,
                                 "name": "ОД"
                                 "name": "Дніпро",
                                "originalName": "Днепр"
                             },
                             },
                             "remain": "8"
                             "remain": "2"
                         },
                         },
                         ...
                         ...
                     ],
                     ],
                     "category": {
                     "detailScanCodes": [
                        "name": "Фильтр масляный"
                    }
                },
                "storage": {
                    "id": 5,
                    "name": "ОД"
                },
                "quantity": 4,
                "price": {
                    "amount": 58.1
                }
            },
            {
                "detail": {
                    "id": 56712,
                    "brand": {
                        "name": "MAHLE FILTERS"
                    },
                    "article": "KL749",
                    "title": "Фильтр топливный Mahle",
                    "quantity": 1,
                    "remains": [
                         {
                         {
                             "storage": {
                             "scanCode": "4013872967957"
                                "id": 6,
                                "name": "НК"
                            },
                            "remain": "1"
                         }
                         }
                     ],
                     ],
                     "category": {
                     "category": {
                         "name": "Фильтр топливный"
                         "name": "Амортизатор"
                     }
                     },
                    "modifier": 0,
                    "isDisabled": false,
                    "hasPartnerRemain": false
                 },
                 },
                 "storage": {
                 "storage": {
                     "id": 5,
                     "id": 15,
                     "name": "ОД"
                     "name": "Kиїв Правий",
                    "originalName": "Kиев Правый"
                 },
                 },
                 "quantity": 1,
                 "quantity": 1,
                 "price": {
                 "price": {
                     "amount": 426.02
                     "amount": 2158.3
                 }
                 }
             },
             }
            ...
         ],
         ],
         "status": "processing",
         "status": "processing",
         "delivery": {
         "delivery": {
             "name": "5 До 14:30 заказ [СЛОБОДКА Одесса] доставка с 15:00"
             "name": "Курьер Киев Розничный Магазин 9:00"
         },
         },
         "paymentType": "nal",
         "paymentType": "nal",
        "comment": "test4",
         "amount": {
         "amount": {
             "amount": 1561.38,
             "amount": 2158.3,
             "currency": {
             "currency": {
                 "code": "UAH"
                 "code": "UAH"
Строка 171: Строка 118:
]
]
</pre>
</pre>
</translate>

Текущая версия на 10:53, 21 февраля 2024

Для перегляду списка замовлень потрібно відправити наступний запит: 

GET https://order24-api.utr.ua/api/order-list/{date}

{date} - дата початку періоду для выборки замовлень (кінець періоду - поточна дата)
додавши при цьому в headers

Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>

Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token

Також запит може бути уточнено шляхом вказання поточної сторінки та кількості елеметів на сторінці: 

GET https://order24-api.utr.ua/api/order-list/{date}?page=1&limit=20&mode=period

Можливо також виконати пошук замовлень, які містять певну деталь 

GET https://order24-api.utr.ua/api/order-list/{date}/{detail_id}

де: {detail_id} – код товара

В результаті ви отримаєте одну із наступних відповідей:

Помилка аутентифікації

Можливі відповіді API при помилці аутентифікації приведено в розділі Помилка аутентификації

Замовлення не знайдено

  • Status Code: 200 OK
  • Body:
[]


Список замовлень

  • Status Code: 200 OK
  • Body:
[
    {
        "id": 6802274,
        "externalCode": "УЭТ000008",
        "date": "2024-02-13T08:31:22+02:00",
        "orderItems": [
            {
                "detail": {
                    "multiplicity": 1,
                    "id": 1022206,
                    "brand": {
                        "name": "SACHS",
                        "externalCode": "00005"
                    },
                    "displayBrand": "SACHS",
                    "article": "317 577",
                    "title": "Амортизатор",
                    "quantity": 1,
                    "remains": [
                        {
                            "storage": {
                                "id": 15,
                                "name": "Kиїв Правий",
                                "originalName": "Kиев Правый"
                            },
                            "remain": "6"
                        },
                        {
                            "storage": {
                                "id": 23,
                                "name": "Дніпро",
                                "originalName": "Днепр"
                            },
                            "remain": "2"
                        },
                        ...
                    ],
                    "detailScanCodes": [
                        {
                            "scanCode": "4013872967957"
                        }
                    ],
                    "category": {
                        "name": "Амортизатор"
                    },
                    "modifier": 0,
                    "isDisabled": false,
                    "hasPartnerRemain": false
                },
                "storage": {
                    "id": 15,
                    "name": "Kиїв Правий",
                    "originalName": "Kиев Правый"
                },
                "quantity": 1,
                "price": {
                    "amount": 2158.3
                }
            }
        ],
        "status": "processing",
        "delivery": {
            "name": "Курьер Киев Розничный Магазин 9:00"
        },
        "paymentType": "nal",
        "comment": "test4",
        "amount": {
            "amount": 2158.3,
            "currency": {
                "code": "UAH"
            }
        }
    },
    ...
]
Источник — https://api.utr.ua/index.php?title=Просмотр_списка_заказов_(API_версия_2)&oldid=448