> ## 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 (Legacy API)
> Yhdistä vanhentunut Instabox (Legacy API) -kuljetusyhtiö Client ID:llä, Client secretillä ja Customer numberilla sekä miksi uusien käyttöönottojen pitäisi käyttää Instaboxia.
**Instabox (vanha API)** on vanhempi tapa yhdistää Instabox. Se on merkitty **Vanhentunut** **Kaikki kuljetusyhtiöt** -välilehdellä. Vie osoitin merkin päälle nähdäksesi tekstin: ”Erillinen Instabox-API on poistumassa käytöstä. Siirry Instabeen varaan rakennettuun Instabox-integraatioon.”
Käytä sitä vain, jos sinulla on edelleen kuljetusyhtiön tunnukset vanhempaan Instabox-järjestelmään (client ID ja secret). Uudessa käyttöönotossa käytä sen sijaan sivua [Yhdistä Instabox](/docs/fi/how-to/connect-instabox). Kentät, jotka ovat yhteisiä kaikille kuljetusyhtiöille, ovat sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials).
Olemassa olevat yhteydet toimivat edelleen: voit yhä yhdistää tämän kuljetusyhtiön ja lähettää sillä lähetyksiä. Uusien käyttöönottojen pitäisi käyttää **Instaboxia**.
Et valitse lähettäjän osoitetta tässä lomakkeessa. Lisää osoitteesi organisaatiovalikon → **Hallitse** → **Osoitteet** kautta. Valitset lähettäjän osoitteen jokaisella lähetyksellä tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields).
## Ennen kuin aloitat
Tarvitset Instaboxilta kolme tietoa vanhempaa järjestelmää varten:
* **Client ID**
* **Client secret**
* **Asiakasnumero**, eli etuliite, jonka Instabox lisää pakettinumeroihisi (esimerkiksi `PA02`)
Nämä eivät ole samat kuin yksittäinen **API-avain**, jota käytetään sivulla [Yhdistä Instabox](/docs/fi/how-to/connect-instabox). **Lue lisää** kortissa avaa sivuston [instabee.com](https://instabee.com).
## Yhdistä Instabox (Legacy API)
Napsauta sivupalkissa **Kuljetusyhtiöt** ja avaa sitten **Kaikki kuljetusyhtiöt** -välilehti.
Etsi kortti nimeltä **Instabox (vanha API)**, jossa on keltainen **Vanhentunut**-merkki. Se on eri kortti kuin **Instabox**. Napsauta **Yhdistä**.
**Yhdistä kuljetusyhtiö** -ikkuna aukeaa. Kirjoita **Kuljetusyhtiön nimi** ja sitten **Client ID**, **Client secret** ja **Asiakasnumero**. **Testitila** on kohdassa **Valinnaiset kentät**.
Napsauta **Yhdistä**. Näet viestin ”Kuljetusyhtiö yhdistetty”, ja kuljetusyhtiö ilmestyy **Omat kuljetusyhtiöt** -välilehdelle.
## Lomakkeen kentät
| Kenttä | Pakollinen | Mitä annetaan |
| - | - | - |
| **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet kohdassa **Omat kuljetusyhtiöt** ja kun valitset kuljetusyhtiön lähetykselle. Se on aluksi **Instabox (vanha API)**. |
| **Brändi** | Ei | Näkyy vain, jos organisaatiollasi on [brändejä](/docs/fi/how-to/create-a-brand). Lomake kertoo: ”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ä. |
| **Client ID** | Kyllä | Client ID Instaboxilta. Lomake kertoo: ”Instaboxin OAuth client id”. |
| **Client secret** | Kyllä | Client ID:täsi vastaava secret. Se piilotetaan kirjoittaessasi. Lomake kertoo: ”Instaboxin OAuth client secret”. |
| **Asiakasnumero** | Kyllä | Lomake kertoo: ”Instabox-asiakasnumerosi, jota käytetään pakettitunnuksen etuliitteenä (esim. PA02)”. |
| **Testitila** | Ei | Valintaruutu, oletuksena pois päältä. Lomake kertoo: ”Käytä Instaboxin testiympäristöä”. |
**Yhdistä** ei tee mitään, ennen kuin kentillä **Kuljetusyhtiön nimi**, **Client ID**, **Client secret** ja **Asiakasnumero** on kaikilla arvo.
### Testi vai tuotanto
Tässä vanhemmassa yhteydessä Instabox päättää testijärjestelmän ja oikeiden lähetysten välillä antamiesi tunnusten perusteella, ei **Testitila**-valintaruudun perusteella. Instaboxin testitunnukset luovat testilähetyksiä. Tuotantotunnukset luovat oikeita lähetyksiä, vaikka **Testitila** olisi päällä. Jos haluat kokeilla, pyydä Instaboxilta testitunnukset ja ota **Testitila** käyttöön niitä käyttäessäsi. Katso [Testitila](/docs/fi/how-to/sandbox-mode).
## Yhdistämisen jälkeen
Kuljetusyhtiö ilmestyy kohtaan **Omat kuljetusyhtiöt** **Yhdistetty**-merkin kanssa. Kun valitset sen lähetykselle, siinä näkyy myös **Vanhentunut**-merkki. 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ähetyksen tyyppi | Toimitetaanko noutopisteeseen? |
| - | - | - |
| **Toimitus pakettiautomaattiin** | Lähtevä | Kyllä, Instaboxin pakettiautomaattiin |
| **Kotiinkuljetus** | Lähtevä | Ei |
| **Palautus pakettiautomaatin kautta** | Saapuva (palautus) | Ei. Asiakkaasi jättää paketin mihin tahansa Instaboxin automaattiin. Ota käyttöön lisäpalvelu **Palautus ilman osoitekorttia**, jos asiakkaan ei pitäisi tulostaa osoitekorttia. |
Kuljetuspalveluja käytetään yleensä Ruotsin, Norjan, Tanskan, Suomen ja Alankomaiden sisällä ja välillä, 0,1-20 kg. Voit valita muita maita toimitussäännössä. Instabox hyväksyy tai hylkää lähetyksen, kun lähetät sen.
* **Toimitus pakettiautomaattiin** tarvitsee noutopisteen (tässä pakettiautomaatin) ennen lähettämistä. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point).
* Instabox lähettää seurantapäivitykset Zippendoon itse. Mitään ei tarvitse määrittää. Katso [Kuljetusyhtiöiden seurannan webhookit](/docs/fi/how-to/tracking-webhooks).
* Instabox ei luo tulliasiakirjoja. Jos toimitussäännössä on **Luo proformalasku** tai **Luo kauppalasku** käytössä, Zippendo luo kyseisen asiakirjan. Katso [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents).
* Tämä kuljetusyhtiö ei ole käytettävissä kohdassa **Noutotilaukset**.
## Muuta tai poista yhteys
Muuttaaksesi sitä avaa **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja napsauta kortissa **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**: **Client ID**, **Client secret**, **Asiakasnumero** ja **Testitila**.
Napsauta **Tallenna**. Näet viestin ”Kuljetusyhtiö päivitetty”.
Poistaaksesi sen napsauta samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoilla kirjaimilla ja napsauta **Poista**. Tätä kuljetusyhtiötä käyttävät toimitussäännöt poistetaan sen mukana. Jo lähettämiesi lähetysten osoitekortit ja seurantakoodit säilyvät.
Kun siirryt uuteen yhteyteen, yhdistä ensin **Instabox**, päivitä toimitussääntösi käyttämään sitä ja poista sitten tämä vanha yhteys.
## Yleisiä ongelmia
| Mitä näet | Mitä tehdä |
| - | - |
| ”Kuljetusyhtiön yhdistäminen epäonnistui. Yritä uudelleen.” | Tarkista, että kaikki pakolliset kentät on täytetty, ja yritä uudelleen. |
| ”Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.” | Pakettisi kuljetusyhtiöiden 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 **Client ID** ja **Client secret** kohdassa **Muokkaa kuljetusyhtiötä**. Instaboxin nykyinen **API-avain** ei toimi täällä. Käytä kyseiselle avaimelle sivua [Yhdistä Instabox](/docs/fi/how-to/connect-instabox). |
| ”Tämä kuljetuspalvelu toimittaa noutopisteeseen. Valitse noutopiste ennen lähettämistä.” | Valitse pakettiautomaatti **Toimitus pakettiautomaattiin** -palvelulle. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point). |
| ”Kuljetusyhtiö hylkäsi pyynnön. Katso kuljetusyhtiön ilmoittama syy, korjaa tiedot ja yritä uudelleen.” ja syynä on ”Instabox … is not available for …” lähettäessäsi | Instabox ei tarjoa tätä kuljetuspalvelua kyseiseen maahan ja postinumeroon. Tarkista osoite tai valitse toinen kuljetuspalvelu. |
## Liittyvää
* [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)
* [Pyydä kuljetusyhtiö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.