# Symelo Bulgarian Shipping for WooCommerce: ръководство за потребителя

URL: https://dev.symelo.com/bg/tools/wordpress-plugins/symelo-bulgarian-shipping-for-woocommerce/docs/user-guide

Speedy, Econt, Pigeon Express и BOX NOW за WooCommerce: доставка до офис, автомат или адрес с актуални цени, товарителници, проследяване и месечния файл за НАП.

Версия 1.0.0. Speedy, Econt, Pigeon Express и BOX NOW за WooCommerce.

## 1. Настройване на куриер

1. Отворете **WooCommerce → Доставка в България → Куриери** и изберете куриера.
2. Отметнете **Предлагай този куриер**, въведете API профила и щракнете върху **Запази**. Връзката се проверява веднага; намерените профили на подателя, договори и складове се показват в полетата за подателя.
3. Попълнете **Подател**: кой изпраща (клиент или профил), дали предавате пратките в офис (изберете го) или куриерът ги взема от вашия адрес, и телефон за контакт.
4. Проверете **Стойности по подразбиране за товарителниците**: услуга, размер на етикета, споразумение за наложен платеж, опции като SMS.

Населените места, офисите и автоматите се изтеглят във фонов режим (за минута-две) и се обновяват всеки ден. С **Обнови сега** ги обновявате при нужда.

Откъде да получите API профил:

| Куриер | Профил | Тестова среда |
|---|---|---|
| Speedy | Пишете на api.registration@speedy.bg и посочете номера на договора си | Няма публична; Speedy предоставя тестови профили при поискване |
| Econt | Данните ви за вход в e-Econt (ee.econt.com) | Изберете **Тестова (демо)**; Econt публикува демо профил (`iasp-dev` / `1Asp-dev`) |
| Pigeon Express | Поискайте API ключове от support@pigeonexpress.com | Ключове за sandbox среда при поискване |
| BOX NOW | Client ID и secret от integrationsupport@boxnow.bg | Ключове за stage среда при поискване |

## 2. Показване на опциите за доставка на страницата за плащане

Щракнете върху **Добавяне към зона за България** (раздел „Общ преглед“ или „Страница за плащане“): бутонът създава зоната, ако е необходимо, и добавя опциите на всеки свързан куриер. След това отворете **WooCommerce → Настройки → Доставка → България** и редактирайте всяка опция:

- **Заглавие**, което се показва на страницата за плащане, напр. „Доставка до офис на Speedy“.
- **Показване** (за опциите с офис): офиси и автомати, само офиси или само автомати. Добавете опцията два пъти, ако искате да предлагате офисите и автоматите поотделно.
- **Цена**: цената на куриера (изчислена в реално време за избрания офис или адрес), фиксирана цена, таблица по тегло (редове от вида „2 = 4.50“) или безплатна. **Корекция на цената** добавя сума или процент; **Закръгляне на цената** я закръгля нагоре.
- **Клиентът плаща доставката**: с поръчката или на куриера при доставка (страницата за плащане показва очакваната цена, а в товарителницата е посочено, че плаща получателят).
- **Безплатна при поръчка от**, **Купони за безплатна доставка**, **Скриване над (кг)**, **Скриване при поръчка над**.
- **Цените са с ДДС**: куриерите дават цените си с ДДС; когато данъците в WooCommerce са включени, ДДС се приспада, така че клиентът плаща същата обща сума.

## 3. Какво виждат клиентите

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

Адресните полета, които изборът прави излишни, се скриват, а офисът или адресът става адрес за доставка на поръчката. Завръщащите се клиенти виждат отново последния си избор.

Настройки в раздела **Страница за плащане**: скриване на адресните полета, адресна форма, проверка на телефона, карта (OpenStreetMap или ваш доставчик на плочки, или картата на самия куриер), външен вид (като полетата на темата или заоблени полета), акцентен цвят и лога. За още промени добавете CSS в **Външен вид → Персонализиране → Допълнителен CSS**, например:

```css
.symelo-shipping, .symelo-modal { --symelo-shipping-accent: #c2185b; --symelo-shipping-radius: 0; }
```

## 4. Товарителници

- **Екранът на поръчката → панел „Доставка в България“**: при нужда сменете офиса или адреса, проверете цената, коригирайте колетите, теглото, наложения платеж, обявената стойност, кой плаща и „преглед/тест преди плащане“, след което щракнете **Създай товарителница**. Оттам отпечатвате етикета (A4 или A6), обновявате проследяването, създавате товарителница за връщане или анулирате товарителницата.
- **Списъкът с поръчки**: групови действия **Създаване на товарителници**, **Отпечатване на етикети за доставка** (няколко етикета идват в един PDF) и **Обновяване на проследяването на пратките**. Колоната **Пратка** показва товарителницата и статуса ѝ.
- Раздел **Пратки**: всички товарителници с филтри (куриер, статус, „Изискват внимание“, дати) и групово отпечатване на етикети, проследяване, заявки за куриер и анулиране.
- **Автоматични товарителници** (Товарителници и автоматизация): когато поръчката премине в статус „Обработва се“, „Задържана“ или „Завършена“, за всички или само за някои куриери. Неуспехите се отбелязват в поръчката и се изпращат по имейл.

Наложеният платеж е общата сума на поръчката за поръчките, платени с методите на плащане, които сте отбелязали като наложен платеж (Товарителници и автоматизация → Товарителници).

### Печат на товарителници

**WooCommerce → Печат на товарителници** (също и раздел в „Доставка в България“) показва етикетите за печат:

- **За печат**: товарителниците, които още не са отпечатани и не са взети от куриера (последните 30 дни). **Отпечатани**: вече отпечатаните, като последно отпечатаните са най-отгоре, с часа и с това кой ги е отпечатал.
- Броячи най-отгоре: товарителници и колети за печат, чакащите от предишни дни, отпечатаните днес, създадените днес. Филтри: куриер, вид доставка, пратки или връщания, дати, номер на товарителница или поръчка.
- **Печат** под дадена товарителница отпечатва само нея. Изберете няколко (или всички) и натиснете **Отпечатай избраните**: етикетите от всички куриери идват в един PDF в нов прозорец, като напредъкът се показва, докато се изтеглят. Под списъка виждате колко товарителници и колети са избрани и сумата на наложения им платеж.
- Отпечатаните товарителници се отбелязват като отпечатани и излизат от **За печат**. Можете да ги отбележите и ръчно с **Отбележи като отпечатана** / **Отбележи като неотпечатана** или с **Отбележи всички като отпечатани** за целия списък.
- **Опис на пратките**: страница, която куриерът да подпише, по един лист за всеки куриер, с товарителниците, получателите, колетите, наложения платеж и общите суми.
- **Размер на етикета**: според настройката на всеки куриер или A4 / A6 за този печат.

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

## 5. Проследяване, статуси и известия

По подразбиране пратките се проследяват на всеки два часа (BOX NOW може и сам да изпраща обновления: изпратете на поддръжката на BOX NOW адреса на webhook, показан на страницата с настройките му). Клиентът вижда статуса и историята на страницата на поръчката си и получава линка за проследяване в имейлите на WooCommerce, както и имейлите **Поръчката е изпратена** и (по избор) **Пратката е готова за получаване** (WooCommerce → Настройки → Имейли).

Статусите на поръчките могат да следват пратката: при създаване на товарителницата, при доставка, отказ или връщане, с допълнителни статуси „Изпратена“, „Доставена“ и „Върната“ по избор.

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

**Изплащанията на наложен платеж** (Speedy, Econt, Pigeon Express) се съпоставят с пратките всеки ден и се отбелязват в поръчките.

## 6. Месечен файл за НАП

За онлайн магазини, които регистрират плащанията с карта и другите безкасови плащания с „документ за регистриране на продажба“ (Наредба Н-18, чл. 3, ал. 17):

1. Раздел **Отчет за НАП**: отметнете **Модул за НАП**, въведете ЕИК, номера на електронния магазин от НАП, уеб адреса точно както е регистриран и данните на продавача за документа.
2. В **Методи на плащане** задайте на всеки метод на плащане, който трябва да влезе във файла, неговия код (1 банков превод, 2 карта през виртуален ПОС терминал с номера на терминала, 4 доставчик на платежни услуги с неговия идентификатор…) и начина, по който се възстановяват сумите. Методите без код не се включват (обикновено това е наложеният платеж).
3. След това всяка платена поръчка получава 10-цифрен номер на документ, а имейлите за поръчката и страницата на поръчката на клиента показват документа с QR кода му.
4. Преди 15-о число на всеки месец: изберете месеца, натиснете **Преглед** (поръчки, възстановени суми, всичко пропуснато и проверка спрямо официалната схема на НАП), след това **Изтегли XML файла** и го качете в електронните услуги на НАП („Подаване на стандартизиран одиторски файл от лице по чл. 3, ал. 17“). От 1-во до 15-о число се показва напомняне, докато файлът не бъде изтеглен.

От януари 2026 г. сумите са в евро. Файлът се създава на вашия сървър.

## 7. Дневник и отстраняване на проблеми

- Раздел **Дневник**: всяка заявка към куриера и отговорът му, със съобщението за грешка на самия куриер (паролите и ключовете са маскирани; етикетите не се съхраняват). Колко да се записва и за колко време избирате в Товарителници и автоматизация → Дневник и данни.
- Раздел **Поддръжка**: системна информация, която да поставите в имейл до поддръжката.
- Фоновите задачи (списъци с локации, проследяване, автоматични товарителници) се изпълняват чрез Action Scheduler на WooCommerce: WooCommerce → Статус → Планирани действия, група `symelo-shipping`.

## 8. За разработчици

Вижте `readme.txt` (хукове, REST API, WP-CLI) и `docs/architecture.md`.

## Plugin

- [Symelo Bulgarian Shipping for WooCommerce](https://dev.symelo.com/bg/tools/wordpress-plugins/symelo-bulgarian-shipping-for-woocommerce)
- [Markdown source](https://dev.symelo.com/wordpress-plugins/symelo-bulgarian-shipping-for-woocommerce/1.0.0/bg/docs/user-guide.md)

## Related pages

- [All tools](https://dev.symelo.com/bg/tools)
- [Agent documentation](https://dev.symelo.com/llms.txt)