ALBI B2B · interní zadání ← Rozcestník · verze 1.0 · 25. 9. 2026 · k revizi

F12 + P7 · fáze 1 · nové

Rozšíření žádosti o přístup - ověření IČO a evidence žádostí

Zájemce zadá IČO, e‑shop si stáhne údaje firmy z rejstříku a ověří plátce DPH. Žádost se uloží a obchodník ji dostane s hotovými daty. Účet dál zakládá obchodník v AlbiLine. Automatické schválení se NESTAVÍ, dokud ho ALBI nerozhodne.

Jádro (FrontAPI, admin) + SFX FrontAPI: 1 nový, 1 existující Administrace: nový výpis žádostí PBS 121587 Autor: Hana Ortmannová

Co je převzetí a co inovace. Žádost o přístup jako dnes (6 polí, 2 e‑maily) patří do převzetí stávajících funkcí 1:1 (rozdělení A2). Tato inovace je jen rozšíření nad ní: ověření IČO v rejstříku, uložení žádosti a výpis v administraci.

Co se dělá

Dnešní žádost o B2B přístup má šest polí, IČO neověřuje, nikam se neukládá a odejde jen dvěma e‑maily, ve kterých IČO ani obor nejsou vidět. Obchodník pak firmu hledá sám. Nová žádost přinese ověřené údaje z rejstříku a zůstane v e‑shopu, aby bylo vidět, co čeká a co je vyřízené.

Formulář ve třech krocích v SFX: IČO a ověření, kontakt a obor, potvrzení.
Nový endpoint pro uložení žádosti a odeslání e‑mailů. Ověření IČO a DIČ používá existující endpoint jádra (ARES, VIES).
Nová tabulka žádostí a jejich výpis v administraci se stavem.
NEZAKLÁDÁ se účet v e‑shopu. Účet vzniká v AlbiLine a přichází synchronizací, jako dnes. NEDĚLÁ se automatické schválení (P7).

Kam patří. Jádro MasterShopu (větev front-api): tabulka žádostí, endpoint pro odeslání žádosti, výpis a detail žádostí v administraci, obě e‑mailové šablony. Žádost o B2B přístup potřebuje každý B2B klient, klasické jádro B2B registraci jen zakáže. Obálka: formulář ve třech krocích v SFX, párování žádosti s účtem při synchronizaci zákazníků z AlbiLine. Názvy nových tabulek a endpointů jsou pracovní, v jádru je pojmenuje programátor.

01 - Otevřené

Otevřené otázky

K1 až K3 jsou obchodní pravidla ALBI a formulář bez nich jde stavět jen pro CZ a SK. D1 je bezpečnostní podmínka celého řešení.

Klient

Rozhoduje ALBI

#	Otázka a náš návrh
K1	Zůstává schvalování vždy ruční? Návrh: ano pro fázi 1. Automatické založení účtu v e‑shopu je vyloučené technicky (viz D1), automatické založení v AlbiLine by musel udělat ERP. Rozhodnutí P7 z dokumentu inovací.
K2	Který rejstřík pro polský a anglický e‑shop? Jádro umí ARES (CZ) a VIES (DIČ v EU). Pro PL a EN návrh: ověřit jen DIČ přes VIES, IČO jen formátem. Pro EN po brexitu VIES neplatí, tam jen formát.
K3	Má zájemce nahrávat živnostenský list? Kalkulace to zmiňuje. Návrh: ne. Ověření v rejstříku ho nahradí, příloha by vyžadovala ukládání souborů a endpoint pro nahrání, který FrontAPI mimo avatar nemá.
K4	Kdo žádosti vyřizuje a v jaké lhůtě? Do administrace dáme stav a poznámku, ale slib zájemci („ozveme se do 2 pracovních dnů") musí určit ALBI.

Vývojář

Rozhoduje vývoj

#	Otázka
D1	Synchronizace zákazníků z AlbiLine smaže e‑shopový účet se stejným e‑mailem, který nevznikl z AL. Žádost proto NESMÍ založit zákazníka. Ověřit, že nová tabulka žádostí je mimo dosah synchronizace.
D2	Párování žádosti s účtem: když synchronizace založí zákazníka s e‑mailem, ke kterému existuje žádost ve stavu „předáno", má se žádost automaticky přepnout na „účet založen"? Navrhujeme ano, hook v obálkovém konektoru zákazníků.
D3	Endpoint ověření firmy vrací u špatného typu chybu s názvem parametru `countryCode` místo typu. Chyba v jádře, SFX s ní musí počítat.
D4	Ochrana veřejného endpointu žádosti proti robotům: použít Turnstile s hlavičkou `X-PB-Captcha-Token`. Obálka albi.eu ho má u formuláře náhradních dílů a jádro stejnou hlavičkou nově chrání i registraci. Potvrdit, že stačí bez limitu na IP.

02 - Řešení v kostce

Shrnutí

Žádost zůstává žádostí. Účet v e‑shopu NEVZNIKÁ. Vzniká v AlbiLine rukou obchodníka a do e‑shopu přijde synchronizací, která zároveň pošle e‑mail s odkazem na nastavení hesla. To všechno už existuje.
Nové je ověření a uložení. IČO se ověří v rejstříku, údaje firmy se předvyplní, DIČ se ověří jako plátce. Žádost se uloží se stavem a obchodník ji vidí v administraci.
E‑maily s daty. Obchodník dostane e‑mail se všemi údaji včetně IČO, DIČ, adresy a oboru, ne jen jméno a telefon jako dnes. Zájemce dostane potvrzení s tím, co bude dál.
Stav žádosti: Nová → Předána do AlbiLine → Účet založen, nebo Zamítnuta. Přepíná obchodník v administraci, poslední krok může přepnout synchronizace. D2
Bez příloh a bez automatiky. K1 K3

03 - Výchozí stav

Jak to funguje dnes

Ověřeno v kódu staré obálky a jádra. Slouží jako měřítko, co se mění.

Formulář na starém B2B má šest povinných polí: jméno, e‑mail, telefon, IČO, typ podnikání (4 hodnoty), text o firmě. IČO se kontroluje jen na číslice. Název firmy, adresa, DIČ a souhlas se zpracováním chybí.
Data se nikam neukládají. Uložení je prázdná metoda, logování nedokončené. Odejdou dva e‑maily: obchodníkovi na jednu adresu ze systémové volby a zájemci rekapitulace. Šablony IČO a typ podnikání nevypisují, i když je dostanou.
Schválení = obchodník založí zákazníka v AlbiLine. Synchronizace vytvoří hlavní účet bez hesla, aktivní, a pošle e‑mail šablony REGISTRATION s odkazem na nastavení hesla (platnost 7 dní). Odkaz vede na SFX stránku pro zapomenuté heslo.
Nastavení v administraci: Nastavení → B2B → Nastavení B2B zákazníků: e‑mail obchodníka a kódy dvou šablon.
Jádro FrontAPI: registrace zákazníka (POST /api-users/users) zakládá účet aktivní ihned, bez firemních polí a bez stavu „čeká na schválení". Pro B2B žádost je NEPOUŽITELNÁ. Ověření firmy (GET /api-services/business-info/…) existuje a vrací název, adresu, DIČ a plátcovství.

04 - Datový model

Co se ukládá

Tabulka	Sloupce	Poznámka
`b2b_registration_requests`	`id`, `presentation_id`, `status` (`new` · `handed_over` · `account_created` · `rejected`), `company_name`, `company_id` (IČO), `vat_id` (DIČ), `is_vat_payer`, `registry_verified` (0/1), `street`, `city`, `zip`, `country_code`, `contact_name`, `email`, `phone`, `business_type`, `note` (text zájemce), `consent_time`, `ip_hash`, `admin_note`, `customer_id` (NULL, doplní se po založení), `created_at`, `updated_at`	V obálce backendu, mimo dosah synchronizace. D1 Údaje z rejstříku se ukládají tak, jak přišly, plus co zájemce upravil.

Osobní údaje se drží 12 měsíců od poslední změny stavu, pak se anonymizují (jméno, e‑mail, telefon, IP). Firma a stav zůstávají pro statistiku.
Žádný účet, žádné heslo. Heslo si zájemce nastaví až z e‑mailu po založení účtu synchronizací.

05 - Co se má stát

Workflow

Zájemce otevře Požádat o přístup z přihlašovací stránky. Je to jediná veřejná stránka B2B webu kromě přihlášení. Krok 1: stát (podle e‑shopu předvyplněný) a IČO.
Klikne na Ověřit. SFX zavolá existující endpoint ověření firmy s typem IČO.
- Nenalezeno: hláška „Firmu jsme v rejstříku nenašli. Zkontrolujte IČO, nebo pokračujte a údaje vyplňte ručně." Tlačítko Pokračovat bez ověření je viditelné, žádost dostane registry_verified = 0.
- Rejstřík nedostupný: stejná cesta jako nenalezeno, jiný text: „Rejstřík teď neodpovídá."
- Nalezeno: předvyplní se název, ulice, město, PSČ, DIČ a příznak plátce. Pole zůstanou editovatelná. K2 D3
Krok 2: kontakt. Jméno, e‑mail, telefon, obor (select), volitelně zpráva. Souhlas se zpracováním údajů (povinný checkbox s odkazem). Ochrana proti robotům. D4
Odeslání. SFX zavolá nový endpoint. Ten ověří, že e‑mail nepatří existujícímu zákazníkovi ani otevřené žádosti.
- E‑mail existujícího zákazníka: 409 a hláška „Pro tento e‑mail už účet existuje. Přihlaste se, nebo si obnovte heslo." s odkazy. Žádost se NEULOŽÍ.
- Otevřená žádost se stejným e‑mailem: 409 a hláška „Vaši žádost už máme, ozveme se." Žádost se NEULOŽÍ, obchodník dostane upozornění o opakovaném pokusu do poznámky původní žádosti.
- Jinak: žádost se uloží se stavem Nová, odejdou dva e‑maily. Krok 3 ukáže potvrzení: co bude dál a do kdy. K4
Obchodník otevře žádost v administraci, ověří ji obchodně, založí zákazníka v AlbiLine s ceníkem a povoleným sortimentem, a v administraci přepne stav na Předána do AlbiLine. Nebo Zamítnuta s poznámkou; zamítnutí NEPOSÍLÁ zájemci automatický e‑mail, obchodník napíše sám.
Synchronizace založí účet a pošle existující e‑mail s odkazem na nastavení hesla. Obálkový konektor při založení zákazníka najde žádost se stejným e‑mailem ve stavu předána a přepne ji na Účet založen s customer_id. D2

Nesahat na registraci ve FrontAPI jádra ani na synchronizaci zákazníků. Žádost nikdy nevytvoří řádek v tabulce zákazníků.

06 - StorefrontX

Zobrazení na FE

Podle prototypu, obrazovka Registrace. Tři kroky s ukazatelem postupu. Design system ALBI.

Pole formuláře

Krok	Pole	Typ · povinnost · pravidla
1	Stát	select · povinné · předvyplněn podle e‑shopu (CZ, SK, PL, ostatní EU, mimo EU)
1	IČO	text · povinné · CZ a SK 8 číslic, PL 10 číslic (NIP), jinak 4 až 20 znaků · tlačítko Ověřit
1	Název firmy	text · povinné · max. 200 · z rejstříku, editovatelné
1	DIČ	text · nepovinné · z rejstříku, ověřeno přes VIES, štítek „plátce DPH" / „neplátce"
1	Ulice, město, PSČ	text · povinné · z rejstříku, editovatelné
2	Jméno a příjmení	text · povinné · max. 100
2	E‑mail	email · povinné · kontrola formátu; kolize řeší endpoint
2	Telefon	tel · povinné · s předvolbou
2	Obor	select · povinné · hodnoty ze systémové volby (výchozí: papírnictví, hračkářství, knihkupectví, dárkové zboží, e‑shop, jiné)
2	Zpráva	textarea · nepovinné · max. 1000
2	Souhlas	checkbox · povinné · odkaz na zásady
3	Potvrzení	rekapitulace údajů, věta co bude dál a lhůta K4, tlačítko Zpět na přihlášení

Náhled FE: krok 1 po ověření

WF-F1

Žádost o přístup, krok 1 s údaji z rejstříku

Žádost o velkoobchodní přístup

Krok 1 ze 3 · Firma

IČO 27604977Ověřit

✓ Nalezeno v rejstříku · plátce DPH

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

Pokračovat

Nové je ověření a předvyplnění. Pole zůstávají editovatelná, ověření se ukládá jako příznak.

07 - Jádro MasterShop

FrontAPI

Endpoint	Stav	K čemu
`GET /api-services/business-info/{countryCode}/{TYPE_ICO\|TYPE_DIC}/{číslo}`	existuje	Jádro. IČO → ARES, DIČ → VIES. Vrací název, město, ulici, PSČ, DIČ, plátcovství. Chyby: neplatný parametr, služba nedostupná, nenalezeno. Bez JWT.
`POST /api-b2b/registration-requests`	nový	Uloží žádost, odešle e‑maily. Bez JWT, s ochranou proti robotům. Tělo = pole z tabulky výše. Odpověď 201 `{ "requestId" }`, 409 s kódem `EMAIL_HAS_ACCOUNT` nebo `REQUEST_PENDING`, 422 s chybami polí.
`POST /api-users/users`	nepoužije se	Registrace jádra zakládá aktivní účet ihned. Pro B2B žádost NEPOUŽÍVAT.

E‑maily po odeslání

Obchodníkovi na adresu ze systémové volby (stávající volba Nastavení B2B): šablona B2B_REGISTRATION_REQUEST_ADMIN rozšířená o všechna pole včetně IČO, DIČ, adresy, oboru a příznaku ověření. Odkaz do administrace na žádost.
Zájemci: šablona B2B_REGISTRATION_REQUEST_CUST: rekapitulace, co bude dál, lhůta, kontakt. K4
Obě šablony existují ve staré obálce jako kódy, texty se přepíší ve čtyřech mutacích. Odesílání přes stávající mechanismus šablon a mailSender.

08 - MasterShop admin

Administrace

Nový výpis: Zákazníci → Žádosti o B2B přístup

Kde: nový plugin v modulu Zákazníci v jádru, položka menu „Žádosti o B2B přístup".
Výpis: sloupce Datum, Firma, IČO, Kontakt, E‑mail, Obor, Ověřeno v rejstříku (ano/ne), Stav, Akce. Filtr podle stavu a prezentace, hledání podle IČO a e‑mailu. Výchozí filtr: Nová.
Detail: všechna pole žádosti jen ke čtení, zpráva zájemce, poznámka obchodníka (textarea), stav (select: Nová, Předána do AlbiLine, Účet založen, Zamítnuta), odkaz na zákazníka, když je customer_id vyplněné. Tlačítko Uložit.
Systémové volby (stávající sekce Nastavení → B2B): e‑mail obchodníka (existuje), kódy šablon (existují), nová volba „Obory podnikání" jako seznam hodnot pro select ve formuláři, jedna hodnota na řádek, vícejazyčná.
Stav Účet založen nastavuje synchronizace, ručně jde nastavit taky. D2

Náhled administrace: výpis a detail žádosti

WF-A1

Zákazníci → Žádosti o B2B přístup

Žádosti o B2B přístup

Filtr: stav Nová · prezentace B2B CZ

Datum	Firma	IČO	Kontakt	Obor	Ověřeno	Stav
25. 9. 2026	Papírnictví u Lípy s. r. o.	27604977	Jana Nováková	Papírnictví	✓	Nová	Detail
24. 9. 2026	Hračky Dvořák	—	Petr Dvořák	Hračkářství	—	Nová	Detail

WF-A2

Detail žádosti

Žádost 1042 · Papírnictví u Lípy s. r. o.

přijato 25. 9. 2026 10:14 · B2B CZ · ověřeno v rejstříku

Firma

IČO / DIČ

27604977 / CZ27604977 · plátce DPH

Adresa

Lípová 12, Praha 2, 120 00

Kontakt

Jana Nováková · jana.novakova@ulipy.cz · +420 777 123 456

Obor · zpráva

Papírnictví · „Máme dvě prodejny v Praze, zajímají nás hry a diáře."

Vyřízení

Stav

Předána do AlbiLine

Poznámka obchodníka

založeno v AL 25. 9., ceník B

Zákazník v e‑shopu

— doplní synchronizace

Uložit

09 - Pravidla

Pravidla a validace

Žádost NIKDY nezakládá účet. Ani neaktivní. Synchronizace by ho smazala. D1
Ověření není podmínka. Firma, kterou rejstřík nezná, může žádost poslat. Příznak ověření vidí obchodník.
Jeden e‑mail = jedna otevřená žádost. Druhý pokus se neuloží, přidá poznámku k původní. Zamítnutá žádost nový pokus NEBLOKUJE.
E‑mail existujícího zákazníka žádost odmítne s odkazem na přihlášení a obnovu hesla.
Zamítnutí je ruční, bez automatického e‑mailu zájemci. Obchodník rozhodne, co napíše.
Prezentace. Žádost nese prezentaci, ze které přišla. Obchodník vidí žádosti všech čtyř e‑shopů s filtrem.
Osobní údaje se po 12 měsících od uzavření anonymizují. Souhlas se ukládá s časem.
Roboti. Endpoint je veřejný, musí mít limit a ochranu. D4
IČO se ukládá tak, jak přišlo z rejstříku, i když ho zájemce upraví. Úprava se pozná z rozdílu proti údajům z rejstříku uloženým v poznámce systému.

10 - Hranice

Mimo rozsah a nasazení

Mimo rozsah

Automatické schválení a založení účtu. Rozhodnutí ALBI (P7), technicky by muselo jít přes AlbiLine. K1
Nahrávání příloh k žádosti. K3
Zakládání zákazníka v administraci e‑shopu. Bez dat z AlbiLine by účet nic neviděl.
Přihlášení zájemce ke sledování stavu žádosti. Stav se dozví e‑mailem od obchodníka.

Nasazení

Tabulka, endpoint a admin plugin v jádru MasterShopu, formulář v obálce SFX, dvě přepsané šablony ve čtyřech mutacích.
Hook na synchronizaci zákazníků v obálkovém konektoru. D2
Nezávisí na blokeru B2B košíku. Dá se nasadit brzy.

Kontrola po nasazení

Zadat platné IČO: název a adresa se předvyplní, DIČ má štítek plátce. Odeslat: žádost v administraci ve stavu Nová, dva e‑maily odešly a obsahují IČO.
Zadat neexistující IČO: hláška, pokračování ručně, žádost bez příznaku ověření.
Odeslat znovu se stejným e‑mailem: 409, žádost se nezdvojí.
Založit zákazníka v AlbiLine se stejným e‑mailem, spustit synchronizaci: žádost přejde na Účet založen, zájemci přišel e‑mail k nastavení hesla.