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

# Kuljetusyhtiöiden seurantawebhookit

> Miten Zippendo saa seurantapäivitykset kustakin kuljetusyhtiöstä, miksi mitään ei tarvitse määrittää ja miten tämä eroaa omista webhookeistasi kohdassa Asetukset → Webhookit.

Zippendo pitää jokaisen lähetyksen seurannan ajan tasalla itse. Jotkin kuljetusyhtiöt lähettävät päivityksensä Zippendoon heti, kun jotain tapahtuu (kuljetusyhtiön seurantawebhook). Muille Zippendo hakee päivitykset kuljetusyhtiöltä tunnin välein. Kummassakin tapauksessa sinun ei tarvitse määrittää mitään: kuljetusyhtiön yhdistäminen riittää.

Kuljetusyhtiöiden seurantawebhookit eivät ole sama asia kuin webhookit, jotka luot kohdassa **Asetukset** → **Webhookit**. Ne lähettävät päivityksiä Zippendosta omaan järjestelmääsi. Katso [Webhookit](/docs/fi/how-to/webhooks). Seurannan opas on [Seuranta](/docs/fi/tutorials/tracking).

<Warning>
  Älä luo kohtaan **Asetukset** → **Webhookit** webhookia, johon GLS, PostNord, Bring tai mikään muu kuljetusyhtiö lähettäisi. Se luettelo on vain Zippendon omiin järjestelmiisi lähettämiä varten. Kuljetusyhtiöt lähettävät päivityksensä Zippendoon erillisellä yhteydellä, jota sinun ei koskaan tarvitse nähdä tai muuttaa.
</Warning>

## Kahdenlaisia webhookeja

| | Kuljetusyhtiöiden seurantawebhookit | Omat webhookisi |
| - | - | - |
| Suunta | Kuljetusyhtiöltä Zippendoon | Zippendosta omaan järjestelmääsi |
| Missä määrität | Ei missään. Kuljetusyhtiön yhdistäminen riittää. | Organisaatiovalikko → **Hallitse** → **Webhookit** |
| Mitä se päivittää | Lähetyksen sivun **Seurannan aikajana** -kortin | Oman järjestelmäsi, esimerkiksi kun lähetys lähetetään tai sen seuranta muuttuu |
| Ohje | Tämä sivu | [Webhookit](/docs/fi/how-to/webhooks) |

<Frame caption="Asetukset → Webhookit on Zippendon ilmoituksille järjestelmääsi, ei kuljetusyhtiöille">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/01-settings-webhooks-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=df4502ef02b976ecde826728a25ce28f" alt="Asetusten Webhookit-luettelo, jossa webhook on tilannut lähetys- ja seurantatapahtumat" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/01-settings-webhooks-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/01-settings-webhooks-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=f8b6f353baa46fc34fb0808c38f59d49" alt="Asetusten Webhookit-luettelo, jossa webhook on tilannut lähetys- ja seurantatapahtumat" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/01-settings-webhooks-dark.png" />
</Frame>

Jos haluat seurantapäivitykset omaan järjestelmääsi, napsauta **Lisää webhook** ja ota kohdassa **Seuranta** käyttöön **Seuranta päivitetty**. Se on yksi omista webhookeistasi, ei kuljetusyhtiön seurantawebhook.

<Frame caption="Seuranta päivitetty Seuranta-ryhmässä, kun luot webhookin">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/02-tracking-updated-event-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=9587f2269133498fb18d3d94c08d9ece" alt="Luo webhook -ikkuna vieritettynä Seuranta-ryhmään, jossa Seuranta päivitetty -tapahtuma" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/02-tracking-updated-event-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/02-tracking-updated-event-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=0251f99e14f96c66b0be820317b95740" alt="Luo webhook -ikkuna vieritettynä Seuranta-ryhmään, jossa Seuranta päivitetty -tapahtuma" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/02-tracking-updated-event-dark.png" />
</Frame>

## Miten kukin kuljetusyhtiö lähettää seurantatiedot

| Kuljetusyhtiö | Miten seuranta tulee Zippendoon | Mitä teet |
| - | - | - |
| **GLS Denmark**, **GLS Croatia**, **GLS Czech Republic**, **GLS Hungary**, **GLS Romania**, **GLS Slovakia**, **PostNord**, **DAO Denmark**, **Danske Fragtmænd**, **FedEx**, **UPS**, **DHL Express**, **DHL Parcel Benelux**, **Matkahuolto**, **DPD Hungary**, **DPD Latvia**, **DPD Lithuania**, **DPD Polska**, **DPD Switzerland**, **Helthjem**, **PostNL** | Zippendo hakee päivitykset kuljetusyhtiöltä tunnin välein. | Ei mitään. |
| **Bring** | Bring lähettää päivitykset Zippendoon. Zippendo tilaa lähetykselle Bringin seurantapäivitykset (Bring Event Cast), kun lähetät sen. | Ei mitään. Yhdistä Bring tavalliseen tapaan. |
| **Instabox**, **Budbee**, **Porterbuddy** | Instabee, näiden kuljetusyhtiöiden taustalla oleva yritys, lähettää päivitykset Zippendoon. | Ei mitään. Yhdistä kuljetusyhtiö tavalliseen tapaan. |
| **Instabox (vanha API)** | Sama kuin Instabox. | Ei mitään. Tämä kuljetusyhtiö on vanhentunut, joten uusissa käyttöönotoissa pitää käyttää **Instabox**-vaihtoehtoa. |
| **Royal Mail** | Zippendo hakee päivitykset Royal Mailista tunnin välein, jos yhteydellä on **Client ID (API Portal)** ja **Client secret (API Portal)** ja Tracking on otettu käyttöön Royal Mail -tililläsi. | Täytä molemmat kentät kohdassa **Muokkaa kuljetusyhtiötä**. Ilman niitä aikajana pysyy tyhjänä, mutta jokaisella lähetyksellä on silti seurantakoodi ja royalmail.com-seurantalinkki. Katso [Yhdistä Royal Mail](/docs/fi/how-to/connect-royal-mail). |
| **Posti** | Zippendo hakee päivitykset Postilta tunnin välein, jos yhteydellä on **Seuranta-API:n käyttäjätunnus** ja **Seuranta-API:n salasana**. | Pyydä Postin asiakaspalvelulta Tracking API -tunnus ja täytä molemmat kentät kohdassa **Muokkaa kuljetusyhtiötä**. Ilman niitä aikajana pysyy tyhjänä, mutta jokaisella lähetyksellä on silti seurantakoodi ja **Seurantalinkki** posti.fi-sivustolle. Katso [Yhdistä Posti](/docs/fi/how-to/connect-posti). |
| **DSV XPress** | Zippendo hakee päivitykset DSV:ltä tunnin välein, jos yhteydellä on **Tracking-palvelun avain**. | Kopioi **Tracking**-avain XPress-portaalin API-profiilisivulta kenttään **Tracking-palvelun avain** kohdassa **Muokkaa kuljetusyhtiötä**. Jos DSV antoi sinulle erillisen **Tracking-tilausavaimen**, lisää myös se. Ilman avainta aikajana pysyy tyhjänä, mutta jokaisella lähetyksellä on silti seurantakoodi ja **Seurantalinkki**. Katso [Yhdistä DSV XPress](/docs/fi/how-to/connect-dsv-xpress). |
| **DSV Road**, **DSV Road (DB Schenker)** | Zippendo hakee päivitykset DSV:ltä tunnin välein, jos yhteydellä on **Tracking-tilausavain**. | Tilaa DSV:n seurantatuote developer.dsv.com-sivustolla ja kopioi sen ensisijainen avain kenttään **Tracking-tilausavain** kohdassa **Muokkaa kuljetusyhtiötä**. Ilman sitä aikajana pysyy tyhjänä, mutta jokaisella lähetyksellä on silti seurantakoodi ja **Seurantalinkki**. Katso [Yhdistä DSV Road](/docs/fi/how-to/connect-dsv-road). |
| **DPD Belgium** | Seurantatapahtumat eivät näy Zippendossa. | Ei mitään. Seuraa lähetyksen **Seurantalinkkiä** DPD:n seurantasivulle. |
| **DHL eCommerce Europe** | Seurantatapahtumat eivät vielä näy Zippendossa. Kun Zippendo ottaa DHL-seurannan käyttöön, Zippendo hakee päivitykset DHL:ltä tunnin välein. | Ei mitään. Siihen asti seuraa lähetyksen **Seurantalinkkiä** DHL:n seurantasivulle. **DHL Parcel Connect Light (ilman seurantaa)** -palvelussa ei ole seurantaa. |

**Muokkaa kuljetusyhtiötä** -sivulla ei ole koskaan seurannan verkko-osoitteen kenttää. Siinä näkyvät vain **Kuljetusyhtiön nimi**, kuljetusyhtiön omat kentät ja useimmilla kuljetusyhtiöillä **Testitila**.

<Frame caption="GLS Denmarkin Muokkaa kuljetusyhtiötä -sivulla ei ole kenttää seurantawebhookeille">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/03-carrier-edit-no-webhook-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=bfdb6f79102e8142a91665e7a046a6a0" alt="GLS Denmarkin Muokkaa kuljetusyhtiötä -sivu, jossa Login name, Password ja Testitila" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/03-carrier-edit-no-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/03-carrier-edit-no-webhook-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=0cd3d52db11fd2d537c2a43b86b6fc13" alt="GLS Denmarkin Muokkaa kuljetusyhtiötä -sivu, jossa Login name, Password ja Testitila" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/03-carrier-edit-no-webhook-dark.png" />
</Frame>

## Mitä näet lähetyksellä

Kun olet napsauttanut **Lähetä lähetys**, avaa lähetyksen sivu. **Seurannan aikajana** ja **Seurantatiedot** -kortit tulevat näkyviin, kun lähetyksellä on seurantakoodi, seurantalinkki, koodi ilman osoitekorttia tai QR-koodi.

Kortit näyttävät samalta riippumatta siitä, miten kuljetusyhtiö lähettää päivitykset: tilamerkintä, uusimmat tapahtumat ensin ja **Seurantatiedot**, joissa on **Seurantakoodi**, **Seurantalinkki** ja joillakin lähetyksillä **Koodi ilman osoitekorttia** tai **QR-koodi**. Sen alla lukee: "Seurantatiedot tulevat kuljetusyhtiöltä. Näet uusimman tilan yllä olevalla seurantakoodilla tai -linkillä."

<Frame caption="Seurantatapahtumat ja Seurantatiedot kuljetusyhtiön ensimmäisten skannausten jälkeen">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/04-tracking-timeline-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=d81333f175c0a8d1afec14a39473851b" alt="Lähetyksen Seurannan aikajana -kortti, jossa Kuljetuksessa-merkintä, luettelo seurantatapahtumista ja seurantakoodi" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/04-tracking-timeline-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/04-tracking-timeline-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=6b4e37c66dafbf0a575a0f74e74b31d1" alt="Lähetyksen Seurannan aikajana -kortti, jossa Kuljetuksessa-merkintä, luettelo seurantatapahtumista ja seurantakoodi" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/04-tracking-timeline-dark.png" />
</Frame>

Heti lähettämisen jälkeen luettelo on yleensä tyhjä: "Ei vielä seurantapäivityksiä. Zippendo tarkistaa tilan kuljetusyhtiöltä tunnin välein." Tapahtumat ilmestyvät kuljetusyhtiön ensimmäisen skannauksen jälkeen. Kuljetusyhtiöillä, jotka lähettävät omat päivityksensä, tapahtumat voivat ilmestyä aiemmin. DPD Belgiumin ja DHL eCommerce Europen kohdalla luettelo pysyy tyhjänä, joten käytä **Seurantalinkkiä**.

<Frame caption="Ei vielä seurantapäivityksiä, heti lähettämisen jälkeen">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/05-empty-timeline-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=17529517cef8450b8caccf04b64a4bfd" alt="Seurannan aikajana -kortti, jolla lukee, ettei seurantapäivityksiä ole vielä" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/05-empty-timeline-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/tracking-webhooks/05-empty-timeline-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=02133acdc122ecc9a646f1a99addd962" alt="Seurannan aikajana -kortti, jolla lukee, ettei seurantapäivityksiä ole vielä" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/tracking-webhooks/05-empty-timeline-dark.png" />
</Frame>

Seurannan päivittämiseen ei ole painiketta. Älä luo lähetystä uudelleen saadaksesi uusia tapahtumia.

## Kun jokin menee pieleen

| Mitä näet | Mitä tehdä |
| - | - |
| "Kuljetusyhtiön seurantapäivityksiä ei voitu ottaa käyttöön." kun lähetät Bring-lähetyksen | Zippendo ei voinut tilata lähetykselle Bringin seurantapäivityksiä. Osoitekortti ja seurantakoodi ovat silti voimassa. Zippendo yrittää uudelleen tunnin välein, ja tapahtumat ilmestyvät, kun se onnistuu. Siihen asti seuraa lähetystä Bringin sivustolla **Seurantalinkillä**. |
| Kuljetusyhtiön verkkosivusto näyttää uudempia tapahtumia kuin Zippendo | Odota seuraavaa tuntipäivitystä. Jos seuranta jää jälkeen, katso [Seuranta ei päivity](/docs/fi/knowledge-base/tracking-not-updating). |

## Liittyvää

* [Webhookit](/docs/fi/how-to/webhooks)
* [Seuranta](/docs/fi/tutorials/tracking)
* [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials)
* [Seuranta ei päivity](/docs/fi/knowledge-base/tracking-not-updating)
* [Webhookien pikaopas](/docs/fi/quickstarts/webhooks)


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