Оформление заказа (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"
}
]