getList — получение списка заказов
Запрос
GET https://[домен]/engine/orders/getList/[days]
где [домен] — адрес вашего интернет-магазина;
[days] — количество дней, за которые нужно искать новые заказы, если считать назад от сегодняшней даты.
API вернет список заказов, у которых еще не получена информация о загрузке заказа в Информационную систему (об этом ниже). В полученной информации будет присутствовать полная информация по всем новым заказам за указанный период дней [days].
Пример ответа сервера:
{
"success":true,
"orders":[
{
"shop_id":"shopID_",
"order_id":6,
"date":"02.06.2020",
"customer_id":7,
"customer_info":"Имя: ТЕСТОВЫЙ ЗАКАЗ E-mail: 1с@unisiter.ru Телефон: +73822978985 Дополнительно: тест поля дополнительно ",
"promocode":"",
"payment":"sber_card",
"status":"2",
"
delivery":"350",
"order_form": {
"login":"ТЕСТОВЫЙ ЗАКАЗ",
"mail":"1с@unisiter.ru",
"phone":"+73822978985",
"extra":"тест поля дополнительно"
},
"goods":[
{
"code":"OAC00410169",
"article":"",
"qt":"1",
"price":"213.50",
"variant":"e0181716-10a9-11ea-81b8-14dae93d3758~8969ecda-4716-11ea-b789-14dae93d3758"
},
{
"code":"OAC00274889",
"article":"",
"qt":"2",
"price":"29.44",
"variant":"dadfedf8-0930-11e7-a357-0003cd830242~f995cb65-95bc-11ea-96b4-14dae93d3758"
},
{
"code":"OAC00128310",
"article":"",
"qt":"3",
"price":"112.50",
"variant":"7d0de481-d6ba-11e2-957a-0003cd830242~1232a4d2-8833-11ea-96b4-14dae93d3758"
}
]
}
]
}
Описание полей в ответе сервера:
success – признак корректности обработки запроса;
orders – массив структур с описанием новых заказов. Новых – значит по ним не была отправлена информация из информационной системы, что заказ загружен в информационную систему;
shop_id – идентификатор магазина, откуда пришел заказ;
order_id – идентификатор заказа;
date – дата заказа. Формат dd- MM-yyyy ;
customer_id – идентификатор покупателя на сайте;
customer_info – строка со сводной информацией о клиенте;
promocode – использованный в заказе промокод (если был использован)
payment – тип оплаты. Возможные варианты:
- sber_card — оплата через эквайринг от Сбербанка
- sber_installment — оплата через рассрочку от Сбербанка
- sber_credit — оплата через кредит от Сбербанка
- sber_QR — оплата по QR коду от Сбербанка
- yandex_card— оплата через Яндекс.Касса
- paykeeper_card — оплата через PayKeeper
- other — любой другой способ оплаты
status – текущий статус заказа. 0 - размещен; 1 - в обработке; 2 - завершен; 3 - оплачен; 4 - отменен; 5 - ожидает оплаты;
delivery – стоимость доставки (если не указана, то будет передана пустая строка);
order_form – структура полей с подробными данными о покупателе:
login – наименование покупателя (ФИО, название организации);
mail – email покупателя;
phone – телефон покупателя;
extra – значение поля «Дополнительно» на форме заказа;
goods – массив структур с описанием состава заказа
code – код товара;
article – артикул товара;
qt – количество товара в заказе;
price – цена товара в заказе;
variant – идентификатор товара из 1С (вплоть до характеристики номенклатуры, если она используется в 1С). Состоит из GUID товара и GUID характеристики, разделенных знаком «~». Если характеристика не используется, то только GUID товара.