¶ Książka adresowa - zapisane adresy klienta i firmy
Książka adresowa w Hummerce pozwala klientowi zapisać w koncie adresy i przy zamówieniu wybrać jeden z nich, bez przepisywania danych za każdym razem. Od wersji 2.34 sklep może używać nowej książki adresowej: z adresami dostawy, rozliczeniowymi i fakturowymi, bez limitu liczby adresów, także z adresami wspólnymi dla całej firmy.
Stan na wersję Hummerce 2.35 (ostatnie zmiany w module: 2.35.30), aktualizacja 2026-09-28.
¶ Korzyści i zastosowania
- Szybsze zamówienie - klient wybiera zapisany adres zamiast go wpisywać.
- Mniej błędów w adresach dostawy przy stałych klientach.
- B2B z oddziałami - wspólne adresy firmy dostępne dla wszystkich pracowników firmy, bez przepisywania.
- Osobne adresy dostawy, rozliczeniowe i fakturowe (nowa książka adresowa).
- Własne pola adresu - np. godziny przyjęć towaru, osoba do kontaktu na budowie.
¶ Jak to wygląda
Zrzut ze sklepu demonstracyjnego Hummerce (szablon BS5).
¶ Książka adresowa w koncie klienta (standardowa)
¶ Zasady działania
¶ Standardowa książka adresowa
- Klient zapisuje w koncie adresy dostawy i przy zamówieniu wybiera jeden z nich.
- W standardowej konfiguracji do 5 adresów, jeden adres domyślny.
¶ Nowa książka adresowa
- Typy adresów: dostawa, rozliczenia, faktura (oraz kontakt i inny). Nowy adres dodany w sklepie jest domyślnie adresem dostawy.
- Bez limitu liczby adresów.
- Adres domyślny - jeden dla klienta i jeden dla firmy. Po usunięciu domyślnego sklep sam wybiera najstarszy pozostały.
- Każdy adres ma własną nazwę i niezmienny identyfikator. Sklep sprawdza przy każdej operacji, czy adres należy do klienta albo jego firmy.
- Pola adresu to parametry - sklep może dodać własne pola (np. godziny przyjęć towaru).
- Działa samodzielnie, bez wielu koszyków. Wiele koszyków w jednym zamówieniu wymaga nowej książki adresowej (zob. Koszyki).
¶ Adresy firmy
- Adresy klienta i adresy firmy: adres firmy widzą i używają wszyscy użytkownicy tej firmy w sklepie (zob. Konta firmowe i role).
- Adres firmy dodaje tylko obsługa sklepu w panelu. Klient w sklepie dodaje wyłącznie własne adresy.
- Nowy pracownik firmy od razu zamawia na adresy firmy, bez przepisywania ich do swojego konta.
¶ Wersja
- Standardowa książka adresowa - funkcja stara, w standardowej konfiguracji sklepu.
- Nowa książka adresowa - od wersji 2.34. W starszych wersjach działa standardowa książka adresowa.
- Ostatnie zmiany w module: wersja 2.35.30.
¶ Zależności
- Standardowa książka adresowa - w standardowej konfiguracji sklepu.
- Nowa książka adresowa - moduł włączany we wdrożeniu, sklep od wersji 2.34.
- Adresy firmy - konta firmowe (zob. Konta firmowe i role).
- Wiele koszyków w zamówieniu korzysta z nowej książki adresowej (zob. Koszyki).
¶ Wdrożenie
- Standardowa książka adresowa - działa po aktualizacji.
- Nowa książka adresowa wymaga wdrożenia - moduł nie jest włączony w standardowej konfiguracji. Zakres:
- włączenie modułu i aktualizacja bazy danych,
- przeniesienie adresów ze standardowej książki adresowej (nie przenoszą się automatycznie),
- ustawienie pól adresu, walidacji i tłumaczeń,
- sprawdzenie formularza zamówienia i stron konta klienta w szablonie sklepu,
- testy na środowisku testowym i uruchomienie produkcyjne.
- Minimalny szacowany czas:
- nowa książka adresowa (szablon BS5 lub BS4) - od 6 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas: liczba adresów do przeniesienia i ich jakość, własne pola adresu i ich walidacja, stopień indywidualizacji formularza zamówienia i konta klienta, liczba języków, integracje z ERP przekazujące adresy (wycena osobno), wersja sklepu (starsza niż 2.34 wymaga najpierw aktualizacji - wycena osobno).
¶ Ograniczenia
- Standardowa książka adresowa ma limit adresów (w standardowej konfiguracji 5) i nie ma adresów firmy ani typów adresów.
- Adres firmy dodaje tylko obsługa sklepu w panelu - klient firmowy nie doda go sam w sklepie.
- Adresy ze standardowej książki adresowej nie przenoszą się do nowej automatycznie.
- Nowa książka adresowa nie sprawdza poprawności adresu (np. istnienia kodu pocztowego) poza wymaganymi polami.
- Wybór adresu rozliczeniowego i fakturowego dla koszyka jest obsługiwany przez sklep, ale nie ma go w szablonach bazowych.
- Książki adresowej nie obsługuje REST API ani asystent AI (MCP).
- Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - czas przechowywania adresów i zakres zbieranych danych ustala sklep (RODO, polityka prywatności).
¶ Potencjał rozwoju
- Dodawanie adresów firmy przez uprawnionego użytkownika firmy w sklepie.
- Walidacja adresów (kody pocztowe, słowniki miejscowości).
- Automatyczne przeniesienie adresów ze standardowej książki adresowej.
- Książka adresowa w REST API i narzędziach MCP.
¶ Najczęstsze pytania
Czy w Hummerce klient może mieć więcej niż jeden zapisany adres dostawy?
Tak. Standardowa książka adresowa pozwala na do 5 adresów w standardowej konfiguracji, a nowa książka adresowa (od wersji 2.34) - bez limitu.
Czy firma B2B może mieć wspólne adresy dla wszystkich pracowników?
Tak, w nowej książce adresowej. Adres firmy dodaje obsługa sklepu w panelu, a korzystają z niego wszyscy przypisani pracownicy firmy, bez przepisywania.
Czy nowa książka adresowa jest dostępna od razu po aktualizacji sklepu?
Nie. Moduł nie jest włączony w standardowej konfiguracji i wymaga wdrożenia, w tym przeniesienia adresów ze starej książki adresowej.
Ile trwa wdrożenie nowej książki adresowej?
Od 6 h, zależnie od liczby adresów do przeniesienia, własnych pól i stopnia indywidualizacji formularza zamówienia.
Czy da się wybrać osobny adres rozliczeniowy i fakturowy dla zamówienia?
Częściowo. Sklep obsługuje takie adresy w danych, ale wyboru w koszyku nie ma w szablonach bazowych - wymaga dopasowania szablonu.
Czy adresy klienta są dostępne przez REST API lub asystenta AI?
Nie. Książki adresowej nie obsługuje ani REST API, ani MCP - dane adresowe zarządzane są wyłącznie w panelu i w koncie klienta.
¶ Powiązane
- Koszyki - koszyk korzysta z adresów książki adresowej, w tym przy wielu koszykach w zamówieniu.
- Konta firmowe i role - firmy, do których przypisane są adresy wspólne.
- Sprzedaż B2B i B2C w jednym sklepie - miejsce książki adresowej w obsłudze klientów firmowych i indywidualnych.
- Na hummerce.com: Platforma B2B.
Chcesz sprawdzić, czy nowa książka adresowa ma sens w Waszym sklepie? Umów bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Klient: CRM -> Klienci, karta klienta - zakładka Książka adresowa. Przy nowej książce adresowej w karcie klienta ustawia się Typ adresu i Zakres (Klient lub Firma).
- Konto klienta w sklepie: Książka adresowa - dodawanie, edycja, usuwanie i adres domyślny.
¶ REST API i MCP
- Brak operacji na książce adresowej w REST API (zob. REST API) i brak narzędzi MCP (zob. Asystent AI - serwer MCP).
¶ Komunikaty sklepu
Komunikaty zmienia się w edytorze komunikatów. Wartości domyślne są po polsku i angielsku.
| Klucz | Wartość domyślna |
|---|---|
msg.abookList.title |
Książka adresowa |
msg.abookList.addNewEntry |
Dodaj nowy wpis do książki adresowej |
msg.abookList.setDefault |
Ustaw domyślny |
msg.abookList.confirmDelete |
Na pewno chcesz usunąć ten wpis? |
msg.abookAdd.addNewABook |
Dodaj nowy wpis |
msg.abookAdd.editABook |
Edytuj wpis |
label.abookAdd.addNewAddress |
Dodaj nowy adres |
label.abookEdit.updateAddress |
Uaktualnij adres |
¶ Parametry
Pola adresu zmienia się zgodnie z parametrami i lokacjami.
| Symbol | Obiekt | Etykieta |
|---|---|---|
_delivery_firstName, _delivery_lastName |
wpis książki adresowej | imię, nazwisko |
_delivery_street, _delivery_postcode, _delivery_city, _delivery_country |
wpis książki adresowej | ulica, kod pocztowy, miasto, kraj |
_delivery_phone |
wpis książki adresowej | telefon |
_addressBookEntryType |
wpis książki adresowej | typ adresu |