Ръководство за работа

Какво прави плъгинът

Плъгинът добавя CVC като начин за доставка в онлайн магазин с WooCommerce. Изчислява цена по пратките и адреса и запазва данните към поръчката. В тази демонстрация CVC е единственият куриер и е постоянно видим. Служителят може да изчисли и запише CVC доставка направо от редакцията на поръчката. След получаване на API ключ се включва и издаването на товарителница от същия екран.

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

Бърза демонстрация за 10 минути

1. Отворете демо магазина и натиснете „Един палет“.
2. Вижте CVC като единствен куриер в секцията за доставка. Показаните стойности са симулирани.
3. Изберете получаване до хъб и вижте преизчисляването. След това започнете „Малък пакет“ или „Два различни пакета“ — CVC остава единственият куриер.
4. Влезте с предоставения тестов профил и отворете CVC демо. Паролата се предоставя отделно, не е публикувана тук.
5. Създайте „Нова поръчка → изчисли CVC“, въведете 100;120;80;100 и изчислете доставката. Прегледайте сумите и я запишете.
6. Проверете договорната цена, след това издайте тестова товарителница, обновете статуса и изтеглете тестовия PDF.
7. От CVC демо изберете „Без API ключ“ или „Непотвърдено издаване / timeout“. Създайте нова поръчка и вижте защитното поведение. Накрая върнете „Успешен тестов достъп“.

Продукти и готови комбинации

Готовите сценарии изпразват предишната количка и попълват тестов адрес в София. За собствена комбинация използвайте „Добави в количката“ при продуктите и променяйте количествата в количката.

„Два различни пакета“ и „Тежък палет“ показват различни физически пратки и тяхната CVC калкулация.

CVC е единственият куриер в демото

CVC е постоянно видим за физическите продукти. Демонстрацията не сравнява куриери и не поставя условие CVC да има най-ниска цена. Палетите са избрани по подразбиране; пакетите и гумите имат собствени примерни сценарии.

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

Опаковане и данни за доставката

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

Един палет със 100 кг и размери 120 × 80 × 100 см се записва като 100;120;80;100. За два палета се използват два реда. Ако продавате на квадратен метър или в кашони, физическите единици трябва да са настроени така, че да не се получава „половин пратка“.

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

Работа от администрацията

Изчисляване и запис на CVC доставка

1. Отворете съществуваща поръчка или създайте нова. Запишете адреса, артикулите и платежния метод.
2. В „CVC доставка и товарителница“ намерете „CVC доставка от администрацията“. При нов избор видът е „Палети“.
3. Попълнете готовите пратки, по един ред за всяка.
4. Натиснете „1. Изчисли CVC доставка“. Вижте транспортната цена, наложения платеж и новата обща сума.
5. Натиснете „2. Запиши CVC доставката в поръчката“. Това записва CVC доставката и цената; не издава товарителница.

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

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

Издаване, статус и PDF

1. При наличен ключ отворете долната част на CVC панела. Данните на поръчката трябва вече да са записани.
2. Проверете дата на изпращане, съдържание, брой и измервания на пратките.
3. Натиснете „1. Провери данните и договорната цена“. Прегледайте получателя, адреса, платеца, обявената стойност и наложения платеж.
4. Натиснете „2. Издай CVC товарителница“ само след проверката. В демото се създава номер DEMO-ID; в реалния магазин с активен API това е реална операция.
5. След издаване са налични номер, обновяване на статуса, проследяване и PDF, ако CVC го е предоставил.

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

В демото „Проследяване“ и „Отвори демо портала“ отварят локална симулация. Тестовите номера не се изпращат към реалния портал на CVC.

Наложен платеж и предплащане

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

В демонстрацията методът cod обозначава наложен платеж. Няма реално събиране на пари.

Публичната и договорната CVC цена могат да се различават. Предварителната API проверка показва договорната цена; не заменя автоматично вече уговорената с клиента сума.

Какво да направите при проблем

Настройки и достъп

Самостоятелната секция CVC доставка съдържа настройките на интеграцията. Включването на CVC в съответната WooCommerce зона за доставка също е необходимо.

Основните групи са: вид пратка и подател; адрес/хъб/офис на получателя; наложен платеж и обявена стойност; надбавка, отстъпка и данъчно третиране; кеш и диагностика; максимални размери, тегло и брой. Отделна част съдържа API ключа, обекта и контакта на подателя, платците и допълнителните услуги.

Тестовият мениджър може да обработва фиктивни продукти и поръчки и да използва CVC панела. Няма достъп до редактори, инсталиране на плъгини/теми, качване на файлове, управление на потребители или сървърни данни. Изтеглянето на тестовата товарителница е разрешено като част от демонстрацията.

Отвори пълната техническа документация →