> ## 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.

# Nastavení - E-maily

> Spravujte transakční e-maily, které TWICE odesílá zákazníkům a vašemu týmu, s podporou šablon podle jazyka.

![Stránka nastavení E-maily](https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/settings-emails.webp?fit=max\&auto=format\&n=lZhc_tO8u1u_bL0Q\&q=85\&s=f188b5622471c5733f4fcaea9c4c639a)

Nastavení > E-maily

> [!NOTE]
>
> Toto zobrazení se může lišit v závislosti na vaší uživatelské roli. \
> Podrobnosti najdete v části Viditelnost a oprávnění.

## Hlavní účel

Spravujte transakční e-maily, které TWICE odesílá: potvrzení objednávek a vaše vlastní e-maily.

> **Systémové šablony**
>
> Je zabudováno osm systémových e-mailových šablon. Můžete upravit jejich předmět a obsah, ale nemůžete je smazat.
>
> | Šablona | Cílová skupina | Výchozí stav |
> | :- | :- | :- |
> | Potvrzení objednávky správce | Tým | Aktivní |
> | Potvrzení objednávky z e-shopu | Zákazník | Aktivní |
> | Odkaz k platbě | Zákazník | Aktivní |
> | Nadcházející platba předplatného | Zákazník | Koncept |
> | Platba předplatného potvrzena | Zákazník | Aktivní |
> | Platba předplatného selhala | Zákazník | Aktivní |
> | Předplatné zrušeno | Zákazník | Aktivní |
> | Předplatné končí brzy | Zákazník | Koncept |
>
> Šablony ve stavu **Koncept** se neodesílají, dokud je neaktivujete.

> **Vlastní šablony**
>
> Vytvořte další e-maily pro zákazníky nebo váš tým, s předmětem a obsahem HTML.

> **Šablony podle jazyka**
>
> Každá e-mailová šablona, systémová i vlastní, může mít obsah podle jazyka. V editoru šablony vyberte jazyk a napište přeloženou verzi předmětu a obsahu.
>
> Když upravujete v jiném jazyce, než je zdrojový jazyk, úprava se uloží jako překlad. Šablona řeší obsah v tomto pořadí:
>
> 1. **Překlad podle jazyka**: přeložený předmět a obsah pro jazyk příjemce, pokud existuje.
> 2. **Obsah šablony**: předmět a obsah uložené na samotné šabloně (vaše verze ve zdrojovém jazyce).
> 3. **Výchozí hodnota v kódu**: pouze u systémových šablon, zabudovaná výchozí hodnota v požadovaném jazyce.
>
> Vlastní šablony nemají výchozí hodnotu v kódu. Pokud neexistuje překlad podle jazyka, použije se obsah ve zdrojovém jazyce.
>
> Systémovou šablonu můžete kdykoli v editoru vrátit na její výchozí hodnotu v kódu.
>
> Odeslání, u kterého se předmět **i** obsah vyhodnotí jako prázdné, se odmítne místo odeslání prázdné zprávy. Pokud je prázdný jen jeden z nich, e-mail se přesto odešle, takže vlastní šablona s předmětem, ale bez obsahu pro daný jazyk odeslání, odejde s prázdným obsahem.

> **Přílohy**
>
> Připojte k e-mailu šablony dokumentů, dokumenty zásad nebo nahrané soubory.

> **Test a stav**
>
> Odešlete testovací e-mail sami sobě a udržujte šablonu jako koncept, nebo ji aktivujte.

> [!NOTE]
>
> E-maily se odesílají z kontaktního e-mailu vaší organizace (nastaveného v [Detailech účtu](https://www.twicecommerce.com/docs/cs/settings/account.md)). Zde není žádné samostatné nastavení odesílatele ani SPF/DKIM.

## Jazyk e-mailu

Notifikační e-maily o objednávce se vykreslují v jazyce zákazníka. Systém určuje jazyk takto:

1. Storefront zachytí **jazyk prohlížení** zákazníka během checkoutu.
2. Při vytvoření objednávky se tento jazyk uloží do záznamu zákazníka.
3. Při odesílání e-mailu systém ověří jazyk zákazníka proti vašim [povoleným jazykům](https://www.twicecommerce.com/docs/cs/settings/translations.md). Pokud je jazyk povolen, e-mail se vykreslí v tomto jazyce. V opačném případě se použije váš **výchozí jazyk**.

Obsah šablony i systémově generovaný text (data, popisky, položky) se vykreslují v tomto jednom jazyce. Šablony dokumentů přiložené k e-mailu se vykreslují ve stejném jazyce, takže e-mail a jeho vlastní PDF nikdy nedorazí v odlišných jazycích.

## Související pojmy

> **[Dokumenty](https://www.twicecommerce.com/docs/cs/settings/documents.md)**
>
> Šablony dokumentů se stejnou podporou podle jazyka

> **[Vícejazyčný obsah](https://www.twicecommerce.com/docs/cs/concepts/admin/translations.md)**
>
> Jak fungují překlady napříč vaším katalogem, lokalitami a šablonami

> **[Nastavení překladů](https://www.twicecommerce.com/docs/cs/settings/translations.md)**
>
> Povolte jazyky a spravujte překlady zákaznicky viditelného obsahu

## Proměnné šablony

E-mailové šablony používají syntaxi Handlebars pro dynamický obsah. Název proměnné zabalte do dvojitých složených závorek, `{{variable}}`, aby se do předmětu nebo obsahu vložila data objednávky.

### Pomocníci

Pomocníci formátují nezpracované hodnoty, než se zobrazí v e-mailu.

| Pomocník | Příklad | Výstup |
| - | - | - |
| `formatDate` | `{{formatDate createdAt}}` | Datum ve formátu lokality (např. `15.03.2026`) |
| `formatDateTime` | `{{formatDateTime earliestStartDate}}` | Datum a čas (např. `15.03.2026, 14:00`) |
| `formatDateOnly` | `{{formatDateOnly subscription.endDate}}` | Kalendářní datum bez převodu časového pásma |
| `formatPrice` | `{{formatPrice pricing.total}}` | Formátovaná cena z nejmenších jednotek (např. `25,00 €`) |
| `formatCycle` | `{{formatCycle unit amount}}` | Fakturační cyklus (např. `měsíc`, `3 měsíce`) |
| `formatDuration` | `{{formatDuration unit amount}}` | Doba trvání s počtem (např. `1 týden`, `6 měsíců`) |
| `eq` | `{{#if (eq status "completed")}}` | Kontrola rovnosti pro podmínky |
| `localeField` | `{{localeField name}}` | Extrahuje výchozí hodnotu z vícejazykového pole |

Standardní blokové pomocníky Handlebars jsou k dispozici: `{{#each}}`, `{{#if}}`, `{{#unless}}`, `{{#with}}`.

### Proměnné objednávky

E-mailové šablony objednávky přijímají celý objekt Order. Běžně používaná pole:

| Proměnná | Popis |
| - | - |
| `reference` | Reference objednávky tak, jak se zobrazuje zákazníkům: `#1042`, nebo cokoliv, co produkuje váš formát [číslování objednávek](https://www.twicecommerce.com/docs/cs/settings/orders.md). Toto vykreslují zabudované šablony |
| `number` | Nezpracovaná hodnota pořadí za referencí (`1042`), bez prefixu, přípony nebo doplnění |
| `createdAt` | Časové razítko vytvoření objednávky |
| `status` | Aktuální stav objednávky |
| `mainContact.firstName` | Jméno zákazníka |
| `mainContact.lastName` | Příjmení zákazníka |
| `mainContact.email` | E-mailová adresa zákazníka |
| `pickupLocation.name` | Název místa vyzvednutí |
| `returnLocation.name` | Název místa vrácení |
| `earliestStartDate` | Nejdřívější začátek položky |
| `latestEndDate` | Nejpozdější konec položky |
| `pricing.total` | Celková cena v nejmenších jednotkách |
| `pricing.subtotal` | Mezisoučet v nejmenších jednotkách |
| `pricing.currency` | Kód měny |
| `note` | Poznámka k objednávce |

Přístup k položkám získáte pomocí `{{#each lineItems}}`. Každá položka obsahuje `name`, `startDate`, `endDate`, `purchaseType`, `pricing` a `variants`.

### Proměnné atributů objednávky

E-mailové šablony objednávky také přijímají [atributy objednávky](https://www.twicecommerce.com/docs/cs/orders/order-tabs/attributes.md) zachycené na objednávce, ve dvou formách.

| Proměnná | Popis |
| - | - |
| `orderAttributes` | Každý atribut na objednávce jako popsaný seznam, pro `{{#each orderAttributes}}`. Každý řádek obsahuje `label` a `value`, již naformátované |
| `attributes.<key>` | Jeden atribut adresovaný svým klíčem. Každý obsahuje `name` (zobrazovaný název), `value` (uloženou hodnotu, pro `{{#if}}` a pomocníky data) a `formatted` (naformátováno pro vaši lokalitu, připraveno k vykreslení) |

Přistupujte k jednotlivé hodnotě přes `attributes`, ne přes popsaný seznam. Použijte **klíč atributu** z [Nastavení → Atributy a tagy](https://www.twicecommerce.com/docs/cs/settings/attributes-tags.md), ne jeho zobrazovaný název: zobrazovaný název lze přejmenovat a liší se podle jazyka, takže stabilní je jen klíč.

```
Nákladové středisko: {{attributes.cost_centre.formatted}}
{{#if attributes.handover_time}}Předání v {{formatDateTime attributes.handover_time.value}}{{/if}}
```

Pod `attributes` se zobrazují jen atributy připojené k této objednávce, takže `{{#if attributes.cost_centre}}` je nepravdivé u objednávky, která ho nikdy nezachytila. Atribut připojený, ale ponechaný prázdný, tam stále je, s `value` i `formatted` rovnými `null`.

Některé integrace také přispívají plochým názvem pro svůj vlastní atribut, například `{{oviUrl}}` pro odkaz na přístup ke dveřím. Ty fungují dál v šablonách, které proti nim byly napsané. V nových šablonách adresujte podle klíče.

### Odkaz na portál předplatného

`subscriptionPageUrl` je odkaz na zákaznický portál za tlačítkem **Spravovat předplatná** v e-mailu k objednávce. U objednávky bez předplatného je `null`, takže tlačítko zabalte do `{{#if subscriptionPageUrl}}`, aby se skrylo tam, kde není co spravovat.

Skutečné odeslání nese jednorázový odkaz vytvořený pro daného příjemce. Náhled nebo testovací odeslání nesou místo toho stránku obnovy portálu, takže otevření náhledu nikdy nevytvoří živý odkaz. Šablony napsané proti `{{subscriptionData.subscriptionPageUrl}}` se stále vyhodnotí.

### Zpracování časového pásma

Pomocníci data a času (`formatDate`, `formatDateTime`) vykreslují hodnoty v **časovém pásmu místa vyzvednutí**. Pokud místo nemá nastavené časové pásmo, systém použije výchozí časové pásmo vašeho účtu.

To znamená, že zákazníci vidí data odpovídající místu, ze kterého vyzvedávají, ne UTC.

### Příklad předmětu

Použijte proměnné šablony v řádku předmětu k vytvoření dynamických předmětů:

```
Objednávka {{number}} potvrzena, vyzvednutí {{formatDate earliestStartDate}}
```

> [!NOTE]
>
> Pokud proměnná šablony nebo pomocník obsahuje syntaktickou chybu, e-mail se přesto odešle s nezpracovaným textem. Kvůli chybě šablony se neztratí žádný e-mail.

## Viditelnost a oprávnění

Tato stránka je omezena oprávněním `account_settings:notifications`, ve čtyřech operacích: zobrazení (Operace zobrazení: přečíst záznam, aniž byste jej změnili.), vytvoření (Operace vytvoření: přidat nový záznam. Úprava existujícího záznamu je operace správy.), správa (Operace správy: upravit existující záznam. Vytvoření a smazání jsou samostatné operace.) a smazání (Operace smazání: odstranit záznam. Většina oblastí místo mazání archivuje.).

Owner a Admin mají všechny operace. Manager má pouze vytvoření. Member ji nemá vůbec.

Význam jednotlivých operací a úplnou matici rolí najdete v části [Uživatelé a role](https://www.twicecommerce.com/docs/cs/settings/users-roles.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.