> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Yhdistä PeakWMS

> Ota Zippendo osoitekorttien toimittajaksi PeakWMS-varastollesi vaihe vaiheelta kuvakaappauksin, ensimmäisestä napsautuksesta Zippendossa ensimmäiseen pakkauspöydällä tulostettuun osoitekorttiin.

Kun varastosi käyttää [PeakWMS](https://peakwms.com)-järjestelmää, pakkaajiesi ei koskaan tarvitse avata Zippendoa. He pakkaavat paketin PeakWMS:ssä, PeakWMS pyytää Zippendolta osoitekortin, ja osoitekortti tulee tulostimesta pakkauspöydällä. Zippendo lähettää lähetyksen kuljetusyhtiölle, seuraa seurantaa ja näyttää lähetyksen kohdassa **Lähetykset** kuten muutkin.

Tämä opas käy käyttöönoton läpi kuvakaappauksin. Viitesivu [PeakWMS](/docs/fi/integrations/peakwms) selittää jokaisen PeakWMS-asetuksen ja sen, mitä tehdä, kun jokin menee pieleen.

<Info>
  PeakWMS:ään ei asenneta mitään. Luot yhteyden Zippendossa, kopioit API-tokenin ja muutaman verkko-osoitteen PeakWMS:ään ja kerrot PeakWMS:lle, mitä kuljetuspalvelua kukin toimitustapa käyttää. Siihen menee noin kaksikymmentä minuuttia, kerran.
</Info>

## Ennen aloitusta

* Voit muuttaa PeakWMS:n asetuksia ja tiedät, missä sen forwarderit ovat. Forwarder on PeakWMS:n nimi kuljetusyhtiön määritykselle.
* Verkkokauppasi on yhdistetty Zippendoon, ja kassalla näkyvät jo Zippendon toimitustavat. Katso [Myyntikanavien yhdistäminen](/docs/fi/tutorials/connect-order-channels).
* Zippendossa on vähintään yksi [toimitussääntö](/docs/fi/tutorials/shipping-rules).

## 1. Etsi PeakWMS Zippendosta

Valitse sivupalkista **Sovellukset ja integraatiot** ja sitten **Katalogi**-välilehti. Kohdassa **Integraatiot** ovat järjestelmät, jotka yhdistyvät Zippendoon ja pyytävät sitä tekemään jotain. PeakWMS on yksi niistä, ja siinä on **Yhdistä**-painike. Kortin **Lue lisää** avaa PeakWMS:n omat ohjesivut.

## 2. Luo yhteys

<Steps>
  <Step title="Valitse PeakWMS:n kohdalla Yhdistä">
    **Yhdistä PeakWMS** -ikkuna kysyy **Nimeä** ja **Tilitunnusta (valinnainen)**.
  </Step>

  <Step title="Nimeä yhteys varaston mukaan">
    Esimerkiksi ”PeakWMS Køge -varasto”. Jos ylläpidät useampaa varastoa, tee yksi yhteys varastoa kohti ja nimeä jokainen sijainnin mukaan, jotta voit myöhemmin erottaa, missä oli ongelma.
  </Step>

  <Step title="Tilitunnus (valinnainen)">
    Jos aiot täyttää Account ID:n PeakWMS:ssä, kirjoita sama arvo tähän. Se on turvaverkko: kun nämä kaksi eivät täsmää, Zippendo hylkää pyynnön, joten forwarder, johon on määritetty toisen varaston verkko-osoitteet, ei voi tulostaa osoitekortteja väärälle yhteydelle. Voit jättää sen tyhjäksi.

    <Frame caption="Yhdistä PeakWMS -ikkuna">
      <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/02-connect-modal-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=217dee82f526d42d30d207dd2a2fbfff" alt="Yhdistä PeakWMS -ikkuna, jossa varaston nimi ja esimerkki Account ID:stä" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/02-connect-modal-light.png" />

      <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/02-connect-modal-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=455dbceee4e14b74ded526b3dbbdd266" alt="Yhdistä PeakWMS -ikkuna, jossa varaston nimi ja esimerkki Account ID:stä" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/02-connect-modal-dark.png" />
    </Frame>
  </Step>

  <Step title="Valitse brändi (vain brändien kanssa)">
    Jos organisaatiosi käyttää brändejä, ikkuna kysyy myös **Brändiä**, jolle tämä varasto lähettää.
  </Step>

  <Step title="Valitse Luo yhteys">
    Näet **WMS-yhteys luotu**, ja uuden yhteyden sivu avautuu.
  </Step>
</Steps>

## 3. Kopioi API-token, kun se on näytöllä

Yhteyden sivu näyttää **API-tokenin** täsmälleen kerran, heti yhteyden luomisen jälkeen. Valitse sen vieressä oleva kopiointipainike nyt ja säilytä token turvallisessa paikassa, kunnes olet liittänyt sen PeakWMS:ään.

<Frame caption="API-token näytetään kerran kopiointipainikkeen kanssa">
  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/03-token-shown-once-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=7d6113e5a6fac453e78cacab115821f8" alt="Yhteyden sivun API-token-osio, jossa API-token näytetään kerran kopiointipainikkeen kanssa" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/03-token-shown-once-light.png" />

  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/03-token-shown-once-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=b40844f259f85551833b13f6e23212f7" alt="Yhteyden sivun API-token-osio, jossa API-token näytetään kerran kopiointipainikkeen kanssa" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/03-token-shown-once-dark.png" />
</Frame>

<Warning>
  Jos poistut sivulta kopioimatta, tokenia ei voi näyttää uudelleen. Valitse **Vaihda token** saadaksesi uuden. Vanha lakkaa toimimasta heti, joten PeakWMS tarvitsee uuden tokenin, ennen kuin pakkaajasi voivat tulostaa taas.
</Warning>

API-token sallii PeakWMS:n vain luoda ja lukea lähetyksiä. Se ei näe kuljetusyhtiötilejäsi, osoitteitasi, tilauksiasi eikä laskutustasi.

## 4. Kopioi verkko-osoitteet PeakWMS:ään

Tokenin alla **URL-osoitteet varastojärjestelmällesi** luettelee yhden verkko-osoitteen jokaiselle asialle, jonka PeakWMS voi pyytää Zippendoa tekemään. Jokaisella on oma kopiointipainikkeensa.

<Frame caption="URL-osoitteet varastojärjestelmällesi, jokaisen osoitteen vieressä kopiointipainike">
  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/04-endpoint-urls-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=c708c756014122b0828c45c2811df4f7" alt="URL-osoitteet varastojärjestelmällesi -osio, jossa Luo osoitekortti, Luo palautuksen osoitekortti, Osoitekortti QR-koodina, Seuranta, Olemassa oleva lähetys ja Osoitekortti käytetty kopiointipainikkeineen" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/04-endpoint-urls-light.png" />

  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/04-endpoint-urls-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=3d902de99bda0e957e455ecb5e744b7c" alt="URL-osoitteet varastojärjestelmällesi -osio, jossa Luo osoitekortti, Luo palautuksen osoitekortti, Osoitekortti QR-koodina, Seuranta, Olemassa oleva lähetys ja Osoitekortti käytetty kopiointipainikkeineen" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/04-endpoint-urls-dark.png" />
</Frame>

Siirry nyt PeakWMS:ään. Kaikki tämän vaiheen toimet tehdään siellä, uudella forwarderilla:

<Steps>
  <Step title="Luo forwarder">
    Lisää PeakWMS:ssä uusi **Forwarder** ja aseta **Provider**-arvoksi **Generic**: forwarder-tyyppi, joka lähettää pyyntöjä täyttämiisi verkko-osoitteisiin. Jos et löydä näyttöä, PeakWMS:n oma [ohjekeskus](https://help.peakwms.com/support/solutions) opastaa siinä. Määritys on sama, mitä kuljetusyhtiötä tahansa käytät.
  </Step>

  <Step title="Liitä verkko-osoitteet">
    Kopioi jokainen osoite Zippendosta PeakWMS:n samannimiseen kenttään: **Luo osoitekortti** (pakollinen), **Seuranta** (suositeltu) ja haluamasi valinnaiset, kuten **Luo palautuksen osoitekortti**, **Osoitekortti QR-koodina**, **Olemassa oleva lähetys** ja **Osoitekortti käytetty**. Jätä **Peru lähetys** tyhjäksi. Zippendo näyttää siinä tekstin ”Not supported. Leave this field blank.”, koska se ei voi perua osoitekorttia kuljetusyhtiöllä.
  </Step>

  <Step title="Täytä kirjautumiskentät">
    **API key** on vaiheessa 3 kopioimasi API-token. **Auth scheme** on **Bearer**, joka on yksinkertaisesti tapa, jolla PeakWMS luovuttaa tokenin. **Account ID** on arvo, jonka kirjoitit Zippendoon vaiheessa 2, jos käytit sellaista.
  </Step>
</Steps>

<Note>
  Forwarder-kenttien täydellinen taulukko, myös se, mitkä ovat valinnaisia, on sivulla [PeakWMS](/docs/fi/integrations/peakwms) kohdassa ”Liitä ne PeakWMS:ään”.
</Note>

## 5. Aseta Host ID jokaiselle toimitustavalle PeakWMS:ssä

PeakWMS:ssä jokaisella toimitustavalla on **Host ID**. Sen avulla PeakWMS kertoo Zippendolle, mitä kuljetusyhtiötä, kuljetuspalvelua ja toimitussääntöä käytetään, kun paketti pakataan. Asetat sen PeakWMS:ssä itse toimitustavalle, et Zippendossa.

<Steps>
  <Step title="Etsi koodi, jonka Zippendo jo laittaa tilauksillesi">
    Kun verkkokauppasi on yhdistetty Zippendoon, jokaisella tilauksella on asiakkaan valitsema toimitustapa koodina, kuten `postnord:PNL13:rule_01HZX9K2QF`: kuljetusyhtiö, kuljetuspalvelu ja toimitussääntö. Tee testitilaus verkkokaupassasi, avaa se ja kopioi koodi toimitustavasta.
  </Step>

  <Step title="Liitä se Host ID:ksi PeakWMS:ssä">
    Avaa vastaava toimitustapa PeakWMS:ssä ja liitä koodi sen **Host ID** -kenttään. Toista jokaiselle verkkokauppasi tarjoamalle toimitustavalle. Zippendo tunnistaa nämä koodit itse, joten niitä varten ei tarvitse määrittää mitään Zippendossa.
  </Step>

  <Step title="Noutopisteet: liitä vain pystyviivaa edeltävä osa">
    Kun asiakas valitsi noutopisteen, tilauksen koodin lopussa on pystyviiva (`|`) ja noutopiste, kuten `postnord:PNL13:rule_01HZX9K2QF|1234567`. Liitä Host ID:ksi vain pystyviivaa **edeltävä** osa. PeakWMS jakaa koodin siinä itse ja välittää noutopisteen Zippendolle, joten yksi Host ID kattaa jokaisen noutopisteen.
  </Step>
</Steps>

<Warning>
  Jos Host ID ei koskaan täsmää tai väärää kuljetusyhtiötä käytetään jatkuvasti, tarkista, onko tilauksillasi kenttä nimeltä `peak_shipping_code`, jonka on usein jättänyt aiemmin käyttämäsi toimitussovellus. PeakWMS lukee sen kentän ensin ja ohittaa koodin, jonka Zippendo laittaa tilaukselle. Verkkokauppasi ylläpitäjä voi tyhjentää sen.
</Warning>

### Omien Host ID:iden käyttö

Zippendossa sinun tarvitsee tehdä jotain vain, kun Host ID on oma koodisi eikä verkkokaupan tilauksen koodi. Näin on, kun tilaukset kirjoitetaan suoraan PeakWMS:ään tai kun haluat koodeja kuten `GLS_BUSINESS_PARCEL`.

Avaa Zippendossa yhteys ja siirry kohtaan **Host ID -linkitykset**. Valitse **Lisää linkitys**, kirjoita koodisi kohtaan **Host ID varastojärjestelmässä** ja valitse käytettävä sääntö kohdassa **Zippendon toimitussääntö**. Valitse **Tallenna linkitykset**, kun rivit ovat valmiit. Riviä ilman toimitussääntöä ei voi tallentaa.

<Frame caption="Host ID -linkitys: GLS_BUSINESS_PARCEL osoittaa GLS-kotiinkuljetuksen toimitussääntöön">
  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/05-host-id-mapping-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=4983b607273ea7ee898b68e12121b724" alt="Host ID -linkitykset-osio, jossa rivi linkittää GLS_BUSINESS_PARCEL:n GLS-kotiinkuljetuksen toimitussääntöön" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/05-host-id-mapping-light.png" />

  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/05-host-id-mapping-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=df14770b6b349b6575dfdbe120df2b91" alt="Host ID -linkitykset-osio, jossa rivi linkittää GLS_BUSINESS_PARCEL:n GLS-kotiinkuljetuksen toimitussääntöön" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/05-host-id-mapping-dark.png" />
</Frame>

## 6. Lopeta tilausten tuonti kyseisestä verkkokaupasta

PeakWMS omistaa nyt tilaukset. Jos Zippendo toisi niitä edelleen, kumpikin järjestelmä loisi lähetykset samalle tilaukselle ja maksaisit kahdesta osoitekortista. Avaa **Myyntikanavat**, avaa verkkokauppa ja kytke kohdassa **Mihin Zippendoa käytetään** pois päältä **Tuo tilaukset tästä verkkokaupasta**.

<Frame caption="Kytke tilausten tuonti pois verkkokaupasta, jota PeakWMS hoitaa">
  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/07-import-orders-switch-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=73324be01059bfd45388799f5b6d4929" alt="Myyntikanavan asetukset, joissa Mihin Zippendoa käytetään -osio ja tilausten tuontikytkin" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/07-import-orders-switch-light.png" />

  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/07-import-orders-switch-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=6de91b96c487660f06e61dc995e573ce" alt="Myyntikanavan asetukset, joissa Mihin Zippendoa käytetään -osio ja tilausten tuontikytkin" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/07-import-orders-switch-dark.png" />
</Frame>

Toimitushinnat ja noutopisteen valinta kassalla toimivat täsmälleen kuten ennenkin. Vain tilausten tuonti loppuu, eikä Zippendo enää merkitse tilauksia lähetetyiksi verkkokaupassasi, koska PeakWMS tekee sen nyt.

## 7. Tarkista, että se toimii

Pakkaa yksi tilaus PeakWMS:n testiympäristössä ja tarkista kolme asiaa: osoitekortti tulostuu ja näyttää odottamasi kuljetusyhtiön, paketti näkyy Zippendon kohdassa **Lähetykset** ja seuranta näkyy tilauksella PeakWMS:ssä. Vaihda sitten PeakWMS:n osoitteet tuotantoasetuksiisi.

Zippendon **Yhdistetty**-välilehti kohdassa **Sovellukset ja integraatiot** näyttää PeakWMS-yhteytesi sekä sen, milloin PeakWMS pyysi viimeksi jotain, tai ”Ei vielä käytetty”. Kun pyyntö epäonnistui, se näyttää viestin, jonka pakkaaja näki.

## Yhteyden keskeyttäminen tai poistaminen

Avaa yhteys valitsemalla sen rivi PeakWMS-kortilla. Kytke pois päältä **Salli varastojärjestelmän luoda osoitekortteja** estääksesi PeakWMS:ää luomasta osoitekortteja poistamatta mitään, ja kytke se takaisin päälle, kun olet valmis. **Poista yhteys** alareunassa poistaa yhteyden ja sen API-tokenin pysyvästi. Jo luodut lähetykset säilyvät paikallaan.

<Frame caption="Salli varastojärjestelmän luoda osoitekortteja on kytkin yhteyden keskeyttämiseen">
  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/08-accept-requests-light.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=24e45c2fe5fd51c82aa94a129bce5c1d" alt="Yhteyden sivu, jossa Tila-osio ja Salli varastojärjestelmän luoda osoitekortteja -kytkin päällä" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/08-accept-requests-light.png" />

  <img src="https://mintcdn.com/zippendo/1v6z3od2MwG05xs5/images/fi/tutorials/connect-peakwms/08-accept-requests-dark.png?fit=max&auto=format&n=1v6z3od2MwG05xs5&q=85&s=77b70f607ecbee3f6d2f4a199e7377dc" alt="Yhteyden sivu, jossa Tila-osio ja Salli varastojärjestelmän luoda osoitekortteja -kytkin päällä" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/tutorials/connect-peakwms/08-accept-requests-dark.png" />
</Frame>

## Hyvä tietää

* Pakkaaja, joka pakkaa saman tilauksen kahdesti, ei saa kahta osoitekorttia. Zippendo palauttaa jo luodun osoitekortin.
* Palautusten osoitekortit toimivat samoin. Osoite, johon paketti palaa, on aina toimitussääntösi lähettäjän osoite, joten osoitekortti on oikea, vaikka PeakWMS:ssä olisi tallennettuna eri osoite.
* Vaaralliset aineet hylätään sen sijaan, että ne lähetettäisiin ilman tarvittavia asiakirjoja. Lähetä ne PeakWMS:ssä toisen forwarderin kautta.

## Aiheeseen liittyvää

* [PeakWMS](/docs/fi/integrations/peakwms): jokainen PeakWMS-asetus, Host ID -säännöt ja viestit, joita pakkaajasi voivat nähdä
* [Toimitussäännöt](/docs/fi/tutorials/shipping-rules): säännöt, joihin Host ID osoittaa
* [Myyntikanavan asetukset](/docs/fi/how-to/order-channel-settings): verkkokaupan kytkimet


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