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

# Asetukset - Sähköpostit

> Hallitse tapahtumasähköposteja, jotka TWICE Commerce lähettää asiakkaille ja tiimillesi, kielikohtaisella pohjatuella.

export const viewAccessDefinition = "View-toiminto: lue tietue muuttamatta sitä.";

export const manageAccessDefinition = "Manage-toiminto: päivitä olemassa olevaa tietuetta. Luonti ja poisto ovat erillisiä toimintoja.";

export const deleteAccessDefinition = "Delete-toiminto: poista tietue. Useimmilla alueilla tietue arkistoidaan poistamisen sijaan.";

export const createAccessDefinition = "Create-toiminto: lisää uusi tietue. Olemassa olevan päivittäminen on manage-toiminto.";

<Frame caption="Asetukset > Sähköpostit">
  <img src="https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/settings-emails.webp?fit=max&auto=format&n=lZhc_tO8u1u_bL0Q&q=85&s=f188b5622471c5733f4fcaea9c4c639a" alt="Sähköpostien asetussivu" width="1920" height="1080" data-path="images/settings-emails.webp" />
</Frame>

<Info>
  Näkymä voi näyttää erilaiselta käyttäjäroolista riippuen. <br />Lisätiedot löytyvät kohdasta Näkyvyys ja käyttöoikeudet.
</Info>

## Ensisijainen käyttötarkoitus

Hallitse TWICE Commercen lähettämiä tapahtumasähköposteja — tilausvahvistuksia sekä omia mukautettuja sähköpostejasi.

<AccordionGroup>
  <Accordion title="Järjestelmäpohjat">
    Sisäänrakennettuja järjestelmäpohjia on kahdeksan. Voit muokata niiden aihetta ja sisältöä, mutta et poistaa niitä.

    | Pohja                            | Vastaanottaja | Oletustila |
    | :------------------------------- | :------------ | :--------- |
    | Hallintapaneelin tilausvahvistus | Tiimi         | Aktiivinen |
    | Verkkokaupan tilausvahvistus     | Asiakas       | Aktiivinen |
    | Kassalinkki                      | Asiakas       | Aktiivinen |
    | Kestotilauksen maksu tulossa     | Asiakas       | Luonnos    |
    | Kestotilauksen maksu vahvistettu | Asiakas       | Aktiivinen |
    | Kestotilauksen maksu epäonnistui | Asiakas       | Aktiivinen |
    | Kestotilaus peruutettu           | Asiakas       | Aktiivinen |
    | Kestotilaus päättyy pian         | Asiakas       | Luonnos    |

    **Luonnos**-tilassa olevia pohjia ei lähetetä, ennen kuin aktivoit ne.
  </Accordion>

  <Accordion title="Mukautetut pohjat">
    Luo lisää sähköposteja asiakkaille tai tiimillesi aiheineen ja HTML-sisältöineen.
  </Accordion>

  <Accordion title="Kielikohtaiset pohjat">
    Jokaisella sähköpostipohjalla — järjestelmän tai mukautetulla — voi olla kielikohtaista sisältöä. Valitse pohjaeditorissa kieli ja kirjoita aiheesta ja sisällöstä käännetty versio.

    Kun muokkaat muulla kuin lähdekielellä, ohitus tallennetaan käännöksenä. Pohja ratkaisee sisällön tässä järjestyksessä:

    1. **Kielikohtainen ohitus** — vastaanottajan kielelle käännetty aihe ja sisältö, jos sellainen on.
    2. **Pohjan sisältö** — pohjalle itselleen tallennettu aihe ja sisältö (lähdekielinen versio).
    3. **Koodin oletus** — vain järjestelmäpohjissa, sisäänrakennettu oletus pyydetyllä kielellä.

    Mukautetuilla pohjilla ei ole koodin oletusta — jos kielikohtaista ohitusta ei ole, käytetään lähdekielistä sisältöä.

    Voit palauttaa järjestelmäpohjan koodin oletukseen milloin tahansa editorista.
  </Accordion>

  <Accordion title="Liitteet">
    Liitä sähköpostiin dokumenttipohjia, ehtodokumentteja tai ladattuja tiedostoja.
  </Accordion>

  <Accordion title="Testaus ja tila">
    Lähetä testisähköposti itsellesi ja pidä pohja luonnoksena tai aktiivisena.
  </Accordion>
</AccordionGroup>

<Note>
  Sähköpostit lähetetään organisaatiosi yhteyssähköpostista (asetetaan kohdassa [Tilin tiedot](/docs/fi/settings/account)). Erillistä lähettäjä- tai SPF/DKIM-määritystä ei ole täällä.
</Note>

## Sähköpostin kieli

Tilausilmoitukset muodostetaan asiakkaan kielellä. Järjestelmä päättelee kielen näin:

1. Verkkokauppa tallentaa asiakkaan **selauskielen** kassalla.
2. Tilausta luotaessa asiakastietue tallentaa tämän kielen.
3. Sähköpostia lähetettäessä järjestelmä tarkistaa asiakkaan kielen [käyttöön otettuja kieliäsi](/docs/fi/settings/translations) vasten. Jos kieli on käytössä, sähköposti muodostetaan sillä kielellä. Muussa tapauksessa käytetään **oletuskieltäsi**.

Sekä pohjan sisältö että järjestelmän tuottama teksti (päivämäärät, nimikkeet, rivitiedot) muodostetaan samalla kielellä — sähköposti ei koskaan sekoita kahta kieltä.

## Aiheeseen liittyvät käsitteet

<CardGroup cols={2}>
  <Card title="Dokumentit" href="/docs/fi/settings/documents">
    Dokumenttipohjat samalla kielikohtaisella tuella
  </Card>

  <Card title="Monikielinen sisältö" href="/docs/fi/concepts/admin/translations">
    Miten käännökset toimivat katalogissa, sijainneissa ja pohjissa
  </Card>

  <Card title="Käännösasetukset" href="/docs/fi/settings/translations">
    Ota kieliä käyttöön ja hallitse asiakkaille näkyvän sisällön käännöksiä
  </Card>
</CardGroup>

## Pohjamuuttujat

Sähköpostipohjat käyttävät Handlebars-syntaksia dynaamiseen sisältöön. Lisää tilaustietoja aiheeseen tai sisältöön ympäröimällä muuttujan nimi kaksinkertaisilla aaltosulkeilla — `{{variable}}`.

### Apufunktiot

Apufunktiot muotoilevat raaka-arvot ennen kuin ne näkyvät sähköpostissa.

| Apufunktio       | Esimerkki                                 | Tuloste                                                 |
| ---------------- | ----------------------------------------- | ------------------------------------------------------- |
| `formatDate`     | `{{formatDate createdAt}}`                | Päivämäärä sijainnin muodossa (esim. `15.03.2026`)      |
| `formatDateTime` | `{{formatDateTime earliestStartDate}}`    | Päivämäärä ja kellonaika (esim. `15.03.2026, 14:00`)    |
| `formatDateOnly` | `{{formatDateOnly subscription.endDate}}` | Kalenteripäivä ilman aikavyöhykemuunnosta               |
| `formatPrice`    | `{{formatPrice pricing.total}}`           | Muotoiltu hinta pienimmistä yksiköistä (esim. `€25.00`) |
| `formatCycle`    | `{{formatCycle unit amount}}`             | Laskutusjakso (esim. `month`, `3 months`)               |
| `formatDuration` | `{{formatDuration unit amount}}`          | Kesto lukumäärän kanssa (esim. `1 week`, `6 months`)    |
| `eq`             | `{{#if (eq status "completed")}}`         | Yhtäsuuruustarkistus ehtolauseisiin                     |
| `localeField`    | `{{localeField name}}`                    | Poimii oletusarvon monikielisestä kentästä              |

Käytettävissä ovat vakiomuotoiset Handlebars-lohkoapufunktiot: `{{#each}}`, `{{#if}}`, `{{#unless}}`, `{{#with}}`.

### Tilausmuuttujat

Tilaussähköpostien pohjat saavat käyttöönsä koko Order-objektin. Yleisimmin käytetyt kentät:

| Muuttuja                | Kuvaus                                                                                                                                                                           |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `reference`             | Tilausviite sellaisena kuin se näytetään asiakkaille — `#1042` tai mitä tahansa [tilausnumeroinnin](/docs/fi/settings/orders) muotosi tuottaa. Tätä sisäänrakennetut pohjat käyttävät |
| `number`                | Viitteen taustalla oleva numerosarjan raaka arvo (`1042`) ilman etuliitettä, päätettä tai täyttöä                                                                                |
| `createdAt`             | Tilauksen luontiaika                                                                                                                                                             |
| `status`                | Tilauksen nykyinen status                                                                                                                                                        |
| `mainContact.firstName` | Asiakkaan etunimi                                                                                                                                                                |
| `mainContact.lastName`  | Asiakkaan sukunimi                                                                                                                                                               |
| `mainContact.email`     | Asiakkaan sähköpostiosoite                                                                                                                                                       |
| `pickupLocation.name`   | Noutosijainnin nimi                                                                                                                                                              |
| `returnLocation.name`   | Palautussijainnin nimi                                                                                                                                                           |
| `earliestStartDate`     | Aikaisin rivitiedon alkuaika                                                                                                                                                     |
| `latestEndDate`         | Myöhäisin rivitiedon päättymisaika                                                                                                                                               |
| `pricing.total`         | Loppusumma pienimmissä yksiköissä                                                                                                                                                |
| `pricing.subtotal`      | Välisumma pienimmissä yksiköissä                                                                                                                                                 |
| `pricing.currency`      | Valuuttakoodi                                                                                                                                                                    |
| `note`                  | Tilauksen muistiinpano                                                                                                                                                           |

Rivitietoihin pääsee käsiksi lausekkeella `{{#each lineItems}}`. Jokainen rivitieto tarjoaa kentät `name`, `startDate`, `endDate`, `purchaseType`, `pricing` ja `variants`.

### Aikavyöhykkeiden käsittely

Päivämäärä- ja aika-apufunktiot (`formatDate`, `formatDateTime`) muodostavat arvot **noutosijainnin aikavyöhykkeellä**. Jos sijainnille ei ole asetettu aikavyöhykettä, käytetään tilisi oletusaikavyöhykettä.

Näin asiakkaat näkevät päivämäärät sen sijainnin mukaan, josta he noutavat — eivät UTC-aikana.

### Esimerkki aiheesta

Pohjamuuttujilla saat aiheriville dynaamista sisältöä:

```
Order {{number}} confirmed — pickup {{formatDate earliestStartDate}}
```

<Note>
  Jos pohjamuuttujassa tai apufunktiossa on syntaksivirhe, sähköposti lähtee silti raakatekstinä. Yksikään sähköposti ei jää lähettämättä pohjan virheen vuoksi.
</Note>

## Näkyvyys ja käyttöoikeudet

Tätä sivua rajaa `account_settings:notifications`. Toimintoja on neljä: <Tooltip tip={viewAccessDefinition}>view</Tooltip>, <Tooltip tip={createAccessDefinition}>create</Tooltip>, <Tooltip tip={manageAccessDefinition}>manage</Tooltip> ja <Tooltip tip={deleteAccessDefinition}>delete</Tooltip>.

Ownerilla ja Adminilla on kaikki neljä toimintoa. Managerilla on vain create. Memberillä ei ole tätä oikeutta lainkaan.

Koko roolimatriisi ja toimintojen merkitykset: [Käyttäjät ja roolit](/docs/fi/settings/users-roles).
