Integrasjoner og API
PostNord
Koble til en egen PostNord-avtale: felter, hentesteder i kassen, booking og etiketter, sporingens grenser, feil, frakobling og kallgrenser.
Med en egen PostNord-avtale booker BunStack pakker og skriver ut etiketter via PostNords API.
Hvor: Stack › PostNord.
Sendify og PostNord kan brukes samtidig. Hver fraktmetode peker på sin leverandør. Fraktmetodene bygger du under Frakt.
Koble til PostNord
- Opprett en API-nøkkel i PostNords Developer portal.
- Åpne Stack › PostNord og fanen Settings.
- Fyll inn feltene i tabellen nedenfor.
- Trykk Connect PostNord.
- Legg til fraktmetoder med leverandør PostNord under Settings › Shipping.
- Fyll inn avsenderadressen i kortet Sender address & default parcel på samme side.
PostNord vises nå som fraktmetode i kassen i alle butikker i workspacet.
| Felt | Hva du legger inn | Standard |
|---|---|---|
| Customer number (8 digits) | Kundenummeret ditt hos PostNord. Påkrevd. | – |
| Label format | Etikettformatet som sendes til PostNord. | label |
| Issuer code | Utstederkoden hos PostNord. | Z12 |
| Application id | Applikasjons-id hos PostNord. | 1438 |
| API key (from PostNord Developer portal) | Nøkkelen. Én nøkkel dekker etiketter, hentesteder og sporing. | – |
- Integrasjonen er tilkoblet når en nøkkel er lagret. BunStack prøver nøkkelen mot PostNord, men svaret setter bare en markering for verifisert nøkkel.
- Knappen heter Update connection når en nøkkel allerede finnes.
- Test connection gjør et søk etter hentesteder med nøkkelen og viser PostNords svar.
- Fanen Service points søker etter hentesteder for et svensk postnummer (5 sifre) med Find points. Det er samme søk som kassen gjør.
Tjenester
| Tjeneste | Hentested kreves |
|---|---|
| PostNord Varubrev | Nei |
| PostNord Paket (hemleverans) | Nei |
| PostNord Ombud / utlämningsställe | Ja |
Hva som skjer når
| Tidspunkt | Hva BunStack gjør |
|---|---|
| Kunden velger en fraktmetode med hentested | Viser PostNords hentesteder nær kundens postnummer. |
| Du sender ordren | Booker pakken hos PostNord og lagrer etikett-PDF-en på forsendelsen. Ordren får sporingsnummeret, og kunden får e-posten om sendt ordre. |
| Print shipping label på forsendelsen, eller ⋯ Actions › Shipping labels | Henter den lagrede etiketten. BunStack lager ingen ny. |
| ⋯ Actions › Refresh tracking på ordren | Spør PostNord etter et sporingsnummer som manglet ved bookingen. |
Bookingen bruker disse opplysningene:
- Mottaker: kunden fra ordren, eller hentestedet for PostNord Ombud.
- Avsender: adressen under Settings › Shipping.
- Vekt: linjens lagrede vekt, ellers variantens, produktets eller standardpakkens. Minst 0,1 kg.
Sporing
PostNord gir normalt sporingsnummeret ved bookingen. Sporingslenken på ordren og i e-posten går til PostNord.
- Godtar PostNord bookingen uten sporingsnummer, står forsendelsen som ventende. Trykk Refresh tracking på ordren.
- BunStack henter ingen sporingshendelser fra PostNord. Ingen planlagt jobb spør PostNord.
- Ordren får ingen leveringstid, og kunden får ingen e-post om levering.
Feil og hvor de vises
| Melding | Årsak | Gjør slik |
|---|---|---|
| Leveringsdialogen viser at PostNord ikke er tilkoblet | Integrasjonen er ikke koblet til, eller nøkkelen mangler. | Koble til PostNord under Stack › PostNord. |
| Leveringsdialogen viser at kundenummeret er feil | Kundenummeret er ikke 8 sifre. | Rett Customer number (8 digits). |
| Leveringsdialogen viser at avsenderadressen mangler | Kortet Sender address & default parcel er tomt. | Fyll inn avsenderadressen under Settings › Shipping. |
| PostNords feiltekst i leveringsdialogen og på forsendelsen | PostNord avviste bookingen. Ingenting er booket. | Rett det feilteksten nevner, og send igjen. |
| Test connection viser en feil | Nøkkelen er feil eller mangler tilgang. | Kontroller nøkkelen i PostNords Developer portal. |
Koble fra
Disconnect sletter API-nøkkelen og slår av integrasjonen. Booking, etiketter og hentesteder stopper. Kundenummeret og øvrige innstillinger blir liggende. Koble til igjen ved å legge inn nøkkelen på nytt.
Kallgrenser
- Hentesteder: 30 per minutt per IP-adresse og 300 per time per butikk. Når en grense er nådd, viser kassen ingen hentesteder før tiden har gått.
- Booking og etiketter gjøres i admin. BunStack begrenser dem ikke.