Баш подаръкът за бизнеса (Този път е код, и то какъв!)

Заглавие: Честита Коледа с Bash Inv: Първата „Баш“ (Истинска) Open Source система за електронно фактуриране в България

Подзаглавие: Java 21, React, UBL 2.1 и VIES интеграция – напълно безплатно и отворено за всички.

Забележка: Демото е на друг софтуер не е ъпдейтван много време.. Ще се потрудите да си го дигнете, аз не продавам SAS услуга да ви правя демо , да ви се натягам да го ползвате. Софтуера е добър заслужава си да го пробвате на контейнери с AI става бързо.

Въведение: Когато „Направи си сам“ срещне Enterprise качеството

В българския IT и бизнес свят от години зейна огромна дупка. Имаме платени счетоводни софтуери, които изглеждат като правени през 90-те, и имаме модерни SaaS платформи, които обаче държат данните ни „заложници“ срещу месечен абонамент. Липсваше нещо по средата. Липсваше нещо, което да е наше, да е модерно и да е отворено.

Тази Коледа, подаръкът ми към общността е решение на този проблем.

Представям ви Bash Inv (Bash Web Electronic Invoicing) – модерна, пълнофункционална система, която отговаря на въпроса: „Как би изглеждало фактурирането, ако беше писано от програмисти за програмисти (и техните счетоводители)?“

Това не е просто скрипт. Това е Баш Инструментът.

👉 GitHub Repository: https://github.com/katehonz/bash-inv-open

Какво е Bash Inv?

Bash Inv е open-source система за управление на електронни документи, проектирана специално за българския пазар, но с глобална визия.

Името не е случайно. В българския диалект думата „баш“ (от тур. baş) означава „точното“, „главното“, „истинското“.

Това е Баш решението, защото е без скрити такси.
Това е Баш технологията, защото ползва Java 21 и React 18.
Това е Баш съвместимостта, защото говори езика на НАП и на Европа (Peppol/UBL).

Технологичен „Двигател“: Под капака на шейната

За разлика от масовите PHP-базирани решения, тук заложихме на тежката артилерия, която гарантира стабилност за години напред.

Backend: Java 21 & Spring Boot 3

Сърцето на системата е написано на Java 21 – последната LTS (Long Term Support) версия. Използваме Spring Boot 3.x рамката, което осигурява enterprise сигурност и мащабируемост.

API: Комуникацията не е със стария REST, а чрез Spring for GraphQL. Това дава гъвкавост на фронтенда да иска точно данните, които му трябват.
Database: PostgreSQL 15+ за надеждно съхранение на транзакциите.
Security: Role-based access control (RBAC) с JWT токени. Имате роли за Супер Админ, Счетоводител и обикновен Потребител.

Frontend: React 18 & Material UI

Лицето на Bash Inv е модерно SPA (Single Page Application), изградено с React 18 и Apollo Client за GraphQL заявките. Дизайнът е изчистен и функционален, базиран на Material-UI, за да може счетоводителите да работят бързо, без да се губят в менюта.

„Killer“ Функционалностите: Защо това е подарък за милиони?

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

1. UBL 2.1 & Peppol: Готови за Европа

Светът върви към машинно-четими фактури. PDF-ите са отживелица.

Bash Inv идва с вграден генератор за UBL 2.1 XML (EN 16931 стандарт).

Какво значи това? Фактурите, издадени от тази система, могат да се импортират директно в ERP системите на вашите партньори (SAP, Oracle, Microsoft Dynamics) без човешка намеса.
Peppol Ready: Системата поддържа BIS Billing 3.0, което ви прави съвместими с европейската мрежа за електронен обмен на документи.

2. VIES Интеграция: Край на грешните данни

Това е може би най-ценната функция за всеки, който работи с клиенти от ЕС.

Bash Inv е единствената (по мои данни) безплатна система, която има пълна интеграция с VIES (VAT Information Exchange System).

Магията: Въвеждате ДДС номера на клиента от Германия или Франция, и системата автоматично попълва името, адреса и данните му. Без грешки, без копи-пейст.

3. Готовност за Еврозоната (2026)

Ние мислим в перспектива. Системата е проектирана с многовалутна архитектура и е готова за момента, в който България приеме еврото (01.01.2026). Тя поддържа автоматични курсове от БНБ и ЕЦБ и може да превключва основната валута без сътресения.

4. Пълна Българска Валидация

Тъй като е правена от българска фирма (Информейт ЕООД), системата познава нашето законодателство:

Валидира ЕИК и ДДС номера.
Следи за последователността на номерата на фактурите.
Генерира документи, които счетоводителите ви ще признаят без възражения.

Как да си разопаковате подаръка?

Най-хубавото на Open Source е свободата. Можете да инсталирате Bash Inv на ваш собствен сървър (VPS) и да имате пълен контрол над данните си.

Бърз старт в 3 стъпки:

Всичко, от което се нуждаете, е Java 21, Node.js и PostgreSQL.

Създайте базата:Bashcreatedb sp-inv-app
Настройте: Редактирайте application.properties с вашите данни.
Стартирайте:Bash./start.sh И готово! Имате работещ Backend на порт 8080 и Frontend на порт 3000.

За по-сериозни внедрявания, в папката docs-bg/ има детайлно ръководство за Deployment на VPS, настройка на Caddy (за SSL) и автоматични бекъпи към S3 (Hetzner).

Защо го правя?

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

Bash Inv е под лиценз MIT. Това означава:

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

Това е моят начин да кажа „Благодаря“ на общността и да помогна на малкия и среден бизнес да бъде по-дигитален, по-европейски и по-ефективен.

Весели празници и успешно фактуриране!

Нека сметките ви винаги излизат, а сървърите ви никога да не спират!