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ä. 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 -käyttäjä, jolla on API Manager -rooli, jotta voit kirjautua Postin Developer Portaliin. 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ä.
Hanki Postin tunnukset
1
Kirjaudu Developer Portaliin
Avaa developer.posti.com ja kirjaudu OmaPosti Pro -käyttäjälläsi.
2
Lisää sovellustilin käyttäjä
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.3
Valitse molemmat API-roolit
Valitse shippingapi ja 2026-04. Ilman roolia 2026-04 voit lähettää lähetyksiä, mutta noutopistehaku ja palautukset ilman osoitekorttia eivät toimi.
4
Liitä logistiikkasopimuksen numero
Lisää logistiikkasopimuksen numero, jonka syötät Zippendoon, ja valitse sitten Save.
5
Kopioi Client ID ja Client secret
Portaali näyttää ne vain kerran. Kopioi molemmat. Jos kadotat secretin, luo portaalissa uudet tunnukset ja päivitä kuljetusyhtiö Zippendossa.
Yhdistä Posti
1
Avaa Kaikki kuljetusyhtiöt
Valitse sivupalkista Kuljetusyhtiöt ja avaa sitten Kaikki kuljetusyhtiöt -välilehti.
2
Etsi Posti
Valitse Posti-kortilla Yhdistä.
3
Täytä lomake
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.
4
Yhdistä kuljetusyhtiö
Valitse Yhdistä. Näet viestin “Kuljetusyhtiö yhdistetty”, ja kuljetusyhtiö näkyy Omat kuljetusyhtiöt -välilehdellä.
Posti-kortti Kaikki kuljetusyhtiöt -välilehdellä
Yhdistä kuljetusyhtiö -ikkuna Postille - täytä Client ID, Client secret ja Logistiikkasopimuksen numero
Lomakkeen kentät
Client secret ja Seuranta-API:n salasana piilottavat kirjoittamasi tekstin.
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.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. Kuljetuspalvelu, joka ei kuulu Posti-sopimukseesi, hylätään lähettäessä Postin ilmoittamalla syyllä.
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.
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 ja Noutopisteet.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. Kun vastaanottajalla on EORI-numero, syötä se vastaanottajan kenttään Vastaanottajan EORI-numero. Katso Tulli ja asiakirjat.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, 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.
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.
Yleisiä ongelmia
Lisää apua: Kuljetusyhtiön todennuksen epäonnistumiset.