Новости
2.4.1 — 2026-11-11
heading.anchorLabel2.4.1
heading.anchorLabelСпрямо 2.4.0.
Бележки
heading.anchorLabelАдаптация към Mage-OS RMA 2.5. Адаптацията на формите за нова заявка е отделно, в Webcode_RMA.
- Срокът е на EasyReturns. От 2.5 Mage-OS RMA прилага свой срок („Return Period (Days)“, 30 дни по подразбиране, броени от всяка пратка) към всяка заявка, включително създадените от тази функция. Заявките, подадени през функцията, вече следват срока, зададен в Easy Returns (последна пратка + дни за доставка + срок, следващ работен ден): срокът на Mage-OS RMA не се прилага, докато модулът създава RMA заявката. Собствените форми на Mage-OS RMA (админ, клиентски профил) пазят своя срок.
- Предупреждение в конфигурацията. Под „Withdrawal / Return Period (Days)“ излиза предупреждение, когато срокът на Mage-OS RMA е над 0 и по-къс от прозореца на функцията в редактирания scope.
- Режим „Заявка за връщане“. Ако RMA заявката не се създаде, клиентът вижда грешка и остава на формата. Досега стигаше до страницата за успех, без да получи имейл. Законовият режим е непроменен: декларация, потвърждение и грешката в
rma_error. - Един вход за отказ. Бутоните на Mage-OS RMA към неговата форма („Request Return“, от 2.5 — „Withdraw from purchase“) не се показват, където функцията е включена: в изгледа на поръчката (клиент и гост, Luma и Hyvä) и на страницата „Откази и връщания“ в профила. Списъкът със заявките и линкът към него остават.
Внимание при деплой
heading.anchorLabel- DI:
di.xmlе променен, аService\WithdrawalServiceима нов конструкторски аргумент — при деплоя се чистиgenerated/(или се пускаsetup:di:compile). Без това формата за отказ дава грешка. - Няма промяна в схемата и няма data patch.
- Изискването остава
mage-os/module-rma: ^2.4. Срещу Mage-OS RMA 2.4.x този релийз не е пускан; проверен е срещу 2.5.1. - С EasyReturns 2.4.0 и Mage-OS RMA 2.5 заявките след изтичане на срока на Mage-OS не се създават. Двата пакета се обновяват заедно.
Известни ограничения
heading.anchorLabel- Формата на Mage-OS RMA (
rma/customer/create,rma/guest/create) остава достъпна по директен адрес — скрити са входовете към нея, не самата форма. - В изгледа на поръчка на гост модулът няма свой бутон; входът там е линкът във footer-а.
- Не е правено цяло подаване през витрината с изтекъл срок на Mage-OS RMA. Проверено е с unit тестове (101) и с истинска пратка срещу Mage-OS RMA 2.5.1 на локална инсталация.
Комити (1)
heading.anchorLabela6451e1MageOS_RMA 2.5: срокът е на EasyReturns, един вход за отказ
2.4.0 — 2026-11-09
heading.anchorLabel2.4.0
heading.anchorLabelСпрямо 2.3.0.
Комити (3)
heading.anchorLabelc17c717Release 2.4.0173d3b7feat: слот и в имейла за потвърждение (easyreturns.email.items.extra)6cfcfa1feat: слот за допълнителни полета във формата за отказ (easyreturns.statement.extra)
Бележки
heading.anchorLabelДва слота за модули-мостове. За търговеца нищо видимо не се променя, докато не се инсталира мост.
easyreturns.statement.extra(aliasextra): контейнер в блока на декларацията. Рендерира се в Luma и в Hyvä формата преди бележката и бутона „Потвърждавам отказа“.easyreturns.email.items.extra(aliasextra): контейнер в блока с артикулите на потвърждението за получаване. Нужен е, защото{{layout}}рендерира само първия коренов блок на handle-а. Всеки блок в него получаваstatement_id.
Първият потребител е Webcode_EasyReturnsStoreCredit (клиентът избира възстановяване
в портфейла).
При деплой
heading.anchorLabelСамо шаблони и layout: cache:flush.
2.3.0 — 2026-10-15
heading.anchorLabel2.3.0
heading.anchorLabelСпрямо 2.2.0.
Новости
heading.anchorLabel- Снимка по причина — различна за всеки store view. Photo на причината (Sales → RMA → Reasons) може да има собствена стойност за всеки store view — през превключвателя на scope във формата на причината (Webcode_RMA 2.1). Формата за отказ / връщане взима изискването за снимка за текущия store view.
Изисквания
heading.anchorLabelwebcode/module-rma^2.1.
Внимание при деплой
heading.anchorLabel- DI:
di.xmlе променен — при деплоя се чистиgenerated/. - Зависимости:
requireвcomposer.json:webcode/module-rma:^2.0→^2.1.
Комити (2)
heading.anchorLabel127cd92Release 2.3.0df138dcСнимка по причина — различна за всеки store view
2.2.0 — 2026-10-14
heading.anchorLabel2.2.0
heading.anchorLabelСпрямо 2.1.0.
Новости
heading.anchorLabel- Режими — законов отказ по Директива (ЕС) 2023/2673 (ЕС/ЕИП), заявка за връщане (RMA) за държави без такъв закон, и „Автоматично“ (по подразбиране) — по държавата на магазина, за всеки website / store view.
- Неизпратени артикули (законов режим) — без RMA: поръчката се заменя чрез core „Edit Order“ — оригиналът се анулира, нова
<номер>-1носи останалото на цените от договора; пълен отказ само анулира поръчката. - Причина за всеки продукт — не се пита / по желание / задължителна (в законов режим никога задължителна); причина по подразбиране за RMA режим.
- Снимка по причина (Sales → RMA → Reasons → Photo) — пазят се като прикачени файлове на RMA заявката; задължителността се проверява и на сървъра.
- Продуктови атрибути — Can Be Returned (напр. бельо) и Return Reason Required (RMA режим).
- Визия по Webcode_RMA 1.0.1 — избор на поръчка, форма с карти, success страница с карти и история със статуса на RMA заявката (Luma и Hyvä).
Промени
heading.anchorLabel- Service contracts за декларацията (
Api\StatementRepositoryInterface,Api\Data\StatementInterface); ViewModel-и вместо Block класове; текстовете по режим презViewModel\Wording. - Артикулите в имейла през
{{layout handle="easyreturns_email_statement_items"}}. - Законовата причина и етикетите ѝ — през репозиторитата на MageOS.
- LESS в един
_module.less(без<css>тагове); Hyvämodule.css+ CSP Alpine компоненти. - Прехвърлянето на срока при почивен ден / празник — само в законов режим.
Поправки
heading.anchorLabel- Пренасочване към грешен store view след изпращане на потвърждението.
- Текущият store след замяната на поръчката.
- „Guest“ като име при поръчки от гост.
Инсталация
heading.anchorLabelbin/magento setup:upgrade — колона rma_reason.easyreturns_image и атрибутите easyreturns_returnable, easyreturns_reason_required. ⚠️ При „Автоматично“ проверете General → Country Options → Default Country (често е останала „United States“).
Внимание при деплой
heading.anchorLabel- DI:
di.xmlе променен — при деплоя се чистиgenerated/. - Схема:
db_schemaе променена —setup:upgradeпипа жива база. - Setup: data/schema patch — изпълнява се срещу жива база при
setup:upgrade. - Static: стилове/JS/шаблони във
view/*/web(илиrequirejs-config.js) са променени — при деплояsetup:static-content:deploy. - Зависимости:
requireвcomposer.json: добавенmagento/module-backend(*); добавенmagento/module-catalog(*); добавенmagento/module-config(*); добавенmagento/module-cron(*); добавенmagento/module-customer(*); добавенmagento/module-eav(*); добавенmagento/module-email(*); добавенmagento/module-quote(*); добавенmagento/module-re-captcha-frontend-ui(*); добавенmagento/module-sales(*); добавенmagento/module-store(*); добавенmagento/module-tax(*); добавенmagento/module-theme(*).
Комити (2)
heading.anchorLabel0f3cd70Release 2.2.00e7a434Режими (законов отказ / RMA / автоматично), неизпратени артикули, причина и снимки
2.1.0 — 2026-10-13
heading.anchorLabel2.1.0
heading.anchorLabelСпрямо 2.0.2.
Внимание при деплой
heading.anchorLabel- Схема:
db_schemaе променена —setup:upgradeпипа жива база. - Setup: data/schema patch — изпълнява се срещу жива база при
setup:upgrade. - Зависимости:
requireвcomposer.json: добавенmagento/module-re-captcha-admin-ui(*); добавенmagento/module-re-captcha-ui(*); добавенphp(~8.3.0||~8.4.0||~8.5.0).
Комити (2)
heading.anchorLabele16086dRelease 2.1.0589d0a9Отказ по ЗЗП чл. 52а: FPC теч, срок по закона, потвърждение с повторение, Hyvä
Бележки
heading.anchorLabel- Правна база: ЗЗП чл. 52а (ЗИД ЗЗП, ДВ бр. 87/24.09.2026) = чл. 11а CRD. Бутонът за потвърждение вече е „Потвърждавам отказа“ (ал. 4); входът остава „Откажете се от договора тук“.
- Сигурност: страниците на декларацията и потвърждението вече не се кешират — FPC сервираше декларацията на един гост на следващия посетител.
- Срок по закона: край на деня по часовата зона на магазина (дотук 23:59:59 UTC → показваше дата с един ден напред), от последната пратка + дни за доставка (ново поле, default 3), следващ работен ден при събота/неделя/официален празник (нов списък), отворен срок докато има неизпратен артикул.
- Потвърждение на траен носител: записва се
acknowledged_at; неуспешно изпращане се повтаря от cron на всеки 10 мин в продължение на седмица. Имейлът носи име, имейл, поръчка, текста на декларацията и часовата зона. - Декларацията се записва преди RMA-то — паднала RMA заявка не губи отказа
(
rma_error+ critical лог), потвърждението тръгва винаги. - Hyvä: собствени Tailwind темплейти за трите страници и footer линка.
- Български етикет на законовата причина за
bg_BGмагазини; секцията в админа е под Sales; админ етикетите са преведени. - Captcha на търсенето на поръчка за гости през reCAPTCHA framework-а на Magento (нова настройка „Enable for Withdrawal Order Lookup“ в Google reCAPTCHA Storefront; reCAPTCHA v2/v3 или Cloudflare Turnstile; празно по подразбиране). Luma и Hyvä.
При деплой
heading.anchorLabelsetup:upgrade— нови колониacknowledged_at,rma_error; патчовеAddStatutoryReasonLabel,BackfillAcknowledgedAt.- Чисти се
generated/— сменени конструктори (WithdrawalService,DeadlineService). - Hyvä магазин: rebuild на Tailwind CSS на темата (нови темплейти).
- Cron трябва да работи (
easyreturns_resend_acknowledgments). - Конфиг: провери Delivery Allowance After Shipment (default 3) и въведи Public Holidays; секцията е преместена от Webcode под Sales (стойностите са запазени — id-то не е сменено).
- Изисква PHP ≥ 8.3.
Известен проблем
heading.anchorLabel- Виртуални и downloadable артикули не минават през функцията (MageOS_RMA не ги приема).
- При включен RMA фронт на MageOS потребителят получава и имейла „нова заявка“ на MageOS.
2.0.2 — 2026-10-08
heading.anchorLabel2.0.2
heading.anchorLabelСпрямо 2.0.1.
Бележки
heading.anchorLabel- Изцяло оттеглена поръчка не се предлага повторно. Поръчка, за която вече е подадена декларация за отказ (или заявка за връщане) за всички артикули, изчезва от списъка на „Отказ от договора“, а бутонът „Откажете се от договора тук“ в изгледа ѝ не се показва. Формата показва само артикулите, които още могат да бъдат върнати.
- Артикули от тип virtual и downloadable вече не се предлагат за отказ — MageOS RMA и без това ги отхвърля при подаване, тъй че дотук формата ги показваше, а подаването им падаше.
- При опит за повторен отказ клиентът вижда разбираемо съобщение на български, веднъж. Дотук виждаше технична грешка на английски, показана два пъти („Item ID … is not eligible for return…“).
- Проверено на magento.local (Hyvä, логнат клиент): изцяло оттеглените поръчки 5000000112 и 2000000228 и изцяло върнатата 5000000110 вече не са в списъка, а поръчките с остатък за връщане са.
При деплой
heading.anchorLabel- Сменени конструктори (
Service\WithdrawalService— нова зависимостMageOS\RMA\Service\OrderEligibility;Block\Identify,Block\Order\WithdrawButton,Controller\Statement\Index) — чисти сеgenerated/иcache:flush. - Нови редове в
i18n/bg_BG.csv/en_US.csv. Без схема, без data patch, без static.
Комити (1)
heading.anchorLabel178d4b0module-easy-returns-1: изцяло оттеглена поръчка не се предлага повторно
2.0.1 — 2026-10-08
heading.anchorLabel2.0.1
heading.anchorLabelСпрямо 2.0.0.
Бележки
heading.anchorLabel- Логнат клиент вижда своите поръчки на „Отказ от договора“ (
/withdrawal). Дотук страницата се кешираше и логнатият клиент виждаше само формата за гост (номер на поръчка + имейл). Сега блокът не се кешира и показва поръчките в срока за отказ, с линк „Откажете се от договора тук“ към всяка. - Бутонът „Откажете се от договора тук“ се показва и в Hyvä. В изгледа на поръчката (My Orders → поръчка) бутонът липсваше, защото Hyvä няма контейнера
sales.order.info.buttons. Сега стои при „Print Order“ и „Request Return“, със стилbtn btn-secondary.
При деплой
heading.anchorLabel- Само layout и шаблон (
.phtml), без DI, схема или static. Стигаcache:flush. - Hyvä: класовете
btn btn-secondaryвече са в базовата тема, затова Tailwind build не е нужен заради този релийз.
Комити (1)
heading.anchorLabel5eb6a60module-easy-returns-1: отказът за логнат клиент — списък с поръчки и бутон в Hyvä
Проверено с E2E на magento.local (Luma и Hyvä; логнат клиент и гост), включително имейла за потвърждение.
2.0.0 — 2026-10-05
heading.anchorLabel2.0.0
heading.anchorLabelСпрямо 1.0.0.
Внимание при деплой
heading.anchorLabel- DI:
di.xmlе променен — при деплоя се чистиgenerated/. - Схема:
db_schemaе променена —setup:upgradeпипа жива база. - Setup: data/schema patch — изпълнява се срещу жива база при
setup:upgrade. - Зависимости:
requireвcomposer.json: добавенmage-os/module-rma(^2.4); добавенwebcode/module-base(*);webcode/module-rma:*→^2.0.
Комити (7)
heading.anchorLabel21a0680Release 2.0.02b177femodule-easy-returns-1: EasyReturns върху MageOS_RMA + Webcode_RMA 2.01153a9aci: махни изводимите ключове от .gitlab-ci.ymlebe1d42fix(i18n): български редове за коментарите в системната конфигурация1f776efCI: матрицата идва от дефолта на pipeline-а (без MATRIX в модула)bb12e75CI: свий матрицата до един лег (2.4.9)35960cdfix(ci): стандартен module pipeline (include + vars)
Бележки
heading.anchorLabelEasyReturns вече създава заявките в MageOS_RMA през RmaSubmitService, със законовата причина на заявката и на всеки артикул и resolution „Return“; заявката се свързва с профила, когато поръчката има такъв.
- Законовата причина е ред
statutory_withdrawalвrma_reason(data patch), активна, без автоматично одобрение. - Махната е настройката „Auto-Approve Withdrawal RMAs“ (
easyreturns/general/auto_approve). Автоматичното одобрение вече е превключвателят „Approve Automatically“ на причината „Withdrawal from the contract (statutory right)“ (Sales → RMA → RMA Reasons). - Fix: секцията Easy Returns в админа гърмеше с „Email template is not defined.“ — id-то на имейл шаблона не съвпадаше с конфиг пътя. Сега е
easyreturns_email_template; персонализиран шаблон, вързан към старото ideasyreturns_acknowledgment, трябва да се избере наново.
⚠️ BC-break
heading.anchorLabel- Изисква
webcode/module-rma^2.0 иmage-os/module-rma^2.4; с RMA 1.x не работи. webcode_withdrawal_statement.rma_entity_idсочиrma_entityна Mage-OS.
При деплой
heading.anchorLabelsetup:upgrade(data patch за причината),cache:flush.- Ако магазинът ползваше автоматично одобрение на оттеглянията — включете „Approve Automatically“ на законовата причина.
1.0.0 — 2026-07-25
heading.anchorLabelRelease 1.0.0