Как да настроите доставка с Еконт и Спиди в WooCommerce

Искате клиентът да избира доставка до офис, автомат или адрес и да може да плати при получаване. За това WooCommerce има нужда от модул на куриера. Това ръководство показва как се настройва доставка с Еконт и Спиди в WooCommerce, от договора до първата тестова поръчка.

Описваме официалните модули на двата куриера и само настройки, които са посочени в документацията им. Надписите в модулите се променят с новите версии, затова при разминаване се доверете на документацията на куриера.

Официалните модули на Еконт и Спиди

Еконт и Спиди предлагат модулите си на собствените си страници. Ако потърсите Econt и Speedy в директорията на wordpress.org, ще намерите само плъгини на други разработчици, например „Drusoft Shipping for Econt“ и „Drusoft Shipping for Speedy“. И двата работят през API-то на куриерите, но са публикувани от друг автор и според страниците си не поддържат блоковите страници за количка и поръчка на WooCommerce. Тук описваме официалните.

Какво да подготвите, преди да настроите доставка с Еконт и Спиди

Преди да качите модул, подгответе четири неща:

• Профил при куриера. При Еконт регистрирате магазина си в delivery.econt.com с профила от e-Econt, а за реални пратки Ви трябва и действащ договор. При Спиди поискайте от лицето за контакт по договора си потребител и парола за интеграция на онлайн магазин. Те са различни от тези за MySpeedy. Ако нямате договор, според ръководството на Спиди трябва да пишете на посочения в него имейл адрес с данните на магазина си.
• Версии. Версиите на WordPress, PHP и плъгините, включително WooCommerce, се виждат в Tools > Site Health > Info.
• Тегло. Всеки продукт и всяка вариация трябва да има тегло в килограми, иначе цената не може да се изчисли. Виртуалните продукти не се изпращат с куриер. Ако продуктите са много, маркирайте ги в Products > All Products и изберете Edit от Bulk actions, където има поле Weight. Масовата редакция работи само за прости продукти, а вариациите се попълват отделно.
• HTTPS. Модулът на Еконт го изисква. Как се включва без грешки, е описано в ръководството за HTTPS.

Настройка на модула на Еконт

Започвате от страната на Еконт. В delivery.econt.com влезте с профила си от e-Econt и добавете магазина си. Ако нямате профил, регистрирайте се от Еконт Вход. Според ръководството на Еконт добавянето минава през шест стъпки.

В настройките на магазина задавате:

• откъде тръгват пратките (от Ваш адрес, откъдето куриерът ги взема, или от офис или Еконтомат) и кое е лицето за контакт
• докъде доставяте (до адрес, до офис, до Еконтомат или комбинация)
• как Еконт Ви изплаща събрания наложен платеж

В последната стъпка копирате идентификатора на магазина и кода за свързване. Според документацията на Еконт в модула те се въвеждат като Store ID и Private Key.

После свалете модула от страницата на Еконт за WooCommerce, качете го от Plugins > Add New Plugin > Upload Plugin и го активирайте. Ако имате Terminal в cPanel, същото прави командата от документацията на Еконт. Тя сваля последната версия от GitHub и я активира. Ако искате да се върнете назад, деактивирайте плъгина и го изтрийте от списъка с плъгини.

# cPanel > Terminal, в папката на сайта
wp plugin install \
  https://github.com/econt/econt-woo-opc-plugin/releases/latest/download/econt-woo-opc-plugin-main.zip \
  --activate

Отворете Settings > Econt Delivery и попълнете Store ID, Private Key и Environment. Започнете с Demo. Полето Customer Details Container оставете както е, освен ако темата Ви ползва друг селектор за формата за поръчка. В по-старите версии полетата се казват ID Number и Private Key, а демо режимът е отметката Use Econt Demo Service.

Накрая добавете метода към зона за доставка. В WooCommerce > Settings > General проверете дали Shipping location(s) включва България. После в WooCommerce > Settings > Shipping отворете зоната за България или създайте такава, натиснете Add shipping method и изберете „Econt“.

Според документацията на Еконт трябва да махнете и отметката Enable the shipping calculator on the cart page от настройките за доставка на същия екран.

Настройка на модула на Спиди

Свалете „Speedy Shipping Extension“ от страницата на Спиди за интеграция с онлайн магазини, качете го по същия начин от Plugins > Add New Plugin > Upload Plugin и го активирайте. После отворете WooCommerce > Settings > Shipping и секцията „Доставка със Speedy“. Ръководството на Спиди не споменава зони за доставка, а методът се включва от собствените му настройки, които са в четири раздела.

• Общи настройки. Включете модула и въведете потребителя и паролата. После натиснете бутона за извличане на данни от Спиди. При първото въвеждане това е задължително, защото така се зареждат данните за търговеца, офисите и населените места. Ръководството препоръчва да го правите няколко пъти седмично.
• Изпращане. Избирате обекта от договора си, откъдето тръгват пратките, лицето за контакт и телефона, края на работното време и дали ще предавате пратките в офис или автомат на Спиди. Цената се изчислява от избрания обект до адреса на клиента.
• Услуги. Изберете поне една активна услуга, например универсалната стандартна услуга на Спиди.
• Плащане. Избирате как се образува цената за доставка. Възможностите са калкулатор на Спиди с цените от договора Ви, фиксирана цена, безплатна доставка над определена сума, собствени цени от CSV файл (различна цена за адрес, офис и автомат) и калкулатор с надбавка. Тук са и настройките на наложения платеж.

Запазете с Save Changes. В раздела „Изпращане“ има и опция адресът на получателя да се попълва в едно поле. Ръководството предупреждава, че ако адресът не е разделен на части, Спиди го обработва допълнително, а това може да доведе до грешки и закъснения.

Наложен платеж и какво вижда клиентът

Наложеният платеж е вграден метод на WooCommerce, а не част от модулите. И двата модула изискват да го включите и да го ограничите до техните методи за доставка. Отворете WooCommerce > Settings > Payments, натиснете Manage до „Cash on delivery“ и в Enable for shipping methods изберете „Econt“ и Any "Доставка със Speedy" method. Така наложеният платеж се предлага само при тези доставки. Останалите му настройки са в ръководството Наложен платеж и плащане с карта в WooCommerce за България.

От страна на куриера избирате как да Ви се изплащат събраните пари. При Еконт това е падащо меню в настройките на магазина в delivery.econt.com. При Спиди се избира в раздела „Плащане“ и само ако нямате договор или анекс, който го урежда. Спиди предлага и услуги, при които издава касов бон от Ваше име. Те изискват отделно споразумение със Спиди, а дали Ви трябват, ще Ви каже счетоводителят.

Какво вижда клиентът, зависи от модула. При Еконт, когато избере „Econt“, на страницата за поръчка се показва формата на Еконт, вградена в страницата (iframe). Какво може да избере клиентът (адрес, офис или Еконтомат), се определя от настройките за локации за доставка в delivery.econt.com. Модулът може да скрива избрани полета на WooCommerce, например име, адрес и телефон, докато е избран Еконт.

При Спиди клиентът започва да пише населеното място и адреса и избира от падащите подсказки. След като избере населеното място, вижда цената за всяка налична услуга. Затова всички продукти трябва да имат реално тегло, различно от нула.

Товарителници, етикети и проследяване

При Еконт товарителницата се създава автоматично за всяка потвърдена поръчка, а всяка пратка получава номер за проследяване. В списъка с поръчки на WooCommerce има колони и действия на Еконт. Ако за някоя поръчка няма товарителница, маркирайте я и изберете „Sync Econt Waybills“ от Bulk actions. Размерът на етикета се избира в настройките на магазина в delivery.econt.com.

При Спиди товарителницата създавате Вие. Отворете поръчката в WooCommerce > Orders, проверете настройките в блока на модула и натиснете „Генериране на товарителница“. Една товарителница може да съдържа най-много 10 пакета.

Готовите товарителници са в WooCommerce > Speedy orders като PDF файлове. Ако пратката тръгва от Ваш адрес, в същия списък изберете товарителницата и натиснете „Заявяване на куриер“, а за няколко товарителници ползвайте масовите действия. Ако изпращате от офис на Спиди, тази стъпка се пропуска. Ако печатате на етикетен принтер, включете опцията за него в общите настройки, защото етикетите са 104 на 147 мм. Ръководството препоръчва товарителниците да се създават автоматично още при поръчката само при малък асортимент. За проследяване на пратката от клиента в магазина ръководството на Спиди не казва нищо.

Тестова поръчка преди пускане

При Еконт тестът минава през демо средата. Според документацията на Еконт в режим Demo не се таксуват реални суми.

1. Оставете Environment на Demo.
2. Сложете в количката продукт с тегло, въведете валиден български адрес, изберете Еконт и наложен платеж и потвърдете поръчката.
3. Проверете дали цената се изчислява автоматично, дали поръчката е създадена и дали в нея се виждат данни от Еконт.
4. Сменете Environment на Production, въведете данните за реална работа и направете малка поръчка. Проверете дали се създава товарителница и следете първите поръчки.

Ръководството на Спиди не описва тестов режим. На страницата им за интеграция има връзка към демо магазин с модула, в който можете да видите как изглежда. Във Вашия магазин направете поръчка като клиент и проверете цената за всяка услуга. Не заявявайте куриер за тестова пратка и попитайте лицето за контакт по договора си със Спиди как се прави такава.

Когато нещо не работи

• Цената не се изчислява. Проверете теглото на продуктите, данните за достъп и дали в Environment е избрана правилната среда.
• Формата на Еконт не се показва. Документацията на Еконт разглежда този проблем най-вече при блоковата страница за поръчка. Обновете модула, проверете полето Customer Details Container (по подразбиране #customer_details) и изчистете кеша. Документацията препоръчва още страницата за поръчка да не се кешира, скриптовете на модула да са изключени от минимизирането, а защитните плъгини да пропускат адресите на API-то на Еконт.
• Няма товарителница. Проверете Store ID, Private Key и средата, после ползвайте „Sync Econt Waybills“.
• Спиди не показва офиси или населени места. Натиснете бутона за извличане на данни от Спиди в общите настройки.
• Модулът не се активира. Сравнете версиите на PHP и WooCommerce с таблицата по-горе.

За да видите какво съобщава модулът на Еконт, включете за малко дневника на грешките. Първо вижте пътя до основната си папка. Командата само го показва.

# cPanel > Terminal
cd ~ && pwd

Добавете редовете над реда „That's all, stop editing!“. Заменете /home/ВАШИЯТ_ПОТРЕБИТЕЛ с пътя от командата. Така дневникът е извън public_html и не може да се отвори от интернет.

// wp-config.php, над реда "That's all, stop editing!"
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', '/home/ВАШИЯТ_ПОТРЕБИТЕЛ/wp-debug.log' );
define( 'WP_DEBUG_DISPLAY', false );

// Само за Еконт, повече подробности в дневника.
define( 'ECONT_DEBUG', true );

Направете поръчка и потърсете в дневника редове, които започват с [Econt]. После върнете WP_DEBUG на false, махнете ECONT_DEBUG и изтрийте файла. Документацията на WordPress не препоръчва тези настройки на живи сайтове, а дневникът може да съдържа чувствителни данни.

Чеклист

• Има бекъп на сайта от преди инсталацията.
• Имате данни за достъп от куриера, идентификатор и код за свързване при Еконт, потребител и парола при Спиди.
• Сайтът работи през HTTPS, а WordPress, WooCommerce и PHP отговарят на изискванията на модула.
• Всеки продукт и всяка вариация има реално тегло.
• Модулът е качен и активиран, а данните са въведени.
• При Еконт методът „Econt“ е добавен към зоната за България, а при Спиди модулът е включен.
• Наложеният платеж е включен и ограничен до методите на куриера.
• Тестовата поръчка е минала и товарителницата е създадена.
• Преди реална работа Environment е на Production, а дневникът на грешките е изключен.

Ако изпращате малко пратки

Ако изпращате по няколко пратки седмично, може и да нямате нужда от модул. Създавайте товарителниците ръчно в системата на куриера, докато поръчките се увеличат. Плащанията при доставка и с карта са описани в отделното ръководство Наложен платеж и плащане с карта в WooCommerce за България.

Когато пратките станат много, при AI автоматизацията на онлайн магазина товарителниците с Еконт и Спиди, проследяването, отговорите на клиентите и фактурите се обработват без ръчна работа, от поръчката до доставката. Ако искате да видите как би изглеждало това за Вашия магазин, пишете ни през формата за запитване.

Източници

• Еконт, модул Достави с Еконт за WooCommerce
• Еконт, Econt WooCommerce плъгин на GitHub
• Еконт, Първоначална настройка на плъгина
• Еконт, Отстраняване на проблеми с плъгина
• Еконт, настройки за локации за доставка
• Еконт, настройки за изпращане на пратка
• Еконт, настройки за наложен платеж
• Спиди, интеграция с онлайн магазини
• Спиди, ръководство за модула за WooCommerce
• WordPress.org, Drusoft Shipping for Econt
• WordPress.org, Drusoft Shipping for Speedy
• WooCommerce, Setting up Shipping Zones
• WooCommerce, Bulk Editing Products
• WordPress, Debugging in WordPress
• WordPress, Site Health Screen
• WP-CLI, wp plugin install