Do hurtowni zamawia firma z trzyosobowym działem zakupów. Zaopatrzeniowiec kompletuje koszyk, kierownik zatwierdza zamówienia powyżej budżetu, a księgowa ma widzieć wszystkie zamówienia i faktury firmy, ale nic nie zamawia. Do tej pory organizacja klienta w Endora Commerce znała tylko dwie role: administratora i zwykłego użytkownika. W wersji 0.110.0 klient sam układa role swojego zespołu.
Poniżej opisuję najważniejsze zmiany. Pełna lista, z podziałem na pakiety, jest na stronie wydania 0.110.0 na GitHubie.
Role i uprawnienia w organizacji klienta
Każda organizacja firmowa ma teraz dwie role wbudowane, Administrator i Członek, oraz do 50 ról własnych. Rola to zestaw uprawnień, które deklarują poszczególne moduły. Przykłady:
- tworzenie koszyka i zamawianie bez akceptacji,
- akceptowanie koszyków innych osób,
- składanie zapytań ofertowych,
- podgląd zamówień całej organizacji, a nie tylko własnych,
- zgłaszanie zwrotów i reklamacji oraz podgląd zgłoszeń całej organizacji,
- zarządzanie adresami organizacji,
- zakup jednym kliknięciem i praca z listami zakupowymi.
Role ustawia administrator organizacji klienta na swoim koncie w sklepie. Wasz zespół może zrobić to samo w panelu: ekran organizacji ma nową sekcję Role z edytorem uprawnień pogrupowanych według modułów i odnośnikiem do historii zmian. Dostęp do tej sekcji dają dwa nowe uprawnienia operatora, do odczytu i do zarządzania rolami.
Kilka szczegółów, które mają znaczenie w praktyce:
- Zaproszenie do organizacji wskazuje rolę, a e-mail z zaproszeniem podaje jej nazwę w języku odbiorcy.
- Rolę, którą ktoś ma, usuwa się tylko ze wskazaniem roli zastępczej. Wszystkie osoby i otwarte zaproszenia przechodzą na nią w jednej operacji.
- Członek widzi rolę w swoim profilu i może sprawdzić, na co mu ona pozwala.
- Uprawnienia obowiązują w całym sklepie, także w API: przy ponownym zamówieniu, kopiowaniu zamówienia do zapytania ofertowego, imporcie szybkiego zamówienia i w rezerwacjach limitu kupieckiego. Kto nie widzi zamówień kolegów, nie zobaczy też ich rezerwacji na limicie.
- Dziennik zdarzeń podpisuje zmiany nazwiskiem klienta. Zmiana roli albo zaproszenie wysłane przez administratora organizacji w sklepie było wcześniej zapisywane jako zmiana „systemowa”.
Akceptacja koszyka działa od początku do końca
Organizacja może wymagać, żeby koszyk przed zamówieniem zatwierdziła uprawniona osoba. W tej wersji domknęliśmy cały ten proces:
- Sklep pokazuje przycisk „Wyślij do akceptacji” zamiast przejścia do kasy, jeśli koszyk wymaga zatwierdzenia.
- Osoby akceptujące dostają e-mail o koszyku czekającym na decyzję, a kupujący o zatwierdzeniu albo odrzuceniu, z podanym powodem. Treść tych wiadomości edytuje się w szablonach e-maili.
- Akceptuje rola z uprawnieniem do akceptacji, nie tylko administrator. Nikt nie zatwierdzi własnego koszyka.
- Zmiana zatwierdzonego koszyka wymaga ponownej akceptacji.
- Po odrzuceniu kupujący nie zaczyna od zera: jego następny koszyk startuje z pozycjami odrzuconego.
- Złożenie zamówienia sprawdza akceptację. Koszyk niezatwierdzony nie przejdzie, nawet gdy ktoś wywoła API zamówień z pominięciem sklepu.
Rejestracja firmy z danymi z rejestru
Firma, która zakłada konto w sklepie, może pobrać nazwę, adres i status VAT na podstawie NIP-u. Polskie numery są sprawdzane w GUS (REGON) i na Białej liście Ministerstwa Finansów, a numery VAT z innych krajów UE w VIES. Odpowiedź rejestru zapisuje się razem z rejestracją. Przy moderacji nowego konta panel pokazuje dane z rejestru obok wpisanych przez klienta i liczbę pól, które się różnią.
Funkcja jest domyślnie wyłączona, a włącza się ją w ustawieniach organizacji. Do GUS potrzebny jest klucz API, który zapisuje się w module danych uwierzytelniających. Bez niego polskie numery sprawdza sama Biała lista.
Przy okazji: Ministerstwo Finansów przeniosło Białą listę pod nowy adres i stary obsługuje tylko do 1 grudnia 2026. Od tej wersji Endora Commerce łączy się z nowym adresem. Jeśli korzystacie z weryfikacji NIP-ów, zaktualizujcie instancję przed tą datą.
Treści: opis produktu w Page Builderze, formularze i autorzy wpisów
- Nowy typ atrybutu „treść Page Buildera”. Opis produktu można złożyć z bloków Page Buildera, osobno w każdym języku, zamiast mieścić go w jednym polu tekstowym. Skopiowanie produktu kopiuje też tę treść.
- Blok formularza w Page Builderze. Formularz z modułu formularzy można wstawić na dowolną stronę sklepu. Obsługuje wszystkie typy pól, warunkowe wyświetlanie, zgody i CAPTCHA, działa też bez JavaScriptu, a jego wygląd wybiera się z gotowych wariantów.
- Autorzy wpisów na blogu. Wpis ma autora, czyli jednego z administratorów. Administrator ustawia w profilu zdjęcie i krótki opis „o mnie” w każdym języku.
- Usuwanie atrybutu pokazuje, w ilu produktach jest użyty, zanim cokolwiek zniknie.
Zwroty, faktury i VAT
- Odstąpienie od umowy przez konsumenta zwraca też koszt dostawy i dopłatę za płatność, gdy klient oddaje całe zamówienie, zgodnie z dyrektywą 2011/83/UE i ustawą o prawach konsumenta. Inne rozliczenie niż zwrot pieniędzy (np. wymiana albo naprawa) wymaga zapisanej zgody klienta.
- Reklamacja rozliczona obniżką ceny trafia na fakturę korygującą jako obniżka, a nie zwrot towaru, z numerem RMA zgłoszenia.
- Faktura wystawiona po zwrocie obejmuje tylko to, co klient zatrzymał.
- Cena brutto produktu liczy się według jego stawki VAT, a nie według stałych 23%. Koszyk pokazuje VAT w podziale na stawki, a koszt dostawy rozkłada się na stawki towarów tak samo jak w zamówieniu.
- Polskie faktury PDF nie mają już angielskich etykiet, a podgląd w edytorze szablonu faktury pokazuje to samo, co wydrukuje PDF.
Bezpieczeństwo i dane osobowe
- Poprawka bezpieczeństwa: członek organizacji, który nie jest jej administratorem, mógł ponownie zamówić albo skopiować do zapytania ofertowego zamówienie kolegi. Teraz obowiązuje ta sama reguła dostępu, co przy podglądzie zamówienia.
- Handlowiec widzi tylko przypisane mu organizacje także przy wejściu bezpośrednio w ich adres w panelu. Wcześniej mógł otworzyć i edytować organizację innego handlowca.
- Zewnętrzne API zamówień przyjmuje zamówienie tylko w kanale sprzedaży przypisanym do organizacji.
- Wymóg weryfikacji dwuetapowej dla roli administratora jest egzekwowany przy logowaniu, hasłem i przez Google lub Microsoft. Ekran ról ostrzega, gdy na serwerze brakuje klucza szyfrowania i wymóg nie obowiązuje.
- Usunięte konta klientów są anonimizowane po okresie przechowywania ustawionym w panelu. Wcześniej to codzienne zadanie się nie uruchamiało. Anonimizacja czyści teraz wszystkie pola z danymi osobowymi, także powody blokady czy odrzucenia wpisane przez operatorów, a przerwana dokończy się przy następnym uruchomieniu.
Wygodniej w panelu
- Usunięcie produktu zwalnia jego SKU i SKU wariantów, także dla produktów usuniętych przed aktualizacją.
- Atrybuty typu „lista wyboru” można tworzyć i edytować w panelu, razem z opcjami.
- Nagłówki grup ustawień i opisy przełączników są przetłumaczone, więc polski administrator nie czyta ich po angielsku.
- Strony Page Buildera i blog nie obciążają już bazy danych, gdy brakuje ich w pamięci podręcznej.
endora devstartuje szybciej: pierwsza warstwa rusza w mniej niż 0,1 sekundy zamiast po około dwóch sekundach.
Na co uważać przy aktualizacji
Wydanie zawiera siedem zmian niekompatybilnych. Dla sklepu najważniejsze są trzy:
- Jedna książka adresowa klienta. Osobista książka adresowa znika. Każdy klient ma jedną książkę adresową swojej organizacji, którą widzi jako „Moje adresy” albo, w firmie, „Adresy organizacji”.
- Zamówienie złożone za klienta w panelu przyjmie tylko kanał sprzedaży przypisany do jego organizacji.
- Zamówienie z koszykiem wymagającym akceptacji zostanie odrzucone, dopóki koszyk nie zostanie zatwierdzony.
Pozostałe dotyczą integracji i rozszerzeń, m.in. kodów błędów logowania przez zewnętrznego dostawcę, nazw modułów tworzonych poleceniem endora new module i ustawień biblioteki plików. Jeśli macie własne integracje albo moduły, przejrzyjcie sekcję zmian niekompatybilnych na stronie wydania.
Instancję aktualizuje się poleceniem upgrade z CLI Endora Commerce. Szczegóły są w dokumentacji aktualizacji instancji. Wszystkie zmiany, porównanie z wersją 0.109.0 i notatki dla każdego pakietu znajdziecie na stronie wydania na GitHubie.
Wasi klienci kupują zespołowo i potrzebują ról, limitów i akceptacji zamówień? Napiszcie do nas, pokażemy, jak to wygląda w Endora Commerce.