Оформление заказа (API версия 2): различия между версиями
(не показано 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> | |||
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 | ||
Строка 77: | Строка 77: | ||
== Замовлення створено == | == Замовлення створено == | ||
* 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" } } } ]