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

> Yhdistä Porterbuddy kohdassa Kuljetusyhtiöt Instabee-API-avaimellasi ja käytä Testitila-valintaruutua kokeillaksesi Instabeen testijärjestelmää.

**Porterbuddy** toimittaa paketteja asiakkaidesi koteihin Norjassa, Ruotsissa ja Tanskassa. Se kuuluu Instabeehen, samaan konserniin kuin Instabox ja Budbee. Porterbuddylla ei ole pakettiautomaatteja. Kaikille kuljetusyhtiöille yhteiset kentät ovat sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials).

<Info>
  Tässä lomakkeessa et valitse lähettäjän osoitetta. Lisää osoitteesi organisaatiovalikon kautta → **Hallitse** → **Osoitteet**. Valitset lähettäjän osoitteen jokaisella lähetyksellä tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields).
</Info>

## Ennen kuin aloitat

* Tarvitset Instabeelta **API-avain**-tunnuksen Porterbuddy-sopimuksellesi. Zippendo ei voi luoda tätä avainta puolestasi.
* **Lue lisää** kortilla avaa sivuston [porterbuddy.com](https://porterbuddy.com). Se on Porterbuddyn julkinen verkkosivusto, ei paikka avaimen hakemiseen.
* Budbee käyttää samanlaista avainta. Katso [Yhdistä Budbee](/docs/fi/how-to/connect-budbee).

Voit yhdistää Porterbuddyn useammin kuin kerran. Anna jokaiselle yhteydelle oma **Kuljetusyhtiön nimi**.

## Yhdistä Porterbuddy

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

  <Step title="Etsi Porterbuddy">
    Napsauta **Porterbuddy**-kortilla **Yhdistä**.
  </Step>

  <Step title="Täytä lomake">
    **Yhdistä kuljetusyhtiö** -ikkuna avautuu. Kirjoita **Kuljetusyhtiön nimi** ja **API-avain**. **Testitila** on kohdassa **Valinnaiset kentät**.
  </Step>

  <Step title="Yhdistä kuljetusyhtiö">
    Napsauta **Yhdistä**. Näet viestin "Kuljetusyhtiö yhdistetty", ja kuljetusyhtiö ilmestyy **Omat kuljetusyhtiöt** -välilehdelle.
  </Step>
</Steps>

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

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

<Frame caption="Kirjoita API-avaimesi. Testitila on valinnainen.">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/connect-porterbuddy/02-connect-modal-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=53c66704d642aae258bf9cc685ada1b8" alt="Yhdistä kuljetusyhtiö -ikkuna Porterbuddylle, jossa API-avain-kenttä ja Testitila-valintaruutu" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-porterbuddy/02-connect-modal-light.png" />

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

## Lomakkeen kentät

| Kenttä | Pakollinen | Mitä syötetään |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet kohdassa **Omat kuljetusyhtiöt** ja kun valitset kuljetusyhtiön lähetykselle. Se on aluksi **Porterbuddy**. |
| **Brändi** | Ei | Näkyy vain, jos organisaatiossasi on [brändejä](/docs/fi/how-to/create-a-brand). Lomakkeessa lukee: "Vain tämä brändi voi käyttää tätä kuljetusyhtiötä." Jätä tyhjäksi, jos haluat jokaisen brändin voivan käyttää sitä. |
| **API-avain** | Kyllä | Instabeen antama avain. Lomakkeessa lukee: "Instabee Integration API -avaimesi (lähetetään muodossa 'Authorization: ApiKey \<key>')". Liitä vain itse avain. |
| **Testitila** | Ei | Valintaruutu, oletuksena pois päältä. Lomakkeessa lukee: "Käytä Instabeen testiympäristöä". |

**Yhdistä** ei tee mitään, ennen kuin **Kuljetusyhtiön nimi** ja **API-avain** on täytetty.

**Testitila** lähettää lähetyksesi Instabeen testijärjestelmään, joten oikeita lähetyksiä ei luoda. Testijärjestelmä tarvitsee Instabeelta testiavaimen: tuotantoavain ei toimi siellä, eikä testiavain toimi oikeille lähetyksille. Jätä **Testitila** pois päältä oikeita lähetyksiä varten. Katso [Testitila](/docs/fi/how-to/sandbox-mode).

## Yhdistämisen jälkeen

Kuljetusyhtiö ilmestyy kohtaan **Omat kuljetusyhtiöt** **Yhdistetty**-merkillä. Valitset kuljetuspalvelun jokaisella lähetyksellä tai toimitussäännössä, et tässä lomakkeessa. Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services).

| Kuljetuspalvelu | Lähetystyyppi | Mitä se tekee |
| - | - | - |
| **Kotiinkuljetus** | Lähtevä | Toimittaa vastaanottajan kotiosoitteeseen. |
| **Palautus kotoa** | Saapuva (palautus) | Porterbuddy noutaa palautuksen asiakkaasi kotoa. |

Molemmat kuljetuspalvelut kuljettavat Norjan, Ruotsin ja Tanskan sisällä ja niiden välillä, 0,1-20 kg. Porterbuddy ei koskaan toimita noutopisteeseen, joten et valitse sellaista.

* Porterbuddy ei ole käytettävissä kohdassa **Noutotilaukset**. Katso [Tilaa nouto](/docs/fi/how-to/schedule-a-pickup) kuljetusyhtiöistä, jotka ovat.
* Instabee lähettää seurantapäivitykset Zippendoon itse. Mitään ei tarvitse määrittää. Katso [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks).
* Porterbuddy ei luo tulliasiakirjoja. Jos toimitussäännössä on **Luo proformalasku** tai **Luo kauppalasku** päällä, Zippendo luo kyseisen asiakirjan. Katso [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents).

## Yhteyden muuttaminen tai poistaminen

Muuttaaksesi sitä avaa **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja napsauta kortilla **Muokkaa kuljetusyhtiötä**. **Muokkaa kuljetusyhtiötä** -sivulla on kaksi osiota:

* **Yleiset**: **Kuljetusyhtiön nimi** ja **Brändi**, jos organisaatiollasi on brändejä.
* **Kuljetusyhtiön asetukset**: **API-avain** ja **Testitila**.

Napsauta **Tallenna**. Näet viestin "Kuljetusyhtiö päivitetty".

Poistaaksesi sen napsauta samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoin kirjaimin ja napsauta **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan sen mukana. Jo lähettämäsi lähetykset säilyttävät osoitekorttinsa ja seurantakoodinsa.

## Yleisiä ongelmia

| Mitä näet | Mitä tehdä |
| - | - |
| "Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen." | Tarkista, että **Kuljetusyhtiön nimi** ja **API-avain** on täytetty, ja yritä sitten uudelleen. |
| "Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä." | Pakettisi kuljetusyhtiöraja on täynnä. Katso [Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage). |
| "Kuljetusyhtiö hylkäsi kirjautumistietosi. Päivitä kuljetusyhtiön tunnukset Kuljetusyhtiöt-sivulla." lähettäessäsi | Tarkista **API-avain** kohdassa **Muokkaa kuljetusyhtiötä** ja varmista, että **Testitila** vastaa avaimen tyyppiä (testi vai tuotanto). Katso [Kuljetusyhtiön todennuksen epäonnistumiset](/docs/fi/knowledge-base/carrier-authentication-failures). |
| "Valittu kuljetuspalvelu ei kulje näiden maiden välillä. Valitse toinen kuljetuspalvelu." | Lähettäjä tai vastaanottaja on Norjan, Ruotsin ja Tanskan ulkopuolella. Valitse toinen kuljetusyhtiö. |
| "Kuljetusyhtiö ei vastannut. Yritä hetken kuluttua uudelleen." | Instabee ei vastannut ajoissa. Odota hetki ja lähetä uudelleen. |

## Aiheeseen liittyvää

* [Yhdistä Budbee](/docs/fi/how-to/connect-budbee)
* [Yhdistä Instabox](/docs/fi/how-to/connect-instabox)
* [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)
* [Kuljetusyhtiöt](/docs/fi/tutorials/carriers)


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