> ## Documentation Index > Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Profil zákazníka > Ucelený záznam soukromého nebo firemního zákazníka obsahující kontaktní údaje, historii objednávek a preference. ![Všeobecný profil zákazníka v administraci](https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/customer-general-tab.webp?fit=max\&auto=format\&n=Ab7tx7ih94KQsi0k\&q=85\&s=1c68dbe7173b85f8bc139897bcb7ef84) Zákazníci > \[Zákazník] > Všeobecné ## Definice Profil zákazníka je jediný záznam, který TWICE používá k identifikaci osoby nebo firmy na druhé straně každé transakce. Na každý profil odkazují objednávky, rezervace, přiložené dokumenty, skladové položky, které má zákazník aktuálně u sebe, a štítky, které řídí segmentaci napříč cenami, publikováním a reportingem. ## Kde to použiji? * Vyhledání zákazníka při zakládání objednávky v administraci * Sledování celoživotní hodnoty, frekvence opakovaných pronájmů a data poslední koupě * Přikládání podepsaných smluv, kopií dokladů a pojistných certifikátů k osobě * Udělení přístupu k inzerátům jen pro personál nebo jen pro členy na základě štítku * Filtrování reportů a exportů zákazníků * Vyřizování žádostí o přístup nebo výmaz podle GDPR * Budování API integrací, které potřebují zákazníky vyhledávat nebo vytvářet ## Klíčové vlastnosti ### Identita a kontakt | Vlastnost | Typ | Popis | | :- | :- | :- | | `id` | String | Unikátní identifikátor (`cust_*`) | | `createdAt` | Timestamp | Kdy byl profil vytvořen | | `firstName` | String | Jméno (povinné) | | `lastName` | String | Příjmení | | `email` | String | Hlavní e-mail – v API volitelný, v administraci často povinný. Ukládá se malými písmeny. | | `phone` | String | Kontaktní telefon | | `customerType` | Enum | `individual` (výchozí) nebo `business`. Firemní zákazníci mají navíc další pole. | | `companyName` | String | Název společnosti (firemní zákazníci) | | `taxId` | String | DIČ / IČ DPH (firemní zákazníci) | | `dateOfBirth` | Date | Datum narození (`YYYY-MM-DD`) | | `language` | String | Preferovaný komunikační jazyk | | `marketingConsent` | Boolean | Zda zákazník souhlasil s marketingem | | `marketingConsentUpdatedAt` | Timestamp | Kdy se `marketingConsent` naposledy změnilo | | `status` | Enum | `active` (výchozí) nebo `archived`. Odvozeno od toho, zda je zákazník archivovaný – měníte ho archivací nebo odarchivováním záznamu, nikoli nastavením pole. Archivovaní zákazníci zůstávají v systému, ale jsou vyloučeni z výchozích seznamů a přiřazovacích toků. Viz [Archivace a mazání](https://www.twicecommerce.com/docs/cs/concepts/repeating-patterns/archiving-and-deletion.md). | Většinu těchto vestavěných polí lze také sbírat od zákazníka u online pokladny. Přidejte je do kroku Kontakt jako [pole profilu zákazníka](https://www.twicecommerce.com/docs/cs/settings/checkouts/steps.md) a odeslané hodnoty přistanou na záznamu zákazníka spolu s objednávkou. Objednávka zadaná s e-mailem, který už má profil, se sloučí do tohoto profilu místo vytvoření druhého záznamu. Pole, které pokladna sebrala, přepíše uloženou hodnotu. Pole, které nesebrala, ponechá to, co už tam je, takže vymazání hodnoty je explicitní úprava v administraci nebo přes API. Tři pole z tohoto pravidla vybočují, protože je nese každé odeslání: `firstName`, `marketingConsent` a `customerType` vždy přebírají hodnotu z pokladny. Pokladna bez pole pro typ zákazníka odešle `individual`, což při další objednávce změní firemního zákazníka na soukromého. Viz [sběr údajů o zákazníkovi u pokladny](https://www.twicecommerce.com/docs/cs/guides/customers/collect-customer-data-at-checkout.md). [Odkaz na pokladnu](https://www.twicecommerce.com/docs/cs/orders/order-tabs/payment.md) vytvořený z existující objednávky nese stejná pole profilu, takže příjemce ho otevře s předvyplněným uloženým datem narození, adresami a firemními údaji. ### Adresa a lokalizace Každý zákazník může mít samostatnou **fakturační adresu** a **doručovací adresu**. Používají se pro vyřízení, fakturaci a vykreslení e-mailů/dokumentů podle lokalizace. ### Agregovaná data Odpovědi API zákazníka nesou objekt `aggregateData` popisující kolekci zákazníků, ze které byl záznam načten: | Vlastnost | Typ | Popis | | :- | :- | :- | | `totalCount` | Integer | Celkový počet záznamů zákazníků odpovídajících dotazu | | `lastCreated` | Timestamp nebo null | Kdy byl vytvořen nejnovější odpovídající záznam zákazníka | | `lastUpdated` | Timestamp nebo null | Kdy byl odpovídající záznam zákazníka naposledy aktualizován | Historie objednávek se na profilu neukládá do mezipaměti. Karta Objednávky a reporty ji čtou přímo z objednávek zákazníka. ### Atributy Vlastní pole definovaná obchodníkem nad rámec výše uvedených vestavěných polí profilu. Atributy jsou seskupené do **skupin atributů** nastavených v **Nastavení → Atributy a štítky**. Použijte je k zachycení věrnostní úrovně, stavu certifikace, stravovacích požadavků, čísla řidičského průkazu nebo jakýchkoli jiných doménově specifických dat. Každý atribut má formát (text, číslo, boolean, datum, výběr nebo vícenásobný výběr) a ukládá na zákazníkovi typovanou hodnotu. > [!NOTE] > > Atributy jsou oddělené od polí profilu. Vestavěná pole jako `companyName`, `taxId` a `dateOfBirth` jsou pole profilu – zobrazují se na kartě Všeobecné. Atributy se zobrazují na kartě Atributy a definují se v Nastavení. ### Štítky Plochý seznam popisků (`vip`, `wholesale`, `staff`, `corporate-account-acme`), který řídí segmentaci napříč platformou. Každý štítek je dvojice `{ value, scope }` – štítky zákazníka nesou `scope: "customers"`. Štítky se aplikují ručně v administraci nebo přes API. Viz [Skupiny zákazníků](https://www.twicecommerce.com/docs/cs/concepts/customers/customer-groups.md) pro celý model segmentace. ### Dokumenty Soubory přiložené k zákazníkovi – podepsané smlouvy, kopie dokladů, pojistné certifikáty, prohlášení o zproštění odpovědnosti. Každý dokument nese pořadí objednávky a volitelný komentář a odkazuje se přes `fileId`, takže ho lze propojit i s konkrétní objednávkou. Užitečné pro KYC, prohlášení o zproštění odpovědnosti a audity. ## Karty profilu Detail zákazníka je organizován do karet, které zrcadlí data připojená k záznamu zákazníka: > **Všeobecné** > > Vestavěná pole profilu – jméno, e-mail, telefon, datum narození, typ zákazníka (soukromý nebo firemní), název společnosti, DIČ, komunikační jazyk, souhlas s marketingem, fakturační adresa a doručovací adresa. Stav účtu (aktivní / archivovaný) se nastavuje také zde. Štítky žijí v postranní kartě na této záložce. > **Atributy** > > Vlastní pole definovaná obchodníkem nad rámec vestavěných polí profilu. Seskupená podle skupiny atributů, nastavuje se v Nastavení. > **Dokumenty** > > Soubory přiložené k zákazníkovi. Dokumenty lze vázat i na konkrétní objednávku. > **Objednávky** > > Každá objednávka, kterou tento zákazník zadal, bez ohledu na typ objednávky. Kliknutím na číslo objednávky přejdete na její detail. > **Nabídky** > > [Inzeráty](https://www.twicecommerce.com/docs/cs/concepts/catalog/listings.md), se kterými zákazník interagoval, s příslušnou objednávkou a datem začátku. Užitečné pro odhalení vzorců opakovaných pronájmů u jednotlivé položky. > **Skladové položky** > > [Skladové položky](https://www.twicecommerce.com/docs/cs/concepts/inventory/stock-item-state.md) aktuálně spojené se zákazníkem – typicky položky, které jsou zapůjčené. Každý řádek zobrazuje datum vyzvednutí a číslo objednávky, která položku zavázala. > **Protokol o aktivitě** > > Vymezená auditní stopa zápisů do tohoto záznamu zákazníka. Stejné sloupce jako globální [protokol o aktivitě](https://www.twicecommerce.com/docs/cs/concepts/admin/activity-logs.md) – časové razítko, akce, typ zdroje, aktér, endpoint, stav. ## Vztahy * **Objednávky** – každá objednávka má `customerId`. Profil zákazníka z nich agreguje součty. * **Skladové položky** – aktuálně zapůjčené položky sledují po dobu pronájmu zákazníka, který si je vypůjčil. * **Dokumenty** – soubory lze vázat na zákazníka nebo na konkrétní objednávku. * **Štítky** – řídí viditelnost publikování, cílené slevové kódy a segmentaci reportů. Viz [Skupiny zákazníků](https://www.twicecommerce.com/docs/cs/concepts/customers/customer-groups.md). * **Atributy** – vlastní pole definovaná obchodníkem, která rozšiřují záznam zákazníka nad rámec vestavěných polí profilu. * **Kanál** – každá objednávka zaznamenává kanál, kterým přišla (`admin`, `api` nebo `online`), užitečné pro analýzu zdroje akvizice. ## Životní cyklus ### Vytvoření Zákazníci mohou vzniknout několika způsoby: | Zdroj | Kdy | | :- | :- | | **Administrace** | Personál zadá údaje při zakládání objednávky, nebo přímo z tabulky Zákazníci. | | **Online pokladna** | Zákazník vyplní své údaje na storefrontu a objednávka je zadána. | | **API** | Integrace obchodníka vytvoří zákazníka přes veřejné API. | Pokud existující zákazník odpovídá podle e-mailu nebo telefonu, TWICE propojí novou objednávku s existujícím profilem místo vytvoření duplicity. ### Aktualizace a sloučení * Pole profilu lze upravit v administraci nebo přes API. Úpravy se zapisují do protokolu o aktivitě. * Historie objednávek na profilu se čte přímo z objednávek zákazníka – neexistuje mezipaměť na zákazníka, kterou by bylo třeba obnovovat. * Duplicitní profily lze sloučit z tabulky Zákazníci – historie objednávek, dokumenty a štítky z obou záznamů se zkombinují do přeživšího profilu. ### GDPR a uchovávání dat * **Přístup**: každé pole na záznamu zákazníka je dostupné přes API pro žádosti o přístup k údajům subjektu. * **Výmaz**: zákazníky lze smazat z administrace nebo přes API. TWICE uchovává záznamy na úrovni objednávky (vyžadované pro účetnictví a DPH), ale ze smazaného profilu zákazníka odstraní osobní údaje. * **Souhlas s marketingem**: sleduje se explicitně jako `marketingConsent` a respektují ho všechny vestavěné e-mailové toky. Formuláře storefrontu zobrazují zaškrtávací políčko souhlasu navázané na toto pole. * **Protokol o aktivitě**: poskytuje auditní stopu toho, kdo k záznamu přistupoval nebo ho upravoval. ## Časté dotazy > **Jaký je rozdíl mezi atributy a štítky?** > > **Atributy** jsou vlastní pole definovaná obchodníkem s klíčem a typovanou hodnotou – užitečné pro věrnostní úrovně, stav certifikace nebo stravovací požadavky. **Štítky** jsou ploché popisky pro segmentaci. Atributy použijte, když potřebujete samotnou hodnotu; štítky, když potřebujete zákazníky seskupovat. > **Může mít zákazník více adres?** > > Ano. Struktura adres podporuje samostatnou fakturační a doručovací adresu a další adresy lze pro firemní případy uložit jako atributy. > **Jak se vyhnu duplicitním zákazníkům?** > > TWICE páruje podle e-mailu a telefonu při zakládání objednávky. Pokud jsou u nového zákazníka bez rezervace oba údaje prázdné, může vzniknout duplicita. Použijte nástroj sloučení v tabulce Zákazníci ke sloučení záznamů. > **Jsou smazaní zákazníci opravdu pryč?** > > Jejich osobní údaje se vymažou, ale objednávky, platby a účetní záznamy zůstávají. Vazba z těchto objednávek na profil zákazníka je přerušena. > **Ukládá se historie objednávek na profilu do mezipaměti?** > > Ne. Karta Objednávky a celoživotní metriky se čtou přímo z objednávek zákazníka. Objekt `aggregateData` v odpovědích API popisuje samotnou kolekci zákazníků (`totalCount`, `lastCreated`, `lastUpdated`), nikoli historii objednávek. ## Vývojářská reference Zákazníci jsou v API vystaveni jako `customers`. > **[API: Customers](https://www.twicecommerce.com/docs/api-reference/customers)** > > Otevřít endpoint v API referenci. ## Související články > **[Skupiny zákazníků](https://www.twicecommerce.com/docs/cs/concepts/customers/customer-groups.md)** > > Segmentace zákazníků pomocí štítků. > **[Životní cyklus objednávky](https://www.twicecommerce.com/docs/cs/concepts/orders/order-lifecycle.md)** > > Objednávky, na které je tento zákazník navázaný. > **[Cenové tabulky](https://www.twicecommerce.com/docs/cs/concepts/catalog/price-tables.md)** > > Znovupoužitelné cenové struktury aplikované na inzeráty (nevázané na zákazníka). > **[Protokol o aktivitě](https://www.twicecommerce.com/docs/cs/concepts/admin/activity-logs.md)** > > Auditní stopa úprav záznamu zákazníka. > **[Kroky a sekce pokladny](https://www.twicecommerce.com/docs/cs/settings/checkouts/steps.md)** > > Sběr polí profilu od zákazníka u pokladny. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.