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

# Pyydä kuljetusyhtiöintegraatiota

> Pyydä Zippendoa lisäämään kuljetusyhtiö, joka ei ole Kaikki kuljetusyhtiöt -välilehdellä, kohdasta Kuljetusyhtiöpyynnöt kuljetusyhtiön verkkosivuston, testitunnusten ja kirjautumistavan avulla.

Jos käyttämäsi kuljetusyhtiö ei ole **Kaikki kuljetusyhtiöt** -välilehdellä, voit pyytää Zippendoa rakentamaan yhteyden. Lähetät kuljetusyhtiön verkkosivuston, dokumentaatiolinkit ja **testi**tunnukset, ja Zippendo rakentaa ja testaa yhteyden tekoälyn avulla. Kun se on valmis, yhdistät kuljetusyhtiön kuten minkä tahansa muun.

Kuljetusyhtiöstä, joka on jo kohdassa **Kaikki kuljetusyhtiöt**, katso [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials). Täysi läpikäynti on sivulla [Kuljetusyhtiöt](/docs/fi/tutorials/carriers).

## Pyyntösi

Napsauta sivupalkissa **Kuljetusyhtiöpyynnöt**. Sivun otsikko on **Kuljetusyhtiöpyynnöt**, ja se luettelee pyyntösi otsikon **Pyyntösi** alla. Napsauta yläreunassa **Pyydä kuljetusyhtiötä** lähettääksesi uuden.

Luettelossa on sarakkeet **Kuljetusyhtiö**, **Tila**, **Kirjautumistapa**, **Lähetetty** ja **Viimeksi päivitetty**. Napsauta riviä nähdäksesi tiedot. Kun sinulla ei ole vielä pyyntöjä, sivulla lukee ”Ei kuljetusyhtiöpyyntöjä” ja siinä on **Pyydä kuljetusyhtiötä** -painike.

<Frame caption="Kuljetusyhtiöpyynnöt-sivu ennen ensimmäistä pyyntöäsi">
  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/01-request-list-light.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=eb3598639df4933544bb8c129d616a74" alt="Kuljetusyhtiöpyynnöt-sivu, jolla ei ole vielä pyyntöjä, ja Pyydä kuljetusyhtiötä -painike" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/request-carrier-integration/01-request-list-light.png" />

  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/01-request-list-dark.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=9b85e90bb0188712aabc0cda4f1e83e5" alt="Kuljetusyhtiöpyynnöt-sivu, jolla ei ole vielä pyyntöjä, ja Pyydä kuljetusyhtiötä -painike" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/request-carrier-integration/01-request-list-dark.png" />
</Frame>

### Tila

| Tila | Mitä se tarkoittaa |
| - | - |
| **Odottaa** | Lähetit pyynnön. Se odottaa, että Zippendo hyväksyy sen. |
| **Hyväksytty** | Zippendo hyväksyi pyynnön. Työ voi alkaa. |
| **Työn alla** | Zippendo rakentaa yhteyttä. |
| **Odottaa tarkistusta** | Yhteys on rakennettu ja odottaa Zippendon tiimin tarkistusta. |
| **Valmis** | Rakennus on valmis. |
| **Julkaistu** | Kuljetusyhtiö on valmis. Voit yhdistää sen kohdasta **Kaikki kuljetusyhtiöt**. |
| **Hylätty** | Zippendo ei hyväksynyt pyyntöä. |
| **Epäonnistui** | Rakennus ei onnistunut. |

## Lähetä pyyntö

<Steps>
  <Step title="Avaa lomake">
    Napsauta **Kuljetusyhtiöpyynnöt**-sivulla **Pyydä kuljetusyhtiötä**. **Pyydä kuljetusyhtiötä** -ikkuna aukeaa.
  </Step>

  <Step title="Kuvaile kuljetusyhtiö">
    Täytä **Kuljetusyhtiön nimi** ja **Kuljetusyhtiön verkkosivusto**. Lisää **Dokumentaation URL** ja **Swagger-/OpenAPI-URL**, jos kuljetusyhtiö julkaisee ne kehittäjille.
  </Step>

  <Step title="Lisää testitunnukset">
    Valitse kuljetusyhtiön käyttämä **Kirjautumistapa** ja täytä sitten sille näkyvät tunnuskentät. Käytä kuljetusyhtiön testijärjestelmän tietoja, älä oikeaa tiliäsi.
  </Step>

  <Step title="Lähetä se">
    Lisää **Muistiinpanot**, jos on jotain, mitä Zippendon tiimin pitäisi tietää, ja napsauta sitten **Lähetä pyyntö**. Näet viestin ”Kuljetusyhtiöpyyntö lähetetty”, ja pyyntö ilmestyy luetteloon tilassa **Odottaa**.
  </Step>
</Steps>

<Frame caption="Pyydä kuljetusyhtiötä -lomake, jossa Kirjautumistapa on API-avain">
  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/02-request-form-api-key-light.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=b72d0d754fe372ff3ea37faa06e05766" alt="Pyydä kuljetusyhtiötä -ikkuna, jossa on kuljetusyhtiön nimi, verkkosivusto, dokumentaatiolinkit ja API-avain-kenttä" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/02-request-form-api-key-light.png" />

  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/02-request-form-api-key-dark.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=560f0df9f9ddceae926b14725f53e929" alt="Pyydä kuljetusyhtiötä -ikkuna, jossa on kuljetusyhtiön nimi, verkkosivusto, dokumentaatiolinkit ja API-avain-kenttä" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/02-request-form-api-key-dark.png" />
</Frame>

### Kentät

| Kenttä | Pakollinen | Mitä annetaan |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Kuljetusyhtiön nimi. Enintään 80 merkkiä: kirjaimia, numeroita, välilyöntejä ja `. & ' + / ( ) _ -`. Muut merkit tuottavat viestin ”Vain kirjaimia, numeroita ja merkkejä . & ' + / ( ) \_ -”. |
| **Kuljetusyhtiön verkkosivusto** | Kyllä | Täydellinen verkko-osoite, esimerkiksi `https://developer.carrier.com`. |
| **Dokumentaation URL** | Ei | Paikka, jossa kuljetusyhtiö kuvaa järjestelmänsä kehittäjille. |
| **Swagger-/OpenAPI-URL** | Ei | Tekninen kuvaustiedosto, jos kuljetusyhtiö tarjoaa sellaisen. Kysy kuljetusyhtiöltä, jos et ole varma. |
| **Kirjautumistapa** | Kyllä | Miten kuljetusyhtiön järjestelmä tarkistaa, kuka olet. Oletuksena **API-avain**. Katso seuraava osio. |
| **Testaa kuljetusyhtiön tuotantojärjestelmää vasten** | Ei | Kytkin, oletuksena pois päältä. Katso alla. |
| **Muistiinpanot** | Ei | Mitä tahansa muuta, mitä Zippendon tiimin pitäisi tietää kuljetusyhtiöstä, enintään 1000 merkkiä. |

Virheellinen verkko-osoite tuottaa viestin ”Anna kelvollinen URL”. Tyhjä pakollinen kenttä tuottaa viestin ”Tämä kenttä on pakollinen”.

### Tunnukset kullekin kirjautumistavalle

Tunnuskentät vaihtuvat **Kirjautumistavan** mukaan. Vain valitsemasi tyypin kentät lähetetään.

| Kirjautumistapa | Täytettävät kentät |
| - | - |
| **API-avain** | **API-avain**. Jos se on tyhjä, näet viestin ”API-avain on pakollinen”. |
| **OAuth 2.0** | **Client ID**, **Client secret** ja **Token-URL** (verkko-osoite, josta kuljetusyhtiö antaa käyttöoikeuden, esimerkiksi `https://auth.carrier.com/token`). |
| **Käyttäjätunnus ja salasana** | **Käyttäjätunnus** ja **Salasana**. |
| **Mukautettu** | Lisää kohtaan **Mukautetut kirjautumistiedot** yksi rivi jokaista tietoa varten, jossa on **Avain** (sen nimi) ja **Arvo**. **Lisää kenttä** lisää rivin ja **Poista kenttä** poistaa rivin. Vähintään yhdellä rivillä on oltava nimi, tai näet viestin ”Lisää vähintään yksi avain–arvo-pari”. |

Kuljetusyhtiö kertoo, mitä tyyppiä se käyttää. Jos et ole varma, kysy kuljetusyhtiöltä tai valitse **Mukautettu** ja lisää kaikki tiedot, jotka se antoi.

<Frame caption="OAuth 2.0:lla täytä Client ID, Client secret ja Token-URL">
  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/03-request-form-oauth-light.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=93b8a68da691c71a556a3ae4d922fe99" alt="Pyydä kuljetusyhtiötä -ikkuna, jossa Kirjautumistapa on OAuth 2.0 ja kentät Client ID, Client secret ja Token-URL" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/03-request-form-oauth-light.png" />

  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/03-request-form-oauth-dark.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=52a93a771d9ff41cd1f9257466ca483f" alt="Pyydä kuljetusyhtiötä -ikkuna, jossa Kirjautumistapa on OAuth 2.0 ja kentät Client ID, Client secret ja Token-URL" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/03-request-form-oauth-dark.png" />
</Frame>

### Testaa kuljetusyhtiön tuotantojärjestelmää vasten

Jätä tämä kytkin useimmissa tapauksissa pois päältä. Zippendo testaa silloin uuden yhteyden kuljetusyhtiön testijärjestelmää vasten antamillasi tiedoilla.

Ota se käyttöön vain, jos kuljetusyhtiöllä ei ole testijärjestelmää. Lomake kertoo: ”Ota tämä käyttöön vain, jos kuljetusyhtiöllä ei ole testiympäristöä. Tällöin ajamme testit kuljetusyhtiön tuotantojärjestelmää vasten yllä olevilla kirjautumistiedoilla. Jätä tämä pois päältä, jos haluat testata kuljetusyhtiön testiympäristössä.”

Tämä kytkin vaikuttaa vain pyyntöön. Se ei ole yhdistetyn kuljetusyhtiön **Testitila**-valintaruutu, katso [Testitila](/docs/fi/how-to/sandbox-mode).

<Frame caption="Testaa kuljetusyhtiön tuotantojärjestelmää vasten on oletuksena pois päältä">
  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/04-request-form-live-light.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=bd73ae83a2d1fa6a5383ac07fc580d9f" alt="Pyydä kuljetusyhtiötä -ikkuna vieritettynä kytkimeen Testaa kuljetusyhtiön tuotantojärjestelmää vasten ja kenttään Muistiinpanot" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/04-request-form-live-light.png" />

  <img src="https://mintcdn.com/zippendo/e1BeVpj74GMUQscV/images/fi/how-to/request-carrier-integration/04-request-form-live-dark.png?fit=max&auto=format&n=e1BeVpj74GMUQscV&q=85&s=ec69223e67a70efcc45305c1a84569b6" alt="Pyydä kuljetusyhtiötä -ikkuna vieritettynä kytkimeen Testaa kuljetusyhtiön tuotantojärjestelmää vasten ja kenttään Muistiinpanot" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/request-carrier-integration/04-request-form-live-dark.png" />
</Frame>

## Seuraa pyyntöä

Napsauta pyyntöä luettelossa avataksesi sen tiedot. Näet:

* kuljetusyhtiön nimen ja tilan
* linkin kuljetusyhtiön verkkosivustolle
* **Muistiinpanosi**, jos lisäsit niitä
* **Edistyminen**: rakennuksen vaiheet, kuten **Pyyntö lähetetty**, **Selvitetään kuljetusyhtiötä**, **Rakennetaan osoitekortteja**, **Rakennetaan seurantaa**, **Rakennetaan noutopisteitä**, **Rakennetaan kuljetuspalveluja**, **Ajetaan testejä** ja **Julkaistu**. Jokainen vaihe on merkitty **Odottaa**, **Rakennetaan**, **Valmis**, **Epäonnistui** tai **Ohitettu**.

Napsauta **Sulje** palataksesi luetteloon. Et voi muuttaa tai lähettää pyyntöä uudelleen täältä. Jos jokin on pielessä, lähetä uusi pyyntö.

Kun tila on **Julkaistu**, avaa **Kuljetusyhtiöt** → **Kaikki kuljetusyhtiöt** ja yhdistä uusi kuljetusyhtiö kuten minkä tahansa muun. Valitse sitten sen kuljetuspalvelut sivun [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services) mukaan.

## Viestit

| Mitä näet | Mitä tehdä |
| - | - |
| ”Pyynnön lähettäminen epäonnistui. Yritä uudelleen.” | Pyyntöä ei lähetetty. Yritä uudelleen hetken kuluttua. |
| ”Liian monta yritystä lyhyessä ajassa. Odota hetki ja yritä uudelleen.” | Lähetit monta pyyntöä lyhyessä ajassa. Odota hetki ja yritä uudelleen. |
| ”Tämän kuljetusyhtiöpyynnön käsittely on jo käynnissä. Odota, että se valmistuu.” | Zippendo työstää jo pyyntöä. Odota, että tila muuttuu. |
| ”Tämän kuljetusyhtiöpyynnön käsittelyä ei voitu aloittaa. Yritä hetken kuluttua uudelleen.” | Rakennusta ei voitu aloittaa. Yritä hetken kuluttua uudelleen. Jos se epäonnistuu jatkuvasti, ota yhteyttä Zippendon tukeen. |

## Liittyvää

* [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials)
* [Tuetut kuljetusyhtiöt](/docs/fi/carriers/supported-carriers)
* [Testitila](/docs/fi/how-to/sandbox-mode)
* [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


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