CatCode Доставка Новою Поштою для WooCommerce

Опис

Плагін додає в WooCommerce метод доставки Новою Поштою разом з вибором відділення прямо в чекауті — покупцю не треба залишати сторінку чи вписувати адресу вручну.

Нова Пошта — найбільший поштовий перевізник в Україні. Через її відділення й поштомати доставляється більшість українських онлайн-замовлень, а сам перевізник очікує ідентифікатор відділення, а не адресу вулиці — тому звичайне поле адреси для таких магазинів не працює.

Що вміє

  • Пошук міста з підказками і список найбільших міст в один клік.
  • Вибір відділення або поштомата з актуального довідника перевізника.
  • Вартість доставки рахується через API перевізника, з необов’язковою націнкою і безкоштовною доставкою від суми замовлення.
  • ТТН створюється зі сторінки замовлення або автоматично, коли замовлення переходить в обраний вами статус.
  • Журнал відправлень в адмінці з посиланнями на відстеження і ручним оновленням статусів.
  • Довідники міст і відділень кешуються у власних таблицях плагіна, тож чекаут не чекає на API.
  • API-ключ зберігається зашифрованим.
  • Працює і з класичним, і з блоковим чекаутом.

Нова Пошта — сторонній сервіс. Цей плагін є незалежною інтеграцією на базі публічного API перевізника і не афілійований з Новою Поштою, не схвалений і не спонсорований нею.

Зовнішні сервіси

Плагін звертається до API перевізника Нова Пошта, щоб шукати міста й відділення, рахувати вартість доставки і створювати ТТН. Поки ви не введете власний API-ключ у налаштуваннях методу доставки, нічого не надсилається.

API Нової Пошти — https://api.novaposhta.ua

  • При показі чекауту: пошукові запити міста й відділення, які вводить покупець, щоб повернути відповідні записи довідника.
  • При розрахунку вартості доставки: ідентифікатори міст відправника й отримувача, вага кошика і оголошена вартість.
  • При створенні ТТН: ім’я отримувача, номер телефону, обране відділення, сума замовлення, вага й оголошена вартість разом з даними вашого відправника.
  • При оновленні статусу відправлення: номер ТТН.

Довідники міст і відділень також завантажуються пакетно й кешуються локально, щоб чекаут не звертався до перевізника на кожному завантаженні сторінки.

Умови використання: https://novaposhta.ua/more/public-agreement-for-cbs
Політика конфіденційності: https://novaposhta.ua/more/privacy-policy

Опис українською

Плагін додає доставку Новою Поштою у WooCommerce разом з вибором відділення прямо на сторінці оформлення замовлення — покупець не залишає сторінку і не вписує адресу руками.

  • Пошук міста з підказками і список найбільших міст в один клік.
  • Вибір відділення або поштомата з живого довідника перевізника.
  • Розрахунок вартості доставки через API Нової Пошти, з можливою націнкою і безкоштовною доставкою від суми замовлення.
  • Створення ТТН (експрес-накладної) з картки замовлення або автоматично при переході в потрібний статус.
  • Журнал відправлень в адмінці з номерами накладних, посиланнями на трекінг і оновленням статусів.
  • Довідники міст і відділень кешуються у власних таблицях плагіна, тож оформлення замовлення не чекає на API.
  • API-ключ зберігається зашифрованим.
  • Працює і з класичним оформленням замовлення, і з блоковим (Gutenberg).

Нова Пошта — сторонній сервіс. Цей плагін є незалежною інтеграцією на публічному API перевізника і не афілійований з Новою Поштою.

Скріншоти

Встановлення

  1. Встановіть і активуйте плагін.
  2. Перейдіть у WooCommerce Налаштування Доставка і додайте метод «Нова Пошта» в потрібну зону.
  3. Вставте свій API-ключ (кабінет Нової Пошти: Налаштування Безпека Ключі API) і збережіть.
  4. Натисніть «Перевірити з’єднання», потім заповніть дані відправника.
  5. За бажанням оберіть статус замовлення, при якому ТТН створюється автоматично.

Часті питання

Чи потрібен договір з перевізником?

Для розрахунку вартості й показу відділень достатньо API-ключа з кабінету Нової Пошти. Для створення ТТН у цьому ж кабінеті має бути налаштований відправник.

Чи працює з блоковим чекаутом?

Так. Вибір зберігається в сесії WooCommerce, тому класичний і блоковий чекаут працюють однаково.

Де подивитись створені ТТН?

У розділі WooCommerce Нова Пошта. Номер ТТН також показується на сторінці замовлення.

Якою мовою інтерфейс?

Вихідні рядки англійською. Українська та будь-яка інша мова перекладаються на translate.wordpress.org, а WordPress підвантажує їх автоматично.

Відгуки

Для цього плагіна немає відгуків.

Учасники та розробники

“CatCode Доставка Новою Поштою для WooCommerce” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:

Учасники

“CatCode Доставка Новою Поштою для WooCommerce” було перекладено на 2 локалізації. Дякуємо перекладачам за їх роботу.

Перекладіть “CatCode Доставка Новою Поштою для WooCommerce” на вашу мову.

Цікавитесь розробкою?

Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.

Журнал змін

1.0.15

  • Fixed: on themes that set their own padding for text fields (for example Storefront), a long branch name no longer runs under the icon in the city and branch fields.

1.0.14

  • Fixed: on the block checkout the branch field stays under the list of delivery methods after the city is changed, instead of dropping below the whole delivery step.

1.0.13

  • Fixed: on the classic checkout a branch picked just before “Place order” could be lost, and the order stopped with “Choose a Nova Poshta city and branch” while the branch was on the screen.
  • Fixed: when an order stops on a missing delivery choice, the city or branch field is highlighted with the reason under it, on both the classic and the block checkout.
  • Fixed: the block checkout no longer accepts a Nova Poshta order without a chosen branch.
  • Classic checkout: the Nova Poshta error no longer comes with notices about the hidden address fields.
  • City and branch fields use a 16 px font on phones, so an iPhone does not zoom the page while typing.

1.0.12

  • Виправлено: місто, якого немає в локальному довіднику, запитується в Нової Пошти, навіть коли пошук знаходить інші населені пункти за областю, тому Київ, Львів чи Тернопіль завжди можна обрати.
  • Додано: довідник міст завантажується сам у фоні.

1.0.11

  • Змінено: фокус або клік на полі відділення показує всі відділення міста, обране підсвічене й видиме без прокручування; введення звужує список. Великі міста (у Києві понад 8 000 відділень і поштоматів) виводяться сторінками по 100, що підвантажуються під час прокручування.
  • Змінено: смуги підтвердження під полями більше немає, обрані місто й відділення видно в самих полях. На телефонах (до 575 px) іконки полів приховані.
  • Змінено: у журналі відправлень сторінки по 25, пошук за номером замовлення, ТТН, імʼям або телефоном, фільтр за статусом, телефон отримувача, а місто й відділення мають окремі колонки.

1.0.10

  • Виправлено: поки встановлена повна версія з catcode.com.ua, видалення цієї копії лишає спільні налаштування і таблиці міст, відділень та накладних, тож повна версія працює з ними далі. Без повної версії видалення, як і раніше, прибирає все.
  • Змінено: поки активна повна версія, ця копія вимикається сама, а не вантажиться поруч із нею (більше жодних попереджень PHP).

1.0.9

  • Виправлено: замовлення з доставкою у відділення більше не містить другого рядка адреси (квартира, під’їзд) з акаунта покупця; відділення — це вся адреса доставки.

1.0.8

  • Виправлено: на англомовному (чи будь-якому не українському) сайті блоковий чекаут мовчки не оформлював замовлення з Новою Поштою, коли в акаунті покупця не вказана область: приховане обов’язкове поле «Область» лишалося порожнім. Тепер область визначається з міста Нової Пошти за кодом, незалежно від мови сайту (місто Київ — «Київ»); якщо визначити не вдалося, поле «Область» лишається видимим.
  • Виправлено: після вибору міста список відділень міг зависнути на «Завантажуємо відділення…», поки не клікнеш у поле ще раз; тепер він з’являється, щойно завантажиться.
  • Виправлено: гість, який створює акаунт на чекауті (або на сторінці підтвердження замовлення), більше не отримує відділення як адресу нового акаунта.

1.0.7

  • Виправлено: після замовлення з Новою Поштою WooCommerce зберігав відділення як адресу оплати й доставки залогіненого покупця (у блоковому і класичному чекауті), тож наступний чекаут пропонував відділення замість його адреси. Відділення й далі записується в замовлення, а в акаунті лишається адреса покупця.

1.0.6

  • Виправлено: у блоковому чекауті віджет відділень відкривався й тоді, коли покупець обирав Укрпошту, Meest чи іншого перевізника з «пошт» у назві, і ховав поля адреси цього перевізника. Тепер обраний метод визначається за ідентифікатором тарифу, тож віджет з’являється і тоді, коли метод названо латиницею («Nova Poshta»).
  • Виправлено: відділення, обране раніше, більше не потрапляє в замовлення з іншим методом доставки – лишається адреса, яку ввів покупець, без чернетки Нової Пошти в журналі й рядка «Відділення Нової Пошти» в листах. Автоматичне створення ТТН за статусом тепер спрацьовує лише для замовлень з Новою Поштою.
  • Після перемикання з Нової Пошти на інший метод у полях знову адреса покупця, а не назва відділення.
  • Клік по відділенню в списку більше не губиться, якщо сторінка зсувається в момент натискання.

1.0.5

  • Обране місто і відділення записуються в адресу доставки замовлення, тож в адмінці, листах і зовнішніх сповіщеннях адреса доставки більше не порожня.
  • Безпека: збережені API-ключі шифруються AES-256 (OpenSSL) замість старої XOR-обфускації, на яку реагували антивіруси деяких хостингів. Ключі, збережені попередніми версіями, працюють і далі.

1.0.4

  • Відділення більше не губляться у великих містах: API Нової Пошти віддає щонайбільше 500 рядків за запит і не повідомляє, що список обрізано, тож у Києві частина відділень і поштоматів просто не приходила. Тепер список завантажується посторінково.
  • Збій API більше не стирає кеш відділень — покупець бачить учорашній робочий список замість порожнього.
  • Перевірено з WordPress 7.1.

1.0.3

  • Виправлено дві ТТН на одне замовлення: автостворення при зміні статусу і кнопка в адмінці (або два кліки поспіль) могли створити одразу два реальні відправлення Нової Пошти. Тепер ТТН створюються по черзі, і другий виклик бачить уже наявний номер.

1.0.2

  • Український переклад знову вбудовано — у 1.0.1 інтерфейс був лише англійською.
  • readme: опис і ключові слова українською.

1.0.1

  • Розрахунок вартості через API Нової Пошти тепер окреме налаштування і за замовчуванням вимкнений, тож задана вами вартість доставки більше не перекривається тарифом перевізника.
  • Нульова вартість більше не показується як «Безкоштовно!» — метод підписаний «(оплата при отриманні)», а ціна читається як «за тарифами перевізника». Безкоштовна доставка від суми замовлення працює як раніше.
  • Прибрано невикористовуваний код, що лишився від внутрішньої збірки: поля післяплати в ТТН, зворотні накладні, таблиці вебхуків і їхні заплановані події.
  • Переклади тепер повністю через translate.wordpress.org; вбудовані .po/.mo файли прибрано.

1.0.0

  • Перший реліз: вибір відділення в чекауті, живий тариф, створення ТТН, журнал відправлень.