Кога е необходима тази настройка?
Simvoly използва собствена цена за доставка. Ако директната интеграция със Speedy показва фиксирана или неправилна сума, checkout widget-ът на Изпрати.БГ може да покаже цената, изчислена за реално избраните куриер, услуга, адрес или офис.
Тази инструкция е продължение на 50. Checkout widget. Първо изпълнете основната инсталация на widget-а и полето octava.
Двата режима за цена #
| Режим | Източник на цената | Кога се използва |
|---|---|---|
Static (Simvoly) | Нативният метод за доставка в Simvoly | Когато цената е фиксирана или нативната интеграция изчислява правилно. |
Signed dynamic (Izprati.bg) | Калкулаторът на Изпрати.БГ | Когато цената трябва да зависи от куриер, услуга, адрес, офис/автомат и съдържанието на поръчката. |
Важно: При динамичния режим нативната цена за доставка в Simvoly трябва да бъде 0.00. Реалната цена се показва от widget-а и се записва в заявката за доставка в Изпрати.БГ/Orderadmin след проверка на подписаната селекция.
Преди активиране #
- Интеграцията със Simvoly трябва да е активна в Изпрати.БГ.
- Checkout widget-ът трябва да е инсталиран според основната инструкция.
- Във V2 checkout формата трябва да има постоянно текстово поле с име точно
octava. - Трябва да са настроени правилните подател и куриерски услуги.
- Първите проверки трябва да се направят в demo режим чрез
?demo=1.
Режим 1: Static (Simvoly) #
- Отворете настройките на Simvoly интеграцията в Изпрати.БГ.
- В полето Delivery price source изберете Static (Simvoly).
- Настройте желаните цени в нативните методи за доставка на Simvoly.
- Запазете и направете тестова поръчка.
В този режим widget-ът може да управлява избора на куриер и офис, но не заменя сумата за доставка, която идва от Simvoly.
Режим 2: Signed dynamic (Izprati.bg) #
- В Simvoly оставете един нативен метод за доставка, валиден за необходимите региони.
- Задайте цена на този метод 0.00. Подходящо име е „Доставка – цената се изчислява по-долу“. Не го именувайте „Безплатна доставка“.
- Изключете нативния динамичен калкулатор на Speedy и всички други методи, които могат да добавят ненулева доставка.
- Проверете, че V2 checkout формата съдържа текстовото поле
octava. - В настройките на Simvoly интеграцията в Изпрати.БГ намерете Delivery price source и изберете Signed dynamic (Izprati.bg).
- Запазете настройката и отворете checkout-а с параметър
?demo=1. - Изберете куриер и точен офис/автомат или доставка до адрес. Проверете показаната цена до избраната опция и в обобщението на поръчката.
- Направете тест с наложен платеж и отделен тест с банков превод или друг неналожен метод.
- Проверете импортираната поръчка в Изпрати.БГ/Orderadmin: куриер, тарифа, точен офис и цена за доставка трябва да съвпадат с checkout-а.
- След успешно приемно тестване премахнете demo ограничението от widget-а, за да го активирате за всички клиенти.
Какво вижда клиентът #
- Наложен платеж: видимата крайна сума включва стоките и динамичната доставка.
- Банков превод или друг неналожен метод: нативната сума за стоките остава непроменена, а редът за доставка показва, че доставката се плаща на куриера.
Widget-ът записва избора в полето octava. Не променяйте ръчно стойността на това поле и не го използвайте за други данни.
Защо селекцията е подписана #
При импортиране Изпрати.БГ проверява цената, валутата, стойността на стоките, начина на плащане, адреса, избрания куриер и точния офис/автомат. Ако данните са изтекли, липсват или са променени, поръчката не се импортира автоматично с грешна или нулева цена. Клиентът трябва да обнови checkout-а и да избере доставката отново.
Важно ограничение на Simvoly #
В самата поръчка на Simvoly нативното поле за доставка остава 0.00. Проверената динамична цена е видима в checkout-а и се записва като цена на заявката за доставка в Изпрати.БГ/Orderadmin, но не се връща обратно в нативното поле shippingAmount на Simvoly.
Проверете имейлите, фактурите и шаблоните на Simvoly. Скрийте нативния ред с цена 0.00 или го заменете с неутрален текст, за да не изглежда като „безплатна доставка“.
Проверка преди пускане #
- Нативният Simvoly метод е един и е с цена 0.00.
- Директният Speedy калкулатор не добавя втора цена.
- Полето
octavaсъществува и widget-ът го попълва. - Избран е режимът
Signed dynamic (Izprati.bg). - Тествани са доставка до адрес и до офис/автомат.
- Тествани са наложен и неналожен начин на плащане.
- Цената и избраната точка съвпадат в checkout-а и в импортираната заявка за доставка.
Чести проблеми #
- Продължава да се показва фиксираната цена на Speedy: проверете дали нативният Speedy калкулатор е изключен и дали източникът е
Signed dynamic (Izprati.bg). - Показва се „Безплатна доставка“ или 0.00: преименувайте нативния нулев метод и проверете дали widget-ът е зареден и има валидна селекция.
- Checkout-ът не позволява продължаване: попълнете адреса и изберете точен офис/автомат. След промяна на адрес, кошница или начин на плащане изберете доставката отново.
- Поръчката не се импортира: проверете дали нативната доставка е точно 0.00, дали селекцията не е изтекла и дали данните на поръчката не са променени след избора.
Връщане към статична цена #
Изберете Static (Simvoly), възстановете реалните цени на нативните методи в Simvoly и направете нова тестова поръчка. Не оставяйте нулев нативен метод при статичен режим, освен ако доставката действително е безплатна.
