> ## 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ä Posti > Yhdistä Posti Zippendossa Client ID:lläsi, Client secretillä ja Logistiikkasopimuksen numerolla sekä valinnaisilla Seuranta-API:n käyttäjätunnuksella ja Seuranta-API:n salasanalla. **Posti** lähettää paketteja Suomesta: Postin pakettiautomaatteihin ja noutopisteisiin, kotiinkuljetuksena, seuraavan päivän Express-toimituksena, pienpaketteina ovelle, asiakkaiden palautuksina sekä Priority- ja EMS-paketteina maailmanlaajuisesti. Kaikille kuljetusyhtiöille yhteiset kentät on kuvattu sivulla [Kuljetusyhtiön tunnukset](/docs/fi/how-to/carrier-credentials). Tällä lomakkeella ei valita lähettäjän osoitetta. Lisää osoitteesi organisaatiovalikon kohdassa **Hallitse** → **Osoitteet**. Valitset lähettäjän osoitteen jokaisella lähetyksellä tai [toimitussäännössä](/docs/fi/how-to/shipping-rule-fields). Posti lähettää osoitteesta Suomessa tai Ahvenanmaalla, ja palautukset palaavat osoitteeseen Suomessa. ## Ennen kuin aloitat * Postin yritysasiakastili, jolla on **logistiikkasopimuksen numero**, yleensä kuusi numeroa. * [OmaPosti Pro](https://pro.posti.fi/) -käyttäjä, jolla on **API Manager** -rooli, jotta voit kirjautua [Postin Developer Portaliin](https://developer.posti.com/). Jos sinulla ei ole roolia, pyydä organisaatiosi OmaPosti Pron pääkäyttäjää avaamaan **Users management → Users**, valitsemaan käyttäjäsi kohdalla **Edit** ja rastimaan **API Manager** kohdassa **Other services**. * Sovellustili Developer Portalissa **Client ID**:tä ja **Client secretiä** varten. Vaiheet ovat alla. * Valinnainen, seurantaa varten: **Tracking API** -palvelutili Postin asiakaspalvelusta. Voit lähettää lähetyksiä ilman sitä. Voit yhdistää Postin useammin kuin kerran, esimerkiksi yhden yhteyden logistiikkasopimusta kohden. Anna jokaiselle oma **Kuljetusyhtiön nimi**. Kortin **Lue lisää** avaa Postin sivun sen verkkokaupan palveluista. ## Hanki Postin tunnukset Avaa [developer.posti.com](https://developer.posti.com/) ja kirjaudu OmaPosti Pro -käyttäjälläsi. Avaa **Configure application accounts → Application account list** ja valitse **Add new application account user**. Kytke **Enabled** päälle ja anna käyttäjälle nimi, esimerkiksi `Zippendo`. Valitse **shippingapi** ja **2026-04**. Ilman roolia **2026-04** voit lähettää lähetyksiä, mutta noutopistehaku ja palautukset ilman osoitekorttia eivät toimi. Lisää logistiikkasopimuksen numero, jonka syötät Zippendoon, ja valitse sitten **Save**. Portaali näyttää ne vain kerran. Kopioi molemmat. Jos kadotat secretin, luo portaalissa uudet tunnukset ja päivitä kuljetusyhtiö Zippendossa. Seurantaa varten pyydä Postin asiakaspalvelulta **Tracking API** -palvelutili sopimuksellesi. Posti lähettää sinulle käyttäjätunnuksen ja salasanan. ## Yhdistä Posti Valitse sivupalkista **Kuljetusyhtiöt** ja avaa sitten **Kaikki kuljetusyhtiöt** -välilehti. Valitse **Posti**-kortilla **Yhdistä**. **Yhdistä kuljetusyhtiö** -ikkuna avautuu. **Kuljetusyhtiön nimi** on valmiiksi täytetty arvolla "Posti". Syötä **Client ID**, **Client secret** ja **Logistiikkasopimuksen numero**. **Seuranta-API:n käyttäjätunnus** ja **Seuranta-API:n salasana** ovat kohdassa **Valinnaiset kentät**. Valitse **Yhdistä**. Näet viestin "Kuljetusyhtiö yhdistetty", ja kuljetusyhtiö näkyy **Omat kuljetusyhtiöt** -välilehdellä. Kaikki kuljetusyhtiöt, jossa Posti-kortti ja sen Yhdistä- ja Lue lisää -painikkeet Kaikki kuljetusyhtiöt, jossa Posti-kortti ja sen Yhdistä- ja Lue lisää -painikkeet Yhdistä kuljetusyhtiö -ikkuna Postille, jossa pakolliset kentät Client ID, Client secret ja Logistiikkasopimuksen numero sekä valinnaiset seurantakentät Yhdistä kuljetusyhtiö -ikkuna Postille, jossa pakolliset kentät Client ID, Client secret ja Logistiikkasopimuksen numero sekä valinnaiset seurantakentät ## Lomakkeen kentät **Client secret** ja **Seuranta-API:n salasana** piilottavat kirjoittamasi tekstin. | Kenttä | Pakollinen | Mitä syötetään | | - | - | - | | **Kuljetusyhtiön nimi** | Kyllä | Nimi, jonka näet **Omat kuljetusyhtiöt** -välilehdellä ja kun valitset kuljetusyhtiön lähetykselle. Oletuksena **Posti**. | | **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 kaikkien brändien voivan käyttää sitä. | | **Client ID** | Kyllä | Lomakkeessa lukee: "Postin Developer Portalista (developer.posti.com): Zippendoa varten lisäämäsi sovellustilin käyttäjän Client ID. Valitse molemmat API-roolit, shippingapi ja 2026-04." | | **Client secret** | Kyllä | Lomakkeessa lukee: "Client secret, jonka Developer Portal näyttää kerran yhdessä Client ID:n kanssa." | | **Logistiikkasopimuksen numero** | Kyllä | Vain numeroita. Lomakkeessa lukee: "Postin logistiikkasopimuksesi numero, yleensä kuusinumeroinen ja alkaa numerolla 6. Lisää se samalle sovellustilin käyttäjälle Developer Portalissa, muuten Posti hylkää lähetyksesi." | | **Seuranta-API:n käyttäjätunnus** | Ei | Täytä molemmat seurantakentät tai ei kumpaakaan. Lomakkeessa lukee: "Seuranta-API:n käyttäjätunnus, jonka Postin asiakaspalvelu antaa sinulle sopimustasi varten. Tarvitaan vain lähetystesi seurantaan." | | **Seuranta-API:n salasana** | Ei | Lomakkeessa lukee: "Salasana, jonka Posti lähettää seuranta-API:n käyttäjätunnuksen kanssa. Posti lukitsee tilin tunniksi viiden epäonnistuneen kirjautumisyrityksen jälkeen." | **Yhdistä** ei tee mitään, ennen kuin kentissä **Kuljetusyhtiön nimi**, **Client ID**, **Client secret** ja **Logistiikkasopimuksen numero** on arvo. ## Testaa yhteys Postilla ei ole testijärjestelmää, joten **Testitila**-valintaruutua ei ole. Jokainen lähettämäsi lähetys on oikea Postin lähetys logistiikkasopimuksellasi. Postin mukaan lähetystä ei laskuteta, ellei sitä fyysisesti lähetetä, joten testiosoitekortti, jota et luovuta Postille, ei maksa mitään. Kokeillaksesi yhteyttä lähetä yksi lähetys omaan osoitteeseesi ja tarkista sen osoitekortti. Posti lähettää vastaanottajalle ilmoituksen, joten käytä testilähetyksessä omaa sähköpostiosoitettasi ja puhelinnumeroasi. Zippendo ei voi perua Postin lähetystä, joten ota yhteyttä Postiin, jos haluat lähetyksen peruttavan. Katso [Testitila](/docs/fi/how-to/sandbox-mode). ## Yhdistämisen jälkeen Kuljetusyhtiö näkyy **Omat kuljetusyhtiöt** -välilehdellä merkinnällä **Yhdistetty**. Valitset kuljetuspalvelun jokaisella lähetyksellä tai toimitussäännössä, et tällä lomakkeella. Katso [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services). Kuljetuspalvelu, joka ei kuulu Posti-sopimukseesi, hylätään lähettäessä Postin ilmoittamalla syyllä. | Kuljetuspalvelu | Toimitus | Enimmäispaino | | - | - | - | | **Postipaketti** | Postin pakettiautomaattiin tai noutopisteeseen Suomessa, Ahvenanmaalla, Virossa, Latviassa tai Liettuassa. | 25 kg | | **Kotipaketti** | Vastaanottajan ovelle Postin hänen kanssaan sopimana aikana. Suomi, Ahvenanmaa ja Baltia. | 25 kg, 35 kg tilaa vievänä | | **Express-paketti** | Seuraavan päivän toimitus allekirjoitusta vastaan. Suomi, Ahvenanmaa ja Baltia. | 25 kg, 35 kg tilaa vievänä | | **Pikkupaketti ovelle** | Vastaanottajan postilaatikkoon tai ovelle Suomessa ja Ahvenanmaalla, enintään 38 x 38 x 28 cm. | 4 kg | | **Palautus** (palautuslähetys) | Asiakkaasi jättää paketin mihin tahansa Postin noutopisteeseen tai pakettiautomaattiin, ja se toimitetaan osoitteeseesi Suomessa. | 25 kg, 35 kg tilaa vievänä | | **Priority Parcel** | Yli 200 maahan, maasta riippuen ovelle tai noutopisteeseen. | 25 kg, 30 kg tilaa vievänä | | **EMS** | Yli 200 maahan, ovelle allekirjoitusta vastaan. | 25 kg, 30 kg tilaa vievänä | Jokainen kuljetuspalvelu paitsi **Palautus** tarvitsee vastaanottajan puhelinnumeron Postin ilmoituksia varten. **Kotipaketti** ja **Express-paketti** voivat sisältää useita paketteja yhdessä lähetyksessä. Muissa kuljetuspalveluissa on yksi paketti lähetystä kohden. ### Lisäpalvelut ja lisätiedot Jokaisella kuljetuspalvelulla on kaksi valintaa kohdassa **Lisätiedot kuljetusyhtiölle**: * **Osoitekortin muoto**: PDF (oletus) tai ZPL lämpötulostimille. * **Toimitusohjeet**: enintään 120 merkkiä, jotka tulostetaan osoitekorttiin, esimerkiksi ovikoodi. Osoitekortit ovat kooltaan 10 x 15 cm. Kansainväliset kuljetuspalvelut, joilla ei ole tämän kokoista osoitekorttia, tulostuvat A5-sivulle. Valitset lisäpalvelut lähetyksellä tai toimitussäännössä. Jokainen kuljetuspalvelu näyttää lisäpalvelut, joita Posti tarjoaa sille: **Saapumisilmoitus tekstiviestillä tai sähköpostilla**, **Ennakkoilmoitus ennen toimitusta**, **Särkyvä**, **Tilaa vievä (ylikokoinen paketti)**, **Ei ulkona olevaan pakettiautomaattiin**, **Lauantaitoimitus**, **Henkilökohtainen luovutus (henkilöllisyyden tarkistus)**, **Kirjattu (luovutus allekirjoitusta vastaan)**, **Toimitus ilman allekirjoitusta**, **Toimitusajasta sovitaan puhelimitse**, **Soitto ennen toimitusta**, **Fossiiliton kuljetus (kohdennettu osuus)** ja vain **Palautus**-palvelussa **Palautus ilman osoitekorttia (lähetyskoodi)**. Valitse **Tilaa vievä (ylikokoinen paketti)** yli 25 kg:n paketille tai paketille, joka on suurempi kuin kuljetuspalvelun vakiokoko. ### Postipaketti-noutopisteet **Postipaketti** toimittaa noutopisteeseen. Valitse noutopiste lähetyksen **Noutopiste**-osiossa ennen lähettämistä. Haku tarvitsee sovellustililläsi roolin **2026-04**. Katso [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point) ja [Noutopisteet](/docs/fi/how-to/drop-point-and-service-points). ### Palautukset **Palautus** tuo paketin asiakkaaltasi osoitteeseesi. Se ei tarvitse noutopistettä, ja Posti-sopimukseesi on sisällyttävä asiakaspalautukset. Lisäpalvelulla **Palautus ilman osoitekorttia (lähetyskoodi)** asiakkaasi kirjoittaa pakettiin koodin osoitekortin tulostamisen sijaan. Lähetys näyttää koodin nimellä **Koodi ilman osoitekorttia** kohdassa **Seurantatiedot**. Lähetä se asiakkaallesi. Jos Posti luo palautuksen ilman koodia, lähetys näyttää varoituksen. Lähetä silloin asiakkaallesi osoitekortti. ### Tulli EU:n ulkopuolisiin maihin sekä Ahvenanmaalle, Kanariansaarille, Ceutaan tai Melillaan tai niistä lähtevät lähetykset sisältävät tullitiedot tilausriveiltä: kuvaus, tullinimike (HS-koodi), määrä, arvo ja alkuperämaa. Posti palauttaa tulli-ilmoituksen ja kauppalaskun osoitekortin mukana, ja ne näkyvät lähetyksen asiakirjoissa. Lisää EORI-numerosi kohdassa [Organisaation asetukset](/docs/fi/how-to/organization-settings). Kun vastaanottajalla on EORI-numero, syötä se vastaanottajan kenttään **Vastaanottajan EORI-numero**. Katso [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents). ### Noutotilaukset ja seuranta * Posti ei ole käytettävissä kohdassa **Noutotilaukset**. Sovi noudot suoraan Postin kanssa. Postin lähetykselle ei voi asettaa noutoaikaa. Katso sivulta [Tilaa nouto](/docs/fi/how-to/schedule-a-pickup), mitkä kuljetusyhtiöt ovat käytettävissä. * Kun **Seuranta-API:n käyttäjätunnus** ja **Seuranta-API:n salasana** on täytetty, Zippendo hakee seurantapäivitykset Postilta noin tunnin välein. Ilman niitä seurantatapahtumia ei näy. Jokaisella lähetyksellä on silti seurantakoodi ja **Seurantalinkki** posti.fi-sivustolle. Jos seurannan kirjautumistiedot ovat väärät, korjaa ne kohdassa **Muokkaa kuljetusyhtiötä** ja valitse **Tallenna**. Katso [Kuljetusyhtiöiden seurantawebhookit](/docs/fi/how-to/tracking-webhooks). ## Muuta tai poista yhteys Muuttaaksesi yhteyttä avaa **Kuljetusyhtiöt** → **Omat kuljetusyhtiöt** ja valitse kortilla **Muokkaa kuljetusyhtiötä**. **Muokkaa kuljetusyhtiötä** -sivulla on kaksi osiota: * **Yleiset**: **Kuljetusyhtiön nimi** ja **Brändi**, jos organisaatiossasi on brändejä. * **Kuljetusyhtiön asetukset**: **Client ID**, **Client secret**, **Logistiikkasopimuksen numero**, **Seuranta-API:n käyttäjätunnus** ja **Seuranta-API:n salasana**. Valitse **Tallenna**. Näet viestin "Kuljetusyhtiö päivitetty". Poistaaksesi yhteyden valitse samalla sivulla **Poista**, kirjoita kuljetusyhtiön nimi isoilla kirjaimilla ja valitse **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 pakolliset kentät ja yritä sitten uudelleen. | | "Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä." | Pakettisi kuljetusyhtiöiden enimmäismäärä 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ä | **Client ID** tai **Client secret** on väärin, tai sovellustilillä ei ole molempia API-rooleja. Korjaa se Developer Portalissa tai kohdassa **Muokkaa kuljetusyhtiötä**. | | "Kuljetusyhtiön asetukset ovat puutteelliset tai virheelliset. Tarkista ne Kuljetusyhtiöt-sivulla." | **Logistiikkasopimuksen numero** sisältää muutakin kuin numeroita. Korjaa se kohdassa **Muokkaa kuljetusyhtiötä**. | | "Posti ei pystynyt luomaan lähetystä." | Posti hylkäsi lähetyksen, esimerkiksi koska logistiikkasopimuksen numeroa ei ole liitetty sovellustiliin. Lähetys näyttää Postin ilmoittaman syyn. Korjaa se ja lähetä uudelleen. | | "Osa tämän kuljetuspalvelun valinnoista puuttuu tai on virheellisiä. Tarkista lähetyksen lisäpalvelut ja valinnat ja yritä sitten uudelleen." | Vastaanottajan puhelinnumero puuttuu, lähetyksessä on liian monta pakettia kuljetuspalvelulle, paketti on liian painava tai suuri, tai Posti ei tarjoa valittua lisäpalvelua kyseiseen kohteeseen. Lähetys näyttää, mikä on vialla. | | "Tämä kuljetuspalvelu toimittaa noutopisteeseen. Valitse noutopiste ennen lähettämistä." | Valitse lähetykselle noutopiste **Postipaketti**-palvelua varten. | | "Valittu kuljetuspalvelu ei kulje näiden maiden välillä. Valitse toinen kuljetuspalvelu." | Valitse Postin kuljetuspalvelu, joka kattaa vastaanottajan maan. | | "Tulli-ilmoitus on puutteellinen. Jokaisella tuotteella on oltava kuvaus, määrä ja nollaa suurempi ilmoitettu arvo." | Tilausriviltä puuttuu kuvaus, tullinimike, määrä tai arvo. Täytä se ja lähetä uudelleen. | | "Kuljetusyhtiö hyväksyi lähetyksen, mutta ei palauttanut osoitekorttia eikä QR-koodia, eikä Zippendo voi pyytää sitä uudelleen. Pyydä sitä kuljetusyhtiöltä äläkä lähetä lähetystä uudelleen." | Pyydä osoitekortti Postilta. Älä lähetä lähetystä uudelleen. | | "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 Postilta, onko lähetys olemassa, ennen kuin lähetät sen uudelleen. | | Seurantatapahtumia ei näy | Tarkista, että molemmat seurantakentät on täytetty oikein. | | "Emme saa juuri nyt yhteyttä kuljetusyhtiöihin. Yritä hetken kuluttua uudelleen." tai "Kuljetusyhtiö hylkäsi pyynnön. Katso kuljetusyhtiön ilmoittama syy, korjaa tiedot ja yritä uudelleen." | Odota hetki ja lähetä uudelleen, tai korjaa se, minkä Postin ilmoittama syy mainitsee. | Lisää apua: [Kuljetusyhtiön todennuksen epäonnistumiset](/docs/fi/knowledge-base/carrier-authentication-failures). ## 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) * [Kuljetuspalvelut ja lisäpalvelut](/docs/fi/how-to/carrier-products-and-services) * [Valitse noutopiste](/docs/fi/how-to/pick-a-service-point) * [Tulli ja asiakirjat](/docs/fi/how-to/customs-and-documents) * [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.