Разширителен модул за доставка със SPEEDY за OpenCart 2.0.x

При технически въпроси	xxxxxxxx@xxxxxx.xx
Дата на последна промяна	28.06.2021
Версия на модула за доставка	5.1.0
Поддържани версии на OpenCart	2.0 - 2.3
Системни изисквания	- Правилно инсталиран и настроен OpenCart без модификации по ядрото; - PHP 5.6.x или по-висока версия; - MySQL 5.0.x или по-висока версия; - server httpd_can_network_connect = true
Xxxxx за достъп	Предоставени от Спиди потребител и парола предназначени за интеграция на online магазини. Те са различни от използваните за MySpeedy. За да получите данни за достъп позволяващи интеграция е необходимо да се свържете с лицето за контакт от страна на Спиди или да ни пишете на e-mail: xx@xxxxxx.xx.

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

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

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

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

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

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

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

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

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

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

1. Проверете версията на OpenCart магазина, върху който ще интегрирате разширителния модул за да сте

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

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

резервно копие (backup) на директориите admin, catalog и system, намиращи се в главната директория на магазина.

2.1. Изтрийте xml файла на Спиди от Extensions > Modifications, маркирайте Speedy Shipping и натиснете горе в дясно бутона „Delete“. Това изчиства качения в магазина speedy.ocmod.xml файл, за да може след това при стъпките за инсталация да качите новия.

2.2. Задължително натиснете бутона „Refresh“ горе в дясно.

2.3. ВАЖНО – За да се запази историята на стари създадени товарителници към поръчки, не

премахвайте/деинсталирайте модула за доставка на Спиди. Заместването на старата с новата версия се случва при заместването на новите файлове от “upload” директорията и инсталирането на новия speedy.ocmod.xml, както е описано в стъпките по-долу.

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

3. Разархивирайте файловете от архива на модула в празна директория.

4. Преди да инсталирате модула, направете резервно копие (backup) на директориите admin, catalog и system, намиращи се в главната директория на магазина. За целта може да използвате FTP клиент или друг метод за трансфер на файлове. Направете резервно копие (backup) на базата данни на магазина.

5. Качете съдържанието на директория upload (не самата директория!) в главната директория на магазина.

При качването е възможно да видите съобщение, че директориите admin, catalog и system ще бъдат

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

6. Отворете административния панел на вашия онлайн магазин (/admin) и изберете от менюто Extensions -> Extensions Installer, натиснете бутона Upload и изберете файла speedy.ocmod.xml от инсталационния архив. Файлът speedy.ocmod.xml се намира в основната директория на архива на модула.

След това отидете в Extensions -> Modifications и натиснете бутона „Refresh” (малка икона в горния десен ъгъл).

II. Настройки на мерни единици и валута

7. Отворете административния панел на онлайн магазина и изберете от менюто Системни -> Локализация ->

Валути (System -> Localisation -> Currencies). Ако нямате въведена валута Лев, изберете Добавяне (Add New) и я добавете, като в полето „КОД (Code)“ задължително трябва да попълните „BGN“.

За да направите „Български лев“ валута по подразбиране (Default), навигирайте до System - Settings -> бутон

„Edit“ на реда с името на вашия магазин -> таб „Local“ -> Изберете опцията „Български лев“ в менюто

Currency.

За Length Class изберете „Centimeter“; За Weight Class изберете „Kilogram“.

Ако искате да изпращате с Наложен платеж до Гърция или Румъния трябва да настроите валутите и съответните курсове на тези страни спрямо валута Лев.

За Гърция ако нямате въведена валута Евро (Euro), изберете Добавяне (Add New) и я добавете, като в полето

„КОД (Code)“ трябва да попълните "EUR". За „Стойност (Value)“ въведете стойността на курса на Евро (Euro)

спрямо валута Лев.

За Румъния ако нямате въведена валута Румънска лея (Romanian Leu), изберете Добавяне (Add New) и я добавете, като в полето „КОД (Code)“ трябва да попълните "RON". За „Стойност (Value)“ въведете стойността на курса на Румънска лея (Romanian Leu) спрямо валута Лев.

III. Настройки на права върху файловете на модула

8. От менюто на административния панел изберете

Системни -> Потребители -> Групи потребители (System -> Users -> User Groups).

Задайте привилегии на всички потребителски групи, които желаете да имат достъп до SPEEDY модула (ако нямате създадени собствени групи е достатъчно да се зададат привилегии за стандартната група Top Administrator) като изберете Редактирай (Edit).

В раздел С права за достъп до (Access Permission) и С права за администрация на (Modify Permission) сложете отметки пред:

- payment/speedy_cod

- sale/speedy

- shipping/speedy

IV. Включване и настройки на модул за наложен платеж

9. От менюто на административния панел изберете:

Разширения -> Платежни модули (Extensions -> Payments).

Към търговците, които вече са имали работещ стар модул за наложен платеж при предишна инсталация. Ще виждате, че модула за наложен платеж, е вече инсталиран. Сверете само дали настройките са както тези по- долу. Не деинсталирайте/премахвайте модула.

Намерете „Спиди Наложен Платеж“ („Speedy Cash On Delivery“) и изберете Инсталирай (Install).

Натиснете бутона Редактирай (Edit).

За „Статус на поръчката“ изберете какъв да бъде статуса, когато клиент е избрал да плати чрез наложен платеж (например Processing).

За „Статус“ – Включено.

За „Поредна позиция в колоната“ – въведете числото „1“.

Натиснете бутона Запази (Save) от горния десен ъгъл на страницата.

V. Включване и настройки на модул за доставка

10. От менюто на административния панел изберете:

Разширения -> Модули за доставка (Extensions -> Shipping).

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

деинсталирайте/премахвайте модула.

За Спиди изберете Инсталирай (Install). След което изберете Редактирай (Edit).

Въведете вашите Потребителско име и Парола, които са предоставени от SPEEDY. След това кликнете върху бутона „Тествай настройките“.

След като направите първоначалните настройки и въведете потребителското си име и парола и запазете настройките с бутона Запази (Save). След това запазване на настройките, модулът прави връзка със системата

на SPEEDY и изтегля и визуализира информация за възможните методи за доставка (куриерски услуги). След като се появи списъка, е нужно да изберете методите. Тези които изберете, ще се предоставят за избор на крайния клиент при завършване на поръчката. Отново натиснете бутон Запази (Save).

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

Край на работно време – Последен възможен момент, в който куриер може да посети обекта Ви, за да вземе подготвените пратки. Попълнете в двете менюта час и минути. Например 18:00.

Позволени методи (куриерски услуги) - За коректна работа изберете поне една градска и една междуградска услуга.

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

Информация за услугите можете да откриете на официалния сайт на компанията xxxxx://xxx.xxxxxx.xx или да получите от лицето си за контакт в Спиди.

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

ЗАБЕЛЕЖКА: В случай, че поръчаната стока се намира в друг обект, в екрана преди генериране на товарителница, администраторът на магазина има възможност да промени този обект. Трябва да се има предвид, че промяната на обекта може да доведе до цена и услуга, различни от тези показани на клиента при завършване на поръчката (особено ако обектите са в различни населени места).

ЗАБЕЛЕЖКА: Ако в контролният панел е посочено, че онлайн търговецът ще занесе пратката до офис на Спиди, посоченият обект се игнорира и се взема адресът на посоченият офис.

Образуване на цена за доставка – Указва начина на калкулиране на цена на куриерската услуга.

- Спиди калкулатор (Speedy Calculator) – Стандартно ценообразуване в реално време взимайки

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

- Спиди калкулатор + допълнително таксуване (Speedy calculator + handling fee) – Стандартно

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

Например: стойността на поръчания артикул е 50лв. Стойността на куриерската услуга е 5лв.

Попълнени са 2 лв. за добавка към този метод на калкулация. Резултата ще бъде пратка с наложен платеж 52 лв. (50 + 2) и куриерска услуга 5 лв. за сметка на получателя.

- Фиксирана цена (Fixed price) – вие избирате стойността на доставка, която желаете клиента да вижда в онлайн магазина. Тази стойност ще бъде фиксирана за всяка поръчка, независимо от това какво и колко е поръчано. Куриерската услуга е за сметка на подателя (ваша сметка). Избраната от вас

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

Например: стойността на поръчания артикул е 50лв. Стойността на куриерската услуга е 5лв.

Попълнени са 15 лв. фиксирана доставка. Резултата ще бъде пратка с наложен платеж 65 лв. (50 + 15) и куриерска услуга 5 лв. за сметка на подателя.

- Безплатна доставка (Free Shipping) – този метод позволява да зададете минимален праг на стойност на поръчката, над който клиента няма да заплаща доставка. В полето „минимална стойност на

поръчка за безплатна доставка (Minimum order amount for free shipping) поставете сумата/прага, над която доставката става безплатна. Когато не е достигнат този праг, калкулацията е както с метода

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

- Ако за „Образуване на цена за доставка“ посочите "Цена от файл (Price from file)", всички генерирани товарителници от модула стават за сметка на подателя. Цените, които ще се показват на клиентите на онлайн магазините ще бъдат съобразени според данните въведени в CSV (Comma-separated values) файл. Файлът трябва да съдържа следните колони:

ServiceID – съдържа ID на услугата, съобразено с ID-тата на услугите в нашата номенклатура; TakeFromOffice – флаг (0, 1), който показва дали е избрана опция за до поискване до офис; FixedTimeDelivery – флаг (0, 1), който показва дали е избрана опция за доставка във фиксиран час; Weight – крайно тегло на доставката;

OrderTotal – цена на продуктите поръчани от онлайн магазина;

PriceWithoutVAT – цена за доставка без ДДС;

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

505,1,0,10,500.00,5.00 - услуга 505, доставка до офис, без фиксиран час, тегло до 10 кг., сума на поръчка до 500 лева, цена за доставка 5.00 лева;

505,0,0,10,500.00,6.00 - услуга 505, доставка до адрес, без фиксиран час, тегло до 10 кг., сума на поръчка до 500 лева, цена за доставка 6.00 лева;

505,1,0,10,50.00,7.00 - услуга 505, доставка до офис, без фиксиран час, тегло до 10 кг., сума на поръчка до 50 лева, цена за доставка 7.00 лева;

и т.н.

Ако искате да посочите безплатна доставка с тази услуга за всички пратки:

505,0,0,100000,100000.00,0.00

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

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

При избрана опция за калкулация „Цена от файл“, ако дадена поръчка попада в границите на

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

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

Тегло по подразбиране за един брой (Default weight for one item) – въвеждате тегло по подразбиране при

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

Опаковка (Default packing) – Напишете с текст използвана по подразбиране опаковка. Например: Плик, Кашон и т.н.

Пощенски паричен превод (вместо наложен платеж) (Postal money transfer (instead of Cash on Delivery) –

Yes/No показва дали товарителницата да се генерира с Пощенски Паричен Превод (ППП), вместо наложен платеж (НП). За да е видима тази опция клиента трябва да има анекс за ППП към договора със Спиди.

Опции преди плащане (Options before payment) – възможност за избор между услуги „Отвори“ и „Тествай“;

- Платец на товарителница за връщане (Return courier service payer) - платец на обратната

товарителница (получателят на правата товарителница генерирана в магазина, се явява подател на обратната товарителница);

- Услуга на товарителница за връщане (градска услуга) (Return city service) - изберете градска услуга, с която ще се връща пратката;

- Услуга на товарителница за връщане (междуградска услуга)(Return intercity service) - изберете междуградска услуга, с която ще се връща пратката;

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

- Автоматично изключване на опциите преди плащане при доставка до автомат (Automatically ignore the options before payment on delivery to automat)– При доставка до автомат опциите преди плащане не са позволени. Тази настройка указва дали те да бъдат игнорирани, при избор на доставка до автомат. При избрана настройка „Да“ и пуснати опции преди плащане в клиентската част ще може да бъде избирана доставка до автомат, но без използване на опции преди плащане. При избрана настройка „Не“ и пуснати

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

ЗАБЕЛЕЖКА: “Отвори” и “Тествай” са допълнителни услуги, които предоставят възможност на

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

Xxxxxx за връщане (Return voucher) - Ако желаете да ползвате ваучер за връщане

- във Ваучер за връщане – изберете „Да“;

- Платец на товарителница за връщане (Return courier service payer) - изберете платеца на куриерската услуга на обратната товарителница (Получателят на правата товарителница генерирана в магазина, се явява подател на обратната товарителница);

- Градска услуга (Return city service) - изберете градска услуга, с която ще се връща пратката;

- междуградска услуга (Return intercity service) изберете междуградска услуга, с която ще се връща пратката;

ЗАБЕЛЕЖКА: „Xxxxxx за връщане“ представлява допълнително отпечатан талон, на който има баркод чрез сканирането, на който се създава нова товарителница с разменени адреси на подател и получател. Не може да се прилага за пратки извън България.

Лейбъл принтер (Label printer) – Yes/No посочвате дали създадените товарителници да са във формат за етикетен принтер.

Допълнително копие на товарителницата (Additional waybill paper copy) – Yes/No По подразбиране при отпечатване на товарителница на лист A4, се отпечатва само една товарителница. Ако позволите тази опция, на листа ще се отпечата още едно допълнително копие.

Обявена стойност (Add declared value) – Yes/No показва дали товарителницата да се генерира с допълнителна услуга обявена стойност. При Yes се визуализира поле Чупливо.

- Чупливост (Fragile items) – Yes/No показва дали пратката съдържа чупливи стоки.

Изпратете от офис (Send from Speedy office) – Yes/No показва дали търговеца на магазина ще изпрати пратката от офис на Спиди. При Yes се визуализира поле за Избор на офис.

- Изберете офис – избирате офиса, от който ще изпратите пратката.

Адрес само в забележка (Address only in address note field:) – При разрешаване на тази опция, при попълване на адрес, вместо попълване на разбит адрес, клиентът ще може да подаде свободен текст за адрес. При така попълнен адрес е препоръчително търговецът да „разбие“ адреса преди да създаде товарителница, за да може да се подсигури правилното разпределение на пратката в куриерската фирма.

Позволи калкулация на цена за временно неработещи офиси (Allow cost calculation for temporary non- working offices) – При разрешаване на тази опция в клиентската част на магазина, ще може да се направи калкулация на цена и поръчка за избран офис, който в момента не работи.

Стойността на доставката се добавя във фактурата (Shipping cost is included in invoice) – посочва се дали стойността на доставката да се включва в придружаваща фактура към артикула от поръчката.

Съботна доставка (Saturday delivery) – Disabled/Enabled посочва се дали да се посочи в услугите съботна доставка

Брой работни дни за отлагане на доставката (Days to postpone taking of the shipment) – въвеждате брой дни за отлагане, след които да бъде взета от подателя пратката.

Статус на поръчката след генериране на товарителница (Order status after the generation of bill of lading)

- изберете подходящ статус (например Shipped).

За Гео зона (Geo zone) изберете „All Zones“. Tекущата версия на модула поддържа доставки до всички държави и доставки с наложен платеж единствено на територията на България, Румъния и Гърция.

Синхронизиране на статуси (Synchronize statuses) – Чрез тази опция можете да синхронизирате статусите на поръчките си след като дадена пратка чрез Спиди бъде доставена, върната, анулирана и т.н. В менютата

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

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

Последователност в колоната (Order in the column) – Показва на кое място сред методите на доставка да се появява модула в клиентската част.

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

ПОЗДРАВЛЕНИЯ!

Вече имате работещ модул за доставка с куриерска фирма SPEEDY!

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

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

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

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

адресната форма трябва да се попълват на латиница.

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

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

За целта отворете административния панел на вашия онлайн магазин и изберете от менюто Продажби ->

Поръчки (Sales -> Orders).

За съответната поръчка, в колоната Товарителница, изберете Създай товарителница.

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

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

ще бъде заменен с номера на товарителницата.

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

Продажби -> Спиди поръчки.

За да заявите куриер, селектирайте поръчките, които планирате да предадете на куриера и натиснете бутон

„Заяви куриер“.

При възникнали проблеми и технически въпроси свързани с инсталирането и използването на модула за доставка на Спиди, можете да се обръщате за съдействие на xxxxxxxx@xxxxxx.xx .

За всички въпроси от търговско естество можете да се обърнете към лицето за контакт от страна на Спиди или да се свържете с нас на xx@xxxxxx.xx

Document Metadata

Table of Contents

Разширителен модул за доставка със SPEEDY за OpenCart 2.0.x

Document Metadata