> ## 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.
# Koble til Posti
> Koble til Posti i Zippendo med Klient-ID, Klienthemmelighet og Logistikkavtalenummer, og eventuelt Brukernavn for Tracking API og Passord for Tracking API.
**Posti** sender pakker fra Finland: til pakkeautomater og hentesteder hos Posti, hjemlevering, Express neste dag, småpakker til døren, kunderetur og Priority- og EMS-pakker over hele verden. Feltene som alle transportører har felles, står på [Legitimasjon for transportører](/docs/no/how-to/carrier-credentials).
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](/docs/no/how-to/shipping-rule-fields). 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](https://pro.posti.fi/) med rollen **API Manager**, for å logge inn i [Posti Developer Portal](https://developer.posti.com/). 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.
Du kan koble til Posti mer enn én gang, for eksempel én tilkobling per logistikkavtale. Gi hver av dem sitt eget **Navn på transportør**. **Les mer** på kortet åpner siden til Posti om tjenestene for netthandel.
## Hent legitimasjonen din fra Posti
Åpne [developer.posti.com](https://developer.posti.com/) og logg inn med brukeren din for OmaPosti Pro.
Å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`.
Velg **shippingapi** og **2026-04**. Uten **2026-04** kan du sende sendinger, men søket etter hentesteder og returer uten fraktetikett fungerer ikke.
Legg til logistikkavtalenummeret du skal skrive inn i Zippendo, og klikk deretter på **Save**.
Portalen viser dem én gang. Kopier begge. Hvis du mister hemmeligheten, oppretter du ny legitimasjon i portalen og oppdaterer transportøren i Zippendo.
For sporing ber du kundeservice hos Posti om en tjenestekonto for **Tracking API** for avtalen din. Posti sender deg et brukernavn og et passord.
## Koble til Posti
Klikk på **Transportører** i sidefeltet, og åpne deretter fanen **Alle transportører**.
Klikk på **Koble til** på kortet **Posti**.
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**.
Klikk på **Koble til**. Du ser «Transportøren er koblet til», og transportøren vises på fanen **Mine transportører**.
## Feltene i skjemaet
**Klienthemmelighet** og **Passord for Tracking API** skjuler det du skriver.
| Felt | Påkrevd | Hva du skriver inn |
| - | - | - |
| **Navn på transportør** | Ja | Navnet du ser under **Mine transportører** og når du velger en transportør på en sending. Det starter som **Posti**. |
| **Merkevare** | Nei | Vises bare hvis organisasjonen din har [merkevarer](/docs/no/how-to/create-a-brand). Skjemaet sier: «Bare denne merkevaren kan bruke denne transportøren.» La feltet stå tomt for å la alle merkevarer bruke den. |
| **Klient-ID** | Ja | Skjemaet sier: «Fra utviklerportalen til Posti (developer.posti.com): klient-ID-en til applikasjonskontobrukeren du legger til for Zippendo. Velg begge API-rollene, shippingapi og 2026-04.» |
| **Klienthemmelighet** | Ja | Skjemaet sier: «Klienthemmeligheten som utviklerportalen viser én gang, sammen med klient-ID-en.» |
| **Logistikkavtalenummer** | Ja | Bare sifre. Skjemaet sier: «Logistikkavtalenummeret ditt hos Posti, vanligvis seks sifre som begynner med 6. Legg det til på den samme applikasjonskontobrukeren i utviklerportalen, ellers avviser Posti sendingene dine.» |
| **Brukernavn for Tracking API** | Nei | Fyll ut begge sporingsfeltene eller ingen av dem. Skjemaet sier: «Brukernavnet for Tracking API som kundeservice hos Posti gir deg for avtalen din. Trengs bare for å spore sendingene dine.» |
| **Passord for Tracking API** | Nei | Skjemaet sier: «Passordet Posti sender sammen med brukernavnet for Tracking API. Posti låser kontoen i en time etter fem mislykkede innloggingsforsøk.» |
**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](/docs/no/how-to/sandbox-mode).
## 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](/docs/no/how-to/carrier-products-and-services). Et fraktprodukt som ikke er med i avtalen din med Posti, blir avvist når du sender, med årsaken fra Posti.
| Fraktprodukt | Leverer til | Maks vekt |
| - | - | - |
| **Postal Parcel (Postipaketti)** | En pakkeautomat eller et hentested hos Posti i Finland, på Åland, i Estland, Latvia eller Litauen. | 25 kg |
| **Home Parcel (Kotipaketti)** | Mottakerens dør, på et tidspunkt Posti avtaler med mottakeren. Finland, Åland og Baltikum. | 25 kg, 35 kg som Bulky |
| **Express Parcel (Express-paketti)** | Levering neste dag mot signatur. Finland, Åland og Baltikum. | 25 kg, 35 kg som Bulky |
| **Small Parcel to Door (Pikkupaketti ovelle)** | Mottakerens postkasse eller dør i Finland og på Åland, opptil 38 x 38 x 28 cm. | 4 kg |
| **Retur (Palautus)** (retursending) | Kunden din leverer en pakke på et hvilket som helst hentested eller en pakkeautomat hos Posti, til adressen din i Finland. | 25 kg, 35 kg som Bulky |
| **Priority Parcel** | Over 200 land, til døren eller et hentested avhengig av landet. | 25 kg, 30 kg som Bulky |
| **EMS** | Over 200 land, til døren mot signatur. | 25 kg, 30 kg som Bulky |
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.
Fraktetikettene er 10 x 15 cm. Internasjonale fraktprodukter som ikke har en fraktetikett i den størrelsen, skrives ut på en A5-side.
Du velger tilleggstjenester på sendingen eller i en fraktregel. Hvert fraktprodukt viser tilleggstjenestene Posti tilbyr på det: **Ankomstvarsel på SMS eller e-post**, **Forhåndsvarsel før levering**, **Skjørt gods**, **Bulky (overdimensjonert pakke)**, **Ikke utendørs pakkeautomat**, **Lørdagslevering**, **Personlig overlevering (ID-kontroll)**, **Rekommandert (overleveres mot signatur)**, **Levering uten signatur**, **Leveringstidspunkt avtalt på telefon**, **Ring før levering**, **Fossilfri transport (tildelt andel)** og, bare på **Retur (Palautus)**, **Retur uten fraktetikett (sendingskode)**. Velg **Bulky (overdimensjonert pakke)** for en pakke over 25 kg eller større enn standardstørrelsen for fraktproduktet.
### 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](/docs/no/how-to/pick-a-service-point) og [Hentesteder](/docs/no/how-to/drop-point-and-service-points).
### 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](/docs/no/how-to/organization-settings). Når mottakeren har et EORI-nummer, skriver du det inn i **Mottakerens EORI-nummer** på mottakeren. Se [Toll og dokumenter](/docs/no/how-to/customs-and-documents).
### 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](/docs/no/how-to/schedule-a-pickup) 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](/docs/no/how-to/tracking-webhooks).
## 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**.
Klikk på **Lagre**. Du ser «Transportøren er oppdatert».
For å fjerne den klikker du på **Slett** på den samme siden, skriver navnet på transportøren med store bokstaver og klikker på **Slett**. Fraktregler som bruker denne transportøren, slettes sammen med den. Sendinger du allerede har sendt, beholder fraktetikettene og sporingsnumrene sine.
## Vanlige problemer
| Hva du ser | Hva du gjør |
| - | - |
| «Kunne ikke koble til transportøren. Prøv igjen.» | Sjekk de påkrevde feltene, og prøv igjen. |
| «Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger.» | Grensen for antall transportører i planen din er nådd. Se [Fakturering og forbruk](/docs/no/how-to/billing-and-usage). |
| «Transportøren avviste innloggingsopplysningene dine. Oppdater legitimasjonen for transportøren under Transportører.» når du sender | **Klient-ID** eller **Klienthemmelighet** er feil, eller applikasjonskontoen har ikke begge API-rollene. Rett det opp i utviklerportalen eller under **Rediger transportør**. |
| «Innstillingene for transportøren er ufullstendige eller ugyldige. Sjekk dem under Transportører.» | **Logistikkavtalenummer** inneholder noe annet enn sifre. Rett det opp under **Rediger transportør**. |
| «Posti kunne ikke opprette sendingen.» | Posti avviste sendingen, for eksempel fordi logistikkavtalenummeret ikke er tildelt applikasjonskontoen. Sendingen viser årsaken fra Posti. Rett opp og send på nytt. |
| «Noen valg for dette fraktproduktet mangler eller er ugyldige. Sjekk tilleggstjenestene og valgene for sendingen, og prøv igjen.» | Mottakerens telefonnummer mangler, sendingen har for mange pakker for fraktproduktet, en pakke er for tung eller for stor, eller Posti tilbyr ikke en valgt tilleggstjeneste der. Sendingen viser hva som er feil. |
| «Dette fraktproduktet leverer til et hentested. Velg et hentested før du sender.» | Velg et hentested for **Postal Parcel (Postipaketti)** på sendingen. |
| «Det valgte fraktproduktet sender ikke mellom disse landene. Velg et annet fraktprodukt.» | Velg et fraktprodukt fra Posti som dekker mottakerens land. |
| «Tolldeklarasjonen er ufullstendig. Hver vare må ha en beskrivelse, et antall og en deklarert verdi over null.» | En ordrelinje mangler beskrivelse, tolltariffnummer, antall eller verdi. Fyll det ut og send på nytt. |
| «Transportøren godtok sendingen, men sendte verken fraktetikett eller QR-kode tilbake, og Zippendo kan ikke be om den på nytt. Be transportøren om den, og ikke send sendingen på nytt.» | Kontakt Posti for å få fraktetiketten. Ikke send sendingen på nytt. |
| «Forbindelsen til transportøren ble brutt før den svarte. Zippendo har ingen bekreftelse på at sendingen ble opprettet, så sjekk med transportøren før du sender på nytt.» | Sjekk med Posti om sendingen finnes før du sender den på nytt. |
| Ingen sporingshendelser vises | Sjekk at begge sporingsfeltene er fylt ut og riktige. |
| «Vi får ikke kontakt med transportørene akkurat nå. Prøv igjen om litt.» eller «Transportøren avviste dette. Se årsaken fra transportøren, rett opp opplysningene og prøv igjen.» | Vent litt og send på nytt, eller rett opp det årsaken fra Posti nevner. |
Mer hjelp: [Feil ved autentisering hos transportøren](/docs/no/knowledge-base/carrier-authentication-failures).
## Relatert
* [Koble til en transportør eller integrasjon](/docs/no/how-to/connect-index)
* [Legitimasjon for transportører](/docs/no/how-to/carrier-credentials)
* [Testmodus](/docs/no/how-to/sandbox-mode)
* [Fraktprodukter og tilleggstjenester](/docs/no/how-to/carrier-products-and-services)
* [Velg et hentested](/docs/no/how-to/pick-a-service-point)
* [Toll og dokumenter](/docs/no/how-to/customs-and-documents)
* [Be om en transportørintegrasjon](/docs/no/how-to/request-carrier-integration)
* [Transportører](/docs/no/tutorials/carriers)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.