Оформление заказа (API версия 2): различия между версиями
| (не показано 7 промежуточных версий этого же участника) | |||
| Строка 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> | |||
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": | "delivery":2109, | ||
"deliveryDate":" | "deliveryDate":"2024-02-15", | ||
"deliveryPoint": | "deliveryPoint":8195, | ||
"items":[ | "items":[ | ||
{ | { | ||
"detail": | "detail":1022206, | ||
"quantity":1, | "quantity":1, | ||
"storage": | "storage":15 | ||
} | } | ||
], | ], | ||
| Строка 31: | Строка 32: | ||
</pre> | </pre> | ||
де:<br> | |||
deliveryDate - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.<br> | '''deliveryDate''' - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.<br> | ||
delivery - Код варіанта доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение вариантов доставки (API версия 2)| | '''delivery''' - Код варіанта доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение вариантов доставки (API версия 2)|Отримання варіантів доставки]]<br> | ||
comment - | '''comment''' - Коментар до замовлення.<br> | ||
deliveryPoint – код точки доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение точек доставки (API версия 2)| | '''deliveryPoint''' – код точки доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение точек доставки (API версия 2)|Отримання точок доставки]]<br> | ||
items - Список | '''items''' - Список позицій замовлення.<br> | ||
detail - Код | '''detail''' - Код товару. Значення поля можна отримати з поля '''id''' результату пошуку товару.<br> | ||
quantity - Кількість позицій.<br> | '''quantity''' - Кількість позицій.<br> | ||
'''storage''' - Код склада. <br> | |||
'''paymentType''' - Варіант оплати замовлення. '''nal''' - готівковий розрахунок, '''beznal''' - безготівковий розрахунок.<br><br> | |||
paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.<br><br> | |||
В результаті ви отримаєте одну із наступних відповідей: | В результаті ви отримаєте одну із наступних відповідей: | ||
| Строка 48: | Строка 48: | ||
== Поимлка аутентифікації == | == Поимлка аутентифікації == | ||
Можливі відповіді API при помилці аутентифікації | Можливі відповіді API при помилці аутентифікації наведені в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Помилка аутентификації]] | ||
== Замовлення не створено – помилка | == Замовлення не створено – помилка підключення == | ||
* Status Code: 504 gateway timeout | * Status Code: 504 gateway timeout | ||
| Строка 75: | Строка 75: | ||
== | == Замовлення створено == | ||
* Status Code: | * Status Code: 201 OK | ||
* Body: | * Body: | ||
<pre> | <pre> | ||
[ | [ | ||
{ | { | ||
" | "id": 6802274, | ||
" | "externalCode": "УЭТ000008", | ||
"date": "2024-02-13T08:31:22+02:00", | |||
"orderItems": [ | |||
" | |||
{ | { | ||
"detail": { | "detail": { | ||
"multiplicity": 1, | |||
"id": 1022206, | |||
"brand": { | "brand": { | ||
"name": " | "name": "SACHS", | ||
"externalCode": "00005" | |||
}, | }, | ||
"article": " | "displayBrand": "SACHS", | ||
"title": " | "article": "317 577", | ||
"title": "Амортизатор", | |||
"quantity": 1, | "quantity": 1, | ||
"yourPrice": { | "yourPrice": { | ||
"amount": | "amount": 0, | ||
"currency": { | "currency": { | ||
"code": " | "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": " | "remain": "2" | ||
}, | }, | ||
... | |||
], | |||
"detailScanCodes": [ | |||
{ | { | ||
" | "scanCode": "4013872967957" | ||
} | } | ||
], | ], | ||
"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 | "amount": 2158.3, | ||
"currency": { | "currency": { | ||
"code": " | "code": "UAH" | ||
} | } | ||
} | } | ||
} | } | ||
], | ], | ||
" | "status": "processing", | ||
"paymentType": " | "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"
}
}
}
]