Раніше, щоб працювати із замовленнями на доставку, необхідно було заповнювати довідник міст і вулиць. Список вулиць використовується під час створення доставних замовлень вручну на касі або в кол-центрі.
Під час інтеграції із зовнішнім сайтом або агрегатором замовлень, Syrve очікує, що поле адреси у зовнішньому замовленні буде заповнене відповідно до списку вулиць, наявного в системі. Однак агрегатори зазвичай використовують так званий “розумний” пошук адреси, як у сервісах Google Maps, тому формат адреси і назва вулиць у зовнішніх замовленнях часто відрізняються, і можуть виникнути проблеми зі створенням замовлень, що надходять із зовнішніх джерел.
Починаючи з версії 8.9.8, в Syrve можна вибрати формат адреси доставки.
Перехід на новий формат адреси
Авторизуйтеся в SyrveOffice, перейдіть у розділ “Адміністрування” – “Налаштування торгового підприємства”. Виберіть потрібне підприємство, перейдіть у вкладку “Загальні налаштування” і в кінці сторінки знайдіть поля “Використовувати новий формат доставки” і “Показувати підказки у рядку адреси” та встановіть галочки.
Для коректної роботи підказок під час створення замовлення на касі переконайтеся, що:
- для вибраної термінальної групи увімкнений обмін даними з Cloud API;
Після виконання налаштувань необхідно перезавантажити Front.
Для мережі ресторанів формат адреси доставки потрібно вибрати в налаштуваннях корпорації.
Робота з новим форматом адреси через API
Для перегляду структури передавання адреси в методі замовлення на доставку або самовивіз (/api/1/deliveries/create) у новому форматі необхідно розкрити масив order, знайти в ньому блок deliveryPoint. Далі розкрити поле address, у ньому знайти рядок з назвою type і змінити його на city. Після цього активуються необхідні поля для роботи.
Опис полів
line1 — містить основну адресну інформацію до будинку включно. У ній передаються такі дані:
city— місто,streetName— назва вулиці,house— будинок,building— будівля.- Для складних адрес, наприклад СНТ, передавайте повну адресу із зазначенням області, міста, вулиці, селища / СНТ тощо.
Додаткова інформація передається в полях:
flat— номер квартири,entrance— номер входу в будинок,floor— поверх,doorphone— інформація про домофон.
Приклад передавання доставки в новому форматі
{
"organizationId": "{{organizationId}}",
"terminalGroupId": "{{terminalGroupId}}",
"order": {
"phone": "+380671234567",
"orderTypeId": "46077ea3-356f-eb93-2d14-1fa00d086c4e",
"payments": [
{
"paymentTypeKind": "Cash",
"sum": 540,
"paymentTypeId": "19322f46-578a-d210-a5d7-eec226a08871"
}
],
"customer": {
"name": "Іван Петренко",
"type": "regular"
},
"items": [
{
"productId": "67a08c89-e6d9-4c07-b617-78f7b04282c1",
"price": 60,
"type": "product",
"amount": 1
},
{
"productId": "59c7bdb5-5571-4ddf-8cba-62531f9e6329",
"productSizeId": "0369a57e-3de6-fdc3-0190-7c8a7bbe30eb",
"type": "product",
"amount": 1,
"modifiers": [
{
"productId": "47150436-89a5-4fe1-ac93-22ce9e0ead9f",
"amount": 1,
"type": "Modifier"
}
]
}
],
"deliveryInfo": {
"address": {
"line1": "місто Київ, вул. Хрещатик, будинок 22, квартира 15",
"type": "city"
},
"courier": {
"id": "a648be87-7035-43c3-ac03-77c280a803e7",
"name": "Олександр",
"phone": "+380931112233"
}
}
}
}Результат відображення адреси на SyrveFront
Адреса: місто Київ, вул. Хрещатик, будинок 22, квартира 15.
Під’їзд: не задано.
Поверх: не задано.
Квартира: 15.
Домофон: не задано.
Район: не задано.
Примітка до адреси: не задано.
Кур’єр: не задано.