Оформление заказа (API версия 2): различия между версиями

Материал из UniqTrade API
Перейти к навигации Перейти к поиску
Строка 21: Строка 21:
"detail":58023,
"detail":58023,
"quantity":1,
"quantity":1,
"storage":5,
"storage":5
"transporter":3
}
}
],
],
Строка 39: Строка 38:
detail - Код товара. Значення поля можна отримати з поля id результату пошуку товара.<br>
detail - Код товара. Значення поля можна отримати з поля id результату пошуку товара.<br>
quantity - Кількість позицій.<br>
quantity - Кількість позицій.<br>
Storage – Код склада. <br>
storage – Код склада. <br>
Transporter – Код перевізника. Значення поля можна отримати з сервісу  [[Special:MyLanguage/Получение перевозчиков (API версия 2)|Получение перевозчиков]]<br>
paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.<br><br>
paymentType - Варіант оплати замовлення. nal - готівковий розрахунок, beznal - безготівковий розрахунок.<br><br>


Строка 77: Строка 75:
== Замовлення створено ==
== Замовлення створено ==


* Status Code: 200 OK
* Status Code: 201 OK
* Body:
* Body:
<pre>
<pre>

Версия 14:35, 23 января 2024

Для оформлення замовлення потрібно відправити настпуний запрос:

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
			}
		],
		"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:
[
    {
        "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"
    }
]