Инструкция за VV Shipping Management

Плъгинът се продава като абонамент. Избираш период (месечен, за 3 месеца, за 6 месеца или годишен) и броя сайтове, на които ще го ползваш.

• По-дългият период излиза по-изгодно на месец – в страницата на плъгина таблицата „Сравни плановете“ показва цената на месец и колко спестяваш.
• Всеки сайт получава собствен лицензен ключ. Всички ключове от един абонамент изтичат на една и съща дата, така че подновяваш всичко с едно плащане.
• Първият сайт е на пълна цена, всеки следващ – с отстъпка. При избора на брой сайтове виждаш веднага разбивката: цената на всеки сайт и общата сума.
• Можеш да започнеш с един сайт и да добавиш още по-късно от профила си – новите сайтове се доплащат само за оставащото време до общата дата.

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

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

1. Избери период и брой сайтове и натисни бутона за добавяне – отиваш директно на плащането.
2. Попълни име, имейл и държава. Ако искаш фактура на фирма, попълни името на фирмата и ДДС номера (само латински букви и цифри, например BG123456789).
3. Плати с карта. Поръчката се приключва автоматично веднага след плащането и лицензът е готов.

Ако размислиш за плана, просто избери друг – той заменя предишния в поръчката. Продукт от плащането махаш с бутона „×“ до него.

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

• Ако при поръчката не си задал парола, ще получиш имейл с връзка за задаване на парола.
• Ако имейлът не пристигне до няколко минути, провери папката „Спам“ или „Промоции“.
• Вход в профила: горе вдясно „Моят профил“.

Ключът изглежда така: VT-XXXXX-XXXXX-XXXXX-XXXXX. Намираш го на две места:

• В имейла с поръчката – блок „Твоите лицензи“.
• В „Моят профил → Лицензи“ – там е винаги, заедно с бутона „Копирай“, бутона за изтегляне на плъгина и състоянието на абонамента.

1. В „Моят профил → Лицензи“ натисни „Изтегли“ – сваля се ZIP файл с последната версия. Не го разархивирай.
2. В админа на твоя WordPress сайт отвори Разширения → Добавяне → Качване на разширение, избери ZIP файла и натисни „Инсталиране“.
3. Натисни „Активиране“. В менюто се появява Viva Tools с подменюта Доставки и Лицензи.

Плъгинът работи с WooCommerce (включително HPOS), класическия checkout и FunnelKit. Сайтът трябва да е с WordPress 6.2+ и PHP 7.4+.

1. В сайта отвори Viva Tools → Лицензи.
2. В картата „VV Shipping Management“ постави ключа и натисни „Активирай“.
3. Статусът става „Активен“ и виждаш до кога е валиден лицензът. Сайтът се появява в „Моят профил → Лицензи“ до съответния ключ.

В същия екран имаш още:

• „Провери сега“ – веднага взема новото състояние, например след подновяване (иначе сайтът проверява сам веднъж на ден).
• „Деактивирай за този сайт“ – освобождава ключа, за да го ползваш на друг сайт.

Лицензът е вързан с домейна на сайта. Тестови адреси (localhost, .local, .test и подобни) не заемат място в лиценза, но поддомейн като staging.tvoiat-sait.bg се брои като отделен сайт.

Новите версии идват по стандартния начин – в Табло → Обновления или в Разширения, докато лицензът е активен. Можеш да изтеглиш последната версия и ръчно от „Моят профил → Лицензи“.

1. Отвори картата Еконт.
2. „Среда“: Production / Live за реалния профил (Demo е само за тест с демо профил на Еконт).
3. Въведи Потребителско име и Парола – същите, с които влизаш в e-Econt.
4. Натисни „Запази данните за достъп“, после „Тествай връзката“.

1. Отвори картата Спиди.
2. Въведи Потребителско име и Парола за API достъп (дава ги Спиди към договора ти).
3. Натисни „Запази данните за достъп“ и „Тествай връзката“.

1. Отвори картата BOX NOW.
2. Попълни Partner API host (по подразбиране api-production.boxnow.bg), OAuth Client ID и OAuth Client Secret – дава ги BOX NOW.
3. „Webhook secret“ попълваш само ако BOX NOW ти е дал такъв.
4. Натисни „Запази данните за достъп“ и „Тествай връзката“.

Известия за статуса на пратките. В картата има готов „Адрес за известия от BOX NOW“. Не трябва да попълваш нищо – натисни „Копирай готово съобщение за BOX NOW“ и го изпрати на контакта си в BOX NOW. Те въвеждат адреса от своя страна и статусите започват да идват веднага. Докато не го настроят, статусите пак се обновяват автоматично на всеки час.

1. Отвори картата Pigeon Express.
2. „Среда“: Production / Live (Sandbox е тестова среда).
3. Въведи API Key и API Secret, натисни „Запази данните за достъп“ и „Тествай връзката“.

1. Отвори картата EUShipments.
2. Въведи API URL и API Token от EUShipments. „Тестов режим“ отметни само ако тестваш с тестов профил.
3. Натисни „Запази данните за достъп“ и „Тествай връзката“.

Кои куриери и типове доставка да виждат клиентите във всяка държава настройваш във vivatools.pro (виж 6. Настройки → EUShipments).

• „Обнови договорния профил“ (Еконт, Спиди, BOX NOW, Pigeon) взема от куриера данните по договора ти – клиентски номер, адреси и офиси за изпращане, споразумение за наложен платеж и т.н. Тези данни после се избират в настройките във vivatools.pro (полетата с етикет „от API“). Натисни го веднъж след въвеждане на данните за достъп и когато договорът ти се промени.
• „Обнови номенклатурата“ изтегля в сайта градовете, офисите и автоматите на куриера. Без нея клиентът няма от какво да избира в поръчката. Натисни го за всеки куриер, който ползваш. След това номенклатурите се обновяват автоматично всяка нощ.

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

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

1. Отвори WooCommerce → Настройки → Доставка → Зони за доставка.
2. Отвори зоната (например „България“) или създай нова и избери държавите в нея.
3. Натисни „Добавяне на метод за доставка“ и добави нужните VV методи.
4. Запази.

Един метод показва в поръчката всички типове доставка на куриера (до адрес, офис, автомат), които си разрешил във vivatools.pro. Името и логото, които вижда клиентът, също се задават там.

1. Отвори „Моят профил → Лицензи“ и натисни „Настройки“ до сайта (или в сайта: Viva Tools → Доставки → „Отвори настройките във vivatools.pro“).
2. Промени нужното и натисни „Запази този блок“ в съответния блок. Настройката се записва директно в сайта ти и важи веднага.

• „История на промените“ вдясно пази последните 30 версии. С „Възстанови“ връщаш предишно състояние.
• Експорт / Импорт – за всеки блок или за всички настройки наведнъж. Така копираш настройки от един твой сайт в друг (данните за достъп не се копират).
• Логата, които качваш тук (PNG, JPG, GIF, WEBP до 2 MB), се записват в медийната библиотека на сайта ти.

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

• „Активирай интеграцията“ – без нея куриерът не се показва в поръчката.
• „Име в WooCommerce“ – името на куриера в поръчката и имейлите.
• „Предлагай доставка до адрес / офис / автомат“ – кои типове доставка да вижда клиентът.
• „Разреши наложен платеж за този куриер“ – ако е изключено, наложеният платеж изчезва от плащанията, когато клиентът избере този куриер.
• „Съдържание на пратката“ – динамично от продуктите в поръчката или фиксиран текст.
• „Тегло по подразбиране (kg)“ – ползва се, когато продуктите нямат тегло.
• „Зареди / обнови договорните данни от API“ – попълва полетата с етикет „от API“ (виж стъпка 4).

• „Изпращане от“ – адрес от договора, офис на Еконт или Еконтомат/APS. Избери изпращащия офис или адрес.
• Подател – фирма, лице за контакт, телефон и имейл.
• „Подаване на опис“ – без опис, електронен или към пратката. Можеш да го подаваш за всички поръчки или само при наложен платеж и да избереш как да влизат таксите и цената на доставката в описа.
• Разширени настройки – SMS известие, преглед или тест преди плащане, частична доставка, обявена стойност (никога, винаги или над праг) и размери по подразбиране.

• „Изпращане от“ – договорен адрес или офис на Спиди.
• Услуги до адрес, до офис и до автомат (по подразбиране 505) и платец на доставката – подател, получател или трето лице.
• „Наложен платеж“ – пощенски паричен превод, наложен платеж или Cash; при Cash може Спиди да издава касов бон.
• Опция преди плащане (OBPD) – отваряне/преглед или тест, с обратна пратка и платец за нея.
• Обявена стойност, Чупливо, Съботна доставка.
• Хартия за товарителницата – A6, A4 или 4 × A6 на A4, с или без копие за подателя; опаковка и размери по подразбиране.

• „Origin location / склад“ – откъде тръгват пратките (зарежда се от API).
• Размер по подразбиране – Small, Medium или Large.
• Данни за контакт на подателя и имейл за известия при приемане.
• „Разреши връщане“ и наложен платеж.

• „Изпращане от“ – адрес на подателя или офис на Pigeon Express.
• Основна услуга – Standard или Express; платец – подател или получател.
• Формат на товарителницата – PDF 100 × 90 mm, PDF 100 × 150 mm или A4.
• Допълнителни услуги – преглед/тест преди плащане, SMS до получателя, специална опаковка, обявена стойност, плащане с карта на наложения платеж, обратна разписка, обратни документи и др.

В таблицата „EUShipments правила по държава и куриер“ определяш какво вижда клиентът във всяка държава. Всеки ред е: Държава, Тип доставка, Courier ID, Име в checkout, Име за проследяване и Service. С „+ Добави куриер“ добавяш ред.

• Ако за една държава и един тип има няколко куриера, клиентът избира между тях.
• Платец, Open package, застраховка, Чупливо, Съботна доставка, формат за печат (A4 или етикет 10 × 15 cm) и размери по подразбиране.
• Анулиране – чрез API или с имейл заявка до EUShipments с готов текст (тагове {tracking_number}, {order_number}, {customer_name}, {site_name}).

Цената се определя от „Правила за цена на доставка“ за всеки куриер. Правилата се проверяват по „Приоритет“ и първото, което съвпадне, определя цената.

1. Натисни „+ Добави правило“ и му дай име.
2. Избери тип доставка (всички, до адрес, до офис, до автомат) и държава (при EUShipments – куриер и държави).
3. С „+ Условие“ добави кога важи: стойност на продуктите, тегло или брой артикули (по-малко, повече, равно, между).
4. Задай цена, или отметни „Това правило е винаги безплатно“, или задай „Безплатна доставка над“ сума.

• „Fallback цени“ се ползват, когато никое правило не съвпада.
• „Показвай в checkout колко остава до безплатна доставка“ – показва лента „Остават X до безплатна доставка“.

• С „+ Добави такса“ създаваш такса, която се добавя като отделен ред в поръчката.
• Избираш за кой куриер и тип доставка, за кой метод на плащане (например само наложен платеж), за коя държава и за каква сума на продуктите (мин./макс.).
• Таксуване: фиксирана сума, процент или сума + процент.
• „Име в checkout“ – как се казва таксата за клиента, например „Такса наложен платеж“.

• „Ред на куриерите“ – подреждаш с влачене кой куриер е пръв.
• За всеки куриер: само лого, само име или лого + име, и собствено лого.
• „Колони по устройство“ – колко куриера и типа доставка да има на ред на компютър, таблет и телефон.

• Текстове за безплатна доставка – преди и след достигане на прага.
• Помощен текст за адрес при българските куриери.
• Текстове за доставка в чужбина – всички надписи, бутони и съобщения за грешка. Празно поле означава автоматичен превод на езика на сайта.
• „Зареди готов превод“ – попълва текстовете на избрания език с един клик.
• Проверки на адреса в чужбина – да не се приема адрес само с номер, проверка на пощенския код по държава, предупреждение за номер в полето за град.

За държавите извън България градовете и улиците могат да се търсят през адресната услуга на vivatools.pro. В блока „Адресни номенклатури“ за всяка държава включваш търсене на населени места и/или улици.

Изпраща се само търсеният текст, градът и пощенският код – никакви данни за клиента. В сайта, в Viva Tools → Доставки, кутията „Адресна услуга на vivatools.pro“ показва дали услугата работи.

• По подразбиране градовете, офисите и автоматите се обновяват всяка нощ в 03:30.
• Можеш да избереш през колко часа или дни, или в кои дни от седмицата, и в колко часа.
• Обновяват се само активираните куриери, един след друг.

• Лого (от сайта, отделно качено, текст или без лого) и данни за подателя.
• Показване на SKU и тегло.
• Всички текстове на листа, с готов превод на много езици.

• Страница за проследяване – клиентът вижда статуса и движението на пратката.
• Имейл при създаване на товарителница с номер и връзка за проследяване; връзката се добавя и в следващите имейли на WooCommerce.
• Бутон в „Моят акаунт“ на клиента до поръчката.
• Подател на имейла, горна част (лого или текст) и всички текстове, с готов превод на 9 езика.

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

Всяко съответствие се променя, а „— не променяй —“ оставя статуса на поръчката както е.

• Масово генериране – кои статуси на поръчките участват в бутоните „Всички товарителници“ и „Всички опаковъчни листове“ (по подразбиране „Обработва се“).
• Цени на сайта – шорткодът [vv_shipping_prices] показва таблица с цените за доставка (например в страницата „Доставка“). Текстовете и езикът ѝ се задават тук.

От списъка с поръчки: в колона „Доставка“ натисни иконката „Създай товарителница“.

От екрана на поръчката: кутията „Shipping Management — Пратка“ показва получателя, куриера, адреса или офиса и параметрите на пратката (тегло, размери, описание, наложен платеж). Провери данните и натисни „Създай нова товарителница“.

• „Запази и преизчисли“ – ако промениш адреса, офиса или куриера.
• „Преглед на Econt опис“ – виждаш и при нужда редактираш описа преди изпращане.
• След създаване номерът на товарителницата се вижда в списъка с поръчки; с клик се копира.

• Една поръчка: иконките „Печат на товарителница“ и „Опаковъчен лист“ в колона „Доставка“.
• Много поръчки наведнъж: бутоните „Всички товарителници“ (всички етикети в един PDF) и „Всички опаковъчни листове“ над списъка с поръчки.
• Масово създаване: отметни поръчките и избери действието „Shipping Management: създай товарителници“.

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

• Статусите се обновяват автоматично, а при BOX NOW – веднага, ако е настроен адресът за известия.
• Ръчно: бутон „Проследи“ в поръчката или иконката в списъка.
• Към поръчката се добавят бележки при всяка промяна на статуса и когато наложеният платеж е изплатен от куриера.

1. Отвори „Моят профил → Лицензи“ и разгъни „Поднови абонамента“.
2. Отметни сайтовете, които запазваш, и избери период. Сумата се показва веднага.
3. Натисни „Поднови“ и плати.

• Новият срок се добавя към общата дата, така че не губиш оставащите дни.
• Ключовете в сайтовете остават същите – не трябва да правиш нищо в тях. Ако искаш веднага да видиш новата дата, натисни „Провери сега“ във Viva Tools → Лицензи.
• Неотметнатите сайтове спират на старата дата.

Ще получиш напомняне по имейл 7 дни и 1 ден преди изтичане.

1. В абонамента разгъни „Добави сайтове“.
2. Избери броя нови сайтове – виждаш сумата за оставащото време до общата дата.
3. Плати. Всеки нов сайт получава свой ключ, който активираш в сайта (стъпка 3).

1. В „Моят профил → Лицензи“ натисни „Освободи“ до стария сайт (или в стария сайт: Viva Tools → Лицензи → „Деактивирай за този сайт“).
2. Активирай същия ключ в новия сайт.

Настройките можеш да пренесеш с „Експорт всички настройки“ от стария сайт и „Импорт всички настройки“ в новия (виж 6. Настройки).

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

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

След подновяване всичко тръгва веднага – ключът и настройките остават същите.

Провери по ред:

1. Методът е добавен в зона за доставка, която съдържа държавата на клиента (стъпка 5). Българските куриери се показват само за България, EUShipments – само за други държави.
2. Във vivatools.pro за куриера е отметнато „Активирай интеграцията“ и поне един тип доставка.
3. Въведени са данните за достъп и „Тествай връзката“ минава.
4. Номенклатурата е обновена – в таблицата „Номенклатури“ има дата и записи.
5. Лицензът е активен.

Провери дали за избрания куриер е отметнато „Разреши наложен платеж за този куриер“ и дали методът „Наложен платеж“ е включен в WooCommerce → Настройки → Плащания.

• Влез в профила, с който е купен лицензът.
• Бутонът „Настройки“ се показва само при активен лиценз и активиран сайт.
• Сайтът ти трябва да е достъпен по HTTPS – настройките се зареждат директно от него.

Провери папката „Спам“. Ключът е винаги и в „Моят профил → Лицензи“. Ако нямаш достъп до профила, използвай „Изгубена парола?“ на страницата за вход или ни пиши.