Країни
Вступ#
Розділ Країни дає змогу керувати країнами, доступними для адрес покупців, доставки та розрахунку податків. Для кожної країни задаються коди ISO, формат адреси й вимога щодо поштового індексу. Правильне налаштування країн забезпечує коректний збір адрес, правильне застосування податків і доступність потрібних способів доставки для покупців з інших країн.
Доступ до керування країнами#
Крок 1. Відкрийте розділ «Країни»#
Увійдіть в адмінку й перейдіть у Система → Локалізація → Країни.
Крок 2. Список країн#
Ви побачите список усіх країн із назвою та кодами ISO.
Крок 3. Керування країнами#
Натисніть Додати, щоб створити нову країну, або Редагувати поруч із наявною країною, щоб змінити її налаштування.
Огляд інтерфейсу#
Поля налаштування країни#
Основна інформація про країну
Ідентифікація
- Назва країни — (обов’язкове) повна назва країни (наприклад, «Україна», «Польща», «Німеччина»), від 3 до 128 символів. В ocStore 3 назва країни одна для всіх мов — окремих перекладів у формі немає.
- Код ISO (2) — дволітерний код країни за ISO 3166-1 (наприклад,
UA,PL,DE). - Код ISO (3) — трилітерний код країни (наприклад,
UKR,POL,DEU). - Статус — чи доступна країна для вибору покупцями.
Формально в ocStore 3 обов’язковою є лише назва, але коди ISO варто заповнювати завжди — їх використовують модулі оплати й доставки.
Налаштування адреси
Правила форматування
- Формат адреси — шаблон показу адреси з використанням змінних. Якщо поле порожнє, використовується стандартний формат.
- Індекс обов’язковий — вимагати поштовий індекс в адресах для цієї країни.
Змінні формату адреси
Змінні шаблону
- {firstname} — ім’я покупця;
- {lastname} — прізвище покупця;
- {company} — назва компанії;
- {address_1} — адреса, рядок 1;
- {address_2} — адреса, рядок 2;
- {city} — місто;
- {postcode} — поштовий індекс;
- {zone} — регіон / область;
- {zone_code} — код регіону;
- {country} — країна.
Приклад формату:
{firstname} {lastname}
{company}
{address_1}
{address_2}
{city}, {zone} {postcode}
{country}Стандарти ISO. Використовуйте офіційні коди ISO 3166-1 — це важливо для узгодженої роботи з платіжними системами, службами доставки й податковими сервісами. Неправильні коди можуть спричинити помилки інтеграції.
Типові завдання#
Додавання нової країни#
Щоб почати продавати в нову країну:
- Перейдіть у Система → Локалізація → Країни і натисніть Додати.
- Введіть Назва країни.
- Заповніть Код ISO (2) і Код ISO (3) офіційними кодами.
- Налаштуйте Формат адреси відповідно до прийнятого в країні формату.
- Встановіть Індекс обов’язковий залежно від того, чи використовуються в країні поштові індекси.
- Встановіть Статус — «Включено».
- Натисніть Зберегти. Країна з’явиться у формах адрес і під час оформлення замовлення.
- За потреби додайте регіони країни в Система → Локалізація → Регіони.
Налаштування формату адреси для країни#
Щоб адреси відображалися правильно:
- З’ясуйте стандартний формат адреси для країни.
- Відредагуйте країну й змініть поле Формат адреси.
- Розташуйте змінні в логічному порядку.
- Кожен рядок адреси пишіть з нового рядка в полі (просто натискайте Enter).
- Перевірте результат, створивши адресу покупця з цією країною.
- Переконайтеся, що адреса правильно відображається в замовленнях і листах.
Керування доступністю країн#
Щоб визначити, куди ви продаєте й доставляєте:
- Вимкніть країни, куди не доставляєте, встановивши Статус — «Виключено».
- Увімкніть країни в міру розширення географії доставки.
- Узгодьте з доставкою — налаштуйте географічні зони (Система → Локалізація → Географічні зони) і прив’яжіть до них способи доставки.
Найкращі практики#
Стратегія виходу на нові ринки
Готовність до міжнародної торгівлі
- Спершу дослідження — перед додаванням країни вивчіть податки, способи доставки й стандарти адрес.
- Поступове увімкнення — вмикайте країни в міру налагодження доставки.
- Законодавство — дотримуйтеся місцевих законів про захист прав споживачів.
- Валюти — додайте відповідні валюти (Система → Локалізація → Валюта).
Цілісність даних
Точне налаштування
- Перевірка кодів ISO за офіційними джерелами.
- Тестування формату адреси на реальних прикладах.
- Індекси — для перевірки формату індексу знадобиться сторонній модуль.
- Актуальність — оновлюйте дані при політичних змінах (нові або перейменовані країни).
Видалення країни. Не видаляйте країну, яка: 1) є країною магазину за замовчуванням, 2) використовується в налаштуваннях магазинів, 3) використовується в адресах покупців або партнерів, 4) має регіони, 5) входить до географічних зон. ocStore не дасть видалити таку країну й покаже повідомлення з причиною — спершу перенесіть залежності.
Усунення проблем#
Країна не з’являється у списку під час оформлення замовлення
Видимість
- Статус — переконайтеся, що країну увімкнено.
- Обмеження доставки — деякі модулі доставки працюють лише для країн зі своєї географічної зони.
- Кеш — список країн кешується; очистіть кеш ocStore (вміст
system/storage/cache/).
Адреса неправильно форматується в замовленнях і листах
Шаблон формату
- Написання змінних — перевірте назви змінних і фігурні дужки.
- Перенесення рядків — кожен рядок адреси має бути на окремому рядку поля.
- Пропущені елементи — включіть усі потрібні частини адреси.
- Спецсимволи — перевірте адреси з апострофами та літерами з діакритикою.
Не вдається видалити країну
Залежності
- Країна за замовчуванням — указана в налаштуваннях магазину (вкладка Локалізація).
- Адреси — використовується в адресних книгах покупців або в даних партнерів.
- Регіони — для країни задано регіони.
- Географічні зони — країна входить до географічних зон для доставки чи податків.
- Рішення: перенесіть усі залежності на іншу країну або просто вимкніть країну.
Проблеми з перевіркою індексу
Налаштування перевірки
- Індекс обов’язковий — перевірте, чи відповідає налаштування реальним вимогам країни.
- Перевірка формату — стандартно ocStore перевіряє лише довжину індексу; для перевірки формату потрібен сторонній модуль.
- Підказки покупцям — наведіть приклад правильного індексу.
- Тестування — перевірте форму з правильними й неправильними індексами.
«Країни — це не лише географічні межі, а й культурний контекст, правові норми та нові ринки. Кожна додана країна — це нова спільнота, яку ви запрошуєте до свого магазину.»