Доставка в магазині — це три різні речі, які легко сплутати між собою. Плутанина коштує дорого: більшість питань «чому в чекауті порожній список відділень» зводиться саме до неї.
Три поняття, які треба розрізняти
- Перевізник — служба: Нова Пошта, Meest, Укрпошта. Підключається окремим плагіном і дає відділення, тарифи, накладні та трекінг.
- Спосіб доставки — те, що бачить покупець у чекауті: «Нова Пошта — відділення». Має власну ціну й поріг безкоштовності.
- Точка видачі — конкретне відділення чи поштомат, який покупець обрав.
Один перевізник дає кілька способів доставки: відділення, поштомат, адресна доставка. Це різні рядки з різними цінами, але адаптер під ними один.
Чому оформлення працює, навіть коли перевізник лежить
Чекаут читає локальний довідник у базі вашого магазину, а не API перевізника в момент покупки. Довідник оновлюється фоном раз на добу. Тому недоступність Нової Пошти чи Meest не блокує оформлення: покупець усе одно обере відділення й оформить замовлення.
API потрібне лише у двох випадках: оновити довідник і створити накладну.
Що вміє кожен перевізник зараз
| Служба | Відділення | Поштомати | Адресна | Розрахунок | ТТН | Трекінг |
|---|---|---|---|---|---|---|
| Нова Пошта | так | так | так | так | так | так |
| Meest Пошта | так | так | етап 2 | так | етап 2 | так |
| Укрпошта | так | так | етап 2 | етап 2 | етап 2 | етап 2 |
Самовивіз працює без перевізника: покупець забирає з магазину, точку видачі обирати не треба.
Чому в Meest поки немає накладної й адресної доставки: створення накладної — єдина незворотна дія у всьому тракті. Документ з'являється в кабінеті перевізника й тарифікується, тож його вмикають окремо, з бойовими доступами й перевіреним зразком.
Способи доставки: де налаштувати
Розділ Продажі → Способи доставки. Кожен рядок — окремий варіант у чекауті.
| Поле | Що робить |
|---|---|
| Код | Технічний ідентифікатор рядка. Не змінюйте після появи замовлень — він лежить у їхніх снапшотах. Покупцеві не видно. |
| Перевізник | Код адаптера з увімкненого плагіна. Саме він вмикає довідник. Порожньо — довідника немає, покупець вписує адресу текстом. |
| Точка видачі | Який довідник показати і які поля відкрити в чекауті. |
| Тариф | Ваша ціна доставки. 0 — безкоштовно. |
| Безкоштовно від | Поріг безкоштовності. Порожньо або 0 — порогу немає. |
| Порядок | Черговість у списку: менше число — вище. |
| Активний | Показувати метод покупцеві. Останній активний вимкнути не можна — магазин лишиться без доставки. |
Режим точки вирішує, що побачить покупець
| Режим | Що показує чекаут |
|---|---|
| Відділення | Місто + список відділень |
| Поштомат | Місто + список поштоматів |
| Адреса | Місто + поле адреси для кур'єра |
| Без точки | Нічого: самовивіз |
Ціна й поріг безкоштовності — ваші, не перевізникові. «Безкоштовно від» порівнюється з сумою товарів після знижки: знижка може зробити доставку платною. Якщо в перевізника налаштований розрахунок, реальний тариф може перекрити вашу фіксовану ціну.
Нова Пошта — підключення
- Візьміть ключ API: кабінет Нової Пошти → Налаштування → Безпека.
- Впишіть його в налаштування плагіна «Нова Пошта».
- Заповніть дані відправника — місто, відділення й телефон. Без них накладна не створиться.
Окремо є два перемикачі: показувати поштомати окремим варіантом і ховати відділення, які зникли з API, але лишились в історії замовлень.
Meest — підключення
Головне спершу: щоб покупці бачили відділення Meest, договір не потрібен. Довідник заливається з публічного джерела одразу після встановлення плагіна. Доступи потрібні лише для розрахунку вартості та накладної.
Авторизуватись можна двома шляхами, досить будь-якого:
- Готовий токен — кабінет Meest → Налаштування → API інтеграції → «Укласти договір».
- Логін і пароль — видає ваш менеджер супроводу. Магазин сам обміняє їх на токен і оновлюватиме кожні 24 години.
Додатково потрібен ID договору — без нього не працює розрахунок вартості.
Укрпошта — підключення
Без токена список відділень буде порожній, і це не помилка. На відміну від Meest, Укрпошта публічного довідника не публікує: відкритий набір даних не оновлювався роками, а класифікатор без токена доступ закриває.
Типові пастки
- Порожній список одразу після підключення Нової Пошти — нормально. Міста приходять першим фоновим прогоном, а відділення міста підтягуються, коли його вперше оберуть: перший покупець «прогріває» місто для решти. У Meest цього етапу немає — публічний дамп заливає довідник одразу.
- Перевізник і режим точки мають узгоджуватись. Якщо обрати Meest + поштомат, а поштоматів Meest у місті немає, покупець побачить порожній список. Це не збій магазину, а відсутність таких точок у довіднику.
- Зниклі відділення не видаляються, а ховаються. Старі замовлення на них посилаються, і видалення зробило б історію нечитабельною.
Про ключі
Ключі й токени вводьте тільки в кабінеті перевізника та в налаштуваннях плагіна. Магазин ніколи не показує збережений секрет назад — тому в полі видно «Значення збережено». Порожнє поле збережене значення не стирає: щоб замінити, введіть нове поверх.