Разширителен модул за доставка със SPEEDY за WooCommerce

При технически въпроси [email protected]
Дата на последна промяна 1.12.2025
Версия на модула 6.0.0
Поддържани версии на WooCommerce

WooCommerce - 8.2 или по-висока версия

WordPress - 5.3 или по-висока версия

Системни изисквания
  • Правилно инсталиран и настроен WooCommerce без модификации по ядрото
  • PHP 8.0 или по-висока версия
  • MySQL 5.6 или по-висока версия
  • server httpd_can_network_connect = true
Данни за достъп

Потребителското име и паролата, предназначени за интеграция на online Магазин се предоставят от Спиди.

Те са различни от използваните за MySpeedy.

Ако не разполагате с такива, моля обърнете се към лицето за контакт от страна на Спиди.

За клиенти без договор, моля изпратете имейл към [email protected] с данните за магазина Ви.

Лицензионно споразумение

Настоящият Модул за доставка с куриерска фирма SPEEDY за WooCommerce, наричан по-долу за краткост СОФТУЕР, е обект на интелектуална собственост.

Авторските права над СОФТУЕРА са притежание на "Спиди" АД.

Нямате право да продавате, променяте, лицензирате и/или създавате производни произведения.

СОФТУЕРЪТ се разпространява безплатно и се предоставя "ТАКЪВ КАКЪВТО Е", без гаранции от какъвто и да е вид, явна или неявна, включително, но и не само търговски гаранции, годност за определена цел и не нарушаване.

Разработчикът или притежателят на авторското право в никакъв случай не носят отговорност за преки или непреки загуби, вреди или пропуснати ползи настъпили в резултат от ползването или невъзможността за използване на СОФТУЕРА.

С инсталацията на СОФТУЕРА, ползвателят се съгласява с горните условия.

I. Инсталация на модула за доставка

Преди да започнете с инсталацията на модула за доставка, моля уверете се, че имате необходимите данни за достъп (потребител и парола), които да използвате за настройките.

Ако нямате потребител и парола, можете да се свържете с лицето за контакт по Вашия договор от страна на Спиди.

Препоръчваме преди всяка промяна, инсталиране и подмяна на модула да си направите backup-резервно копие на сайта.

Не могат да бъдат използвани данните за достъп до уеб модула на Спиди (MySpeedy).

  1. Проверете версията на WooCommerce магазина, върху който ще интегрирате разширителния модул, за да сте сигурни, че версията на модула е съвместима с Вашия магазин. Това може да направите от: Административен панел > Plugins > Installed Plugins > WooCommerce:

    WooCommerce Version
  2. Инсталиране

    • Отворете административния панел на магазина
    • Отидете в "Plugins > Add Plugin" от основното меню
    Add Plugin Upload Plugin Choose File
    • Изберете "Upload Plugin"
    • Изберете .zip файла, съдържащ модула
    • Изберете "Install Now"
    Install Now

    Забележка: Ако за първи път инсталирате WordPress Plugin на Вашия сайт, може да се наложи да въведете FTP вход за идентификационни данни.

    • Изберете Proceed, за да започнете инсталацията
    • След като инсталирането приключи, изберете "Activate Plugin", за да активирате, или "Return to Plugin Installer" за други действия

II. Конфигуриране

  1. След като успешно сте инсталирали и активирали модула:

    1. Отидете в "Plugins > Installed Plugins" от основното меню. Намерете "WooCommerce Speedy Shipping Method" и натиснете "Settings"

      Settings

    или

    1. Отидете в "WooCommerce > Settings" от основното меню, след това изберете tab "Shipping". Трябва да видите "Доставка със Speedy" като опция в горната част на екрана (под tab "Shipping"). Натиснете, за да конфигурирате.

      Shipping Settings

Следват полета на настройките в модула, разпределени в няколко таба. Конфигурирайте модула, като попълните необходимите данни:

Settings Tabs

4. Таб Общи настройки

General Settings

Статус на модула (Module Status)

Включено/Изключено (Enabled/Disabled). Указва дали модулът за доставка на Спиди да бъде включен.

Заглавие (Title)

Оставете по подразбиране или попълнете друго име за доставка със Спиди

Потребител и парола (Username and Password)

Потребителското име и паролата, предназначени за интеграция на online Магазин се предоставят от Спиди.

Те са различни от използваните за MySpeedy.

Ако не разполагате с такива, моля обърнете се към лицето за контакт от страна на Спиди.

За клиенти без договор, моля изпратете имейл към [email protected] с данните за магазина Ви.

Принтер за етикети (Label printer)

Да/Не - Посочвате дали създадените товарителници да се отпечатват на етикетен (лейбъл) принтер. Необходимо е да имате инсталиран физически подобен принтер.

Етикетите за него са лепящи се стикери с размери 104х147мм (формат А6). При включена опция, товарителниците не се печатат върху лист формат А4.

Допълнително хартиено копие на товарителницата (Additional waybill paper copy)

Да/Не - По подразбиране при отпечатване на товарителница на лист формат A4, се отпечатва само един екземпляр за получател, който се постави върху пратката.

Ако позволите тази опция, на А4 листа ще се отпечата още едно допълнително копие за подател. В края на всяко копие е посочено за кого е то.

Извличане на данни от Спиди (Sync Settings)

Извличане и синхронизиране на данни за търговеца, офиси на Спиди и населени места в България. Желателно е да се прави няколко пъти седмично.

При първоначално вписване на данните в модула е задължително да преминете през бутона, за да се извлекат данните.

Запишете данните, за да бъдат съхранени настройките.

5. Таб Изпращане

Shipping Settings

Подател на пратката (Object from which shipment leave)

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

Цената на куриерската услуга се калкулира от избрания обект до въведения от клиента адрес за доставка.

Забележка: В случай че поръчаната стока се намира в друг обект (различен от посочения в "Избор на обект"), в момента на генериране на товарителница администраторът на магазина има възможност да промени този обект (адрес).

Забележка 2: Ако в Настройките за изпращане в модула е посочено, че ще изпращате пратките от офис/автомат на Спиди, посоченият за подател обект (адрес) се игнорира.

Office Selection

Лице за контакт и телефон (Contact person)

Това са данните, които ще се изписват в товарителницата в частта за подател.

Край на работно време (End of working time)

Последен възможен момент за вас (край на работно време), в който нашият куриер може да посети обекта Ви, за да вземе подготвените пратки. Попълнете час и минути (напр. 17:00).

Изпращане от офис (Sending from Speedy office)

Да/Не - Указва дали подателят (търговецът на магазина) ще изпрати пратката от офис/автомат на Спиди (куриер на Спиди няма да посети обекта (адреса) на подател, за да вземе пратката).

При активирана опция, се визуализира допълнително поле за "Избор на офис".

Изпращането от офис е ценообразуващ фактор. Активирането на тази опция е възможно да доведе до промяна (намаление) в цената на куриерската услуга.

Избор на офис

Избирате офис/автомат, от който ще изпратите пратката.

Опаковка (Default packing)

Опишете с текст каква опаковка най-често ще използвате за Вашите пратки. Пример: Плик, Кашон, Кутия и т.н.

В случай на нужда, описанието на опаковката може да бъде променено/редактирано при създаването на товарителница за конкретна заявка/поръчка.

Адрес на получател само в едно поле (Recipient address in one field only)

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

Клиентът ще може да подаде свободен текст за адрес за доставка.

При така попълнен адрес е препоръчително в екрана за създаване на товарителница, търговецът да "разбие" адреса на отделни части.

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

Доставка в събота/празник (Saturday/Holidays delivery)

Да/Не - В това поле се отбелязва стойност по подразбиране за доставка в полуработен ден/празничен ден (събота/празник).

Ако очакваният ден за доставка е полуработен ден, можете да изберете дали пратката да бъде доставена в този ден или в следващия работен ден.

Опцията е ценообразуващ фактор за пратки с доставка до адрес и активирането на тази опция може да доведе до промяна (увеличение) на цената на куриерската услуга.

Доставка на пратки в събота/празничен ден до поискване в офис/автомат е безплатно.

6. Таб Услуги

Services

Активни услуги (Active services)

За коректна работа, изберете поне една услуга. Можете да използвате универсалната услуга СТАНДАРТ 24 ЧАСА, която може да бъде едновременно градска и междуградска.

В случай че имате сключен договор със Спиди, към "Активните услуги", могат да се визуализират и индивидуално договорени услуги, ако има такива.

Тегло по подразбиране за пратка (Default shipment weight)

Теглото по подразбиране се взима под внимание само в случаите, в които за даден продукт не сте дефинирали тегло.

Имайте предвид, че теглото е ценообразуващ фактор и е препоръчително Вашите продукти да имат описано такова.

Обявена стойност (Add declared value)

Да/Не - Указва дали пратката да ползва допълнителна услуга Обявена стойност (застраховка).

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

При активирана допълнителна услуга Обявена стойност се визуализира допълнителна опция "Чупливо".

Чупливо (Fragile)

Да/Не - Указва дали пратката съдържа чупливи стоки. Опцията "Чупливо" не може да се използва самостоятелно без допълнителна услуга "Обявена стойност".

Автоматични товарителници (Automatic waybills)

При включване на тази опция се създава товарителница още при запис на поръчката от клиента в Check-out страницата на магазина.

Препоръчително е да се използва само в случаите, когато асортиментът на магазина е ограничен или много малък.

Опции преди плащане/получаване (Options before payment)

Избира се една от двете възможности "Отвори" или "Тествай".

"Отвори" или "Тествай" са допълнителни услуги, които предоставят възможност на получател да провери съдържанието на пратката преди да бъде приета и/или заплати дължимата сума.

Платец

Изберете платеца на обратната пратка в случай че получателят откаже да я получи след като е отворил/тествал (пратка при връщане).

Автоматично изключване на опциите преди плащане при доставка до автомат

При доставка до автомат, опциите Отвори/Тествай не са позволени. Тази настройка указва дали те да бъдат игнорирани (премахнати), при избор на доставка до автомат.

Ваучер за връщане (Return Voucher)

Опцията "Ваучер за връщане" (ВВ - RV) е начин за управление на връщането на доставени поръчки.

Позволява на клиент на магазина контролирано да върне пратката до определен от Вас период след доставката й.

За да можете да използвате RV, трябва да настроите:

  • Платец на куриерска услуга по товарителница за връщане
  • Период на валидност (в дни) - Указва брой дни на валидност на ваучера за връщане

Допълнителни изисквания при доставка (Special Requirements upon Delivery)

Можете да укажете допълнителни специфични изисквания при доставката, които куриерът на Спиди трябва да съблюдава. Те трябва да са договорени в договора на търговеца със Спиди.

7. Таб Плащане

Payment Settings

Начин на изплащане на наложен платеж (Cash on Delivery pay-off method)

Избира се начин на изплащане на Наложения платеж, само ако клиентът няма сключен договор/анекс със Спиди.

Включване на цената за доставката в стойността на НП (Add the Shipping cost to the COD amount)

Представлява възможност за добавяне на стойността на куриерската услуга към стойността на наложения платеж.

Пример: Ако стоката е на стойност 100.00 лв, а доставка е 5.00 лв, то наложеният платеж ще стане 105.00 лв и тази сума ще бъде събрана от получател.

Начин на изплащане на наложен платеж (Cash on Delivery pay-off method)

Избира се начин на изплащане на Наложения платеж, само ако клиентът няма сключен договор/анекс със Спиди, в който е регламентиран начинът на изплащане на сумите от наложен платеж, НП чрез ППП или Касов бон за НП.

Включване на цената за доставката в стойността на НП (Add the Shipping cost to the COD amount)

Представлява възможност за добавяне на стойността на куриерската услуга към стойността на наложения платеж. Новополучената сума на наложен платеж ще бъде събрана от получателя при доставката и тя ще бъде изплатена на търговеца/подател/заявител на пратката като Наложен платеж. Куриерската услуга по товарителницата е за сметка на подателя (търговеца).

Пример: Ако стоката е на стойност 100.00 €, а доставка е 5.00 €, то наложеният платеж ще стане 105.00 € и тази сума ще бъде събрана от получателя. В последствие търговецът (подателят) ще заплати на Спиди сумата за куриерската услуга.

Наложен платеж чрез Пощенски паричен превод (Cash on Delivery paid back via a Postal money transfer)

Да/Не - Указва дали товарителницата трябва да се генерира с наложен платеж, изплащан чрез Пощенски Паричен Превод (ППП).

Наложен платеж и Наложен платеж чрез ППП са две допълнителни услуги, които не могат да се използват едновременно в една товарителница.

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

Касов бон за Наложен платеж по артикули (COD Fiscal Receipt by items)

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

За услугата е необходимо да имате сключен договор и допълнително споразумение със Спиди.

Касов бон за Наложен платеж по данъчни групи (COD Fiscal Receipt by tax group)

Указва дали Спиди издава касов бон от името на клиента. В касовия бон, издаван от Спиди, съдържанието се разпределя спрямо данъчната група, в която попада. Всяка данъчна група се описва на отделен ред, като за всеки ред (стока) трябва да бъде посочена правилната данъчна група. Ако описанието на касовия бон (съдържанието на пратката) е само от една данъчна група, то те се показват в един обобщен ред.

Повече информация за разликите между услугите може да получите от лицето си за контакт по търговски въпроси в Спиди. Актуалните данни са в MySpeedy – меню „Спиди контакти“.

Ако нямате сключен договор със Спиди АД, може да се свържете с нас чрез формата за запитвания тук.

Образуване на цена за доставка (Service pricing type)

Изберете един от начините за калкулиране на цена на куриерската услуга от падащото меню:

Образуване на цена за доставка – Спиди калкулатор (Speedy calculator)

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

Образуване на цена за доставка - Фиксирана цена (Fixed price)

Начин на ценообразуване, което позволява задаване на еднаква цена за доставка за всички услуги и пратки. В полето „Фиксирана цена/надбавка“ посочете сумата, която желаете да се приложи. Тази стойност ще се добавя към наложения платеж на товарителницата.

Платецът на куриерската услуга в този случай ще бъде подателят.

Пример: Ако продавате мобилен телефон на стойност 100 €, то наложеният платеж ще бъде 100 €.

В случай че в полето "Фиксирана цена/надбавка" посочите "5", то наложеният платеж ще стане 105 €.

Куриерът на Спиди ще събере от получателя 105 €, а вие (подателят) ще заплатите на Спиди реалната цена на куриерската услуга каквато и да е тя за конкретната пратка.

Образуване на цена за доставка - Безплатна доставка (Free Shipping)

Ценообразуване, което позволява безплатна доставка за клиента-купувач над определена сума. В „Праг на стойност на поръчката за безплатна доставка“ посочете сумата/прага, над която доставката става безплатна за получателя. Ако стойността на поръчката на клиента е по-малка от този праг, то куриерската услуга ще бъде за сметка на получателя. Когато прагът е достигнат, клиентът ще има безплатна доставка, а куриерската услуга ще бъде за сметка на подателя (търговеца). Избират се приложими услуги в България и международни услуги, за които ще се използва за безплатна доставка.

Пример: Ако в „Праг на стойност на поръчката за безплатна доставка" сте посочили 99 и продавате мобилен телефон за 100 €, то доставката за клиента ще бъде безплатна, а Вие (търговецът-подател) ще заплатите на Спиди реалната цена на куриерската услуга каквато е тя за конкретната пратка.

Образуване на цена за доставка – Собствени цени (My own Prices)

Ценообразуване, което позволява да определите сами цената на куриерската услуга, предоставяйки гъвкавост и различни цени спрямо комбинацията от услуга, начин на получаване (офис, автомат или адрес), сума на поръчката (стойност на наложен платеж). Възможни са много на брой вариации с посочени фиксирани цени за доставка при посочени условия.

При този метод на ценообразуване, всички генерирани товарителници за сметка на подателя (търговеца). Цените, които ще се показват на клиентите, ще бъдат съобразени според данните въведени в CSV (Comma-separated values) файл.

Например:

Файлът трябва да съдържа следните колони:

CSV Example

Горните редове могат да бъдат „преведени" по следния начин:

Генерирай CSV за собствени цени в Спиди Модул

Ако искате да посочите безплатна доставка с тази услуга за всички пратки, то записът трябва да има следния вид: 505,0,0,100000,100000.00,0.00

Като посочите условно високо тарифно тегло от 100000 кг или условно висока цена 100000 €, си гарантирате че всички пратки ще влязат в избрания диапазон.

Можете да имате един ред или комбинация от много редове с различни стъпки, както е в примерния файл.

При избрана опция за калкулация „Собствени цени", ако дадена поръчка попада в границите на параметрите в някои от случаите описани в CSV файла, то на клиента на магазина се показва цената от колона PriceWithoutVAT. Същата тази цена при генерирането на товарителницата се добавя към наложения платеж и се заплаща от получателя, а вие (подателят) ще заплатите на Спиди реалната цена на куриерската услуга каквато и да е тя за конкретната пратка.

Ако дадена поръчка НЕ попада в никой от случаите описани в CSV файла, то при опит за калкулиране на цена за поръчката, на клиента на магазина ще се изпише съобщение за невъзможност за калкулиране на цена.

Образуване на цена за доставка – Спиди калкулатор + надбавка (Speedy calculator + handling fee)

Стандартно ценообразуване в реално време, което взима предвид преференциите по договора на потребителя + желана от онлайн търговеца надбавка.

В полето „Фиксирана цена/надбавка" посочете сумата, която желаете. Тази стойност ще се добави автоматично към наложения платеж на товарителницата.

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

Пример: Ако продавате мобилен телефон на стойност 100 € и не сте вписали стойност в поле „Фиксирана цена/надбавка", то наложеният платеж ще бъде 100 €.

В случай че в полето "Фиксирана цена/надбавка" посочите "2", то наложеният платеж ще стане 102 €.

Административна такса (Administrative fee)

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

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

След като преминете през всички полета, натиснете бутон "Save Changes".

III. Наложен Платеж

Конфигуриране на плащане с наложен платеж

За да използвате плащане с наложен платеж за поръчки направени чрез Спиди трябва, да конфигурирате стандартния Наложен платеж (Cash on Delivery), предоставен от WooCommerce.

Отидете в WooCommerce > Настройки (Settings) от основното меню, след това изберете таб Плащания (Payments). Трябва да видите Наложен платеж (Cash on Delivery) като опция на екрана. Натиснете, за да конфигурирате.

Настройте наложения платеж:

  • Enable/Disable: Активирайте/Enable cash on delivery
  • Title: Спиди наложен платеж
  • Description: По ваше желание
  • Instructions: По ваше желание
  • Enable for shipping methods: Изберете: Any "Доставка със Speedy" method
  • Accept for virtual orders: По ваше желание
Cash on Delivery Settings

Натиснете бутон Save Changes.

С тази стъпка инсталацията и конфигурацията на модула е завършена.

ПОЗДРАВЛЕНИЯ!
Вече имате работещ модул за доставка с куриерска фирма SPEEDY!

IV. Допълнителна информация

Попълване на данни от клиенти на магазина

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

Address Selection

След въвеждане на населено място, клиентът ще види стойността на доставката за всеки възможен метод за доставка (куриерска услуга), който е наличен и приложим.

За да бъде изчислена правилно цената за доставка, всички избрани от клиента продукти трябва да имат предварително зададено реално тегло (различно от 0).

V. Генериране на товарителници

След като клиент направи поръчка, трябва да генерирате товарителница към Спиди.

За целта отворете административния панел на вашия онлайн магазин. Отидете в WooCommerce > Поръчки (Orders) от основното меню.

Изберете от менюто конкретна поръчка и отворете детайлен преглед на поръчка, за която клиентът е избрал доставка чрез Спиди.

За съответната поръчка се появява допълнителен блок с различни настройки, които можете да промените преди генериране на товарителница и бутон „Генериране на товарителница" в долната част.

Ако желаете да създадете многопакетна пратка може да въведете броя пакети, от които имате нужда, като модула ще ви изведе редове с възможност да опишете размерите на всеки пакет. Редовете ще са винаги равни на броя на въведените от вас пакети. Една товарителница НЕ МОЖЕ да има повече от 10 пакета.

Waybill Generation

След като вече имате генерирани товарителници може да ги прегледате: Отидете в WooCommerce > Спиди поръчки (Speedy orders), от където може да видите PDF файла на самата товарителница, както и други възможни действия.

Speedy Orders Waybill Actions

Ако пратката ще бъде изпратена от адрес на магазина, е необходимо да заявите куриер. Ако пратката ще се изпрати от офис на Спиди – тази стъпка се пропуска.

За да заявите куриер, селектирайте товарителницата, която планирате да предадете на куриера и натиснете > Заявяване на куриер (Request for courier).

Courier Request

За да заявите куриер за няколко товарителници, селектирайте поръчките, които планирате да предадете на куриера и натиснете > Масови действия > Заявяване на куриер (Request for courier).

Bulk Courier Request

При възникнали проблеми и технически въпроси свързани с инсталирането и използването на модула за доставка на Спиди, можете да се обръщате за съдействие на [email protected].

За всички въпроси от търговско естество можете да се обърнете към лицето за контакт от страна на Спиди или да се свържете с нас на [email protected].