Оформление заказа (API версия 2): различия между версиями
(Новая страница: «Для оформления заказа нужно отправить следующий запрос: <pre> POST http://order24-api.utr.ua/api/order/accept </pr...») |
(Подготовленная к переводу страница) |
||
Строка 1: | Строка 1: | ||
<languages/> | |||
<translate> | |||
Для оформления заказа нужно отправить следующий запрос: | Для оформления заказа нужно отправить следующий запрос: | ||
<pre> | <pre> | ||
Строка 31: | Строка 33: | ||
где:<br> | где:<br> | ||
deliveryDate - Дата отправки заказа. Текстовое поле в формате ГГГГ-ММ-ДД. Например: 2016-09-30.<br> | deliveryDate - Дата отправки заказа. Текстовое поле в формате ГГГГ-ММ-ДД. Например: 2016-09-30.<br> | ||
delivery - Код варианта доставки. Значение поля можно получить из сервиса [[Получение вариантов доставки (API версия 2)|Получение вариантов доставки]]<br> | delivery - Код варианта доставки. Значение поля можно получить из сервиса [[Special:MyLanguage/Получение вариантов доставки (API версия 2)|Получение вариантов доставки]]<br> | ||
comment - Коментарий к заказу.<br> | comment - Коментарий к заказу.<br> | ||
deliveryPoint – код точки доставки. Значение поля можно получить из сервиса [[Получение точек доставки (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 – Код перевозчика. Значение поля можно получить из сервиса [[Получение перевозчиков (API версия 2)|Получение перевозчиков]]<br> | Transporter – Код перевозчика. Значение поля можно получить из сервиса [[Special:MyLanguage/Получение перевозчиков (API версия 2)|Получение перевозчиков]]<br> | ||
paymentType - Вариант оплаты заказа. nal - наличный расчет, beznal - безналичный расчет.<br><br> | paymentType - Вариант оплаты заказа. nal - наличный расчет, beznal - безналичный расчет.<br><br> | ||
В результате вы получите один из следующих ответов: | В результате вы получите один из следующих ответов: | ||
== Ошибка аутентификации == | == Ошибка аутентификации == | ||
Возможные ответы API при ошибке аутентификации приведены в разделе [[Ошибка аутентификации (API версия 2)|Ошибка аутентификации]] | |||
Возможные ответы API при ошибке аутентификации приведены в разделе [[Special:MyLanguage/Ошибка аутентификации (API версия 2)|Ошибка аутентификации]] | |||
== Заказ не создан – ошибка соединения == | == Заказ не создан – ошибка соединения == | ||
* Status Code: 504 gateway timeout | * Status Code: 504 gateway timeout | ||
* Body: | * Body: | ||
Строка 55: | Строка 61: | ||
} | } | ||
</pre> | </pre> | ||
== Заказ не создан – недопустимое значение одного из параметров == | == Заказ не создан – недопустимое значение одного из параметров == | ||
* Status Code: 400 bad request | * Status Code: 400 bad request | ||
* Body: | * Body: | ||
Строка 65: | Строка 73: | ||
} | } | ||
</pre> | </pre> | ||
== Заказ создан == | == Заказ создан == | ||
* Status Code: 200 OK | * Status Code: 200 OK | ||
* Body: | * Body: | ||
Строка 149: | Строка 159: | ||
] | ] | ||
</pre> | </pre> | ||
</translate> |
Версия 10:06, 4 июня 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" } ]