Du velger ikke en avsenderadresse i dette skjemaet. Legg til adressene dine under organisasjonsmenyen → Administrer → Adresser. Du velger avsenderadressen på hver sending eller i en fraktregel. Posti sender fra en adresse i Finland eller på Åland, og returer kommer tilbake til en adresse i Finland.
Før du begynner
- En bedriftskundekonto hos Posti med et logistikkavtalenummer, vanligvis seks sifre.
- En bruker i OmaPosti Pro med rollen API Manager, for å logge inn i Posti Developer Portal. Hvis du ikke har rollen, ber du hovedbrukeren av OmaPosti Pro i organisasjonen din om å åpne Users management → Users, klikke på Edit på brukeren din og krysse av for API Manager under Other services.
- En applikasjonskonto i utviklerportalen, for Klient-ID og Klienthemmelighet. Fremgangsmåten står nedenfor.
- Valgfritt, for sporing: en tjenestekonto for Tracking API fra kundeservice hos Posti. Du kan sende sendinger uten den.
Hent legitimasjonen din fra Posti
1
Logg inn i utviklerportalen
Åpne developer.posti.com og logg inn med brukeren din for OmaPosti Pro.
2
Legg til en applikasjonskontobruker
Åpne Configure application accounts → Application account list og klikk på Add new application account user. Slå på Enabled og gi brukeren et navn, for eksempel
Zippendo.3
Velg begge API-rollene
Velg shippingapi og 2026-04. Uten 2026-04 kan du sende sendinger, men søket etter hentesteder og returer uten fraktetikett fungerer ikke.
4
Tildel logistikkavtalenummeret ditt
Legg til logistikkavtalenummeret du skal skrive inn i Zippendo, og klikk deretter på Save.
5
Kopier Klient-ID og Klienthemmelighet
Portalen viser dem én gang. Kopier begge. Hvis du mister hemmeligheten, oppretter du ny legitimasjon i portalen og oppdaterer transportøren i Zippendo.
Koble til Posti
1
Åpne Alle transportører
Klikk på Transportører i sidefeltet, og åpne deretter fanen Alle transportører.
2
Finn Posti
Klikk på Koble til på kortet Posti.
3
Fyll ut skjemaet
Vinduet Koble til transportør åpnes. Navn på transportør er allerede fylt ut med «Posti». Skriv inn Klient-ID, Klienthemmelighet og Logistikkavtalenummer. Brukernavn for Tracking API og Passord for Tracking API ligger under Valgfrie felt.
4
Koble til transportøren
Klikk på Koble til. Du ser «Transportøren er koblet til», og transportøren vises på fanen Mine transportører.
Kortet Posti under Alle transportører
Koble til transportør for Posti - fyll ut Klient-ID, Klienthemmelighet og Logistikkavtalenummer
Feltene i skjemaet
Klienthemmelighet og Passord for Tracking API skjuler det du skriver.
Koble til gjør ingenting før Navn på transportør, Klient-ID, Klienthemmelighet og Logistikkavtalenummer har en verdi.
Test tilkoblingen
Posti har ikke noe testsystem, så det finnes ingen avkrysningsboks for Testmodus. Hver sending du sender, er en ekte sending hos Posti på logistikkavtalen din. Ifølge Posti faktureres en sending ikke med mindre den faktisk blir sendt, så en testfraktetikett du aldri leverer fra deg, koster ingenting. For å prøve tilkoblingen sender du én sending til din egen adresse og sjekker fraktetiketten. Posti varsler mottakeren, så bruk din egen e-postadresse og ditt eget telefonnummer på en testsending. Zippendo kan ikke kansellere en sending hos Posti, så kontakt Posti hvis du trenger å få en kansellert. Se Testmodus.Etter at du har koblet til
Transportøren vises under Mine transportører merket Tilkoblet. Du velger fraktproduktet på hver sending eller i en fraktregel, ikke i dette skjemaet. Se Fraktprodukter og tilleggstjenester. Et fraktprodukt som ikke er med i avtalen din med Posti, blir avvist når du sender, med årsaken fra Posti.
Alle fraktprodukter unntatt Retur (Palautus) trenger mottakerens telefonnummer for varslene fra Posti. Home Parcel (Kotipaketti) og Express Parcel (Express-paketti) kan ha flere pakker i én sending. De andre fraktproduktene tar én pakke per sending.
Tilleggstjenester og ekstra opplysninger
Alle fraktprodukter har to valg under Ekstra opplysninger til transportøren:- Etikettformat: PDF (standard) eller ZPL for termiske skrivere.
- Leveringsinstruksjoner: opptil 120 tegn som skrives ut på fraktetiketten, for eksempel en dørkode.
Hentesteder for Postipaketti
Postal Parcel (Postipaketti) leverer til et hentested. Velg hentestedet i delen Hentested på sendingen før du sender. Søket krever rollen 2026-04 på applikasjonskontoen din. Se Velg et hentested og Hentesteder.Returer
Retur (Palautus) bringer en pakke fra kunden din til adressen din. Den trenger ikke noe hentested, og avtalen din med Posti må omfatte kunderetur. Med Retur uten fraktetikett (sendingskode) skriver kunden din en kode på pakken i stedet for å skrive ut en fraktetikett. Sendingen viser koden som Etikettfri kode under Sporingsinformasjon. Send den til kunden din. Hvis Posti oppretter returen uten kode, viser sendingen en advarsel. Send da fraktetiketten til kunden din i stedet.Toll
Sendinger til et land utenfor EU, og til eller fra Åland, Kanariøyene, Ceuta eller Melilla, har med tolldata fra ordrelinjene: beskrivelse, tolltariffnummer (HS-kode), antall, verdi og opprinnelsesland. Posti sender tolldeklarasjonen og handelsfakturaen tilbake med fraktetiketten, og de vises sammen med dokumentene for sendingen. Legg til EORI-nummeret ditt under Organisasjonsinnstillinger. Når mottakeren har et EORI-nummer, skriver du det inn i Mottakerens EORI-nummer på mottakeren. Se Toll og dokumenter.Hentinger og sporing
- Posti er ikke tilgjengelig under Hentinger. Avtal hentinger direkte med Posti. Du kan ikke angi et hentevindu på en sending med Posti. Se Bestill en henting for transportørene som er tilgjengelige.
- Når Brukernavn for Tracking API og Passord for Tracking API er fylt ut, henter Zippendo sporingsoppdateringer fra Posti omtrent én gang i timen. Uten dem vises ingen sporingshendelser. Hver sending har likevel sporingsnummeret sitt og en Sporingslenke til posti.fi. Hvis sporingsinnloggingen er feil, retter du den opp under Rediger transportør og klikker på Lagre. Se Sporingswebhooks fra transportører.
Endre eller fjern tilkoblingen
For å endre den åpner du Transportører → Mine transportører og klikker på Rediger transportør på kortet. Siden Rediger transportør har to deler:- Generelt: Navn på transportør, og Merkevare hvis organisasjonen din har merkevarer.
- Transportørinnstillinger: Klient-ID, Klienthemmelighet, Logistikkavtalenummer, Brukernavn for Tracking API og Passord for Tracking API.
Vanlige problemer
Mer hjelp: Feil ved autentisering hos transportøren.