Раздел InPost Integration в конструкторе сайтов Gridbox для Joomla описывает пошаговый процесс подключения и конфигурирования службы доставки InPost в интернет-магазине (Store App). Интеграция обеспечивает автоматический расчет стоимости доставки и позволяет покупателям выбирать ближайший постамат (Paczkomat 24/7) на интерактивной карте Geowidget или оформлять адресную курьерскую доставку InPost Kurier.
1. Получение учетных данных API InPost ShipX (Getting InPost API Credentials)
Для подключения интернет-магазина к логистической платформе InPost вам понадобятся: Organization ID (идентификатор организации) и API Token / Geowidget Token (токен авторизации API ShipX):
- Войдите в личный кабинет менеджера посылок на портале InPost Manager Paczek (для боевого режима) или в кабинет тестовой среды InPost Sandbox Manager (официальный портал сервиса — InPost.pl, документация для разработчиков — InPost ShipX Documentation).
- В боковом меню личного кабинета перейдите в раздел Moje konto (Мой аккаунт) ➝ API или Integracje (Интеграции).
- Скопируйте ваш уникальный Organization ID (ID organizacji).
- В блоке управления ключами API сгенерируйте и скопируйте API Token (Klucz API / Bearer Token), а также токен для виджета карты (Geowidget Token).
2. Настройка способа доставки InPost в Gridbox (Configuring InPost Shipping in Gridbox)
После получения ключей завершите привязку логистического модуля в административной панели сайта:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Shipping Methods (Способы доставки).
- Нажмите кнопку Add New Item и выберите в списке служб InPost.
- В поле Title укажите понятное для клиентов название (например, Paczkomaty InPost 24/7 или InPost Kurier).
- Вставьте скопированный Organization ID в соответствующее поле.
- Вставьте скопированный API Token в поле токена авторизации.
- В выпадающем списке Environment выберите режим: Sandbox (для проверки работы в тестовой среде) или Production (для реальной обработки доставок).
- В блоке Shipping Price настройте базовую стоимость отправления и при необходимости укажите порог для бесплатной доставки (Free Shipping over...).
- Активируйте переключатель Published и сохраните параметры кнопкой Save.
3. Выбор постамата при оформлении заказа (Checkout & Geowidget Map)
При оформлении покупки в чекауте интернет-магазина процесс выбора доставки строится следующим образом:
- ■ Интерактивная карта InPost Geowidget: При выборе способа доставки покупателю открывается всплывающее окно карты с геопозиционированием, строкой поиска по городу/индексу и отметками всех доступных постаматов.
- ■ Фиксация кода терминала: Выбранный покупателем идентификатор терминала (например,
WAW01M,KRA02A) и его точный адрес автоматически прикрепляются к данным заказа. - ■ Отображение в панели заказов: Администратор магазина в разделе Store App ➝ Orders видит детальные логистические данные и может мгновенно сгенерировать транспортную накладную (Shipping Label).
4. Сводная таблица параметров InPost Integration
Полный перечень параметров конфигурации интеграции службы доставки InPost в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Публичное название метода доставки, отображаемое покупателю при оформлении заказа (Checkout). | Текстовая строка |
| Organization ID | Уникальный цифровой номер организации мерчанта в системе InPost ShipX. | Числовой идентификатор |
| API Token | Секретный токен авторизации (Bearer Token) для обмена данными между сайтом и серверами InPost. | Секретный API-токен |
| Environment | Выбор рабочей среды: Sandbox (тестирование) или Production (реальная логистика). | Выпадающий список (Sandbox / Production) |
| Price | Фиксированная стоимость доставки данным методом, прибавляемая к сумме чека. | Числовое значение (Валюта) |
| Free Shipping | Минимальная сумма заказа для предоставления покупателю бесплатной доставки. | Числовое значение (Валюта) |
| Published | Статус публикации и доступности метода доставки для клиентов магазина. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции службы доставки в базе данных сайта. | Кнопка действия |
Благодаря интеграции InPost Geowidget виджет карты подгружает статус доступности ячеек в реальном времени. Если какой-либо постамат временно переполнен или находится на обслуживании, клиент увидит соответствующее предупреждение и сможет выбрать альтернативную точку рядом.
В паре с платежным шлюзом PayU Polska (с поддержкой BLIK) доставка через InPost Paczkomaty дает конверсию в успешный заказ выше 90% для польского трафика. Не забудь проверить, что на сайте активен SSL-сертификат (HTTPS), иначе браузеры могут блокировать отображение интерактивной карты Geowidget из соображений безопасности геолокации.