Оформление заказа (API версия 2): различия между версиями
(Подготовленная к переводу страница) |
|||
Строка 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 | ||
Строка 7: | Строка 7: | ||
добавив при этом в headers<br> | добавив при этом в headers<br> | ||
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | Authorization: Bearer eyJ0eXAiOiJKV1Q...<br> | ||
Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token | |||
<br><br> | <br><br> | ||
* Body: | * Body: | ||
Строка 32: | Строка 32: | ||
где:<br> | где:<br> | ||
deliveryDate - Дата | deliveryDate - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.<br> | ||
delivery - Код | delivery - Код варіанта доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение вариантов доставки (API версия 2)|Получение вариантов доставки]]<br> | ||
comment - | comment - Коментарій до замовлення.<br> | ||
deliveryPoint – код точки доставки. | deliveryPoint – код точки доставки. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение точек доставки (API версия 2)|Получение точек доставки]]<br> | ||
items - Список позиций заказа.<br> | items - Список позиций заказа.<br> | ||
detail - Код товара. | detail - Код товара. Значення поля можна отримати з поля id результату пошуку товара.<br> | ||
quantity - | quantity - Кількість позицій.<br> | ||
Storage – Код склада. <br> | Storage – Код склада. <br> | ||
Transporter – Код | Transporter – Код перевізника. Значення поля можна отримати з сервісу [[Special:MyLanguage/Получение перевозчиков (API версия 2)|Получение перевозчиков]]<br> | ||
paymentType - | paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.<br><br> | ||
В | В результаті ви отримаєте одну із наступних відповідей: | ||
== | == Поимлка аутентифікації == | ||
Можливі відповіді API при помилці аутентифікації наведены в розділі [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]] | |||
== | == Замовлення не створено – помилка подлончення == | ||
* Status Code: 504 gateway timeout | * Status Code: 504 gateway timeout | ||
Строка 63: | Строка 63: | ||
== | == Замовлення не створено – неприпустиме значення одного із параметрів == | ||
* Status Code: 400 bad request | * Status Code: 400 bad request |
Версия 13:12, 1 июля 2021
Для оформлення замовлення потрібно відправити настпуний запрос:
POST http://order24-api.utr.ua/api/order/accept
добавив при этом в headers
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Де в Authorization після ключового слова Bearer потрібно передати отриманий при проходженні аутентифікації token
- Body:
[ { "comment":"test4", "delivery":1296, "deliveryDate":"2019-12-19", "deliveryPoint":8244, "items":[ { "detail":58023, "quantity":1, "storage":5, "transporter":3 } ], "paymentType":"beznal", "withoutDocument":false } ]
где:
deliveryDate - Дата відправки замовлення. Текстове поле в форматі РРРР-ММ-ДД. Наприклад: 2016-09-30.
delivery - Код варіанта доставки. Значення поля можна отримати з сервісу Получение вариантов доставки
comment - Коментарій до замовлення.
deliveryPoint – код точки доставки. Значення поля можна отримати з сервісу Получение точек доставки
items - Список позиций заказа.
detail - Код товара. Значення поля можна отримати з поля id результату пошуку товара.
quantity - Кількість позицій.
Storage – Код склада.
Transporter – Код перевізника. Значення поля можна отримати з сервісу Получение перевозчиков
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: 200 OK
- Body:
[ { "deliveryDate": "2019-12-19T15:51:40+02:00", "delivery": { "name": "До 10-30 заказ \\ Выезд 11-00 ЛЕНИНГРАДКА - КИЕВ2 (Доставка с 11:00 до 13:30)" }, "comment": "test4", "items": [ { "detail": { "brand": { "name": "MAHLE FILTERS" }, "article": "OC90", "title": "Фильтр масляный Mahle Lanos/Aveo", "quantity": 1, "yourPrice": { "amount": 3.32, "currency": { "code": "EUR" } }, "remains": [ { "storage": { "name": "ОД" }, "remain": "6" }, { "storage": { "name": "Херсон" }, "remain": "3" }, { "storage": { "name": "Kиев Прав" }, "remain": "9" }, { "storage": { "name": "ЗПР" }, "remain": "10" }, { "storage": { "name": "Kиев Левый" }, "remain": "5" } ], "category": { "name": "Фильтр масляный" } }, "storage": { "name": "ОД" }, "quantity": 1, "price": { "amount": 3.32, "currency": { "code": "EUR" } }, "transporter": { "id": 3, "name": "Юник Трейд" } } ], "externalCode": "УЮТ706690", "paymentType": "beznal" } ]