B2B košík a pokladna - co odběratel vidí navíc

Otevřené otázky

Otázky jsou jen pro vývoj. Žádná nebrání začít s odblokováním B2B objednávky ve FrontAPI.

Co B2B košík ukazuje navíc

Stav ve starém B2B a ve FrontAPI je ověřený v kódu. „Jádro" = umí to jádro MasterShopu, „dnes obálka" = umí to jen stará obálka ALBI.

Starý B2B dnes

Snímky starého B2B jsou u wireframů v části StorefrontX, vedle nového návrhu.

Workflow

Čtyři kroky jako starý B2B. Předpoklad: zákazník je přihlášený na B2B prezentaci a má zvolenou doručovací adresu (S02). Košík patří této adrese.

1. Krok 1 Přehled košíku. Zákazník otevře košík. SFX načte košík a stav dopravy zdarma. Zobrazí položky, lištu dopravy zdarma a souhrn: počet kusů, celkem bez DPH, celkem s DPH.
   • Objednávku nelze dokončit (isOrderAllowed = false): alert s hláškou podle důvodu, „Pokračovat" je neaktivní, další kroky nejsou klikací. Košík jde dál upravovat. Dlužník: S04. Neaktivní adresa, zákazník nebo blokovaný uzel: „Nelze provést objednávku". Adresa bez povolené platby: „Pro Váš účet neevidujeme žádnou povolenou dopravu."
   • Objednávku lze dokončit: „Pokračovat" je aktivní.
2. Zákazník změní množství v poli, tlačítkem „+1 balení" / „+2 balení" nebo odebere položku „×". SFX pošle nový počet do košíku a načte košík znovu.
   • Počet je násobek balení a do maxima: košík se přepočítá.
   • Počet není násobek balení: jádro zaokrouhlí NAHORU na násobek balení (nad maximum dolů) a vrátí varování. SFX ukáže toast „Není možné nakoupit tento počet kusů produktu „%s". Počet kusů musí být dělitelný číslem %d." a zobrazí opravený počet. D4
   • Počet je nad maximum: jádro ořízne na maximum. Toast „Není možné nakoupit více než %s ks produktu „%s"."
   • Produkt už není skladem nebo v sortimentu: položka zmizí. Hláška „Produkt „%s" již není skladem a byl z košíku odebrán."
3. Zákazník klikne na „Pokračovat". SFX přejde do kroku 2.
4. Krok 2 Dodací podmínky. Zákazník vybere dopravu a platbu. Nabídka obsahuje jen dopravy a platby povolené na zvolené adrese.
   • Žádná povolená platba: stav jako v kroku 1, zákazník se vrátí do košíku s hláškou.
   • Doprava a platba vybrané: pokračuje se.
5. SFX ukáže fakturační adresu (s IČ a DIČ) a doručovací adresu jen ke čtení. Zákazník je NEMŮŽE upravit ani v košíku přepnout, stejně jako starý B2B. Doručovací adresa = aktivní adresa košíku.
6. Zákazník vyplní nepovinná B2B pole: „Požadované datum dodání", „Interní číslo vaší objednávky", Poznámka. Kalendář nabídne jen dny od nejbližšího data doručení zvolené dopravy do jejího maxima. „Pouze kompletní zásilka" se NENABÍZÍ, stejně jako starý B2B.
7. Zákazník klikne na „Pokračovat". SFX přejde do kroku 3. Pole se odešlou až s objednávkou.
8. Krok 3 Souhrn objednávky. SFX ukáže položky seskupené podle cost levelu, „Přehled sazeb DPH", „Sumarizace" (doprava, platba, celkem) a „Údaje firmy". U tlačítka „Odeslat objednávku" je věta „Odesláním objednávky souhlasím s obchodními podmínkami." Seskupení podle cost levelu a přehled DPH jsou stejně jako starý B2B.
9. Zákazník klikne na „Odeslat objednávku". SFX pošle objednávku s dopravou, platbou, poznámkou a B2B poli. Adresy NEPOSÍLÁ, server je doplní sám. Tlačítko je do odpovědi neaktivní.
   • Úspěch: objednávka vznikne, cena se po vytvoření už nepřepočítává. Objednávka jde do AlbiLine s interním číslem a požadovaným datem. Košík se vyprázdní. Pokračuje se krokem 4.
   • Blokace (dlužník, blokovaný zákazník, adresa nebo uzel, nepovolená platba se změnila během nákupu): server objednávku odmítne s vlastním kódem. SFX ukáže hlášku a vrátí zákazníka do kroku 1. Dlužník: S04.
   • Neplatné datum dodání: server vrátí kód chyby data. SFX vrátí zákazníka do kroku 2 a u pole ukáže „Datum doručení musí být v pracovní den" nebo „Toto datum doručení není u zvolené dopravy možné".
   • Jiná chyba odeslání (výpadek, chyba serveru): hláška „Objednávku se nepodařilo odeslat, zkuste to znovu." Objednávka nevznikla, košík se NEMĚNÍ, zákazník zůstane v kroku 3.
10. Krok 4 Objednávka odeslána. SFX ukáže číslo objednávky, celkovou cenu s DPH i bez DPH, „Zbývá k úhradě", dopravu, platbu, interní číslo a požadované datum.

StorefrontX

Jádro SFX má kroky košíku, součet bez DPH a zobrazení varování z FrontAPI. B2B podobu skládá obálka SFX. Vzhled podle design systému ALBI, chování podle prototypu.

Kroky a trasy

Názvy kroků ve stepperu jsou překladové klíče BASKET_STEPPER.steps.*. Kroky „Přehled košíku", „Dodací podmínky", „Souhrn objednávky", „Objednávka odeslána" jako dnes.

Náhled FE: krok 1, 2 a 3 nového B2B

Čárkovaný rámeček = B2B prvek, který jádro SFX nemá.

WF-S1

Krok 1 Přehled košíku

Starý B2B · dnes

Nový B2B · SFX

ALBI B2BLípová 12, Praha 2 · ceny bez DPH

1Přehled košíku2Dodací podmínky3Souhrn objednávky4Odesláno

Máte dopravu zdarma

Puzzle Karak 500 dílků

P‑4412 | K12 | 8590228012345

skladem · 6 ks v balení

−12++6+12

1 548,00 Kčbez DPH · 1 873,08 Kč s DPH ×

Hrnek Kočka 330 ml

HR‑7701 | D07 | 8590228067890

skladem · 6 ks v balení

−18++6+12

2 682,00 Kčbez DPH · 3 245,22 Kč s DPH ×

Přání k narozeninám

P‑6601 | P03 | 8590228055501

skladem · 25 ks v balení

−25++25+50

725,00 Kčbez DPH · 812,00 Kč s DPH ×

Počet kusů55 ks Celkem za nákup bez DPH4 955,00 Kč Celkem za nákup s DPH5 930,30 Kč

← Zpět do obchoduPokračovat →

Řádek: kód | cost level | EAN, sklad, „X ks v balení". Pole množství má krok = balení. Tlačítka přičtou 1 a 2 balení, popisek je počet kusů jako dnes. Hlavní cena je bez DPH. Pole pro slevový kód NENÍ. Při blokaci je nad položkami červený alert a „Pokračovat" je šedé.

WF-S2

Krok 2 Dodací podmínky

Starý B2B · dnes

Nový B2B · SFX

ALBI B2BKošík › Dodací podmínky

✓Přehled košíku2Dodací podmínky3Souhrn objednávky4Odesláno

Doprava

Firemní zásilka PPL/DPD/GeisZdarma

Vlastní rozvoz ALBIZdarma od 5 000 Kč

Platba

FakturaObjednané zboží bude zasláno spolu s fakturou k zaplacení.

Fakturační adresajen ke čtení

Papírnictví u Lípy s. r. o., Lípová 12, 120 00 Praha 2 · IČ 27604977 · DIČ CZ27604977

Doručovací adresajen ke čtení

Pobočka Lípová, Lípová 12, 120 00 Praha 2

Požadované datum dodáníVyberte datum

Interní číslo vaší objednávkyZadejte číslo objednávky

PoznámkaZde můžete napsat poznámku či připomínku k objednávce.

Rekapitulace

3 položky · 55 ks
Doprava zdarma · Platba zdarma

Celkem bez DPH4 955,00 Kč Celkem s DPH5 930,30 Kč

← ZpětPokračovat →

Adresy NEJSOU formulář, jen text. Data z GET /api-users/users/{userId}/billing-address a aktivní doručovací adresy. Kalendář má rozsah od deliveryDate do maxDeliveryDate zvolené dopravy. „Pouze kompletní zásilka" NENÍ, stejně jako starý B2B.

WF-S3

Krok 3 Souhrn objednávky

Starý B2B · dnes

Nový B2B · SFX

ALBI B2BKošík › Souhrn objednávky

✓Přehled košíku✓Dodací podmínky3Souhrn objednávky4Odesláno

Položky košíku

K12

Puzzle
12 ks

Cena bez DPH: 1 548,00 Kč
Cena s DPH: 1 873,08 Kč

D07

Hrnky
18 ks

Cena bez DPH: 2 682,00 Kč
Cena s DPH: 3 245,22 Kč

P03

Přání
25 ks

Cena bez DPH: 725,00 Kč
Cena s DPH: 812,00 Kč

Přehled sazeb DPH

Sazba DPH: 21 %Celkem bez DPH: 4 230,00 Kč · s DPH: 5 118,30 Kč

Sazba DPH: 12 %Celkem bez DPH: 725,00 Kč · s DPH: 812,00 Kč

Sumarizace

Doprava - Firemní zásilka PPL/DPD/GeisZdarma

Platba - FakturaZdarma

Celkem za nákup5 930,30 Kč

Údaje firmy

Fakturační adresa

Papírnictví u Lípy s. r. o.
Lípová 12, 120 00 Praha 2

Doručovací adresa

Pobočka Lípová
Lípová 12, 120 00 Praha 2

K objednávce

Požadované datum: 14. 10. 2026
Vaše číslo: OBJ‑2026‑114

← ZpětOdesláním objednávky souhlasím s obchodními podmínkami.Odeslat objednávku ✓

Karta cost levelu: kód v kruhu (prázdný kód = „PP", „Produkty podpory"), název cost levelu, počet kusů, cena bez a s DPH. Data z costLevelSummary[] a vatSummary[]. Blok „K objednávce" zopakuje B2B pole z kroku 2. Seskupení a přehled DPH stejně jako starý B2B.

Co převzít z jádra SFX a co chybí

Jádro MasterShop (FrontAPI)

Pořadí = závislosti. Bez bodu 1 nefunguje nic dalšího. Kde je víc cest, rozhodne programátor.

1. Odblokovat B2B košík a objednávku

• Dnes: BaseNBasket::getBasketBasketOrderData() pro B2B zákazníka se zapnutým FrontAPI vyhodí výjimku „FrontAPI is not yet implemented for B2B customer types." Objednávka spadne obecnou chybou serveru. Totéž každé vyprázdnění košíku.
• Nově: třída B2B objednávkových dat pro FrontAPI (vzor B2C varianty) a klíč v konfiguraci modulu Basket. Košík ji pro B2B + FrontAPI použije místo výjimky.
• Adresy a e‑mail plní server ze zákazníka a aktivní adresy, jako klasické jádro u B2B. Adresu z požadavku pro B2B NEPŘEBÍRÁ.
• Kontroly blokace v FrontAPI cestě validace objednávky. Dnes je kontrola dlužníka jen v klasickém formuláři. Detail S04.
• Jádro. Vzniká v rámci blokeru Z1.

2. Aktivní doručovací adresa

Bez aktivní adresy nefunguje ceník, katalog, dopravy ani platby. Jádro ji dnes nastaví při ověření tokenu na výchozí adresu. Podúčet má jedinou, hlavní účet dostane nejnovější a přepnout ji přes FrontAPI nejde. Varianty, rozhodne programátor: D1

• a) Košík nese adresu: PUT /api-carts/carts/{token}/delivery-address s { "addressId" }. Uloží adresu k DB košíku (sloupec existuje), všechny endpointy s tokenem z ní nastaví kontext.
• b) Hlavička s ID adresy v každém požadavku. Server ověří, že adresa patří zákazníkovi. Přidat do Vary cache.
• c) Token: volba adresy uložená u zákazníka a nový přístupový token s adresou.
• Ve všech variantách: každá adresa má vlastní košík (klasické jádro to umí), ceník z adresy přepisuje obálka (S02). Jádro.

3. Rozšíření GET košíku

{
  "deliveryAddressId": 812,
  "isOrderAllowed": true,
  "orderBlockReasons": [],
  "cartItems": [
    { "productId": "4412", "code": "P-4412", "inCartCount": 12,
      "piecesInPackage": 6, "maxOrderCount": 600, "costLevelCode": "K12" }
  ],
  "vatSummary": [
    { "vatRate": 21, "priceWithoutVat": 4230.00, "priceWithVat": 5118.30 },
    { "vatRate": 12, "priceWithoutVat": 725.00, "priceWithVat": 812.00 }
  ],
  "costLevelSummary": [
    { "code": "K12", "name": "Puzzle", "count": 12,
      "priceWithoutVat": 1548.00, "priceWithVat": 1873.08 }
  ]
}

Rozšíření v jádře, nebo přepisem DTO v obálce: D3. Obálka albi.eu už podobně přepisuje DTO i služby FrontAPI.

4. B2B pole v POST objednávky

{
  "cartToken": "c3f1…",
  "paymentId": 7,
  "transport": { "id": 3 },
  "message": "Prosíme dodat do 10:00.",
  "customerOrderCode": "OBJ-2026-114",
  "requestedDeliveryDate": "2026-10-14"
}

• customerOrderCode (text, nepovinné) → interní číslo objednávky. Do AlbiLine jde jako CustomerReferenceCode, převod dnes v obálce funguje.
• requestedDeliveryDate (Y-m-d, nepovinné) → požadované datum. Validace v jádře už běží i pro FrontAPI, chybí jen vstup. Do AlbiLine jde jako DeliveryDate.
• onlyCompleteConsignment se NEPŘIDÁVÁ. Starý B2B volbu nenabízí a do AlbiLine ji neposílá.
• Ploše, nebo v objektu b2b: D2. Jádro.
• customer s adresami je pro B2B nepovinný a server ho ignoruje (bod 1).

5. Chybové kódy objednávky

Dnes FrontAPI všechny chyby validace objednávky vrací jako ORDER_CUSTOMER_INVALID_ADDRESS. Chyba data dodání by tak přišla jako „neplatná adresa". Kódy a HTTP status rozhodne programátor, níže pracovní názvy.

6. Doprava, balení, slevy, povinná pole

• Doprava: maxDeliveryDate = konec rozsahu pro výběr požadovaného data. Jádro ho dnes počítá jako dnešek + 1 rok. Jádro.
• Balení: PUT košíku dnes vrací varování WARNING_CART_COUNT_ERROR_PIECES_IN_PACKAGE_B2B a počet zároveň zaokrouhlí. Varování se počítá z požadovaného počtu. Sjednotit. D4
• Slevy: když nová obálka převezme vypnutí slev, slevový kód pro B2B nesmí projít tiše. Dnes obálka. D5
• Volitelná povinná pole: přenést volbu „Validovat data zákazníka ve 3. kroku košíku" do B2B objednávkových dat pro FrontAPI. Při plnění adres ze serveru je to kontrola úplnosti dat z AlbiLine. Přebírá se beze změny. Dnes obálka, nová obálka ji nemá.
• Součty: vlastní výpočet AlbiB2BPricesService převzít do nové obálky beze změny. Dnes obálka. D7

Administrace

Beze změny. Nic nového se nepřidává.

• Systémová volba „Validovat data zákazníka ve 3. kroku košíku" (b2b_validate_basket_customer_data), nápověda „V případě, že je aktivní, je prováděna validace obsahu FA a DA v košíku." Dnes ji definuje stará obálka (albi-envelope-master/Local/Modules/Customers/config/config.module.php:45-50). Nová obálka ji převezme beze změny textu.
• Detail objednávky: pole „Interní číslo objednávky zákazníka", „Dodat pouze kompletní zásilku" a „Požadované datum dodání" jsou v jádře zakomentovaná (MasterShop-front-api-php85/app/Modules/Orders/src/admin/orders/config.php:173-175). Hodnoty se ukládají do objednávky a jdou do AlbiLine. Zobrazení v administraci se NEMĚNÍ.

Pravidla a validace

Ceny a součty

• Hlavní cena je bez DPH v řádku, v souhrnu i v potvrzení. Cena s DPH je doplňková.
• Součty jako AlbiLine. Součet bez DPH po sazbách. SK položky na 3 desetinná místa. CZ s platbou kódu D nebo H v AlbiLine zaokrouhlí na celé Kč. Dnes obálka.
• Slevy NEJSOU. Kupóny, kartové slevy, množstevní slevy, dárky ani dárkové poukazy se v B2B košíku neuplatní. Pole pro slevový kód se NEZOBRAZÍ. Dnes obálka.
• Souhrn objednávky seskupuje položky podle cost levelu a ukazuje přehled sazeb DPH, stejně jako starý B2B.
• Cena položky podle ceníku aktivní doručovací adresy, stejně jako v katalogu. Pořadí ceníků a výpočet ceny v S02.
• Cena objednávky se po vytvoření NEPŘEPOČÍTÁVÁ, ani po změně ceníku. Dnes obálka, viz C4.
• Doporučená cena (RRP) v košíku NENÍ, stejně jako starý B2B. RRP je jen na detailu produktu.
• Minimální hodnota objednávky NENÍ, stejně jako starý B2B. Minimum je 1 balení u položky.

Množství a balení

• Minimum položky = 1 balení, krok = balení. Balení je B2B hodnota produktu (pieces_in_package_b2b).
• Maximum položky = menší ze skladu (když se smí objednat jen ze skladu) a B2B maxima produktu, případně limitu z nastavení košíku. Zarovnané dolů na balení. Jádro.
• Tlačítka „+1" a „+2" balení přičtou 1 a 2 balení. Popisek ukazuje počet kusů. Násobitel 2 je dnes konstanta obálky.
• Nedělitelný počet jádro zaokrouhlí NAHORU na násobek balení. Nad maximum zaokrouhlí dolů. Hláška: „Není možné nakoupit tento počet kusů produktu „%s". Počet kusů musí být dělitelný číslem %d."
• Nad maximum jádro ořízne. Hláška: „Není možné nakoupit více než %s ks produktu „%s"." a „V případě zájmu o tento produkt ve větším množství nás kontaktujte na %s."
• Vyprodaný produkt zmizí z košíku. Hláška: „Produkt „%s" již není skladem a byl z košíku odebrán."

Adresy, doprava, platba

• Adresy jsou jen ke čtení. Fakturační adresa s IČ a DIČ, doručovací = aktivní adresa košíku. Zákazník je v košíku NEMŮŽE upravit ani přepnout, stejně jako starý B2B. Přepínač adresy je jen v horní liště mimo košík (S02).
• E‑mail objednávky bere server v pořadí: doručovací adresa → fakturační adresa → uzel firmy → zákazník. Jádro.
• Doprava a platba jen povolené na adrese. Bez povolené platby nelze pokračovat: „Pro Váš účet neevidujeme žádnou povolenou dopravu."
• Volitelná povinná pole. E‑mail je povinný vždy: „Zadaný email není platný", „Musíte vyplnit emailovou adresu". Se zapnutou volbou navíc jméno, příjmení, PSČ, ulice, město a stát fakturační adresy a údaje doručovací adresy. Dnes obálka.

B2B pole objednávky

• „Požadované datum dodání" je NEPOVINNÉ. Musí být pracovní den: „Datum doručení musí být v pracovní den". Musí být v rozsahu zvolené dopravy: „Toto datum doručení není u zvolené dopravy možné". Kalendář jiné dny nenabídne, server je ověří znovu.
• „Interní číslo vaší objednávky" je NEPOVINNÉ. Volný text, placeholder „Zadejte číslo objednávky".
• Poznámka je NEPOVINNÁ, max. 500 znaků. Podtext „Zde můžete napsat poznámku či připomínku k objednávce."
• „Pouze kompletní zásilka" se NENABÍZÍ, stejně jako starý B2B. FrontAPI pole NEPŘIDÁ.

Blokace a odeslání

• Blokace nebrání plnit košík, jen dokončit objednávku. „Pokračovat" je neaktivní, kroky 2 a 3 nejsou dostupné. Dlužník: S04. Neaktivní adresa, zákazník nebo blokovaný uzel: „Nelze provést objednávku".
• Server kontroluje blokaci znovu při odeslání. Příznaky se mění synchronizací z AlbiLine během nákupu, hodnota z načtení košíku NEROZHODUJE.
• Souhlas s obchodními podmínkami je věta u tlačítka: „Odesláním objednávky souhlasím s obchodními podmínkami." Zaškrtávátko NENÍ.
• Dvojklik. „Odeslat objednávku" je po kliknutí neaktivní do příchodu odpovědi.
• Zboží 18+: „Košík obsahuje zboží 18+! Nákupem souhlasíte, že při předání zboží vás může dopravce požádat o prokázání věku." Platí i pro B2C.

Mimo rozsah a nasazení

Mimo rozsah

• Import objednávky ze souboru a kopie objednávky do košíku. Opakovaná objednávka je F01, import ze souboru je samostatná funkce (D3). Obojí stojí na odblokovaném B2B košíku z bodu 1.
• Blokace špatného plátce (lišta, hláška, kontrola na serveru) je S04.
• Přepínač doručovací adresy, ceník z adresy a zavřený katalog jsou S02.
• Filtrace doprav a plateb podle adresy a skupiny přechází ze staré obálky beze změny (C2). S03 jen čte výsledek.
• Doporučená cena na detailu produktu (B3).

Nasazení

• Závisí na odblokování B2B košíku ve FrontAPI, bloker Z1. Do té doby nejde nic z S03 otestovat s B2B účtem.
• Závisí na aktivní adrese (bod 2, S02) a na příznaku B2B prezentace pro SFX (Z3).
• Jádro: bod 1, 2, B2B pole, balení a maximum v datech, chybové kódy, maxDeliveryDate. Obálka backendu: součty, cost level, seskupení, vypnutí slev, volitelná povinná pole. Obálka SFX: obrazovky.
• Stejný kód pro všechny instalace. Texty jsou překladové klíče SFX.

Kontrola po nasazení

• Podúčet s B2B účtem dokončí objednávku přes nový web. Objednávka má adresy z AlbiLine, ne z formuláře.
• Produkt s balením 6 ks, zadání 7 ks: v košíku 12 ks a toast „…musí být dělitelný číslem 6."
• Tlačítko „+12" u produktu s balením 6 ks přičte 2 balení.
• Košík ukazuje cenu bez DPH jako hlavní a součty sedí se starým B2B na stejném košíku (CZ i SK).
• Objednávka s interním číslem a požadovaným datem: obojí je v detailu objednávky FrontAPI a v AlbiLine.
• Požadované datum v sobotu: chyba data, zákazník je zpět v kroku 2, objednávka nevznikla.
• Souhrn ukazuje skupiny podle cost levelu a přehled DPH pro košík se dvěma sazbami.
• Slevový kód pro B2B neprojde.
• Blokovaný uzel: „Pokračovat" je neaktivní, přímé volání objednávky vrátí ORDER_CUSTOMER_BLOCKED.