Към съдържанието

Новости

2.4.1 — 2026-11-11

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.anchorLabel
  • a6451e1 MageOS_RMA 2.5: срокът е на EasyReturns, един вход за отказ

2.4.0 — 2026-11-09

heading.anchorLabel

Спрямо 2.3.0.

Комити (3)

heading.anchorLabel
  • c17c717 Release 2.4.0
  • 173d3b7 feat: слот и в имейла за потвърждение (easyreturns.email.items.extra)
  • 6cfcfa1 feat: слот за допълнителни полета във формата за отказ (easyreturns.statement.extra)

Бележки

heading.anchorLabel

Два слота за модули-мостове. За търговеца нищо видимо не се променя, докато не се инсталира мост.

  • easyreturns.statement.extra (alias extra): контейнер в блока на декларацията. Рендерира се в Luma и в Hyvä формата преди бележката и бутона „Потвърждавам отказа“.
  • easyreturns.email.items.extra (alias extra): контейнер в блока с артикулите на потвърждението за получаване. Нужен е, защото {{layout}} рендерира само първия коренов блок на handle-а. Всеки блок в него получава statement_id.

Първият потребител е Webcode_EasyReturnsStoreCredit (клиентът избира възстановяване в портфейла).

При деплой

heading.anchorLabel

Само шаблони и layout: cache:flush.

2.3.0 — 2026-10-15

heading.anchorLabel

Спрямо 2.2.0.

Новости

heading.anchorLabel
  • Снимка по причина — различна за всеки store view. Photo на причината (Sales → RMA → Reasons) може да има собствена стойност за всеки store view — през превключвателя на scope във формата на причината (Webcode_RMA 2.1). Формата за отказ / връщане взима изискването за снимка за текущия store view.

Изисквания

heading.anchorLabel
  • webcode/module-rma ^2.1.

Внимание при деплой

heading.anchorLabel
  • DI: di.xml е променен — при деплоя се чисти generated/.
  • Зависимости: require в composer.json: webcode/module-rma: ^2.0 → ^2.1.

Комити (2)

heading.anchorLabel
  • 127cd92 Release 2.3.0
  • df138dc Снимка по причина — различна за всеки store view

2.2.0 — 2026-10-14

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.anchorLabel

bin/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.anchorLabel
  • 0f3cd70 Release 2.2.0
  • 0e7a434 Режими (законов отказ / RMA / автоматично), неизпратени артикули, причина и снимки

2.1.0 — 2026-10-13

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.anchorLabel
  • e16086d Release 2.1.0
  • 589d0a9 Отказ по ЗЗП чл. 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.anchorLabel
  • setup: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.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.anchorLabel
  • 178d4b0 module-easy-returns-1: изцяло оттеглена поръчка не се предлага повторно

2.0.1 — 2026-10-08

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.anchorLabel
  • 5eb6a60 module-easy-returns-1: отказът за логнат клиент — списък с поръчки и бутон в Hyvä

Проверено с E2E на magento.local (Luma и Hyvä; логнат клиент и гост), включително имейла за потвърждение.

2.0.0 — 2026-10-05

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.anchorLabel
  • 21a0680 Release 2.0.0
  • 2b177fe module-easy-returns-1: EasyReturns върху MageOS_RMA + Webcode_RMA 2.0
  • 1153a9a ci: махни изводимите ключове от .gitlab-ci.yml
  • ebe1d42 fix(i18n): български редове за коментарите в системната конфигурация
  • 1f776ef CI: матрицата идва от дефолта на pipeline-а (без MATRIX в модула)
  • bb12e75 CI: свий матрицата до един лег (2.4.9)
  • 35960cd fix(ci): стандартен module pipeline (include + vars)

Бележки

heading.anchorLabel

EasyReturns вече създава заявките в 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; персонализиран шаблон, вързан към старото id easyreturns_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.anchorLabel
  • setup:upgrade (data patch за причината), cache:flush.
  • Ако магазинът ползваше автоматично одобрение на оттеглянията — включете „Approve Automatically“ на законовата причина.

1.0.0 — 2026-07-25

heading.anchorLabel

Release 1.0.0