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

# Miten siirrät tietosi API:n kautta

> Siirrä TWICE 1.0 -tilin sijainnit, varasto, katalogi, hinnat ja asiakkaat TWICE 2.0:aan Admin API:n kautta siinä järjestyksessä, jossa tiedot riippuvat toisistaan.

> [card] [Avaa TWICE Adminissa](https://admin.twicecommerce.com/settings/connect/integrations)
>
> settings/connect/integrations

Lue 1.0-tili sen API:n kautta ja kirjoita se 2.0:aan [Admin API:n](https://www.twicecommerce.com/docs/fi/concepts/integrations/overview.md) kautta vaihe kerrallaan. Jokainen vaihe kertoo, mitä sen on saatava oikein ja mistä tuloksen näkee hallintapaneelissa. [Mikä muuttuu TWICE 1.0:sta](https://www.twicecommerce.com/docs/fi/guides/migration/what-changes-from-1-0.md) kertoo jokaisen 1.0:n kohteen vastineen 2.0:ssa.

Jätä tilaukset 1.0:aan. Tuotu tilaus saa uuden numeron ja päivämäärän ja varaa varastoa pitkin kalenteriasi.

## Edellytykset

> [!WARNING]
>
> **Vaaditut oikeudet:** **Integraatiot & API** avaimen luomiseen (`account_settings:integrations`). Owner- ja Admin-rooleilla on se. Katso [Käyttäjät ja roolit](https://www.twicecommerce.com/docs/fi/settings/users-roles.md).

> [!NOTE]
>
> **Pidä valmiina ennen kuin aloitat:**
>
> * **Asetukset määritettyinä** [vaiheessa 1](https://www.twicecommerce.com/docs/fi/guides/migration/configure-settings.md): sijaintisi, valuuttasi ja veroasetuksesi ovat olemassa ennen kuin mitään tietoja on.
> * **TWICE 1.0 -API-avain** tilille. Pyydä se TWICE-yhteyshenkilöltäsi, jos sinulla ei ole sitä.
> * **Neljä päätöstä, jotka on tehty kauppiaan kanssa:**
>   * **Sijainnit:** yksi jokaista 1.0:n toimipistettä kohden, tai useampi toimipiste yhdistettynä yhdeksi sijainniksi.
>   * **Hinnat:** jokainen 1.0:n kestoporras kiinteänä rivinä tai yksi kertoimeen perustuva rivi.
>   * **Asiakkaat:** siirrä ne tai jätä ne 1.0:aan. Ne ovat henkilötietoja.
>   * **Vero:** sisältävätkö 1.0:n hinnat veron, luettuna oikeasta 1.0-tilauksesta.

## Vaiheittainen ohje

**1. Luo 2.0:n API-avain**

Avaa **Asetukset → Integraatiot ja API** ja klikkaa **API-avaimet**-kortilla **Luo avain**. Anna avaimelle nimi, valitse kohdassa **Käyttöoikeus** **Rajoitettu käyttöoikeus** ja aseta **Inventaario**, **Katalogi** ja **Sijainnit** tasolle **Kirjoitus**, sekä **Asiakkaat** ja **Verkkokauppa**, jos siirrät ne. Kopioi avain kohdasta **Tallenna API-avaimesi**: se näytetään vain kerran.

![Luo API-avain -ikkuna Käyttöoikeus-vaiheessa, jossa vaihe, Rajoitettu käyttöoikeus sekä Kirjoitus-tasolle asetetut Inventaario- ja Katalogi-rivit on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-01.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=7fac6cd8f68d613c596d9f4ea2bef8c5)

**2. Tarkista, että 2.0-tili on tyhjä**

Avaa 2.0:n hallintapaneelissa **Katalogi → Tuotelistaukset** ja **Inventaario → Varastoartikkelit**. Molempien taulukoiden pitäisi olla tyhjiä. Jos niissä on listauksia tai varastoartikkeleita, tili on siirretty tai rakennettu aiemmin: pysähdy ja selvitä, kuka sen teki, ennen kuin kirjoitat mitään. Tallenna nyt kopio molempien tilien tiedoista palautuspisteeksi.

![Tuotelistaukset-taulukko ilman rivejä korostettuna](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-02.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=48d5af77169512d52c0bcb471fc8e106)

**3. Kohdista jokainen 1.0:n toimipiste 2.0:n sijaintiin**

Avaa **Asetukset → Toimipisteet**, merkitse muistiin jokainen sijainti kohdassa **Kaikki sijainnit** ja lue niiden tunnisteet API:n kautta. Osoita jokainen 1.0:n toimipiste sijaintiin, joksi se tulee, myös yhdistetyt. Kirjoita varasto, listaukset ja hinnat näitä tunnisteita vasten. Jätä sijaintien omat asetukset vaiheeseen 1: sijainti ilman nouto- tai palautustapaa tai myyntikanavaa ei tee mistään tilattavaa.

![Asetukset avattuna Toimipisteet-sivulle, jossa Kaikki sijainnit -kortti on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-03.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=26759c78d615bb016dfdb3bb7afc9c84)

**4. Luo SKU:t ja varastoartikkelit**

Luo yksi SKU jokaista 1.0:n SKU:ta kohden samalla koodilla. Luo 1.0:n yksittäinen artikkeli varastoartikkeliksi, jota seurataan yksilöllisesti, ja bulk-artikkeli yhdeksi varastoartikkeliksi, jota seurataan määränä. Merkitse myydyt tai kadonneet artikkelit ei-aktiivisiksi. Luo attribuutit ensin ja siirrä mukautettujen kenttien arvot niihin.

![Varastonimikkeet-taulukko, jossa Varastonimikkeet-valikkokohta ja SKU-koodi-sarake on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-04.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=ae3122e988fa4217d9af0d3ee951f9ef)

**5. Luo listaukset**

Luo yksi listaus jokaista 1.0:n tuotetta kohden. Ohita kaksoiskappaleet, jotka kauppias teki kiertääkseen 1.0:n rajoituksia. Kopioi jokaisen tuotteen myyntikanavat, myös verkkokaupasta piilotettujen tuotteiden. Muunna Markdown-kuvaukset muotoilluksi tekstiksi, tai verkkokauppa näyttää raa'at merkit.

![Listauksen Julkaisu-välilehti, jossa välilehti ja Myyntikanavat-kortti on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-05.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=112bae6b851d9119c47f44024b89759c)

**6. Kirjoita varastosäännöt**

Anna jokaiselle listaukselle sääntö, joka vastaa sen SKU-koodeja. Anna paketille yksi sääntö jokaista osaa kohden, kukin yhdelle yksikölle: yhden säännön sisäisistä ehdoista riittää mikä tahansa, erillisten sääntöjen on täytyttävä kaikkien. Luo kokojen ja muiden varianttien vaihtoehdot ja sitten jokaiselle vaihtoehdolle varianttisääntö, joka rajaa sen vaihtoehdon omaan varastoon.

![Pakettilistauksen Keräily-välilehti, jossa välilehti ja varastoartikkelikortti sääntöineen, yksi kutakin osaa kohden, on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-06.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=275e8a1268c1917c08cd8c3644dd1028)

**7. Luo hintataulukot**

Kirjoita jokainen 1.0:n porras kiinteänä rivinä tai yhtenä kertoimeen perustuvana rivinä, kuten päätettiin. 1.0:n aukioloaikojen sisällä laskettu päivä muuttuu päiväriviksi, joka päättyy sulkemisaikaan. Tarkista ensin hintojen mittakaava: jotkin 1.0-tilit tallentavat hinnat sentteinä. Jos rivi on voimassa kaikkina viikonpäivinä, jätä viikonpäivät asettamatta äläkä anna tyhjää listaa.

![Listauksen Hinnoittelu-välilehti, jossa välilehti ja hintarivit on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-07.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=1a67066165d0cdc6a50fae98930a7400)

**8. Luo lisäosat**

Tee ilmaisista lisävarusteista lisäosalistauksia ja liitä kukin listauksiin, joihin se kuuluu, ellei kaikki kauppiaan tarjoama ole ilmaista. Luo vakuutus tai vahinkovastuun rajoitus ostoskorin lisäosaksi.

![Listauksen Suositukset-välilehti, jossa välilehti ja Lisämyynti-kortti on korostettu](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-08.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=f55bb48fdb78e8c0067c8c51647f6145)

**9. Luo kokoelmat**

Luo yksi kokoelma jokaista 1.0:n kategoriaa kohden, jota kauppias yhä käyttää, ja lisää siihen sen listaukset. Kytke verkkokanava pois kokoelmalta, jossa ei ole yhtään verkossa myytävää listausta, tai se näkyy tyhjänä verkkokaupan valikossa.

![Kokoelmat-taulukko korostettuna](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-09.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=22398f5412958f9259d9a20460c37e45)

**10. Tuo asiakkaat, jos niin päätettiin**

Luo yksi asiakas jokaista 1.0:n asiakasta kohden ja täsmäytä sähköpostiosoitteen perusteella, jotta kaksoiskappaleita ei synny. Ohita tämä vaihe, jos kauppias päätti jättää asiakkaat 1.0:aan.

![Asiakkaat-taulukko sumennetuin rivein korostettuna](https://mintcdn.com/twicecommerce/jz2_BOK5KskFTNx1/images/guide-migrate-through-the-api-10.webp?fit=max\&auto=format\&n=jz2_BOK5KskFTNx1\&q=85\&s=6e12d9061031b849d08f409af5bb58e8)

## Mistä tiedän, että se onnistui?

* Jokaisella 1.0:n SKU:lla, varastoartikkelilla, tuotteella ja kategorialla, jonka kauppias säilytti, on vastine 2.0:ssa, laskettuna kummankin API:n ilmoittamia kokonaismääriä vasten.
* Jokaisella listauksella, jonka takana on varastoa, on varastosääntö, ja sen hintarivit vastaavat 1.0:aa.
* Kauppias on käynyt läpi [vaiheen 3](https://www.twicecommerce.com/docs/fi/guides/migration/check-what-was-migrated.md), ja jokaisen listauksen voi tilata verkkokaupasta.

## Vianetsintä ja yleiset sudenkuopat

> [accordion] Verkkokauppa näyttää jokaisen listauksen saatavilla olemattomana
>
> Sijainnilla ei ole nouto- tai palautustapaa tai sen verkkokanava on pois päältä, tai hintarivit eivät ole voimassa yhtenäkään viikonpäivänä. Katso [Selvitä myymätön listaus](https://www.twicecommerce.com/docs/fi/guides/catalog/diagnose-an-unsellable-listing.md).

> [accordion] Hinnat ovat sata kertaa liian korkeita tai matalia
>
> Tämä 1.0-tili tallentaa hinnat eri yksikössä kuin oletit. Vertaa yhtä siirrettyä hintaa siihen, mitä kauppias veloittaa nyt, ja aja hintavaihe uudelleen. Katso [Mikä muuttuu TWICE 1.0:sta](https://www.twicecommerce.com/docs/fi/guides/migration/what-changes-from-1-0.md#hintasi).

> [accordion] Paketin voi tilata, vaikka yksi osa on loppu varastosta
>
> Sen osat jakavat yhden säännön, joten mikä tahansa niistä täyttää sen. Jaa osat kukin omaan sääntöönsä. Katso [Listauksen varastosäännöt](https://www.twicecommerce.com/docs/fi/guides/catalog/listing-inventory-rules.md).

## Aiheeseen liittyvät artikkelit

> [card] [Mikä muuttuu TWICE 1.0:sta](https://www.twicecommerce.com/docs/fi/guides/migration/what-changes-from-1-0.md)
>
> Jokainen 1.0:n kohde ja sen korvaaja 2.0:ssa.

> [card] [API-avaimet](https://www.twicecommerce.com/docs/fi/concepts/integrations/api-keys.md)
>
> Oikeusalueet, vanheneminen ja avaimen lähettäminen.

> [card] [Luonti joukkona](https://www.twicecommerce.com/docs/fi/concepts/integrations/bulk-creation.md)
>
> Luo monta varastoartikkelia, SKU:ta tai asiakasta yhdellä kutsulla.

> [card] [Tarkista tietosi 1.0:aa vasten](https://www.twicecommerce.com/docs/fi/guides/migration/check-what-was-migrated.md)
>
> Kauppiaan tarkistus, kun tuonti on valmis.


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