Напомняния за такси: учтиви, по график, с човек
Всеки месец някой забравя да плати таксата, а домоуправителят губи часове да проверява, да звъни и да пише. Тук строим малък помощник, който сам напомня учтиво и по график от първия до тридесетия ден след срока, пази работните дни и празниците и никога не ескалира сам — това решава човек. Лични данни и суми остават на твоя сървър.
Decimal; проверка на IBAN; основание за превод само с латински букви; предложение за съпоставяне на плащане без автоматично осчетоводяване; правна бележка за основание, съгласие и ЗЕС; измислени данни, показан реален изход и тест.
01Какво ще научиш
- Как изглежда учтив график D+1, D+7, D+14, D+30 и защо последното ниво е за човек.
- Как да смяташ „следващ работен ден“ и да не пишеш в събота и на празник.
- Как да правиш напомнянето от фиксиран шаблон, а не от модел, който може да сбърка сума.
- Кога напомняне не се праща: платено, спор, отказ, липса на основание.
- Как да пазиш пари като
Decimalв EUR и да проверяваш IBAN. - Какво да питаш юриста за основанието за e-mail и SMS.
02Преди да започнеш
- Python 3.10 или по-нов и терминал. Ядрото няма външни пакети и не иска видеокарта.
- Списък с такси: апартамент, краен срок, сума в EUR. В урока са измислени.
- За всеки получател — записано основание (договор, решение на собствениците или съгласие) и канал (e-mail, SMS). Без запис — без автоматично напомняне.
- PostgreSQL и n8n за реалното свързване — виж Обучение 7 · Schedules и Cron jobs.
- Правило: реални имена, телефони и сметки не влизат в код, примери, логове и чатове.
| Ниво | Кога | Тон и канал | Кой решава |
|---|---|---|---|
| 1 | D+1 | Меко напомняне, с „ако вече сте платили, игнорирайте“. E-mail или кратък SMS | Автоматично |
| 2 | D+7 | Сума, срок и телефон за въпроси | Автоматично |
| 3 | D+14 | Пак учтиво; предлага разговор, ако има затруднение | Автоматично |
| 4 | D+30 | Не се праща. Става задача за домоуправителя | Човек |
03Стъпки
-
Идеята в четири реда
(1) Всеки ден в работен ден кодът гледа всички неплатени такси. (2) За всяка пита: падна ли ден за ниво, което още не е изпратено? (3) Спира, ако е платено, има спор, отказ или няма основание. (4) Нива 1–3 стават готови съобщения от шаблон; ниво 4 става задача за човек. Всичко се записва, за да не се изпрати два пъти.
-
Схема на данните
Три таблици: хора (с отбелязано основание по канал, отказ и спор), такси (в EUR) и дневник на напомнянията. Ограничението
UNIQUE (fee_id, level)не позволява едно ниво да се изпрати два пъти.sql · не е пускано от нас ⚠️CREATE TABLE residents ( id SERIAL PRIMARY KEY, building VARCHAR(20) NOT NULL, apt VARCHAR(10) NOT NULL, full_name VARCHAR(100) NOT NULL, email VARCHAR(100), phone VARCHAR(20), email_ok_at TIMESTAMPTZ, -- кога и на какво основание е записано за e-mail sms_ok_at TIMESTAMPTZ, -- същото за SMS opted_out_at TIMESTAMPTZ, -- човекът е поискал да не получава dispute BOOLEAN NOT NULL DEFAULT FALSE ); CREATE TABLE fees ( id SERIAL PRIMARY KEY, resident_id INTEGER REFERENCES residents(id), period CHAR(6) NOT NULL, -- 202610 due_date DATE NOT NULL, amount_eur NUMERIC(10,2) NOT NULL, paid_eur NUMERIC(10,2) NOT NULL DEFAULT 0 ); CREATE TABLE reminder_log ( id SERIAL PRIMARY KEY, fee_id INTEGER REFERENCES fees(id), level SMALLINT NOT NULL CHECK (level BETWEEN 1 AND 4), channel VARCHAR(10) CHECK (channel IN ('email','sms')), status VARCHAR(20) NOT NULL CHECK (status IN ('ready','sent','skipped','needs_human','done')), sent_at TIMESTAMPTZ, UNIQUE (fee_id, level) ); -
График, нива и шаблони
Защо работни дни: D+7 може да падне в неделя, а D+30 — в събота. Ден за ниво
Lе следващият работен ден след „срок + отместване“. Списъкът с празниците за 2026 е същият като в Обучение 7 на n8n (сверен там; проверявай го всяка година, а неприсъствените дни, обявени допълнително, добавяй ръчно). Защо най-високото неизпратено ниво: ако системата е била спряна, не искаме три съобщения накуп — изпращаме най-късното дължимо, а по-ранните се прескачат. Защо шаблон: сумата и срокът идват от базата, не от модел.python · reminders.pyfrom dataclasses import dataclass, field from datetime import date, timedelta from decimal import Decimal CENT = Decimal("0.01") OFFSETS = {1: 1, 2: 7, 3: 14, 4: 30} # ниво -> дни след крайния срок # Официални почивни дни 2026 - същият списък като в n8n · Обучение 7 HOLIDAYS = {date.fromisoformat(d) for d in ( "2026-01-01", "2026-03-03", "2026-04-10", "2026-04-13", "2026-05-01", "2026-05-06", "2026-05-25", "2026-09-07", "2026-09-22", "2026-12-24", "2026-12-25", "2026-12-28")} def is_workday(d, holidays=HOLIDAYS): return d.weekday() < 5 and d not in holidays def next_workday(d, holidays=HOLIDAYS): while not is_workday(d, holidays): d += timedelta(days=1) return d @dataclass class Fee: apt: str due: date amount: Decimal # EUR paid: Decimal = Decimal("0") sent_levels: set = field(default_factory=set) consent: bool = False # записано основание/съгласие за канала opted_out: bool = False disputed: bool = False def level_due(fee, today, holidays=HOLIDAYS): """Кое ниво е дължимо днес (или None). Най-високото неизпратено; ако системата е била спряла, по-ниските се прескачат, а не се изпращат накуп.""" if not is_workday(today, holidays): return None if fee.paid >= fee.amount or fee.opted_out or fee.disputed or not fee.consent: return None due_levels = [lv for lv, off in OFFSETS.items() if next_workday(fee.due + timedelta(days=off), holidays) <= today and lv not in fee.sent_levels] if not due_levels: return None lv = max(due_levels) # същият ден не пращаме две нива; ако е бил изпратен по-висок - нищо if fee.sent_levels and max(fee.sent_levels) > lv: return None return lv def balance(fee): return (fee.amount - fee.paid).quantize(CENT) TEXT = { 1: "Здравейте! Напомняне за такса {month} за ап. {apt}: {bal} EUR. Ако вече сте платили, игнорирайте съобщението. Домоуправител Пример", 2: "Здравейте! Таксата за ап. {apt} ({month}) още не е постъпила: {bal} EUR до {deadline}. Въпроси: {phone}. Домоуправител Пример", 3: "Здравейте! Таксата за ап. {apt} ({month}) остава неплатена: {bal} EUR. Ако имате затруднение, обадете се на {phone} и ще се разберем. Домоуправител Пример", } def draft(fee, level, month, phone="<тел. на домоуправителя>", today=None): if level == 4: # не се изпраща автоматично return {"apt": fee.apt, "level": 4, "status": "needs_human", "note": f"{balance(fee)} EUR неплатени 30 дни след срока - домоуправителят решава как да продължи"} deadline = (today + timedelta(days=7)).strftime("%d.%m.%Y") if today else "" t = TEXT[level].format(month=month, apt=fee.apt, bal=f"{balance(fee):.2f}".replace(".", ","), deadline=deadline, phone=phone) return {"apt": fee.apt, "level": level, "status": "ready", "text": t} def iban_ok(iban): s = iban.replace(" ", "").upper() if not (15 <= len(s) <= 34) or not s.isalnum(): return False r = s[4:] + s[:4] return int("".join(str(int(c, 36)) for c in r)) % 97 == 1Последната функция е проверка на IBAN по
mod 97(ISO 13616) — хваща грешно препечатана сметка, преди да я сложиш в съобщение. Библиотека катоschwifty(2026.7.3 в PyPI) прави и повече — разбира банка и държава, — но не я пускахме ⚠️.⚠️Телефонът и срокът са плейсхолдъриВ примера телефонът е<тел. на домоуправителя>и не се пише твърдо в кода. Крайният срок в ниво 2 е „днес + 7 дни“ — смени го според правилата на сградата си. -
Пусни го върху измислени данни
Четири измислени апартамента с краен срок четвъртък, 10.09.2026: ап. 12 е редовен длъжник със съгласие, ап. 13 няма записано основание, ап. 14 е платил част, ап. 15 е в спор.
python · run_demo.pyfrom reminders import * due = date(2026, 9, 10) # краен срок (измислен) fees = [Fee("12", due, Decimal("25.00"), consent=True), Fee("13", due, Decimal("25.00"), consent=False), Fee("14", due, Decimal("25.00"), paid=Decimal("10.00"), consent=True), Fee("15", due, Decimal("25.00"), consent=True, disputed=True)] for today in (date(2026, 9, 11), date(2026, 9, 17), date(2026, 10, 12)): for f in fees: lv = level_due(f, today) if lv: d = draft(f, lv, "септември", today=today) print(today, "ап.", d["apt"], "ниво", lv, d["status"]) print(iban_ok("DE89 3704 0044 0532 0130 00"), iban_ok("DE89 3704 0044 0532 0130 01"))Изходът от нашето пускане (измислени данни):
изход2026-09-11 ап. 12 ниво 1 ready 2026-09-11 ап. 14 ниво 1 ready 2026-09-17 ап. 12 ниво 2 ready 2026-09-17 ап. 14 ниво 2 ready 2026-10-12 ап. 12 ниво 4 needs_human 2026-10-12 ап. 14 ниво 4 needs_human True FalseКакво виждаме: ап. 13 (няма основание) и ап. 15 (спор) не получават нищо. D+30 е събота, 10.10.2026, затова ниво 4 е в понеделник, 12.10. Демото не записва „изпратено“, затова на 12.10 излиза направо ниво 4 — така се държи и истинският график след прекъсване. Текстът за ап. 14 при ниво 1 е с остатъка:
15,00 EUR, не с целия 25,00.✅Какво проверихме отделноНа 22.09.2026 (празник)is_workdayвръщаFalse, аnext_workday(07.09.2026)дава 08.09. Ап. без никакво изпращане до D+20 получава ниво 3 (най-високото дължимо), не три съобщения.iban_okвръщаTrueза примерния IBAN от документацията иFalse, когато смениш последната цифра. Дължини на примерните текстове: 129, 141 и 170 знака.📱SMS на кирилица е по-скъпКирилицата обикновено се изпраща в кодиране, което побира около 70 знака на съобщение, затова 129–170 знака са няколко части. По тази причина основният канал е e-mail, а SMS е кратък. Колко части и колко струват при твоя доставчик — питай го ⚠️. -
Ниво 4 е задача, не съобщение
На D+30 системата не пише нищо на човека. Тя добавя ред в дневника със статус
needs_humanи известява домоуправителя: „ап. 12 · 25,00 EUR · 30 дни след срока“. Домоуправителят се обажда, говори, може да разсрочи, да сложи въпроса на срещата на собствениците или да не прави нищо. Всичко извън тези три шаблона е негово решение. Така „ескалация“ е човешко действие, а не следствие от таймер. -
Свързване с n8n
n8n пуска графика — в работни дни в 10:00. По Обучение 7 изразът е с шест полета, а часовата зона е Европа/София:
cron · Schedule Trigger (Custom)0 0 10 * * 1-5Веригата: Schedule Trigger → Postgres (неплатени такси с хората) → логиката от
reminders.py→ If (готово за изпращане?) → Send Email или SMS шлюз → Postgres (запис вreminder_log). Часът 10:00 не пада в нощта на смяна на часовото време. Как n8n вика Python логиката (малка локална услуга или същата логика на JavaScript в Code нод) — избор на твоята среда; не сме го пускали ⚠️. Ако n8n е бил изключен в 10:00, графикът по подразбиране пропуска изпълнението; логиката по-горе ще изпрати най-високото дължимо ниво при следващото пускане. -
Основание за e-mail и SMS
Имена, e-mail и телефони са лични данни. Преди да пуснеш автоматични съобщения, запиши за всеки човек на какво основание му пишеш (поле
email_ok_at/sms_ok_at) и дай лесен отказ във всяко съобщение (в примера: „обадете се на …“). Какво да уточниш с юриста си:- Основание по общия регламент за защита на данните (GDPR), чл. 6, параграф 1: „Обработването е законосъобразно, само ако и доколкото е приложимо поне едно от следните условия: a) субектът на данните е дал съгласие за обработване на личните му данни за една или повече конкретни цели; б) обработването е необходимо за изпълнението на договор, по който субектът на данните е страна, или за предприемане на стъпки по искане на субекта на данните преди сключването на договор; в) обработването е необходимо за спазването на законово задължение, което се прилага спрямо администратора; […] е) обработването е необходимо за целите на легитимните интереси на администратора или на трета страна, освен когато пред такива интереси преимущество имат интересите или основните права и свободи на субекта на данните, които изискват защита на личните данни, по-специално когато субектът на данните е дете.“ (Регламент (ЕС) 2016/679, български текст по ОВ L 119, 4.5.2016 г., с. 1; пропуснатите букви г) и д) — жизненоважни интереси и обществен интерес — не се отнасят до такси в сграда.) Значи: съгласието е само едно от основанията. Дали за напомняне за такса основанието е б) (договор с домоуправителя или фирмата), е) (легитимен интерес да се съберат дължимите вноски) или а) (съгласие) — решава юристът ⚠️.
- Задължението да се плаща идва от закона. Закон за управление на етажната собственост (ЗУЕС), чл. 6, ал. 1: „Собствениците са длъжни да: […] 10. заплащат разходите за управлението и разходите за поддържането на общите части на сградата;“ и чл. 48, ал. 8: „За поддържане на общите части на етажната собственост собствениците, ползвателите и обитателите на самостоятелни обекти правят ежемесечни вноски в размер, определен в правилника за вътрешния ред или с решение на общото събрание.“ (обн. ДВ бр. 6 от 2009 г., последно изм. ДВ бр. 49 от 17.06.2025 г.; т. 10 — изм. ДВ бр. 82 от 2023 г., в сила от 29.09.2023 г.; текст по lex.bg към 01.10.2026). Напомнянето е за вноска, която законът и решението на общото събрание вече определят — затова то съобщава сума и срок, не налага нищо ново.
- Съгласие, ако е избраното основание: трябва да е доказуемо (запис кога и как) и да може да се оттегли лесно ⚠️.
- Закон за електронните съобщения (ЗЕС), чл. 261, ал. 1: „Осъществяването на повиквания, съобщения или електронна поща със или без човешка намеса за целите на директния маркетинг и реклама се позволяват само при предварително получено съгласие на потребителя. Съгласието може да бъде оттеглено по всяко време.“ (ал. 1 — изм. ДВ бр. 105 от 2011 г., в сила от 29.12.2011 г.; текст по lex.bg към 01.10.2026). Изискването за съгласие по тази норма е за директен маркетинг и реклама. Напомнянето за дължима такса, без рекламно съдържание, по нашето разбиране не е такова съобщение — но потвърди с юриста ⚠️ и не добавяй реклама в напомнянето.
- Мерки спрямо неплатилите (лихва, събрание на собствениците, съд) се определят от собствениците по ЗУЕС и вътрешните правила — не от автоматизацията ⚠️.
- Минимум данни и срок: държи само нужното; дневникът трий по правилата за съхранение на твоята организация.
⚖️Не сме юристиТова е подготовка за разговор с юрист, не правно становище. Текстовете на нормите по-горе са взети от първоизточник на 01.10.2026 (GDPR — българският текст в Официален вестник на ЕС; ЗУЕС и ЗЕС — lex.bg); сверявай ги с действащата редакция в деня, в който пускаш системата. Кое основание важи за твоята сграда, потвърждава юристът на етажната собственост или на фирмата. -
Когато плащането дойде: предложение, не запис
За да засичаш плащанията лесно, дай на всяка такса основание само с латински букви и цифри — много банки ограничават знаците в полето ⚠️ (питай банката си). Формат:
DP-B12-A007-202610(блок 12, апартамент 7, период октомври 2026; „DP“ е измислен префикс). По-подробното съпоставяне на банково извлечение е в 04-132. Тук — само основата:python · match.pyimport re from decimal import Decimal REF = re.compile(r"DP-B(?P<bl>\d+)-A(?P<apt>\d+)-(?P<ym>\d{6})") def make_ref(block, apt, ym): # ym: "202610" return f"DP-B{block}-A{apt:0>3}-{ym}" def match_payment(text, amount, fees): """fees: {(block, apt, ym): Decimal} дължима сума в EUR. Връща предложение, не запис.""" m = REF.search(text.upper()) if not m: return {"status": "human", "why": "няма разпознаваемо основание"} key = (m["bl"], m["apt"].lstrip("0") or "0", m["ym"]) if key not in fees: return {"status": "human", "why": "няма такава такса"} due, paid = fees[key], Decimal(amount) if paid == due: st = "proposed_paid" elif paid < due: st = "proposed_partial" else: st = "human" return {"status": st, "key": key, "diff": str(due - paid)}Проверихме:
25.00по такса25.00даваproposed_paid;10.00—proposed_partialс разлика15.00;30.00(повече) —human; „rent oct“ без основание —human. Платено се отбелязва след като човек потвърди; едва тогава напомнянията спират. -
По избор: месечно PDF извлечение
В края на месеца можеш да правиш за всеки собственик кратко извлечение с библиотеката
reportlab(5.0.1 в PyPI): такси, платено, остатък в EUR. Не сме го пускали ⚠️. Връзката към базата се взима от настройка на средата, не се пише с парола в кода, а извлечението се праща само до самия собственик. -
Езиковият модел: най-много за идеи
Съобщенията, които излизат, са от шаблона. Ако искаш да пробваш формулировки, можеш да ползваш локален модел (например
mistral:7bв Ollama — съществува, около 4,4 GB) само за чернови, които човек чете и слага в шаблона. Той не вижда сметки, не пише суми и не изпраща. Не сме го пускали за тази задача ⚠️.
04Проверка
- Скриптът
run_demo.pyдава същите шест реда иTrue False. - Апартамент без основание или със спор не получава нищо.
- Частично платена такса показва остатъка, не цялата сума.
- Ниво 4 връща
needs_humanи няма текст за изпращане. - Нито един ден за изпращане не е събота, неделя или празник.
- В кода няма
floatза пари, няма реални имена, телефони и сметки.
Тест
1. Какво прави системата на D+30?
2. Системата е била спряна 20 дни след срока. Какво изпраща при пускане?
3. Кой пише текста на съобщението?
4. Кога НЕ се праща автоматично напомняне?
05Какво следва
06Източници
- n8n · Обучение 7: Schedules и Cron jobs 🔒 локално — график, часова зона, работни дни и празници 2026.
- n8n: Schedule Trigger 🔒 локално — документация на нода.
- Python: модулът decimal · datetime — точна десетична аритметика и дати.
- IBAN: формат, примери и проверка mod 97 — откъдето е примерният IBAN в урока (не е истинска сметка).
- schwifty · reportlab · psycopg2-binary 🔒 локално — версии 2026.7.3, 5.0.1 и 2.9.13 към 01.10.2026.
- Регламент (ЕС) 2016/679 (GDPR) в EUR-Lex — чл. 6, параграф 1; цитатът е от българския текст в ОВ L 119, 4.5.2016 г. (сверен на 01.10.2026 през хранилището на Службата за публикации на ЕС).
- Закон за управление на етажната собственост (lex.bg) — чл. 6, ал. 1, т. 10 и чл. 48, ал. 8, последно изм. ДВ бр. 49 от 17.06.2025 г.
- Закон за електронните съобщения (lex.bg) — чл. 261, ал. 1 (директен маркетинг и реклама).
- mistral в Ollama 🔒 локално — по избор, само за идеи за формулировки.