Skip to content

Новости

This content is not available in your language yet.

2.13.5 — 2026-11-20

heading.anchorLabel

Спрямо 2.13.4.

Комити (1)

heading.anchorLabel
  • c0c715f Празен отговор не гаси градовете при синхронизация

Бележки

heading.anchorLabel
  • Празен отговор не гаси градовете. Синхронизацията изключва всички градове на държавата и включва обратно тези, които куриерът е върнал. Отговор без градове ги изключваше всичките и не включваше нито един — а с тях изчезваше и изборът на офис в checkout-а до следващата успешна синхронизация. Синхронизацията е месечна, така че липсата можеше да трае седмици. Сега такъв отговор се записва в лога и градовете от последната синхронизация остават.

Проверено

heading.anchorLabel
  • Unit тестове на модула в CI, с нов тест, който пада без поправката. Срещу живото API не е предизвикван празен отговор.
  • Непълен, но непразен отговор не се разпознава: върнатото се приема за целия списък.

При деплой

heading.anchorLabel
  • cache:flush. Няма промяна в схемата, в di.xml или в конструктори.

2.13.4 — 2026-11-20

heading.anchorLabel

Спрямо 2.13.3.

Комити (2)

heading.anchorLabel
  • d62af6e test(cod): стъбът отказва само паричния превод за чужбина, както живото API (itx-75)
  • b0a6baf Наложен платеж за чужбина влиза в цената на доставката

Бележки

heading.anchorLabel
  • Наложеният платеж за чужбина вече се иска от Speedy и таксата му влиза в цената на доставката (преди клиентът плащаше само превоза, а таксата оставаше за магазина). Таксата е фиксирана по държава, напр. Гърция 7,54 → 13,75 €, Румъния 5,88 → 6,80 €.
  • Пощенският паричен превод е само за България. Speedy отказва цялата калкулация за чужбина, ако го има в заявката.
  • Полша иска обявена стойност към наложения платеж: калкулацията и товарителницата повтарят заявката с declaredValue = сумата на наложения платеж.
  • Тирето в пощенския код се маха („40-035“ → „40035“), иначе Speedy го отказва.

При деплой

heading.anchorLabel
  • Без промени в схемата, DI или static. Калибровката на надбавките за чужбина е отделна за всяка държава и тръгва от нулата при първата заявка за деня.

2.13.3 — 2026-11-19

heading.anchorLabel

Спрямо 2.13.2.

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

heading.anchorLabel
  • Зависимости: require в composer.json: webcode/module-carrier: ^2.20 → ^2.22.3.

Комити (1)

heading.anchorLabel
  • 20314f4 Услугите се кешират по store на акаунта

Бележки

heading.anchorLabel
  • Акаунтът при куриера е на store-а на поръчката (продължение на webcode/module-carrier 2.22.3). Услугите са на договора. С акаунт по website вторият сайт получаваше услугите на първия — от кеша, а в рамките на един процес и от паметта на класа. Сега всеки store със собствен акаунт пази свои услуги.
  • Инсталация с един акаунт на default scope не усеща разлика: без отделен акаунт на website/store всичко се чете и кешира както досега.

Проверено

heading.anchorLabel
  • Unit тестове на модула в CI, с нов тест за промяната. Заявка към куриера не е пращана и втори акаунт на website не е пробван с истинска товарителница.

При деплой

heading.anchorLabel
  • Изисква webcode/module-carrier ^2.22.3. cache:flush; няма промяна в схемата или в di.xml.
  • Преди деплой на инсталация с повече от един сайт: ред за акаунт на куриера на website/store в core_config_data, който досега е бил без ефект, започва да се ползва за този store (виж бележките на Carrier 2.22.3).

2.13.2 — 2026-11-19

heading.anchorLabel

Спрямо 2.13.1.

Комити (1)

heading.anchorLabel
  • d812f6e Настройките на куриера са само в „Методи за доставка“

Бележки

heading.anchorLabel
  • Настройките на куриера са само в „Методи за доставка“. Същата група се показваше и на страницата „Delivery Methods“ на Webcode (webcode_carriers). Запис оттам не синхронизираше активността на куриера, по която се филтрират офисите (куриер, включен оттам, даваше тарифи без офиси), бутонът за вход там не работеше, а част от полетата се записваха в пътища, които никой не чете.
  • Пътищата в конфигурацията не се сменят и нищо записано не се губи. Общите настройки на страницата „Delivery Methods“ остават.

Проверено

heading.anchorLabel
  • Промяната е три реда в system.xml; unit тестовете на модула минават в CI. В админа не е отваряно с промяната.

При деплой

heading.anchorLabel
  • cache:flush. Ако някой е записвал настройки на куриера от страницата на Webcode, редове webcode_carriers/<куриер>/… в core_config_data са мъртви настройки — стойностите им трябва да се въведат в „Методи за доставка“.

2.13.1 — 2026-11-16

heading.anchorLabel

Спрямо 2.13.0.

Комити (1)

heading.anchorLabel
  • 3970a43 fix(admin): платецът на връщането при отказ вече не се чете обратно

Бележки

heading.anchorLabel
  • Диалогът „Create Shipping Label“ и настройките: полето за платеца на връщането при преглед/тест вече се казва „Return Payer if Refused (Open / Test)“ (беше „Return Shipment Payer“) и има пояснение. Опциите са „Sender (store)“ / „Recipient (buyer)“ (беше „Recepient (customer)“). „Customer“ се четеше и като магазина: на kompass.bg настройката остана „получател“, при желано „подател“.
  • Добавени са български преводи.
  • Само надписи. Стойностите (SENDER/RECIPIENT), конфиг пътищата и payload-ът към Speedy не са сменени, така че настроеното досега остава в сила.

При деплой

heading.anchorLabel
  • Само .phtml, source model и CSV: стига cache:flush. Без DI и без схема.

2.13.0 — 2026-11-10

heading.anchorLabel

Спрямо 2.12.1.

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

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

Комити (4)

heading.anchorLabel
  • f67e2b8 Release 2.13.0
  • fa489f7 refactor(rates): calculatePrice() минава през AbstractCarrier::lookupRates() (speedy-4)
  • 52ac678 test(rates): integration сценарий за паднало API; стъбът отговаря като живото API (speedy-4)
  • 321792c fix(rates): тарифите се питат без суми, надбавките се смятат локално (speedy-4)

Бележки

heading.anchorLabel

Тарифата на Speedy вече остава в checkout-а и при недостъпно API. На 10.11.2026 Speedy беше недостъпен около два часа от един магазин и резервната тарифа не сработи нито веднъж: ключът на кеша съдържаше сумата на количката, точното тегло и пощенския код, тоест беше уникален за всяка количка.

  • Тарифата се пита без суми. Базовата цена зависи само от дестинацията, теглото и услугите и се повтаря между количките. Надбавките за наложен платеж и обявена стойност се смятат локално.
  • Формулата се сверява сама. Първата истинска заявка за деня върви със сумите, както досега, и живият ѝ отговор се сравнява с локалната сметка до стотинка. Съвпадне ли — следващите заявки тръгват без суми. Разминава ли се — модулът пита със суми 24 часа и пише error в лога.
  • Резерва при паднало API: последната тарифа за точно същата заявка, после за същата дестинация и стъпка на теглото (офис и автомат — по града им). Докато API-то работи, цената е винаги за точното тегло.
  • Circuit breaker (от module-carrier 2.20): след транспортна грешка останалите видове доставка в същата заявка не чакат Speedy.
  • Нова команда bin/magento speedy:rates:verify --limit=100 — само четене; сравнява живата цена със суми срещу локалната върху реални поръчки.
  • Поправка: надбавката за наложен платеж в тарифния ред се четеше от грешно поле и излизаше 1.00 за всяка тарифа.
  • При празен отговор от Speedy се сервира резервата, ако има такава (преди методът отпадаше направо).

При деплой

heading.anchorLabel
  • Изисква webcode/module-carrier ^2.20.
  • Нови зависимости в конструктора на Model\Carrier и нова CLI команда в etc/di.xml → setup:di:compile (или чистене на generated/) и cache:flush.
  • Няма промяна по схемата и няма data patch.
  • След деплоя и след всяка смяна на тарифата или договора: bin/magento speedy:rates:verify --limit=100.

Известен проблем

heading.anchorLabel

Правилата за надбавките (наложен платеж 0.8 % с минимум 0.26 € нето, обявена стойност 0.2 %) са измерени срещу живото API на един акаунт на 10.11.2026 — 250 от 250 поръчки съвпаднаха. Те са правила на Speedy и на договора, не са вечни. На друг договор важи сверката с първата заявка за деня: при разминаване модулът се връща към заявки със суми.

2.12.1 — 2026-10-31

heading.anchorLabel

Спрямо 2.12.0.

Комити (1)

heading.anchorLabel
  • 1db489e fix(config): групата Visibility се вижда на website и store

Бележки

heading.anchorLabel

Групата Visibility вече се вижда и на ниво website и store view, така че държавите, подредбата, показването на неприложим метод и съобщението могат да се задават по магазин от админа. Куриерът и досега чете тези настройки в store-а, затова стойност, вече записана на такова ниво, започва да се вижда в админа, без да променя поведението.

При деплой

heading.anchorLabel

Промяната е само в system.xml. След обновяване е нужен пълен cache:flush: cache:flush config не вдига промяна в структурата на конфигурацията.

2.12.0 — 2026-10-30

heading.anchorLabel

Спрямо 2.11.0.

Комити (2)

heading.anchorLabel
  • 91aae82 Release 2.12.0
  • bead01a feat(label): избор накъде се връщат обратните и отказаните пратки

Бележки

heading.anchorLabel
  • Търговецът вече избира накъде отива заявената обратна пратка: до подателя или до офис на Speedy. Настройките са „Return Shipment Destination“ и „Return Shipment Office“.
  • Отказаните и недоставените пратки могат да се връщат до друг обект по договора. Настройката е „Refused Shipments Return To“.
  • И двата избора се променят за конкретна пратка в диалога „Създаване на товарителница“.
  • Без настройка поведението не се променя.
  • „Return Shipment Service“ вече се показва независимо от „Options Before Payment“.

При деплой

heading.anchorLabel
  • Съществуващ конструктор не е променен. Добавени са два source модела (ReturnDestination, SendBackClient), затова при компилиран DI се пуска setup:di:compile.
  • Нови конфигурационни пътища: carriers/speedy/return_destination, return_office_id, send_back_client_id. Схема няма.

Известен проблем

heading.anchorLabel
  • Обект за отказани пратки зависи от договора. С договор 84422 Speedy отказва всеки реален обект с „Посочване на обект за връщане на пратката не е позволено“, а настройката важи за всяка товарителница, тъй че на такъв договор спира и масовото генериране. Полето е празно по подразбиране; първо уточнете със Speedy.
  • Успешният път със sendBackClientId не е проверен срещу API-то, защото няма договор с разрешение. Изборът на офис за обратна пратка е проверен с реална товарителница 63803350239 (анулирана).

2.11.0 — 2026-10-19

heading.anchorLabel

Спрямо 2.10.0.

Комити (3)

heading.anchorLabel
  • e512f06 Release 2.11.0
  • 035d6e7 feat(label): опаковката е затворен списък ПЛИК / КАШОН / КУТИЯ
  • 9f4ef56 fix(label): „Тип“ и „Опаковка“ на един ред в диалога

Бележки

heading.anchorLabel
  • Опаковка (carriers/speedy/package) вече е затворен списък: ПЛИК / КАШОН / КУТИЯ (Model/Config/Source/PackageType), и в настройката, и в диалога „Създаване на товарителница“ (select). По подразбиране е КАШОН.
  • В диалога Тип и Опаковка стоят на един ред.
  • ⚠️ Промяна в поведението: без зададена настройка се праща КАШОН, не BOX (до 2.10.0 включително). Стойност, записана с 2.10.0 като свободен текст и извън списъка (напр. BOX, ENVELOPE), се игнорира: тогава се праща КАШОН. Пренастрой от Stores → Configuration.

При деплой

heading.anchorLabel
  • Нов параметър в конструктора няма. Добавен е source model и са сменени поле в system.xml и шаблонът на диалога. Стига cache:flush.

2.10.0 — 2026-10-19

heading.anchorLabel

Спрямо 2.9.0.

Комити (2)

heading.anchorLabel
  • 40b2433 Release 2.10.0
  • 9267679 feat(label): опаковка от настройките и от диалога за товарителница

Бележки

heading.anchorLabel
  • Нова настройка Опаковка (carriers/speedy/package, default BOX): това се праща в content.package и се печата на товарителницата. По Speedy API е свободен текст до 50 знака (напр. BOX, ENVELOPE, ПЛИК). Празна стойност праща BOX, по-дълга се реже до 50.
  • Настройката важи за всяка товарителница, включително автоматичните и масовите. В диалога „Създаване на товарителница“ има поле Опаковка с подсказки, с което се сменя за конкретната пратка.
  • Без промяна в настройката поведението е досегашното (BOX).

При деплой

heading.anchorLabel
  • Нов параметър в конструктора няма. Добавени са поле в system.xml и шаблонът на диалога. Стига cache:flush.

2.9.0 — 2026-10-17

heading.anchorLabel

Спрямо 2.8.5.

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

heading.anchorLabel
  • Зависимости: require в composer.json: webcode/module-carrier: ^2.12 → ^2.19.

Комити (4)

heading.anchorLabel
  • 71e86d9 Release 2.9.0
  • 612040d build: изисква webcode/module-carrier ^2.19
  • 3a9226f feat(label): изпращач от обект/офис и заявка за обратна пратка (SWAP)
  • 1e9c9cc feat(label): формат на товарителницата и копие за подателя от настройките

Бележки

heading.anchorLabel
  • Диалогът „Create Shipping Label“ — „Изпращач“ вместо „Клиент/Обект“. Групата „От адрес“ са обектите по договора (всеки със своя регистриран адрес), „От офис на куриер“ — офисът/автоматът за предаване от office_id плюс новата настройка „Допълнителни офиси за предаване“ (carriers/speedy/sender_offices, няколко офиса). Изборът на офис праща dropoffOfficeId с конфигурирания клиент; изборът на обект праща неговия clientId без офис. Масовото и автоматичното генериране са без промяна — от конфигурацията.
  • „Заявка за обратна пратка“ Да/Не → additionalServices.returns.swap (услугата за връщане от return_service_id, иначе основната; 1 колет). По подразбиране „Не“; само от диалога.
  • Формат на товарителницата и копие за подателя от настройките (1e9c9cc).

При деплой

heading.anchorLabel
  • Изисква webcode/module-carrier ^2.19.
  • Сменени system.xml и шаблонът на диалога → cache:flush. Нов конструктор няма.
  • Ако магазинът праща от няколко офиса — попълнете „Допълнителни офиси за предаване“ в Speedy.

2.8.5 — 2026-10-14

heading.anchorLabel

Поправки

heading.anchorLabel
  • Офисите се пипат само при реална промяна. Синкът вече не гаси всички и не ги включва наново всяка нощ: изключва само активните, които куриерът вече не връща; празен или провален отговор не пипа нищо. Заедно с Carrier DatabaseManagedTimestamps updated_at показва кога офисът наистина се е променил.
  • „Преглед/тест преди плащане“ влиза в цената на доставката (c9301f7).

2.8.4 — 2026-09-30

heading.anchorLabel

Спрямо 2.8.3.

Комити (2)

heading.anchorLabel
  • d1a0040 fix: настройките за товарителницата се четат по store-а на поръчката
  • f8c5460 chore: post-release bump to 2.8.4

Бележки

heading.anchorLabel
  • Настройките за товарителницата се четат по store-а на поръчката. Диалогът ги четеше по store-а на поръчката, а ShipmentRequestBuilder само от Default. Масовото генериране от грида минава само през builder-а, така че настройка на ниво website или store view (платец, надбавка, подател, опции преди плащане, застраховка, разрешени услуги…) важеше в диалога, но не и там. Сега и двата пътя дават еднаква товарителница.
  • Scope-ът се задава при build() и getDefaultCodAmount() и се връща след това, защото builder-ът е споделен между поръчките при масовото генериране.

При деплой

heading.anchorLabel
  • ⚠️ Стойности на ниво website или store view под carriers/speedy/*, досега игнорирани при масовото генериране, започват да важат. Провери преди деплой:
    SELECT scope, scope_id, path, value FROM core_config_data
    WHERE path LIKE 'carriers/speedy/%' AND scope <> 'default';
    Празна (NULL) стойност на store ниво отменя наследената. На isd-bg.com такъв ред за accept_options на store 2 беше изтрит преди деплоя (30.09.2026).
  • Няма нови зависимости в конструктора, промени в схемата, шаблоните или статичните файлове: cache:flush.

2.8.3 — 2026-09-29

heading.anchorLabel

Спрямо 2.8.2.

Комити (2)

heading.anchorLabel
  • ced0c7c fix: извън България без опции преди плащане (ОПП)
  • 363a06c chore: post-release bump to 2.8.3

Бележки

heading.anchorLabel
  • Извън България товарителницата е без опции преди плащане. Speedy отказва пратката с „Детайли за ОПП: Опциите преди плащане/получаване не са позволени за държавата на получателя“ (поръчка до Гърция, isd-bg.com, 29.09.2026). Както при доставка до автомат, obpd отпада изцяло: и конфигурираният default (accept_options), и ръчно избраната в диалога опция.
  • Диалогът за товарителница не предлага опция извън BG. В България нищо не се променя.
  • ⚠️ Не е проверено с реална товарителница до чужбина (създаване и отказ).

При деплой

heading.anchorLabel
  • Няма нови зависимости в конструктора, промени в схемата, шаблоните или статичните файлове: cache:flush.

2.8.2 — 2026-09-29

heading.anchorLabel

Спрямо 2.8.1.

Комити (2)

heading.anchorLabel
  • af0198f fix: извън България куриерът е за сметка на търговеца
  • 80ff7ef chore: post-release bump to 2.8.2

Бележки

heading.anchorLabel
  • Извън България куриерът е за сметка на търговеца. Speedy не позволява платец получател за международните услуги и отказва пратката с „Платец: Избраният платец не е позволен за избраната услуга“ (поръчка до Гърция, isd-bg.com, 29.09.2026). При адрес или офис извън BG RECIPIENT става SENDER, и от настройката, и от диалога. THIRD_PARTY не се пипа.
  • С платец подателя наложеният платеж е пълната сума на поръчката (стока + доставка + надбавка за наложен платеж), така че клиентът плаща доставката през наложения платеж.
  • Диалогът за товарителница предлага SENDER по същото правило. Нов публичен метод ShipmentRequestBuilder::isCrossBorder().
  • ⚠️ Не е проверено с реална товарителница до чужбина (създаване и отказ).

При деплой

heading.anchorLabel
  • Няма нови зависимости в конструктора, промени в схемата, шаблоните или статичните файлове: cache:flush.

2.8.1 — 2026-09-29

heading.anchorLabel

Спрямо 2.8.0.

Комити (2)

heading.anchorLabel
  • edaeb11 fix: адрес извън BG/RO се подава с addressLine1, не с addressNote
  • eba9a62 chore: post-release bump to 2.8.1

Бележки

heading.anchorLabel
  • Адрес извън България и Румъния се подава с addressLine1. Speedy води по номенклатура само BG и RO адресите. За всички останали държави иска адресни редове и без addressLine1 отказва пратката с „Получател Адрес 1: Изисква се адрес“ (поръчка до Гърция, isd-bg.com, 29.09.2026). Досега модулът пращаше улицата само в addressNote.
  • За BG/RO няма промяна: улицата остава в addressNote, защото Speedy губеше номера, когато сам разчита addressLine1.
  • Улица над 50 знака се пренася в addressLine2, като се реже между думи. Улицата, въведена ръчно в диалога за товарителница, минава по същия път.
  • ⚠️ Не е проверено с реална товарителница до чужбина (създаване и отказ). Лимитът от 50 знака е по документацията на Speedy.

При деплой

heading.anchorLabel
  • Няма нови зависимости в конструктора, промени в схемата, шаблоните или статичните файлове: cache:flush.

2.8.0 — 2026-09-26

heading.anchorLabel

Спрямо 2.7.0.

Комити (2)

heading.anchorLabel
  • 836125f Release 2.8.0
  • 59b6451 feat: при цени от таблица услугата за товарителницата се избира по дестинация

Бележки

heading.anchorLabel
  • Услугата за товарителница по дестинация при цени от таблица (custom_prices). Методът тогава е тип доставка (speedy_address), не услуга. Досега товарителницата взимаше винаги първата разрешена услуга, тоест 505 и за чужбина, и операторът я сменяше на ръка в диалога. Сега услугата е първата разрешена (по реда на allowed_methods), която Speedy връща от services/destination за получателя. Пример с allowed_methods = 505,202,302,…: Гърция и Румъния → 202 (CEE Economy), България → 505. Палетните услуги (412, 432, 442…) не се избират, докато са по-назад в реда.
  • Ако Speedy не отговори или няма съвпадение, остава първата разрешена, както досега. Услугата, избрана в диалога, и услугата в метода (speedy_505, при API цени) печелят и не питат services/destination.
  • Нов клас Service\DestinationServices. Праща само местоположението на получателя (държава, населено място, пощенски код или офис) и подателя (clientId/dropoffOfficeId).

При деплой

heading.anchorLabel
  • Конструктор: ShipmentRequestBuilder има нова зависимост (DestinationServices). Трябва setup:di:compile и изчистен generated/. Автоматичният сигнал отгоре не го хваща.
  • Няма промени в схемата, в шаблоните и в статичните файлове: cache:flush.

2.7.0 — 2026-09-25

heading.anchorLabel

Спрямо 2.6.1.

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

heading.anchorLabel
  • Конструктор: сменена сигнатура на __construct — при деплоя се чисти generated/.
  • Зависимости: require в composer.json: webcode/module-carrier: ^2.10 → ^2.12.

Комити (2)

heading.anchorLabel
  • 933bf73 Release 2.7.0
  • 976f519 feat(admin): searchable sender office picker

Бележки

heading.anchorLabel
  • „Choose office“ в конфигурацията на куриера е поле с търсене (UI Select от Webcode_Carrier 2.12.0) вместо <select> с всички офиси: търсене по град, име, адрес или номер, подредба по град и име, етикет [номер] ГРАД — име, адрес.
  • Model\Config\Source\Office е изтрит — оттам идва сигналът „Конструктор“ горе; нов конструктор няма. Запазената стойност (office_id) не се променя.
  • Старият source model викаше живото API на Speedy при всяко отваряне на страницата с настройки.

При деплой

heading.anchorLabel
  • Изисква webcode/module-carrier ^2.12. Чисти generated/ и пусни setup:static-content:deploy за adminhtml (заради JS-а в Carrier).

2.6.1 — 2026-09-24

heading.anchorLabel

Спрямо 2.6.0.

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

heading.anchorLabel
  • Конструктор: сменена сигнатура на __construct — при деплоя се чисти generated/.
  • Setup: data/schema patch — изпълнява се срещу жива база при setup:upgrade.

Комити (1)

heading.anchorLabel
  • 5275289 fix: записът на куриера се възстановява сам (RecurringData), patch-ът е идемпотентен

Бележки

heading.anchorLabel
  • Записът на куриера в webcode_carrier_entity се възстановява сам. Ако таблицата е празна, а отметката на AddSpeedyCarrierEntityPatch е останала в patch_list (модулът е бил изключван и таблицата е създадена наново), куриерът досега оставаше без запис, докато някой не махне отметката на ръка. Сега новият Setup\RecurringData създава липсващия запис при всеки setup:upgrade: неактивен, както и при първа инсталация.
  • AddSpeedyCarrierEntityPatch::apply() е идемпотентен. При махната отметка и съществуващ запис вече не гърми на уникалния code.

При деплой

heading.anchorLabel
  • Уточнение към автоматичните предупреждения: никоя съществуваща сигнатура не е сменена. __construct е на новия клас Setup\RecurringData. В production mode е нужен setup:di:compile заради новия клас.
  • Съществуващият data patch не се пуска наново. RecurringData при всеки setup:upgrade чете записа по code и създава нов само ако липсва. Съществуващ запис, вкл. is_active, не се пипа.

2.6.0 — 2026-09-19

heading.anchorLabel

Спрямо 2.5.4.

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

heading.anchorLabel
  • Зависимости: require в composer.json: webcode/module-carrier: ^2.9.2 → ^2.10.

Комити (3)

heading.anchorLabel
  • 2380056 Release 2.6.0
  • 4ec04c5 chore(carrier-11): изисквай webcode/module-carrier ^2.10
  • 890b3f3 feat(carrier-11): отказ на товарителница при отказ на поръчка

Бележки

heading.anchorLabel

Модулът вече може да анулира товарителницата при отказ на поръчка.

Закача вече съществуващия ShippingLabel::delete() (shipment/cancel), който до момента нямаше нито един извикващ — тоест кодът стоеше, но никога не се изпълняваше.

Включва се от Магазини → Конфигурация → Webcode Solutions → Delivery Methods → Товарителници. Настройката е обща за всички куриери и е изключена по подразбиране — това издание не променя нищо от само себе си.

Отказ от куриера никога не блокира отказа на поръчката; причината влиза в коментарите на поръчката и в лога.

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

heading.anchorLabel
  • Изисква webcode/module-carrier ^2.10 — констрейнтът е стегнат в това издание, защото модулът вече ползва LabelCancellationInterface, който идва с carrier 2.10.0. Деплой без него би дал фатал при зареждане на класа.
  • Нужен е cache:flush (заради новия observer и конфигурация в carrier 2.10.0).
  • Няма промени по схема и по static content.

Известен проблем

heading.anchorLabel

Не е минат реален отказ на жива товарителница при куриера (DoD т. 2–3) — покритието е unit. Първият жив отказ да се наблюдава.

2.5.4 — 2026-09-18

heading.anchorLabel

Спрямо 2.5.3.

Комити (1)

heading.anchorLabel
  • 2e01140 диалогът за товарителница: не сваляй избрания тип на „до адрес“

2.5.3 — 2026-09-17

heading.anchorLabel

fix(address): доставка до адрес вече резолва населеното място вместо да пада в обслужващия офис.

  • countryId се маппва от ISO кода на поръчката през CarrierCountryRepository (BG→100), не 0 (Speedy отхвърляше 0 → офис).
  • siteName се чисти от префикса “гр.”/“с.” (иначе location/site връщаше празен списък → офис).

Засягаше ВСЯКА Speedy доставка до адрес. Изисква module-carrier ^2.9.2.

2.5.2 — 2026-09-16

heading.anchorLabel

fix(address): улицата с номера отива в addressNote вместо addressLine1. Speedy печата адреса дословно, тъй че номерът винаги стига до куриера; рутиране по siteId + пощенски код. Поправя доставка до адрес без номер на товарителницата.

2.5.0 — къде принадлежи надбавката и какво пише в съдържанието — 2026-09-09

heading.anchorLabel

Изисква webcode/module-carrier ^2.9.0

heading.anchorLabel

resolveContents() и isSurchargePartOfDelivery() са нови в базата. Старият constraint (^2.8.1) допускаше 2.8.x и билдът щеше да пада с undefined method.

Cash-on-Delivery Surcharge (carriers/speedy/surcharge_scope)

  • Part of the delivery — по подразбиране. Клиентът дължи наложен платеж за стоката; доставката с надбавката ѝ се събира от куриера.
  • Part of the order — надбавката остава в сумата, за търговец, който иска разбивката на цената на доставка да се вижда.

Действа само при платец получателя — иначе няма плащане на гише, което да следва.

⚠️ Промяна в поведението. Магазин с Webcode_Surcharge и платец получателя ще започне да издава товарителници с по-нисък наложен платеж. За 000020909: 98.06 → 96.90.

Parcel Contents (carriers/speedy/contents_template) — какво декларира товарителницата като съдържание. {increment_id} става номерът на поръчката (Поръчка 000020909); празно оставя списъка с артикулите, както досега.

Решение, което си струва да се знае

heading.anchorLabel

Проверката е за изричното order, не за delivery, тъй че подразбиращото се живее в кода, а etc/config.xml само го документира. Обратното би направило сумата, която куриерът събира от клиента, зависима от това дали конфигът се е заредил.

2.4.2 — 2026-09-05

heading.anchorLabel

Поправено

heading.anchorLabel
  • Колоната Location в tracking popup-а вече не е празна. Carrier::getTrackingInfo() пълнеше deliverylocation от comment — свободен текст, който Speedy не връща за повечето операции, тъй че колоната излизаше празна практически винаги. Правилното поле е place — единственото в TrackedParcelOperation, което носи място (https://api.speedy.bg/v1/schema). Добавен регресионен тест.
  • bin/magento config:set carriers/speedy/sender вече работи. Групата в system.xml се казваше sender, колкото и пътят на полето client_id. Magento резолвира по структурен път и попадаше в ГРУПАТА вместо в поле, тъй че полето беше недостижимо от CLI — за deploy скриптове и за всяка настройка извън админ формата. В админа работеше, затова дефектът беше невидим. Групата е преименувана; и шестте полета носят изричен config_path, тъй че нито една съхранена стойност не се осиротява.

Тестове

heading.anchorLabel

Test/Unit: 58 теста, 165 assertions. PHPCS Magento2: 0 errors.

2.4.1 — 2026-08-31

heading.anchorLabel

Поправено

heading.anchorLabel
  • ActiveGuard четеше подателя от грешния config-leaf. Проверката „има ли попълнен подател“ гледаше не там, където полето пази стойността си, тъй че gate-ът при пускане в експлоатация съдеше по празно. Сега чете sender.

2.4.0 — 2026-08-28

heading.anchorLabel
  • Магазинът избира кой плаща доставката. Payer политиката е споделена с останалите куриери през module-carrier (вече изисква ^2.8) и се подава при заявка за товарителница; изборът стои и в диалога „Create Shipping Label“.
  • Полетата на подателя са задължителни при пускане в експлоатация. Нов Model/Config/Backend/ActiveGuard не дава Speedy да се включи с празен подател, вместо конфигурацията да мине и заявките да падат по-късно.
  • Вход в Speedy със запазените креденшъли от админ контролера, без повторно въвеждане.

2.3.2 — 2026-08-25

heading.anchorLabel

Register carriers/speedy/api_url as a hidden system.xml field, so the API base URL is manageable per environment via bin/magento config:set / env.php (no merchant UI; default stays in config.xml).

2.3.1 — 2026-08-21

heading.anchorLabel
  • Етикетът на метода в checkout вече показва само бранда и типа доставка (напр. „Speedy - До офис на куриер“), без името на услугата от API-то („СТАНДАРТ 24 ЧАСА“). Клиентите четяха услугата като срок за доставка и си търсеха пратката „след 24 часа“.
  • Махната неизползваната вече зависимост CarrierService от Model\Carrier.

Инвариантът „carrierTitle = конфигурираното заглавие“ живее в Webcode_Carrier (2.7.1) и важи за всички куриери; тук е само cleanup-ът.

2.2.4 — 2026-08-19

heading.anchorLabel

Поправено

heading.anchorLabel

Speedy отхвърляше товарителниците за частни лица.

Получател Лице за контакт: Не се очаква име на контакт

Второ затягане на валидацията за един ден. Сутринта API-то поиска име на получателя (2.2.3 добави clientName), а следобед започна да отхвърля contactName при privatePerson — частното лице Е получателят, лице за контакт не се очаква.

Затова името се подава единствено като clientName. Това удовлетворява и двете правила.

sender.contactName остава непроменен — той е за подателя и е друго поле.

Как се разпозна

heading.anchorLabel

Мерено на bilki.bg 19.08.2026, при непроменен код и payload:

6 успешни товарителници 14:53 … 15:21
2 провала 15:25, 15:28

Разграничителят е времето, не поръчката и не офисът — проверено, че трите payload-а са структурно еднакви.

Тестове

heading.anchorLabel

testRecipientCarriesClientNameAlongsideContactName е преработен: clientName присъства, contactName отсъства (assertArrayNotHasKey).

2.2.3 — 2026-08-19

heading.anchorLabel

Поправено

heading.anchorLabel

Теглото на пратката идва от поръчката, не от конфигурацията

heading.anchorLabel

buildContent() подаваше default_weight винаги, когато няма override — тоест при масово генериране и при автоматичното създаване. Реалното тегло на поръчката се игнорираше и куриерът дотаксуваше. Дефектът е невидим: нищо не гърми, нищо не влиза в лог, товарителницата просто тръгва лека.

Мерено на bilki.bg, поръчки със Speedy за 30 дни: средно 1.41 кг, максимум 44.13 кг, а 764 от 1756 (43%) над 1 кг при default_weight = 1.

Редът става override → тегло на поръчката → default_weight, по модела на BoxNow — единственият от петте куриера, който го правеше правилно. Същата поправка влезе и в Econt 2.3.1, Evropat и PostOne.

Идентичност на получателя — clientName

heading.anchorLabel

Влезе с 2.2.2 (!23) и се пренася тук: Speedy отказваше всяка товарителница с „Получател: Необходимо е да бъде подадено или id или име на получател“, след като на 19.08.2026 затегна валидацията. contactName е лице за контакт и не удовлетворява идентичността.

Кой трябва да я вземе

heading.anchorLabel

Всяка инсталация на 2.x — при 1.0.x ShippingLabel::create() няма извикващ, тоест товарителници оттам не се генерират.

2.2.2 — 2026-08-19

heading.anchorLabel

Поправено

heading.anchorLabel

Speedy отказваше всяка товарителница. От 19.08.2026 API-то вали с

Получател: Необходимо е да бъде подадено или id или име на получател

при непроменен наш код. По Speedy ClientDTO идентичността на получателя е clientId или clientName; contactName е лице за контакт и вече не я удовлетворява. buildRecipient() сега подава и двете полета с една и съща стойност, с непроменения fallback към firstname + lastname.

Доказано срещу живото API: същата поръчка отказана без полето и приета с него.

Засяга всяка инсталация на 2.x — при 1.0.x ShippingLabel::create() няма извикващ, тоест товарителници оттам не са се генерирали.

2.2.0 — 2026-07-28

heading.anchorLabel

Populate webcode_directory_city.region_id during Speedy city taxonomy sync via Webcode Carrier RegionResolver, on create and as self-heal for existing rows. Requires carrier ^2.6.

2.1.0 — 2026-07-28

heading.anchorLabel

Delivery Methods config cleanup:

  • API base URL default живее в etc/config.xml (carriers/speedy/api_url), не като PHP const; override през config:set / env.php / DB.
  • Креденшълите (username/password) вече не са required за Save на секцията; валидацията е бутонът Login & Configure.

2.0.1 — 2026-07-24

heading.anchorLabel

Speedy checkout place-order integration test matrix: 2 pricing modes x guest/customer x address/office/aps + COD + rival-carrier + estimate-preserves-choice regression. SpeedyApiStub (no live API).