Оформление заказа (API версия 2): различия между версиями

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
 
(не показано 5 промежуточных версий этого же участника)
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
Для оформлення замовлення потрібно відправити настпуний запрос:
Для оформлення замовлення потрібно відправити настпуний запит:
<pre>
<pre>
POST http://order24-api.utr.ua/api/order/accept
POST http://order24-api.utr.ua/api/order/accept
</pre>
</pre>
добавив при этом в headers<br>
додавши при цьому в headers<br>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
<pre>
Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token  
Authorization: Bearer eyJ0eXAiOiJKV1Q...</pre>
<br>
Де в '''Authorization''' після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token  
<br><br>
<br><br>
* Body:
* Body:
Строка 14: Строка 16:
{
{
"comment":"test4",
"comment":"test4",
"delivery":1296,
"delivery":2109,
"deliveryDate":"2019-12-19",
"deliveryDate":"2024-02-15",
"deliveryPoint":8244,
"deliveryPoint":8195,
"items":[
"items":[
{
{
"detail":58023,
"detail":1022206,
"quantity":1,
"quantity":1,
"storage":5,
"storage":15
"transporter":3
}
}
],
],
Строка 31: Строка 32:
</pre>
</pre>


где:<br>
де:<br>
deliveryDate - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.<br>
'''deliveryDate''' - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.<br>
delivery - Код варіанта доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение вариантов доставки (API версия 2)|Получение вариантов доставки]]<br>
'''delivery''' - Код варіанта доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение вариантов доставки (API версия 2)|Отримання варіантів доставки]]<br>
comment - Коментарій до замовлення.<br>
'''comment''' - Коментар до замовлення.<br>
deliveryPoint – код точки доставки. Значення поля можна отримати з сервісу  [[Special:MyLanguage/Получение точек доставки (API версия 2)|Получение точек доставки]]<br>
'''deliveryPoint''' – код точки доставки. Значення поля можна отримати з сервісу  [[Special:MyLanguage/Получение точек доставки (API версия 2)|Отримання точок доставки]]<br>
items - Список позиций заказа.<br>
'''items''' - Список позицій замовлення.<br>
detail - Код товара. Значення поля можна отримати з поля id результату пошуку товара.<br>
'''detail''' - Код товару. Значення поля можна отримати з поля '''id''' результату пошуку товару.<br>
quantity - Кількість позицій.<br>
'''quantity''' - Кількість позицій.<br>
Storage – Код склада. <br>
'''storage''' - Код склада. <br>
Transporter – Код перевізника. Значення поля можна отримати з сервісу  [[Special:MyLanguage/Получение перевозчиков (API версия 2)|Получение перевозчиков]]<br>
'''paymentType''' - Варіант оплати замовлення. '''nal''' - готівковий розрахунок, '''beznal''' - безготівковий розрахунок.<br><br>
paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.<br><br>


В результаті ви отримаєте одну із наступних відповідей:  
В результаті ви отримаєте одну із наступних відповідей:  
Строка 48: Строка 48:
== Поимлка аутентифікації ==
== Поимлка аутентифікації ==


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




== Замовлення не створено – помилка полончення ==
== Замовлення не створено – помилка підключення ==


* Status Code: 504 gateway timeout
* Status Code: 504 gateway timeout
Строка 77: Строка 77:
== Замовлення створено ==
== Замовлення створено ==


* Status Code: 200 OK
* Status Code: 201 OK
* Body:
* Body:
<pre>
<pre>
[
[
     {
     {
         "deliveryDate": "2019-12-19T15:51:40+02:00",
         "id": 6802274,
         "delivery": {
         "externalCode": "УЭТ000008",
            "name": "До 10-30 заказ \\ Выезд 11-00 ЛЕНИНГРАДКА - КИЕВ2 (Доставка с 11:00 до 13:30)"
        "date": "2024-02-13T08:31:22+02:00",
        },
         "orderItems": [
        "comment": "test4",
         "items": [
             {
             {
                 "detail": {
                 "detail": {
                    "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,
                     "yourPrice": {
                     "yourPrice": {
                         "amount": 3.32,
                         "amount": 0,
                         "currency": {
                         "currency": {
                             "code": "EUR"
                             "code": "UAH"
                         }
                         }
                     },
                     },
Строка 105: Строка 107:
                         {
                         {
                             "storage": {
                             "storage": {
                                 "name": "ОД"
                                "id": 15,
                                 "name": "Kиїв Правий",
                                "originalName": "Kиев Правый"
                             },
                             },
                             "remain": "6"
                             "remain": "6"
Строка 111: Строка 115:
                         {
                         {
                             "storage": {
                             "storage": {
                                 "name": "Херсон"
                                "id": 23,
                                 "name": "Дніпро",
                                "originalName": "Днепр"
                             },
                             },
                             "remain": "3"
                             "remain": "2"
                        },
                        {
                            "storage": {
                                "name": "Kиев Прав"
                            },
                            "remain": "9"
                        },
                        {
                            "storage": {
                                "name": "ЗПР"
                            },
                            "remain": "10"
                         },
                         },
                        ...
                    ],
                    "detailScanCodes": [
                         {
                         {
                             "storage": {
                             "scanCode": "4013872967957"
                                "name": "Kиев Левый"
                            },
                            "remain": "5"
                         }
                         }
                     ],
                     ],
                     "category": {
                     "category": {
                         "name": "Фильтр масляный"
                         "name": "Амортизатор"
                     }
                     },
                    "modifier": 0,
                    "isDisabled": false,
                    "hasPartnerRemain": false
                 },
                 },
                 "storage": {
                 "storage": {
                     "name": "ОД"
                    "id": 15,
                     "name": "Kиїв Правий",
                    "originalName": "Kиев Правый"
                 },
                 },
                 "quantity": 1,
                 "quantity": 1,
                 "price": {
                 "price": {
                     "amount": 3.32,
                     "amount": 2158.3,
                     "currency": {
                     "currency": {
                         "code": "EUR"
                         "code": "UAH"
                     }
                     }
                },
                "transporter": {
                    "id": 3,
                    "name": "Юник Трейд"
                 }
                 }
             }
             }
         ],
         ],
         "externalCode": "УЮТ706690",
         "status": "processing",
         "paymentType": "beznal"
        "delivery": {
            "name": "Курьер Киев Розничный Магазин 9:00"
        },
         "paymentType": "nal",
        "comment": "test4",
        "amount": {
            "amount": 2158.3,
            "currency": {
                "code": "UAH"
            }
        }
     }
     }
]
]
</pre>
</pre>
</translate>
</translate>

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

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

POST http://order24-api.utr.ua/api/order/accept

додавши при цьому в headers

Authorization: Bearer eyJ0eXAiOiJKV1Q...


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

  • Body:
[
	{
		"comment":"test4",
		"delivery":2109,
		"deliveryDate":"2024-02-15",
		"deliveryPoint":8195,
		"items":[
			{
				"detail":1022206,
				"quantity":1,
				"storage":15
			}
		],
		"paymentType":"beznal",
		"withoutDocument":false
	}
]

де:
deliveryDate - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.
delivery - Код варіанта доставки. Значення поля можна отримати з сервісу Отримання варіантів доставки
comment - Коментар до замовлення.
deliveryPoint – код точки доставки. Значення поля можна отримати з сервісу Отримання точок доставки
items - Список позицій замовлення.
detail - Код товару. Значення поля можна отримати з поля id результату пошуку товару.
quantity - Кількість позицій.
storage - Код склада.
paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.

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


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

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


Замовлення не створено – помилка підключення

  • Status Code: 504 gateway timeout
  • Body:
{
    "code": 504,
    "message": "Ошибка обработки запроса. Нет соединения."
}


Замовлення не створено – неприпустиме значення одного із параметрів

  • Status Code: 400 bad request
  • Body:
{
    "code": 400,
    "message": "Значение недопустимо.\r\n"
}


Замовлення створено

  • Status Code: 201 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,
                    "yourPrice": {
                        "amount": 0,
                        "currency": {
                            "code": "UAH"
                        }
                    },
                    "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,
                    "currency": {
                        "code": "UAH"
                    }
                }
            }
        ],
        "status": "processing",
        "delivery": {
            "name": "Курьер Киев Розничный Магазин 9:00"
        },
        "paymentType": "nal",
        "comment": "test4",
        "amount": {
            "amount": 2158.3,
            "currency": {
                "code": "UAH"
            }
        }
    }
]