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

# Webhook-toimitusten epäonnistuminen

> Mitä tehdä, kun Zippendon webhookit eivät saavu järjestelmääsi, näyttävät virheitä toimituslokissa tai saapuvat useammin kuin kerran.

Webhookin avulla Zippendo kertoo toiselle järjestelmälle tapahtumasta, kuten **Lähetys lähetetty** tai **Seuranta päivitetty**. Webhookit otetaan käyttöön kohdassa **Asetukset** → **Webhookit** (avaa organisaatiovalikko ja napsauta **Hallitse**). Jokaisesta tapahtumasta Zippendo lähettää viestin antamaasi **Päätepisteen URL** -osoitteeseen.

Nämä eivät ole kuljetusyhtiön seurannan webhookeja. Niistä katso [Kuljetusyhtiöiden seurannan webhookit](/docs/fi/how-to/tracking-webhooks).

## Mitä näet

* Järjestelmäsi ei saa mitään.
* Webhookin **Toimitusloki** näyttää punaisia tilakoodeja tai tekstiä **Virhe**-sarakkeessa.
* Järjestelmäsi saa saman tapahtuman useammin kuin kerran.

## Tarkista ensin toimitusloki

Napsauta **Webhookit**-sivulla webhookin kohdalla **Toimitusloki**. Jokainen rivi on yksi yritys, ja siinä näkyvät **Tapahtuma**, **Tila**, jolla järjestelmäsi vastasi, **Kesto** ja mahdollinen **Virhe**.

* **Ei vielä toimituksia**: Zippendo ei ole yrittänyt lähettää mitään. Katso alla ”Mitään ei lähetetä”.
* Vihreä tila: järjestelmäsi sai viestin. Etsi ongelmaa omasta järjestelmästäsi.
* Punainen tila tai **Ei tietoa** ja virhe: järjestelmäsi ei hyväksynyt viestiä. Katso alla ”Toimitukset epäonnistuvat”.

## Mitään ei lähetetä

| Todennäköinen syy | Mitä tehdä |
| - | - |
| Webhook on **Ei aktiivinen** | Napsauta webhookin kohdalla **Muokkaa** ja ota käyttöön **Aktiivinen**. Ei-aktiivinen webhook ei lähetä eikä kirjaa mitään. **Lähetä testi** ei myöskään lähetä mitään, vaikka se näyttää **Testitapahtuma lähetetty** |
| Tapahtumaa ei ole rastitettu | Napsauta **Muokkaa** ja tarkista, että tapahtuma on rastitettu kohdassa **Tapahtumat** |
| Tapahtumaa ei tapahtunut | Esimerkiksi **Lähetys lähetetty** lähetetään vasta, kun lähetys todella lähetetään kuljetusyhtiölle |

## Toimitukset epäonnistuvat

Zippendo katsoo toimituksen onnistuneeksi vain, kun järjestelmäsi vastaa onnistumistilalla (200-299) 10 sekunnin kuluessa. Muuten se yrittää uudelleen vielä muutaman kerran noin minuutin sisällä, yhteensä 5 yritystä. Sen jälkeen tapahtumaa ei lähetetä uudelleen.

| Mitä toimitusloki näyttää | Todennäköinen syy | Mitä tehdä |
| - | - | - |
| 404 | **Päätepisteen URL** on väärä tai osoite on muuttunut puolellasi | Korjaa **Päätepisteen URL** kohdassa **Muokkaa** |
| 401 tai 403 | Järjestelmäsi pyytää salasanaa tai tokenia tai estää tuntemattomat lähettäjät | Päästä Zippendon viestit läpi ja tarkista ne allekirjoituksen avulla (katso alla) |
| 500-599 | Järjestelmäsi kaatui viestiä käsitellessään | Tarkista järjestelmäsi virheloki |
| **Ei tietoa** ja aikakatkaisuvirhe | Järjestelmäsi vastaus kesti yli 10 sekuntia | Vastaa heti ja tee hitaat työt vasta sen jälkeen |
| **Ei tietoa** ja yhteysvirhe | Osoitteeseen ei saada yhteyttä internetistä tai sen varmenne on virheellinen | Käytä julkista `https://`-osoitetta, jolla on kelvollinen varmenne |

Kun olet korjannut syyn, napsauta webhookin kohdalla **Lähetä testi**. Näet **Testitapahtuma lähetetty**, ja kohtaan **Toimitusloki** ilmestyy uusi rivi.

<Note>
  Zippendo ei lähetä epäonnistuneita tapahtumia myöhemmin uudelleen. Jos järjestelmäsi oli pois käytöstä jonkin aikaa, hae kaipaamasi lähetykset tai tilaukset Zippendo-sovelluksesta tai API:n kautta.
</Note>

## Järjestelmäsi hylkää allekirjoituksen

Jokaisessa viestissä on `X-Webhook-Signature`-otsikko, jotta järjestelmäsi voi tarkistaa, että se tuli todella Zippendosta. Se on viestin raakasisällön HMAC-SHA256, joka on tehty webhookin salaisuudella. Yleisiä virheitä:

* Allekirjoitus lasketaan viestistä sen jälkeen, kun se on jäsennetty ja kirjoitettu uudelleen, eikä raakasisällöstä täsmälleen sellaisena kuin se vastaanotettiin.
* Käytetään toisen webhookin salaisuutta. Jokaisella webhookilla on oma salaisuutensa.

Tiedot ja koodiesimerkit: [Webhookien pika-aloitus](/docs/fi/quickstarts/webhooks).

## Sama tapahtuma saapuu kahdesti

Jos järjestelmäsi vastasi liian hitaasti tai virheellä, Zippendo yrittää uudelleen, vaikka järjestelmäsi olisi käsitellyt ensimmäisen yrityksen. Käytä `X-Webhook-Id`-otsikkoa tunnistaaksesi viestin, jonka olet jo käsitellyt.

Liittyvää: [Webhookit](/docs/fi/how-to/webhooks), [Webhook-asetukset](/docs/fi/settings/webhooks).


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