Polkurier.pl для OpenCart — курьеры Польши, пункты выдачи и этикетки

Polkurier.pl для OpenCart 4.x, 3.x и 2.3 добавляет в чекаут доставку по Польше через агрегатор курьеров Polkurier: до восьми методов, каждый из них — один перевозчик вашего аккаунта Polkurier, на адрес или в пункт выдачи этого перевозчика. Цену можно задать фиксированную или брать живую оценку Polkurier для корзины.

Что нужно от Polkurier. Аккаунт на polkurier.pl с подписанным договором для API и сгенерированный в панели токен (Ustawienia → Token API). Перевозчики, которых вы видите в модуле, — те, что подключены к вашему аккаунту.

Что видит покупатель

В чекауте — методы доставки с вашими названиями и ценами. Для метода «в пункт» под ним появляется выбор пункта: кнопка официальной карты Polkurier и поиск по списку по городу, улице, индексу или коду пункта. Без выбранного пункта заказ не оформить, пункт без наложенного платежа не пропустит заказ с оплатой при получении, а после выбора в заказе появляется адрес пункта. Сервер сверяет выбранный пункт с Polkurier, поэтому подменить его запросом из браузера не получится.

Что получает администратор

Расширения → Доставка → Polkurier.pl: вкладки «Методы доставки», «Аккаунт и отправитель», «Отправления», «Автоматизация» и «Лицензия». На вкладке «Аккаунт и отправитель» вы вводите ID аккаунта и токен и нажимаете «Сохранить и проверить соединение»: модуль загружает перевозчиков, банковские счета и шаблоны посылок вашего аккаунта. Токен хранится зашифрованным и обратно в форму не подставляется.

До восьми методов: для каждого вы выбираете перевозчика из списка вашего аккаунта, тип (на адрес или в пункт выдачи), название в чекауте, страны, лимит веса и сумму, от которой доставка бесплатна. Цена — фиксированная, живая оценка Polkurier (для размера посылки по умолчанию и веса корзины, с наценкой в процентах и запасной фиксированной суммой, когда Polkurier не отвечает) или, в Pro, по весовым порогам с доплатой за наложенный платёж. Polkurier считает в злотых: чтобы живая цена работала, в магазине должна быть валюта PLN.

На странице заказа появляется панель Polkurier: перевозчик, размер и вес посылки, способ подъезда — «передам сам» или «первый доступный выезд курьера». Кнопка создаёт отправление в Polkurier с адресом получателя, разбитым на улицу, дом и квартиру; ниже — номер заказа Polkurier, номер накладной перевозчика, статус и цена. Этикетку скачиваете PDF-файлом, статус обновляете кнопкой. Если в адресе не найден номер дома или в заказе нет телефона, модуль так и говорит и ничего не выдумывает: данные вносит оператор в панели.

Список отправлений (кнопка «Список отправлений» в настройках) показывает все накладные со статусами. В Pro в нём появляются массовые действия: создать отправления для выбранных заказов, напечатать все этикетки одним PDF, заказать сборный подъезд курьера на выбранную дату и часы и получить протокол передачи. На вкладке «Автоматизация» Pro создаёт отправление, когда заказ достигает нужного статуса, каждый час обновляет статусы и переводит заказ в выбранный вами статус после доставки, а покупателю уходит письмо с номером отправления.

Наложенный платёж — в Pro: заказы с выбранными способами оплаты уходят в Polkurier с суммой наложенного платежа в злотых, а возврат собранных денег вы выбираете на вкладке «Отправления»: на банковский счёт (счёт можно взять из аккаунта Polkurier), почтовым переводом или на копилку Polkurier, со сроком возврата S, 1D, 4D или 16D. В Free отправление из заказа с наложенным платежом не создаётся: панель сразу объясняет почему. Pro также отменяет отправление со страницы заказа, держит шаблоны посылок аккаунта и ведёт доплату за наложенный платёж в чекауте.

Как это работает, шаг за шагом

1. Установите архив для своей версии OpenCart и включите доставку Polkurier.pl.
2. На вкладке «Аккаунт и отправитель» введите ID аккаунта, токен и данные отправителя, нажмите «Сохранить и проверить соединение».
3. На вкладке «Методы доставки» выберите перевозчиков, тип (адрес или пункт), цену и страны.
4. Убедитесь, что в магазине есть валюта PLN, и проверьте чекаут: метод «в пункт» просит выбрать пункт.
5. В заказе нажмите «Создать отправление», скачайте этикетку и обновляйте статус.
6. В Pro включите автоматические отправления по статусу и ежечасную синхронизацию статусов.

Что под капотом

• Polkurier API версии 1.14; ID аккаунта и токен хранятся зашифрованными, в журнал токен не попадает.
• Коды перевозчиков берутся из вашего аккаунта (available_carriers), а не из жёсткого списка: новые перевозчики появляются в модуле без обновления.
• Живая цена — один запрос оценки на все методы, результат кратко кэшируется; валюта Polkurier — злотые, цена переводится в валюту магазина по курсу.
• Карта пунктов — официальный виджет Polkurier, токен карты кэшируется; если карта недоступна, остаётся поиск по списку.
• Polkurier принимает отдельно улицу, номер дома и квартиры, а в OpenCart адрес — одна строка: номер выделяется из адреса, а когда его не нашли, оператор вводит его в панели.
• Для заказов в пункт без платёжного адреса (типично в OpenCart 4) адресом получателя идёт адрес самого пункта.
• Лимит Polkurier — 500 запросов за 60 секунд с одного IP: поиск пунктов и оценка кэшируются, но на общем хостинге лимит делится с другими магазинами.
• Статусы Polkurier тянет опросом: вебхуков у API нет.
• События OpenCart без правок ядра; при обновлении модуля аккаунт, токен и методы остаются. Интерфейс на английском и польском.

Как установить

1. Расширения → Установка: загрузите архив для своей версии без переименования (OpenCart 4 — cc_polkurier.ocmod.zip, 3.x — cc_polkurier-oc3.ocmod.zip, 2.3 — cc_polkurier-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Расширения → Доставка → Polkurier.pl: установите и откройте.
4. Введите ID аккаунта и токен, заполните отправителя, сохраните и проверьте соединение.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Лицензия».