Przejdź do głównej zawartości

Cenniki (price_lists)

Każda cena, którą kupujący widzi albo płaci — na liście produktów, na stronie produktu, w wyszukiwarce, w koszyku, w zamówieniu, jako cena referencyjna zapytania ofertowego, w zewnętrznym API katalogu i w feedzie produktowym — pochodzi z cenników. Ta strona wyjaśnia, czym jest cennik i jak platforma wybiera cenę, którą płaci kupujący. Dwie kolejne strony opisują szczegóły:

  • Edytor cenników — ekrany panelu administracyjnego krok po kroku: lista cenników, tworzenie cennika, siatka cen, import i eksport CSV, duplikowanie cennika, ceny bazowe w produkcie, wyjaśnienie ceny i Ustawienia cenowe.
  • Ceny dla programistów — model danych, algorytm wyceny, jedyna dozwolona ścieżka odczytu, pamięć podręczna, powierzchnia cen stojąca za sortowaniem według ceny, API administracyjne, porty używane przez inne moduły oraz to, jak wydanie przekształciło stary model.

Modułu nie można wyłączyć na ekranie modułów: sprzedaż B2B to ceny kontraktowe, a bez tego modułu każdy kupujący płaciłby bez ostrzeżenia cenę bazową.

Idea w jednym akapicie​

Każdy produkt ma cenę bazową w każdej walucie. Cennik katalogowy może zmienić tę cenę dla wszystkich w wybranych kanałach sprzedaży. Cennik dla kupującego daje organizacji, zbiorowi organizacji albo zbiorowi grup klientów ich własne ceny. Cennik promocyjny oferuje cenę czasową, która jest naliczana tylko wtedy, gdy jest niższa od ceny, jaką kupujący zapłaciłby w przeciwnym razie. Gdy kilka cenników wycenia ten sam produkt dla tego samego kupującego, o zwycięzcy decyduje stała, jawna kolejność — kolejność cen — a wyjaśnienie ceny pokazuje dla dowolnego kupującego i produktu, który cennik wygrał, a które przegrały.

Czym jest cennik​

Cennik ma nagłówek i wiersze.

Nagłówek ustala:

PoleCo oznacza
NazwaPo niej rozpoznajesz cennik. Zmiana nazwy nigdy nie zmienia tego, która cena wygrywa.
TypCeny regularne — ceny, które płacą kupujący — albo Ceny promocyjne, naliczane tylko wtedy, gdy są niższe od zwykłej ceny kupującego.
WalutaDokładnie jedna. Po utworzeniu cennika nigdy się nie zmienia; aby ustalić ceny w innej walucie, zduplikuj cennik.
Kanały sprzedażyKanały, w których cennik obowiązuje. Każdy musi sprzedawać w walucie cennika. Kanał, który później przestaje oferować tę walutę, zostaje w cenniku jako Nieaktywny, a cennik przestaje w nim obowiązywać; gdy kanał znów oferuje walutę, cennik znów obowiązuje — bez żadnej zmiany w cenniku.
Dla kogo są ceny (odbiorcy)Wszyscy, zbiór grup klientów albo zbiór organizacji — jeden rodzaj na cennik, nigdy mieszanka. Rodzaj nie zmienia się, odkąd cennik był aktywny.
HarmonogramOpcjonalny początek i koniec. Cennik obowiązuje dokładnie od chwili początku do chwili końca.
PriorytetLiczba całkowita. Rozstrzyga tylko między cennikami, które wyceniają ten sam rodzaj linii dla tego samego kupującego — wygrywa wyższa liczba — i nigdy nie pozwala ogólnej linii wygrać z bardziej szczegółową.
StanSzkic, Zaplanowany, Aktywny albo Wygasły. Szkic nigdy nie obowiązuje. Aktywacja zmienia stan cennika na Aktywny, a na Zaplanowany, gdy jego początek jest w przyszłości. Zmiana dat aktywnego albo zaplanowanego cennika ustala jego stan w ten sam sposób od nowa, a gdy jego koniec już minął, zmienia stan na Wygasły. Przenieś do szkiców znów wyłącza cennik z użycia.

Cennik można aktywować tylko wtedy, gdy obowiązywałby gdzieś i kogoś: potrzebuje co najmniej jednego kanału sprzedaży, który sprzedaje w jego walucie, a cennik grup klientów lub organizacji — co najmniej jednego odbiorcy.

Każdy wiersz wycenia jedną linię cennika dla progu ilościowego. Linia to jedno z:

LiniaWycenia
Wszystkie produktykażdy produkt (tylko procentem albo korektą — nigdy jedną ceną stałą dla wszystkiego)
Wartość atrybutukażdy produkt z tą wartością atrybutu, na przykład color = red
Kategoriakażdy produkt przypisany do tej kategorii (własne przypisanie produktu; podkategorie się nie liczą)
Kategoria i wartość atrybutuprodukty z tej kategorii, które mają tę wartość — na przykład czerwone produkty z kategorii Screws
Produktjeden produkt i wszystkie jego warianty
Wariantjeden wariant produktu

Linie atrybutów mogą tworzyć tylko atrybuty oznaczone jako Reguły cennika w Katalog → Atrybuty, i tylko takie, których wartości są pojedynczym wyborem, wielokrotnym wyborem albo tak/nie i które nie zależą od języka ani od kanału sprzedaży. Jeśli atrybut straci tę flagę (albo przestanie się kwalifikować), jego linie przestają wyceniać — siatka pokazuje je jako Nieaktywne z przyczyną — i znów wyceniają, gdy tylko atrybut znów się kwalifikuje. Wycena nigdy nie kończy się błędem z powodu takiej linii.

Wiersz podaje cenę na jeden z trzech sposobów:

RodzajWpisywany jakoZnaczenie
Cena stała95 albo 95,50cena, do czterech miejsc po przecinku
Procent-5%, +20%rabat albo narzut, od −100 % (pozycja za darmo) do +1000 %, do dwóch miejsc po przecinku
Korekta kwotowa-3, +3kwota odejmowana albo dodawana

Procent albo korekta jest liczona od ceny odniesienia: od ceny bazowej w cenniku katalogowym, od ceny katalogowej w cennikach dla kupujących i promocyjnych (zob. niżej). Jeśli wynik wiersza byłby poniżej zera, ten wiersz nie wycenia linii i sprawdzany jest następny kandydat; wynik równy dokładnie zero jest poprawną ceną.

Progi ilościowe. Każdy wiersz zaczyna się od pewnej ilości („od 1”, „od 10”, „od 100”) i, jeśli nie ma jawnego końca, obowiązuje do miejsca, w którym zaczyna się następny próg tej linii. Dwa wiersze tej samej linii nie mogą na siebie nachodzić. Wiersz, który nie obejmuje zamawianej ilości, jej nie wycenia, a wycena przechodzi do następnego kandydata — innego progu tej samej linii albo innej linii.

Cennik może mieć najwyżej 5 000 wierszy. Cenniki cen bazowych nie mają tego limitu, bo przechowują cenę bazową każdego produktu w katalogu.

Ceny bazowe​

Każda waluta ma dokładnie jeden cennik cen bazowych — na liście widoczny jako Ceny bazowe — PLN, Ceny bazowe — EUR i tak dalej. Obowiązuje każdego kupującego, w każdym kanale sprzedaży, który sprzedaje w jego walucie, i jest zawsze aktywny: nie można zmienić jego nazwy, zaplanować go, nadać mu priorytetu ani go usunąć.

  • Cena bazowa produktu to cena stała, opcjonalnie z progami ilościowymi, w każdej walucie, w której sprzedajesz produkt. Ustawiasz ją w samym produkcie (Katalog → Produkty, zakładka Pricing) albo w siatce cennika cen bazowych.
  • Wariant albo dziedziczy cenę bazową produktu, albo ma własną cenę, albo jest procentem lub kwotą powyżej albo poniżej ceny bazowej produktu przy tej samej ilości.

Cena bazowa nigdy nie jest przeliczana między walutami: produkt z ceną bazową tylko w PLN nie ma w EUR żadnej ceny. Produkt bez ceny bazowej w danej walucie, którego nie wycenia żaden inny cennik, nie ma w tej walucie ceny: kupujący nie mogą dodać go do koszyka i widzą zamiast tego ścieżkę zapytania ofertowego. Innej ceny zastępczej nie ma — produkt nie ma własnej ceny.

Cennik cen bazowych domyślnej waluty platformy istnieje zawsze; cennik cen bazowych innej waluty powstaje przy pierwszym zapisie ceny bazowej w tej walucie.

Jak wybierana jest cena, którą płaci kupujący​

Cena jest zawsze wyliczana dla produktu (a jeśli jest wybrany — wariantu), ilości, kanału sprzedaży, waluty i kupującego. Kupujący to gość albo organizacja — razem z jej organizacjami nadrzędnymi — oraz jedna grupa klientów: własna grupa zalogowanego klienta, jeśli ją ma, a w przeciwnym razie grupa jego organizacji.

Udział biorą tylko cenniki, które są teraz aktywne, w walucie żądania, w kanale żądania (gdy ten kanał sprzedaje w tej walucie) i dla tego kupującego. Cena powstaje potem w czterech krokach:

  1. Cena bazowa — wiersz bazowy wariantu, jeśli wariant go ma, a w przeciwnym razie wiersz produktu, w progu obejmującym ilość.
  2. Cena katalogowa — najlepszy wiersz cenników regularnych dla wszystkich w tym kanale, jeśli któryś wycenia linię: linia wariantu przed linią produktu, przed linią kategorii i wartości atrybutu, przed linią kategorii, przed linią wartości atrybutu, przed linią wszystkich produktów. Procenty są liczone od ceny bazowej. Jeśli żaden taki wiersz nie wycenia linii, ceną katalogową jest cena bazowa.
  3. Cena kupującego — najlepszy wiersz cenników regularnych dla organizacji i grupy klientów kupującego, według opisanej niżej kolejności cen. Procenty są liczone od ceny katalogowej. Jeśli żaden taki wiersz nie wycenia linii, ceną kupującego jest cena katalogowa.
  4. Cena promocyjna — najlepszy wiersz cenników promocyjnych, które dotyczą kupującego (najpierw cenniki promocyjne jego organizacji i grupy, potem cenniki promocyjne dla wszystkich). Procenty są liczone od ceny katalogowej. Cena promocyjna jest naliczana tylko wtedy, gdy jest ściśle niższa od ceny kupującego; kupujący widzi wtedy swoją cenę przekreśloną. Cena promocyjna równa cenie kupującego lub wyższa nie jest naliczana i nic nie jest przekreślane — klient kontraktowy nigdy nie płaci więcej z powodu promocji.

Ponieważ procenty dla kupujących są liczone od ceny katalogowej, rabat kontraktowy podąża za ceną kanału: jeśli kanał sprzedaje produkt za 120 zamiast 100, rabat kontraktowy 20 % daje 96.

Procenty są zaokrąglane połówkowo w górę do czterech miejsc po przecinku. Cena zachowuje cztery miejsca aż do faktury: pozycja koszyka, zamówienie, które ją przejmuje, podgląd zamówienia, cena referencyjna i uzgodniona w zapytaniu ofertowym oraz pozycja faktury niosą cenę jednostkową bez zaokrąglenia, a zaokrąglana jest tylko wartość pozycji — cena jednostkowa × ilość — raz, połówkowo w górę, do dwóch miejsc. Wkręt po 0,0125 kosztuje 125,00 za 10 000 sztuk, a 0,0150 × 3 to 0,045, czyli 0,05. Cena jednostkowa jest pokazywana ze swoimi znaczącymi miejscami, do czterech, a z dwoma, gdy trzecie i czwarte są zerami: 0,0125 zł, 1,505 zł, 1,50 zł; wartości pozycji i sumy mają zawsze dwa miejsca. Plik produktowy publikuje dwa miejsca i nie zaokrągla przy tym żadnej ceny jednostkowej: cena z trzecim albo czwartym znaczącym miejscem trafia do pliku jako dokładna cena opakowania — 9,0450 jako 10 sztuk za 90,45, 0,0125 jako 100 za 1,25 — a jeśli szablon feedu nie potrafi wyrazić opakowania, nie trafia wcale (moduł Feedy produktowe).

Kolejność cen​

Kupującego może wyceniać naraz kilka linii — cena jego organizacji za jeden produkt, rabat jego organizacji na całą kategorię, cena jego grupy klientów za ten sam produkt. Każdy kandydat należy do jednej z dwunastu komórek: dla kogo jest cennik (organizacja albo grupa klientów) × co wybiera linia. Kolejność cen to porządek tych dwunastu komórek; wygrywa pierwsza komórka, w której jest kandydat.

Platforma jest dostarczana z ustawieniem Najpierw umowa, rabat ogólny na końcu (HY):

#KomórkaPrzykład
1Organizacja × wariantcena Acme za jeden wariant produktu Screws 0200
2Organizacja × produktcena Acme za Screws 0200
3Organizacja × kategoria i wartość atrybutucena Acme za czerwone produkty z kategorii Screws
4Organizacja × kategoriacena Acme za wszystko z kategorii Screws
5Organizacja × wartość atrybutucena Acme za wszystko, co czerwone
6Grupa klientów × wariantcena klientów VIP za jeden wariant produktu Screws 0200
7Grupa klientów × produktcena klientów VIP za Screws 0200
8Grupa klientów × kategoria i wartość atrybutucena klientów VIP za czerwone produkty z kategorii Screws
9Grupa klientów × kategoriacena klientów VIP za wszystko z kategorii Screws
10Grupa klientów × wartość atrybutucena klientów VIP za wszystko, co czerwone
11Organizacja × wszystkie produktyrabat Acme na wszystko
12Grupa klientów × wszystkie produktyrabat klientów VIP na wszystko

Wynegocjowane ceny organizacji wygrywają więc z cenami jej grupy, z jednym wyjątkiem: ogólny rabat organizacji na wszystko nie wygrywa z konkretną ceną, którą ma jej grupa klientów — inaczej mały rabat ogólny sprawiałby, że ta organizacja płaci więcej niż każdy inny członek grupy. Linia kategorii wygrywa z linią wartości atrybutu na każdym kroku.

W obrębie jednej komórki pozostałe remisy rozstrzyga kolejno:

  1. Bliższa organizacja — linia własnej organizacji kupującego przed linią jej organizacji nadrzędnej, przed linią organizacji nadrzędnej wobec tamtej. Oddział bez własnej linii w danej komórce dostaje linię centrali.
  2. Priorytet — wygrywa wyższa liczba.
  3. Wyższa ilość początkowa — wiersz „od 100” przed wierszem „od 10”, który również obejmuje ilość.
  4. Niższa cena.
  5. Stały porządek wewnętrzny, dzięki któremu wynik nigdy nie zależy od czasu, od zmiany nazwy ani od tego, który cennik edytowano jako ostatni.

Obowiązująca kolejność jest widoczna tylko do odczytu w Ustawieniach cenowych. W kodzie istnieją trzy inne ustawienia — Najpierw odbiorca (AF), Najpierw szczegółowość (SF) i Najpierw odbiorca, najbliższa organizacja przed nadrzędnymi (AF-N) — ale zmiana kolejności nie jest jeszcze dostępna: pojawi się w jednym z kolejnych wydań, z podglądem skutków zmiany.

Warianty​

Wariant jest wyceniany w tych samych cennikach co jego produkt. Linia wariantu wygrywa z linią jego produktu u tych samych odbiorców; stała cena produktu obowiązuje każdy wariant, chyba że wycenia go linia wariantu z tej samej albo lepszej komórki; procent na produkcie zachowuje różnice między jego wariantami. Linia atrybutu dopasowuje wariant po jego własnych wartościach osi (czerwony wariant produktu pasuje do color = red), nałożonych na wartości produktu.

Na liście produktów produkt, którego warianty kosztują różnie, pokazuje najniższą cenę jako cenę „od”; sortowanie i filtrowanie według ceny korzystają z tej najniższej ceny. Na stronie produktu pokazywana jest cena wybranego wariantu, a koszyk nalicza cenę wariantu z pozycji.

Gdzie pojawiają się ceny​

Ten sam kupujący, produkt, wariant, ilość, kanał i waluta dają tę samą cenę na każdej powierzchni: na listach produktów, w wynikach i podpowiedziach wyszukiwania, na stronie produktu, w porównaniach, w produktach powiązanych, w koszyku i przy składaniu zamówienia, w formularzu zamówienia w panelu administracyjnym, w zapytaniach ofertowych, w zewnętrznym API katalogu i w feedach produktowych. Koszyk ponownie wycenia pozycję przy każdym dodaniu, połączeniu i zmianie ilości, a złożenie zamówienia odrzuca koszyk, którego zapisana cena nie jest już aktualna (409 CART_PRICE_CHANGED), więc kupujący sprawdza nową cenę przed zamówieniem.

Sortowanie i filtrowanie według ceny podąża za cenami pokazywanymi na kartach produktów, dla każdego kupującego — kupujący z własnymi cenami kontraktowymi widzi listę w porządku swoich cen. Porządek pochodzi z cen wyliczanych przez platformę w tle: po zmianie ceny karty od razu pokazują nową cenę, a porządek sortowania nadąża, gdy tylko wykona się odświeżanie w tle. Odświeżanie przelicza tylko produkty, które zmiana może przesunąć, dla kupujących, do których sięga, więc linia cennika, cena bazowa albo edycja produktu pojawia się w porządku w ciągu około pół sekundy w pomiarach platformy, także w trakcie dużego importu produktów. Zmiana, która sięga całego katalogu — linia dla wszystkich produktów albo tylko dla wartości atrybutu, zmiana ponad 10 000 produktów naraz albo zmiana kanału sprzedaży — przelicza porządek w całości dla każdej grupy kupujących, do której sięga, co w dużym katalogu z wieloma cennikami kontraktowymi może trwać minutę lub dwie. Platforma zakłada dla niej dwie i pół minuty przy około 200 takich grupach, wobec jednej minuty dla każdej innej zmiany. Platforma zmierzyła około 1 min 25 s przy 202 grupach.

Cena katalogowa obok ceny kupującego. Po włączeniu ustawienia Pokazuj cenę katalogową obok ceny kupującego (Ustawienia cenowe, domyślnie wyłączone) kupujący, którego cena jest niższa od ceny katalogowej, widzi obie na stronie produktu, na listach produktów, w wynikach wyszukiwania i w podpowiedziach — Cena katalogowa 100,00 · Twoja cena 95,00. Kupujący, którego cena jest równa cenie katalogowej lub wyższa, widzi jedną cenę. Gdy naliczana jest cena promocyjna, kupujący widzi tylko dwie ceny: przekreśloną cenę katalogową i cenę promocyjną jako Twoja cena; jego zwykła cena kontraktowa nie jest pokazywana jako trzecia liczba. Przy wyłączonym ustawieniu naliczona cena promocyjna przekreśla własną cenę kupującego. Koszyk i składanie zamówienia zawsze pokazują tylko naliczaną cenę.

Tryby prezentacji decydują, jak ceny są pokazywane — tylko brutto, tylko netto, obie albo wcale. Tryb none ukrywa wszystkie ceny i zastępuje Dodaj do koszyka przyciskiem Dodaj do zapytania ofertowego; koszyk również odrzuca taki produkt (400 CART_PRODUCT_QUOTE_ONLY). Ceny wstrzymuje serwer, a nie tylko strona: listy produktów, karta produktu, wyniki i podpowiedzi wyszukiwania, porównania, produkty powiązane i zewnętrzne API katalogu nie wysyłają dla takiego produktu żadnej kwoty. Przy sortowaniu po cenie taki produkt nie jest szeregowany — trafia za produkty z ceną, w obu kierunkach — a filtr zakresu cen go pomija. Tryb none dla anonimowych odwiedzających to konfiguracja „ceny po zalogowaniu”. Tryb ustawia się osobno dla zalogowanych i anonimowych odwiedzających — dla wszystkich kanałów sprzedaży w Ustawieniach cenowych albo dla jednego kanału na ekranie Ustawienia, gdzie wartość kanału wygrywa z wartością dla całej platformy — i można go nadpisać dla organizacji, kategorii i produktu; wygrywa najbardziej szczegółowe ustawienie. Nadpisanie produktu lub kategorii wygrywa także dla anonimowych odwiedzających: produkt nadpisany na Tylko brutto pokazuje cenę gościom nawet w kanale, którego tryb dla anonimowych to Żaden, i jest to jedyny sposób, by pokazać tam gościowi cenę. Nadpisanie organizacji dotyczy tylko zalogowanych kupujących z tej organizacji. Tryby prezentacji ustawia się w Ustawieniach cenowych oraz w edytorach organizacji i kategorii. W edytorach organizacji i kategorii nadpisanie jest częścią jednego przycisku Zapisz edytora: wybór trybu czeka na zapis, a Zapisz edytora zapisuje go po własnych zmianach organizacji lub kategorii.

Cena brutto na karcie produktu, w wierszu listy i na stronie produktu to cena netto powiększona o stawkę VAT tego produktu dla oglądającego — tę samą, którą stosują koszyk i zamówienie, według reguł podatkowych dla typu produktu i organizacji oglądającego: 8 % dla produktu opodatkowanego stawką 8 %, a bez VAT dla organizacji zwolnionej z VAT lub rozliczającej odwrotne obciążenie. Niezalogowany odwiedzający widzi stawkę, którą płaci czynny podatnik VAT w Polsce. Jeśli sklep nie może poznać stawki, pokazuje cenę netto z oznaczeniem „netto”, a nie kwotę brutto, za którą nie może ręczyć.

Kanały sprzedaży nie mają własnego przełącznika widoczności cen. Kiedyś go miały (isPublic), a gdy był wyłączony, kanał ukrywał ceny przed wszystkimi, także przed zalogowanymi kupującymi. Przełącznik wycofano: każdy kanał, który miał go wyłączonego, dostał tryb Żaden dla anonimowych odwiedzających, więc goście nadal nie widzą tam cen, a jego zalogowani kupujący widzą teraz ceny zgodnie ze swoim trybem prezentacji.

Przykłady — sklep demonstracyjny​

Sklep demonstracyjny (pnpm run cli demo seed) zawiera trzy scenariusze, na podstawie których zaprojektowano model, z dokładnymi liczbami. Jego dane:

  • Screws 0200 — czerwony, w kategorii Screws, cena bazowa 100,00 PLN;
  • Screws 0032 — niebieski, w kategorii Screws, cena bazowa 50,00 PLN;
  • Bolts 0025 — czerwony, w kategorii Bolts, cena bazowa 30,00 PLN;
  • organizacja Acme B2B (demo), członek grupy klientów VIP.

Trzy scenariusze są alternatywami: po wczytaniu danych demonstracyjnych cenniki E3 są aktywne, a cenniki E1 i E2 są szkicami. Aby zobaczyć E1 albo E2, aktywuj cenniki tego scenariusza, a pozostałe przenieś do szkiców.

E1 — cena dla wszystkich na kategorię i wartość atrybutu. Cennik E1 — red screws for everyone (demo): regularny, dla wszystkich, jedna linia Screws ∩ color = red, cena stała 120.

KupującyProduktPłaciDlaczego
gośćScrews 0200120,00linia katalogowa wycenia czerwone wkręty
gośćScrews 003250,00niebieski: linia nie pasuje, więc cena bazowa
gośćBolts 002530,00czerwony, ale nie wkręt: cena bazowa
AcmeScrews 0200120,00Acme nie ma w tym scenariuszu własnego cennika

E2 — umowa organizacji. Cennik E2 — Acme B2B contract (demo): regularny, dla organizacji Acme, Screws −10 %, Screws 0200 −20 %.

KupującyProduktPłaciDlaczego
AcmeScrews 020080,00linia produktu (−20 %) wygrywa z linią kategorii (−10 %)
AcmeScrews 003245,00linia kategorii
AcmeBolts 002530,00nic nie pasuje: cena bazowa
inna organizacjaScrews 0200100,00nie jest odbiorcą: cena bazowa

Gdy aktywny jest także E1, Acme płaci za Screws 0200 96,00: −20 % jest liczone od ceny katalogowej 120, a nie od ceny bazowej.

E3 — organizacja w grupie klientów. Cenniki E3 — VIP customers (demo) (dla grupy klientów VIP, Screws 0200 −10 %) oraz E3 — Acme B2B terms (demo) (dla organizacji Acme, Screws 0200 −5 %, Screws −15 %).

KupującyProduktPłaciDlaczego
AcmeScrews 020095,00Organizacja × produkt (−5 %) to najlepsza komórka; linia kategorii (85,00) i linia VIP (90,00) przegrywają
inna organizacja z grupy VIPScrews 020090,00linia VIP
AcmeScrews 003242,50linia kategorii Acme (−15 %)
oddział AcmeScrews 020095,00odziedziczona po centrali
gość albo organizacja spoza VIPScrews 0200100,00cena bazowa

Wyjaśnienie ceny odpowiada na każdy wiersz tych tabel, podając zwycięski cennik, komórkę, cenę odniesienia i przegrane linie.

Kto może co​

UprawnienieDaje
price_lists:readlistę cenników, ustawienia i ceny każdego cennika, ceny bazowe, wyjaśnienie ceny, Ustawienia cenowe
price_lists:writetworzenie, zmienianie, aktywowanie, planowanie, duplikowanie, importowanie i usuwanie cenników; ceny bazowe; tryby prezentacji; ustawienie ceny katalogowej. Dodawanie linii produktów korzysta też z przeglądarki produktów katalogu, więc rola edytująca cenniki potrzebuje także catalog:read (mówi o tym edytor ról na /admin-roles).

Handlowcy — administratorzy, których rola ogranicza do organizacji, do których sięgają: przypisanych do nich (z organizations:rollup także ich organizacji podrzędnych) i każdej organizacji, do której nie jest przypisany żaden handlowiec — widzą i edytują tylko cenniki organizacji, w których każdy odbiorca jest jedną z ich organizacji. Cenniki dla wszystkich, cenniki grup klientów i ceny bazowe są dla nich tylko do odczytu. Cennik, który wskazuje jakąkolwiek organizację spoza ich zakresu, dla nich nie istnieje: nie ma go na liście, a jego adres pokazuje tę samą stronę co cennik, którego nigdy nie utworzono; tak samo jest z cennikiem organizacji, który nie wskazuje jeszcze żadnej organizacji. Tworząc, duplikując albo zmieniając cennik, mogą wybrać tylko Organizacje, tylko własne i co najmniej jedną.

Każda zmiana cennika — jego ustawień, kanałów, odbiorców, wierszy, aktywacji, duplikat, usunięcie — oraz każda zmiana cen bazowych i ustawienia ceny katalogowej jest zapisywana w dzienniku audytu z administratorem i stanem przed zmianą i po niej; Zobacz historię w cenniku otwiera jego wpisy.

Znane ograniczenia​

  • Kolejności cen nie można jeszcze zmienić. Obowiązuje wyłącznie ustawienie HY; proces zmiany, z podglądem skutków, pojawi się w jednym z kolejnych wydań.
  • Promocje działają dodatkowo na ceny promocyjne i kontraktowe. Promocja koszyka nie wie jeszcze, czy pozycja jest wyceniona ceną promocyjną albo kontraktową; wykluczanie takich pozycji pojawi się w jednym z kolejnych wydań.
  • Lista cenników nie ma zapisanych widoków; jej filtry są przechowywane w adresie strony, więc przefiltrowaną listę można dodać do zakładek i udostępnić (zgłoszenie #408).
  • Tuż po dużym imporcie stronicowanie i wyszukiwanie w siatce bardzo dużego cennika (dziesiątki tysięcy linii) mogą przez mniej więcej minutę trwać nieco dłużej: po zapisie zbiorczym moduł prosi procesy w tle o odświeżenie statystyk bazy danych dla tabel cen minutę później (zgłoszenie #409). Bez działających procesów w tle zrobi to później samo utrzymanie bazy danych.
  • Porządek sortowania opóźnia się względem zmiany ceny o czas odświeżania w tle — zwykle poniżej sekundy, a do około dwóch i pół minuty przy zmianie, która sięga całego katalogu (zob. Gdzie pojawiają się ceny); ceny na kartach nigdy się nie opóźniają. Sortowanie według ceny wymaga działających workerów platformy.
  • Zewnętrzne API katalogu wycenia organizację klucza API z grupą klientów tej organizacji, a nie z własną grupą powiązanego konta klienta, a jego zbiorcze żądanie cen wskazuje wyłącznie SKU produktów.
  • Feedy produktowe wyceniają produkty, nie warianty, dla ilości 1; feed przypina się do cennika na karcie Ustawienia feedu, która podpowiada tylko cenniki publikujące dla niego.

Aktualizacja ze starych cenników (uwaga migracyjna)​

Wydanie, które wprowadziło cenniki w obecnym kształcie, zastąpiło poprzedni model cen w jednym kroku. W instancji, która go używała:

  • Ceny bazowe zostały zachowane. Każda cena starego cennika Default stała się ceną bazową w swojej walucie.
  • Wszystkich pozostałych cenników już nie ma — razem z ich regułą stosowania, produktami i przedziałami ilościowymi oraz macierzą cen. Ceny, które zawierały, utwórz ponownie jako cenniki. Jedynym wyjątkiem jest cennik, do którego był przypięty feed produktowy: zostaje, z tym samym id, jako pusty, wygasły cennik dla wszystkich bez kanału sprzedaży, o nazwie <old name> (removed by the 0.108.0 upgrade) (dawna nazwa jest skracana tak, by całość mieściła się w 200 znakach). Usuń go, gdy żaden feed go nie potrzebuje; feed nadal do niego przypięty ostrzega wtedy, że jego cennik już nie istnieje.
  • Nie ma już Default unit price produktu ani nadpisania ceny wariantu i nie zostały one przeniesione: edytor produktu nie ma tych pól, a zapisy produktów i import produktów je odrzucają (400 PRICE_SET_IN_PRICE_BOOKS). Produkt, który miał tylko Default unit price, a nie miał ceny w cenniku Default, nie ma ceny, dopóki nie wpiszesz ceny bazowej w jego zakładce Pricing.

Co zrobiły migracje i które wywołania API zastąpiły usunięte, opisano na stronie Ceny dla programistów.