> ## 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ä Instabox

> Yhdistä Instabox Zippendossa Instabee-API-avaimellasi, valitse testi- tai tuotantotila Testitilalla ja lähetä Instaboxin pakettiautomaatteihin ja koteihin.

Yhdistä **Instabox**, jotta voit lähettää paketteja Instaboxin pakettiautomaatteihin ja asiakkaidesi koteihin Ruotsissa, Norjassa, Tanskassa ja Suomessa. Instabox kuuluu Instabeehen, ja Zippendo yhdistää siihen yhdellä Instabee-API-avaimella.

Käytä kohdassa **Kaikki kuljetusyhtiöt** korttia, jonka nimi on **Instabox**. Kortti nimeltä **Instabox (vanha API)** on vanhempi yhteys, joka poistuu käytöstä: katso [Yhdistä Instabox (vanha API)](/docs/fi/how-to/connect-instabox-legacy).

Tämä sivu koskee vain Instaboxia. Kaikille kuljetusyhtiöille yhteiset kentät ovat sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials). Läpikäynti: [Kuljetusyhtiöt](/docs/fi/tutorials/carriers).

## Mitä tarvitset Instaboxilta

* Instaboxin lähetyssopimus.
* **Instabee Integration API -avain** kyseiselle sopimukselle. Instabee antaa avaimen. Zippendo ei voi luoda sitä puolestasi.

## Yhdistä Instabox

<Steps>
  <Step title="Avaa Kaikki kuljetusyhtiöt">
    Napsauta sivupalkissa **Kuljetusyhtiöt** ja sitten **Kaikki kuljetusyhtiöt** -välilehteä.
  </Step>

  <Step title="Napsauta Instaboxin kohdalla Yhdistä">
    Etsi kortti nimeltä **Instabox**, ilman "vanha API" -tekstiä ja ilman **Vanhentunut**-merkkiä, ja napsauta **Yhdistä**. (**Lue lisää** avaa instabee.com-sivuston.)
  </Step>

  <Step title="Täytä lomake">
    **Yhdistä kuljetusyhtiö** -ikkuna avautuu. **Kuljetusyhtiön nimi** on jo täytetty nimellä "Instabox". Liitä avaimesi kenttään **API-avain**. **Testitila** on kohdassa **Valinnaiset kentät**.
  </Step>

  <Step title="Napsauta ikkunassa Yhdistä">
    Näet viestin **Kuljetusyhtiö yhdistetty**. Instabox näkyy nyt kohdassa **Omat kuljetusyhtiöt** merkittynä **Yhdistetty**.
  </Step>
</Steps>

<Frame caption="Instabox-kortti Kaikki kuljetusyhtiöt -näkymässä">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-instabox/01-all-carriers-card-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=05a0bc19b1abf9e103a28207bdea5961" alt="Kaikki kuljetusyhtiöt, jossa Instabox-kortti sekä sen Yhdistä- ja Lue lisää -painikkeet" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-instabox/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-instabox/01-all-carriers-card-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=43845575d3f36005f6b81d4933c09a56" alt="Kaikki kuljetusyhtiöt, jossa Instabox-kortti sekä sen Yhdistä- ja Lue lisää -painikkeet" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-instabox/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Yhdistä kuljetusyhtiö Instaboxille - API-avain ja Testitila">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-instabox/02-connect-modal-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=bab1a220645acf2f06b3a52be8de778f" alt="Yhdistä kuljetusyhtiö -ikkuna Instaboxille, jossa pakollinen API-avain ja valinnainen Testitila" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-instabox/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-instabox/02-connect-modal-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=ca476ec052ca1fcdd4ee05c36afb29cf" alt="Yhdistä kuljetusyhtiö -ikkuna Instaboxille, jossa pakollinen API-avain ja valinnainen Testitila" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-instabox/02-connect-modal-dark.png" />
</Frame>

## Mitä syötetään

| Kenttä | Pakollinen | Kuvaus lomakkeessa | Mitä syötetään |
| - | - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | | Nimi, jonka näet Zippendossa. Säilytä "Instabox" tai muuta se. |
| **Brändi** | Ei | **Vain tämä brändi voi käyttää tätä kuljetusyhtiötä.** | Näkyy vain, jos organisaatiossasi on [brändejä](/docs/fi/how-to/create-a-brand). |
| **API-avain** | Kyllä | Instabee Integration API -avaimesi (lähetetään muodossa 'Authorization: ApiKey \<key>') | Avain täsmälleen sellaisena kuin Instabee sen antoi. |
| **Testitila** | Ei | Käytä Instabeen testiympäristöä | Jätä pois päältä oikeita lähetyksiä varten. Katso alla. |

Tässä lomakkeessa ei ole asiakastunnusta, asiakassalaisuutta eikä asiakasnumeroa. Ne kuuluvat [Instaboxille (vanha API)](/docs/fi/how-to/connect-instabox-legacy).

## Testi vai tuotanto

Kun **Testitila** on päällä, Zippendo lähettää lähetyksesi Instabeen testijärjestelmään oikean sijaan. Käytät samaa **API-avain**-tunnusta. Laita se pois päältä ennen kuin lähetät oikeita tilauksia. Lisää sivulla [Testitila](/docs/fi/how-to/sandbox-mode).

## Yhdistämisen jälkeen

Valitset Instabox-kuljetuspalvelun, kun [luot lähetyksen](/docs/fi/how-to/send-a-shipment) tai [toimitussäännön](/docs/fi/how-to/shipping-rule-fields). Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services). Kukin paketti voi painaa 0,1-20 kg.

| Kuljetuspalvelu | Mihin sitä käytetään | Valitaanko pakettiautomaatti? |
| - | - | - |
| **Toimitus pakettiautomaattiin** | Lähetys Instaboxin pakettiautomaattiin | Kyllä |
| **Kotiinkuljetus** | Lähetys vastaanottajan kotiin. Instabox suunnittelee toimitusajan. | Ei |
| **Palautus pakettiautomaatin kautta** (palautuslähetys) | Asiakkaasi jättää palautuksen pakettiautomaattiin. Valinnainen lisäpalvelu: **Ilman osoitekorttia** | Kyllä |

Instaboxilla ei ole kotipalautuksen kuljetuspalvelua.

* **Pakettiautomaatit:** valitse **Toimitus pakettiautomaattiin** ja **Palautus pakettiautomaatin kautta** -palveluille pakettiautomaatti lähetyksen **Noutopiste**-osiossa ennen lähettämistä. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point).
* **Noutotilaukset:** Instabox ei ole käytettävissä kohdassa **Noutotilaukset**.
* **Seuranta:** seurantapäivitykset tulevat Instabeelta. Kuljetusyhtiöllä ei ole seuranta-asetusta. Katso [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks).
* **Tulli:** Instabox ei luo tulliasiakirjoja Zippendossa.

## Jos yhteys epäonnistuu

Zippendo tallentaa avaimesi tarkistamatta sitä. Virhe tulee esiin ensimmäisellä lähetyskerralla.

| Mitä näet | Mitä tehdä |
| - | - |
| Mitään ei tapahdu, kun napsautat **Yhdistä** | Täytä **Kuljetusyhtiön nimi** ja **API-avain**. |
| **Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.** | Pakettisi kuljetusyhtiöraja on täynnä. Vaihda pakettia tai poista kuljetusyhtiö, jota et enää käytä ([Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage)). |
| **Kuljetusyhtiö hylkäsi kirjautumistietosi. Päivitä kuljetusyhtiön tunnukset Kuljetusyhtiöt-sivulla.** | Liitä avain uudelleen ilman ylimääräisiä välilyöntejä. Jos kopioit sen vanhasta Instabox-määrityksestä, pyydä Instabeelta Instabee Integration API -avain. |
| **Tämä kuljetuspalvelu toimittaa noutopisteeseen. Valitse noutopiste ennen lähettämistä.** | Valitse lähetykselle pakettiautomaatti. |
| **Valittu kuljetuspalvelu ei kulje näiden maiden välillä. Valitse toinen kuljetuspalvelu.** | Instabox lähettää vain Ruotsin, Norjan, Tanskan ja Suomen sisällä. |
| **Yhteys kuljetusyhtiöön katkesi ennen kuin se vastasi. Zippendolla ei ole vahvistusta siitä, että lähetys luotiin, joten tarkista asia kuljetusyhtiöltä ennen kuin lähetät uudelleen.** | Tarkista Instaboxilta, onko lähetys olemassa, ennen kuin lähetät sen uudelleen. |

Lisää apua: [Kuljetusyhtiön todennuksen epäonnistumiset](/docs/fi/knowledge-base/carrier-authentication-failures).

## Yhteyden muuttaminen tai poistaminen

* **Muuta:** napsauta kohdassa **Omat kuljetusyhtiöt** **Muokkaa kuljetusyhtiötä**. Päivitä kentät kohdassa **Kuljetusyhtiön asetukset** ja napsauta **Tallenna**.
* **Poista:** napsauta samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoin kirjaimin (esimerkiksi `INSTABOX`) ja napsauta **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan myös. Jo lähettämäsi lähetykset säilyttävät osoitekorttinsa ja seurantakoodinsa.

## Aiheeseen liittyvää

* [Yhdistä kuljetusyhtiö tai integraatio](/docs/fi/how-to/connect-index)
* [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials)
* [Testitila](/docs/fi/how-to/sandbox-mode)
* [Yhdistä Instabox (vanha API)](/docs/fi/how-to/connect-instabox-legacy)
* [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services)
* [Pyydä kuljetusyhtiön integraatiota](/docs/fi/how-to/request-carrier-integration)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


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