BG BG Courier Checkout

Имате въпрос за плъгина?

Изпрати запитване
Практическо ръководство

Настройка на Спиди, Еконт, BOX NOW и Pigeon Express в WooCommerce

От инсталацията и checkout до цените, плащането, товарителниците, етикетите, визията и лиценза. Безплатен план и Premium.

Актуализирано: 12.10.2026

01

Подготовка

Какво Ви е необходимо

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

Система

  • WordPress 7.0 или по-нова версия.
  • WooCommerce 9.0 или по-нова версия.
  • PHP 8.3 или по-нова съвместима версия.
  • Магазин с доставки в България.
  • Поддържа се специализираното съхранение на поръчки (HPOS).

Куриерски профили

  • Собствен API достъп за всеки използван куриер: Спиди, Еконт, BOX NOW, Pigeon Express.
  • Договорни услуги, съобразени с Вашия начин на работа.
  • Данни за подател и локация за изпращане.
  • Активен лиценз за функциите на Premium.

Checkout-ът е базиран на класическата WooCommerce форма със shortcode [woocommerce_checkout] или на уиджета BGCC Checkout за Elementor. WooCommerce Checkout Block не се поддържа.

02

Планове

Безплатен план и Premium

Безплатният план дава удобния куриерски checkout с четирите куриера. Premium добавя управлението на пратките и персонализацията, за един магазин, за една година.

Безплатен план (0 €, без срок)

  • Спиди, Еконт, BOX NOW и Pigeon Express в общ интерфейс.
  • Избор на адрес, офис или автомат според куриера.
  • Търсене, карти и близки локации според интеграцията.
  • Цени за доставка и индивидуални ценови правила.
  • Предварителни цени и прогрес към безплатна доставка.
  • Настройки за плащане по куриер.
  • Автоматична подготовка при инсталиране и BGCC Status.

Premium (150 € на година за един магазин)

  • Единично и масово генериране на товарителници.
  • PDF етикети, ZPL за Pigeon Express и общ архив с етикети.
  • Анулиране според възможностите на куриера.
  • Проследяване от поръчката и обща справка за пратките.
  • Автоматично завършване на доставени поръчки.
  • Проверки в Nekorekten.com със собствен API ключ.
  • Готови стилове, Custom style и интеграция с Elementor.
  • Официални автоматични обновявания.

Premium може да се изпробва 30 дни без заплащане, без платежни данни и без автоматично подновяване. Куриерските услуги и таксите им се определят от договора на магазина с куриера; лицензът не включва куриерски услуги.

03

Инсталация

Заявка, изтегляне и активиране

Безплатната версия и 30-дневният тест на Premium се заявяват от сайта с кратка регистрация. След одобрение архивът е в Клиентска зона → Софтуер.

1
Заявете версия

Безплатна версия или тест на Premium; профилът и заявката се създават в една стъпка.

2
Потвърдете имейла

След одобрение от администратор файлът (и ключът при Premium) се появяват в клиентската зона.

3
Изтеглете ZIP архива

Клиентска зона → Софтуер. Не разархивирайте пакета.

4
Качете плъгина

В WordPress: Plugins → Add New → Upload Plugin, изберете ZIP файла и Install Now.

5
Активирайте

Activate Plugin, след което отворете WooCommerce → BG Courier.

При обновяване направете резервно копие и използвайте официалния пакет от клиентската зона. С активен Premium лиценз обновяванията се получават автоматично в WordPress.

04

WooCommerce

Автоматична подготовка и checkout

При активиране плъгинът подготвя отделна checkout страница, зона за България и методите за четирите куриера. Изборът коя страница да използва WooCommerce остава Ваш.

Checkout BGCCСтраница със slug checkout-bgcc и shortcode [woocommerce_checkout].
Зона БългарияСъздава се нова зона или се използва наличната зона за страната.
Куриерски методиСпиди, Еконт, BOX NOW и Pigeon Express се добавят като отделни WooCommerce методи.
1
Отворете Page setup

WooCommerce → Settings → Advanced → Page setup.

2
Изберете Checkout BGCC

Задайте страницата в полето Checkout page.

3
Проверете зоната

В WooCommerce → Settings → Shipping оставете само нужните куриерски методи.

4
Отворете BGCC Status

Вградената проверка показва WooCommerce, checkout страницата, методите в зоните, наложения платеж и активните куриери.

Методите Cash on delivery и Direct bank transfer се включват от WooCommerce → Settings → Payments, ако ще ги предлагате. Плъгинът ги показва според режима на плащане на всеки куриер.

05

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

Какво вижда клиентът

Активирайте само куриерите и начините за получаване, които реално предлагате. Всички се показват в един подреден checkout, а обобщението се обновява при всяка промяна.

Куриери и локации

  • Спиди, Еконт, BOX NOW и Pigeon Express се включват поотделно.
  • Доставка до адрес, офис или автомат според куриера.
  • Търсене на населено място, включително на латиница (например Sofia).
  • Интерактивна карта и близки локации (Спиди, Еконт, BOX NOW), когато клиентът разреши местоположение.

Удобства в checkout

  • Предварителни цени след избор на населено място.
  • Прогрес към безплатна доставка по куриер.
  • Куриер по подразбиране и тегло за продукт без собствено тегло.
  • Фирмени полета за клиент, който желае фактура.
Метод за плащане на поръчкатаКакво вижда клиентът
С наложен платежНаложеният платеж и останалите активни методи на магазина.
Без наложен платежСамо останалите активни методи.
Банков преводСамо банковият превод на WooCommerce.
С касов бон от магазина (BOX NOW)Наложен платеж, при който магазинът издава и прилага бона.

Режимът се задава отделно за всеки куриер, така че например BOX NOW може да е само с банков превод, а Спиди и Еконт с наложен платеж. Плъгинът не издава касови бележки и не потвърждава автоматично постъпването на банков превод.

Сравнение на четирите интеграции

ВъзможностСпидиЕконтBOX NOWPigeon Express
Доставка до адрес✓✓×✓
Доставка до офис✓✓×✓
Доставка до автомат✓✓✓✓
Търсене на населено място и локация✓✓✓✓
Интерактивна карта за избор✓✓✓×
Автоматична локализация и близки локации✓✓✓×
Цена, изчислена от куриера✓✓×✓
Фиксирана цена за клиента✓✓✓✓
Максимална цена за клиента✓✓×✓
Безплатна доставка над зададена сума✓✓✓✓
Цена по теглови диапазони или клетки××✓×
Предварителни цени в checkout✓✓✓✓
Наложен платеж по артикули без касов бон✓✓××
Самостоятелен режим „Банков превод“✓✓✓✓
Преглед или тест преди плащане✓✓×✓
Обявена стойност✓✓×✓
Настройки за връщане✓✓✓✓
Return Voucher✓×××
Колет, палет и карго към поръчката×✓××
Автоматично определяне на клетки××✓×
PDF етикети✓✓✓✓
ZPL етикети×××✓
Единично и масово създаване на товарителници✓✓✓✓
Анулиране и проследяване✓✓✓✓
Автоматично завършване след доставка✓✓✓✓
06

Спиди

Спиди за WooCommerce

Въведете API потребител и парола и използвайте Провери връзката. Наличните обекти, офиси и договорни възможности се зареждат според профила.

СпидиПодател, пратка и услуги
  1. Обект на подателя и офис за предаване на пратките.
  2. Предпочитана услуга или автоматичен избор на най-евтината приложима.
  3. Пакет: стандартен, със зададени размери, от продуктите или отделен за всяка бройка.
  4. Тегло от продуктите с резервна стойност или строг режим.
  5. Обявена стойност, чуплива пратка, бележка и референция към товарителницата.
  6. Без преглед, Отвори или Тествай; Return Voucher с платец и срок.

Цена към клиента

Цена от Спиди, фиксирана цена, максимална цена за клиента и безплатна доставка над праг. Правилата не променят тарифата, която Спиди фактурира по договора.

Касов бон с наложен платеж по артикули

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

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

07

Еконт

Еконт за WooCommerce

Започнете в Demo среда, а за реални пратки преминете към Live. След проверката на връзката изберете точния клиентски профил и офис за изпращане.

ЕконтПрофил, пратка и известяване
  1. Demo или Live среда, API потребител и парола.
  2. Клиентски профил при акаунт с повече от един профил.
  3. Стандартен пакет (до 60 см), размери от продуктите или отделни пакети.
  4. Тежки и специални пратки към конкретната поръчка: колет, палет или карго.
  5. Плащане към Еконт при предаване или отложено по договор.
  6. Имейл известяване; SMS изключено, само за автомати или за всички пратки.

Цена към клиента

Цена от Еконт, фиксирана цена, максимална цена за клиента и безплатна доставка над праг. SMS известяването е услуга на Еконт и може да участва в изчислената цена.

Онлайн продажби без касов апарат

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

Прегледът и тестът не се изпращат за автомати, локъри, Econt Drive и карго. След смяна на средата, данните за достъп или клиентския профил проверете връзката отново.

08

BOX NOW

BOX NOW за WooCommerce

Изберете Staging за тестове или Production за реална работа. Въведете Client ID, Client Secret и Partner ID, проверете връзката и посочете локацията за изпращане.

BOX NOWАвтомати и клетки
  1. Избор на автомат от списък, от официалната карта или от петте най-близки.
  2. Автоматично определяне на размер и брой клетки от продуктите.
  3. Размер по подразбиране или скриване на BOX NOW при продукт без размери.
  4. Максимален брой клетки за една поръчка.
  5. Контакти на подателя, PDF етикет по имейл и префикс към заявките.
  6. Разрешаване на връщане според услугата на BOX NOW.
Фиксирана ценаЕдна цена за цялата поръчка.
Цена според теглотоСобствени диапазони с горна граница и цена.
Цена според клеткитеОтделна цена за малка, средна и голяма клетка; при няколко клетки се събират.

BOX NOW не връща checkout цена, затова тя се определя от магазина; може да добавите безплатна доставка над праг или винаги. Една клетка приема до 20 kg и до 60 × 45 × 36 cm; единичен продукт извън тези граници прави BOX NOW недостъпен за количката.

09

Pigeon Express

Pigeon Express за WooCommerce

Отделните Sandbox и Live настройки позволяват конфигурацията да се изпита с тестови данни преди реални пратки. Връзката, подателят, цените, плащането и услугите са в отделни карти.

Pigeon ExpressДоставка и услуги
  1. Доставка до адрес, офис и автомат, всяка включвана поотделно.
  2. Офис или адрес на подателя, тегло и размери по подразбиране.
  3. Преглед или преглед и тест като отделни режими.
  4. Обявена стойност според стоките.
  5. Електронна или хартиена обратна разписка и обратни документи.
  6. Проверка на самоличност и подпис, връщане за сметка на подателя.

Цена и плащане

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

Етикети

PDF 100 × 90 mm, PDF 100 × 150 mm, A4 PDF и ZPL 300 DPI за етикетен принтер. По желание съдържанието на пратката не се отпечатва върху етикета.

Автомати се показват, когато Pigeon Express предоставя подходящи локации за избраното населено място.

10

Поръчки Premium

Товарителници, етикети и проследяване

Товарителницата се създава от WooCommerce поръчката, след като проверите данните. Така финалният контрол остава при екипа на магазина.

1
Проверете поръчката

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

2
Запазете корекциите

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

3
Създайте товарителницата

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

4
Изтеглете етикета

PDF (или ZPL при Pigeon Express) и връзка към официалното проследяване.

Масово генериране

Изберете поръчки от списъка в WooCommerce. Отделният екран показва куриера, доставката, теглото и готовността; поръчките с товарителница се пропускат, а етикетите се изтеглят в общ архив.

Анулиране

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

Проследяване

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

Автоматично завършване

По желание: подходящите поръчки се завършват след потвърдена доставка от куриера.

КуриерФормати на етикета
СпидиPDF A6; четири A6 етикета върху A4; копие за подателя при A4.
ЕконтPDF документ от поръчката.
BOX NOWPDF етикет; при няколко клетки общ PDF с всички етикети.
Pigeon ExpressPDF 100 × 90, PDF 100 × 150, A4 PDF, ZPL 300 DPI.

Nekorekten.com: по желание и със собствен API ключ, наличните сигнали се показват към поръчките със статус „Обработва се“. Интеграцията не отказва поръчки автоматично. Промяна на куриерските данни от поръчката не преизчислява начислената в checkout доставка.

11

Визия Premium

Стилове и Elementor

Checkout страницата може да следва цветовете, типографията и характера на магазина. Настройките са в таб Стил.

Готови стилове и Custom style

  • По подразбиране, Изумруд, Графит и Виолетов с един избор.
  • Цветове, текстове, фонове, рамки и акценти.
  • Шрифт на темата или избор от наличните; мащаб на текста по колони.
  • Ширина, пропорции на колоните, отстояния, заобляне, сенки и височина на полетата.

Уиджет BGCC Checkout за Elementor

  • Включва се от таб Стил.
  • Поставя checkout-а в Elementor страница.
  • Ширина, колони, цветове, шрифт и подробна типография в редактора.
  • Elementor Pro не е задължителен.

При тема като Astra, Divi или Woodmart съчетанието с конкретния шаблон и останалите разширения се проверява като част от настройката на магазина.

12

Лиценз

Активиране и управление на лиценза

Лицензният ключ (тестов или годишен) се предоставя в клиентската зона и се активира за конкретната WordPress инсталация.

1
Копирайте ключа

Клиентска зона → Услуги.

2
Отворете License

WooCommerce → BG Courier → License.

3
Активирайте

Поставете ключа и натиснете „Активирай“.

Функции с лиценз

Товарителниците, етикетите, проследяването, автоматичното завършване, Nekorekten.com, стиловете и Elementor изискват активен лиценз (тестов или годишен).

Преместване на магазина

Първо освободете старата инсталация от таб License или от клиентската зона, след което активирайте ключа на новия адрес.

13

Финална проверка

Тест преди реални поръчки

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

Проверете настройките

  • Checkout BGCC е избрана в Page setup.
  • В зона България няма дублирани куриерски методи.
  • Проверката на връзката е успешна за всеки активен куриер.
  • Режимът на плащане е зададен за всеки куриер.
  • BGCC Status не показва предупреждения.

Направете тестова поръчка

  • Адрес, офис и автомат според активните куриери.
  • Показаната цена отговаря на избраното правило.
  • Данните в поръчката са верни преди товарителницата.
  • Етикетът се създава в тестова среда (Demo, Staging, Sandbox).

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

Ръководство за изтеглянеСъщите инструкции в удобен PDF формат за преглед и печат.
Изтеглете PDF
Viber