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

# Kokoelma – Julkaiseminen

> Valitse, missä myyntikanavissa kokoelma näytetään — hallintapaneelin tilausselaimessa, verkkokaupassa, molemmissa vai ei kummassakaan

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="Katalogi > Kokoelmat > [Kokoelma] > Julkaiseminen">
  <img src="https://mintcdn.com/twicecommerce/VS2TRCJ4uKTp3qg2/images/catalog-collection-publishing.webp?fit=max&auto=format&n=VS2TRCJ4uKTp3qg2&q=85&s=b026b7218a023fc5b07a24c2505e6670" alt="Kokoelman Julkaiseminen-välilehti, jonka Myyntikanavat-kortilla ovat Ylläpito ja Verkkokauppa" width="1920" height="1080" data-path="images/catalog-collection-publishing.webp" />
</Frame>

Julkaiseminen-välilehti määrittää, **missä kokoelma näytetään**: hallintapaneelissa tilauksia luotaessa, verkkokaupassasi, molemmissa vai ei kummassakaan. Uusi kokoelma julkaistaan molemmissa kanavissa.

Julkaisun poistaminen ottaa kokoelman pois kanavalta eikä muuta mitään muuta. Kokoelmalla säilyvät sen listaukset, se pysyy muokattavana hallintapaneelissa ja palaa kanavalle heti, kun kytket sen takaisin päälle — kausikokoelma otetaan siis pois verkkokaupasta sesongin väliajaksi sen sijaan, että se arkistoitaisiin.

## Myyntikanavat

**Myyntikanavat**-kortti listaa kanavat, joissa kokoelma näytetään tällä hetkellä. Valitse **Hallitse**, avaa paneeli, kytke kukin kanava päälle tai pois ja valitse **Tallenna**.

| Kanava           | Kenttä               | Mitä se ohjaa                                               |
| ---------------- | -------------------- | ----------------------------------------------------------- |
| **Ylläpito**     | `salesChannelAdmin`  | Näytetäänkö kokoelma, kun luot tilauksia hallintapaneelissa |
| **Verkkokauppa** | `salesChannelOnline` | Näytetäänkö kokoelma verkkokaupassasi                       |

Molemmat kentät ovat `true` luomassasi kokoelmassa sekä hallintapaneelissa että API:n kautta, joten kokoelma on julkaistu kaikkialla, kunnes päätät toisin.

Kortti listaa vain päällä olevat kanavat. Kun kytket molemmat pois, kortti näyttää niiden tilalla varoituksen: ”Tätä kokoelmaa ei näytetä millään myyntikanavalla.”

<Frame caption="Katalogi > Kokoelmat > [Kokoelma] > Julkaiseminen > Hallitse">
  <img src="https://mintcdn.com/twicecommerce/VS2TRCJ4uKTp3qg2/images/catalog-collection-sales-channels-drawer.webp?fit=max&auto=format&n=VS2TRCJ4uKTp3qg2&q=85&s=eae6901f5c9abd9f9a254733c92821d9" alt="Hallitse myyntikanavia -paneeli, jossa Ylläpito- ja Verkkokauppa-kytkimet ovat päällä" width="1920" height="1080" data-path="images/catalog-collection-sales-channels-drawer.webp" />
</Frame>

<Frame caption="Katalogi > Kokoelmat > [Kokoelma] > Julkaiseminen — molemmat kanavat pois">
  <img src="https://mintcdn.com/twicecommerce/VS2TRCJ4uKTp3qg2/images/catalog-collection-no-sales-channel.webp?fit=max&auto=format&n=VS2TRCJ4uKTp3qg2&q=85&s=29822e2cd99ab9bdb2c208919a77689f" alt="Myyntikanavat-kortti, jossa kanavalistan tilalla on varoitus siitä, ettei kokoelmaa näytetä millään myyntikanavalla" width="1920" height="1080" data-path="images/catalog-collection-no-sales-channel.webp" />
</Frame>

Kokoelmalla on vain nämä kaksi kanavaa. Kokoelmille ei ole myymäläkanavaa, toisin kuin listauksille, joita myydään myös itsepalvelussa.

## Mitä julkaisun poistaminen piilottaa

Julkaisun poistaminen piilottaa **kokoelman, ei sen listauksia**. Jokaisella listauksella säilyy oma tilansa ja omat myyntikanavansa, se pysyy tilattavana ja näkyy edelleen verkkokaupan koko listausvalikoimassa — asiakas löytää sen selaamalla tai hakemalla kokoelman sijaan.

Kun kokoelma ei ole julkaistu **verkkokaupassa**, se katoaa näistä:

* kokoelmalistaus ja kokoelman oma sivu, joka palauttaa vastauksen `404`
* ylätunnisteen navigaatio, etusivun kokoelmalista, nostettu kokoelma -lohko ja alatunniste
* verkkokaupan hakupalkin kokoelmavalikko
* kokoelman listauksia hakevat kyselyt — julkaisemattoman kokoelman listauksia pyydettäessä tulos on tyhjä

Kun kokoelma ei ole julkaistu **ylläpidossa**, se katoaa tilauspaneelin **Lisää listaus** -selaimesta. Kokoelmataulukossa ja kokoelman omalla sivulla se näkyy edelleen, joten se pysyy muokattavana silloinkin, kun se on pois kanavalta.

Teemaeditori on tarkoituksellinen poikkeus: sen kokoelmavalitsimet tarjoavat edelleen kaikkia kokoelmia, ja verkkokauppa jättää julkaisemattoman kokoelman pois sivua muodostaessaan. Kokoelma, jonka julkaisun poistat sen ollessa valittuna etusivun lohkossa, pysyy valittuna eikä enää näy sivulla.

## Julkaisun poistaminen ei ole arkistointi

Nämä kaksi ovat eri asioita ja molemmat ovat peruttavissa, mutta ne vastaavat eri kysymykseen.

|                    | Kanavan julkaisun poistaminen       | Arkistointi                                        |
| ------------------ | ----------------------------------- | -------------------------------------------------- |
| Laajuus            | Yksi kanava kerrallaan              | Kaikki kanavat ja hallintapaneelin listat kerralla |
| Hallintapaneelissa | Näkyy listoilla ja on muokattavissa | Piilotettu kokoelmataulukosta                      |
| Peruminen          | Kytkemällä kanava takaisin päälle   | Poista arkistointi                                 |

Ota kokoelma pois verkkokaupasta sesongin ajaksi poistamalla sen julkaisu kyseiseltä kanavalta. Arkistoi se, kun et enää tarvitse sitä lainkaan. Lue lisää: [Arkistointi ja poistaminen](/docs/fi/concepts/repeating-patterns/archiving-and-deletion).

## API:n kautta

Kokoelmat ovat `collections`-resurssi. Todenna `X-API-KEY`-otsakkeella (katso [API-avaimet](/docs/fi/concepts/integrations/api-keys)) ja kutsu:

* `GET /v1/admin/collections` — listaa kokoelmat, joista kussakin on kentät `salesChannelAdmin` ja `salesChannelOnline`
* `PATCH /v1/admin/collections/{id}` — päivitä kokoelma, mukaan lukien nämä kaksi myyntikanavakenttää

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PATCH "https://server.twicecommerce.com/v1/admin/collections/9c1f7b60-3d2a-4a51-8e4c-1b7d5a0f6e23" \
    -H "X-API-KEY: {key}" \
    -H "Content-Type: application/json" \
    -d '{"salesChannelOnline": false}'
  ```

  ```json Response theme={null}
  {
    "id": "9c1f7b60-3d2a-4a51-8e4c-1b7d5a0f6e23",
    "title": "Winter gear",
    "description": "Boots, jackets and skis for the cold months",
    "type": "manual",
    "tagMatchType": "any",
    "slug": "winter-gear",
    "noindex": false,
    "archivedAt": null,
    "salesChannelAdmin": true,
    "salesChannelOnline": false
  }
  ```
</CodeGroup>

Molemmat kentät ovat valinnaisia sekä luonnissa että päivityksessä: jos jätät toisen pois, sen nykyinen arvo säilyy, ja jos jätät luonnissa molemmat pois, kokoelma julkaistaan kummassakin kanavassa.

<Note>
  Osoitteet muodossa `/internal/collections` toimivat edelleen olemassa olevissa integraatioissa. Uudet integraatiot käyttävät yllä olevia `/v1/admin`-polkuja.
</Note>

Katso täydelliset pyyntö- ja vastausskeemat [API-referenssistä](https://server.twicecommerce.com/api) — se muodostetaan suoraan käytössä olevasta API:sta, joten se vastaa aina nykyisiä kenttiä.

## Näkyvyys ja käyttöoikeudet

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

Kaikilla neljällä järjestelmäroolilla — Owner, Admin, Manager ja Member — on kaikki neljä toimintoa.

Julkaisemisella ei ole omaa käyttöoikeuttaan: se kuuluu saman rajauksen alle kuin Yleiset-välilehti, joten rooli, joka voi muokata kokoelmaa, voi myös julkaista sen. Rooli, jolla ei ole oikeutta `catalog:collection:view`, ei näe Julkaiseminen-välilehteä, ja myyntikanavakenttien päivitys roolilta, jolla ei ole oikeutta `catalog:collection:manage`, hylätään vastauksella `403`.

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

## Yhteenveto

* **Kaksi kanavaa** — Ylläpito ja Verkkokauppa, molemmat päällä kokoelmaa luotaessa.
* **Piiloon jää kokoelma**, ei sen listauksia eikä kokoelman omia hallintapaneelin sivuja.
* **Molemmat pois** näyttää varoituksen, eikä kokoelmaa näytetä missään.
* **Julkaisun poistaminen on peruttavissa ja kanavakohtaista** — arkistointi on laajempi, kaikki kerralla kattava tila.

## Aiheeseen liittyvät artikkelit

<CardGroup cols={2} className="doc-rows-condensed">
  <Card title="Kokoelmat" href="/docs/fi/concepts/catalog/collections">
    Välilehden taustalla oleva käsite — jäsenyys, kanavat ja kokoelmasivu.
  </Card>

  <Card title="Listauksen julkaisu" href="/docs/fi/catalog/listings/publishing">
    Samat kaksi kanavaa listauksella, sekä sen sijainnit.
  </Card>

  <Card title="Arkistointi ja poistaminen" href="/docs/fi/concepts/repeating-patterns/archiving-and-deletion">
    Toinen tapa ottaa kokoelma pois käytöstä — ja miten sen perut.
  </Card>

  <Card title="Verkkokauppa" href="/docs/fi/concepts/sales-channels/online-store">
    Missä julkaistu kokoelma näkyy.
  </Card>
</CardGroup>
