Integrationer og API
PostNord
Tilslut en egen PostNord-aftale: felter, pakkeshops i kassen, booking og labels, sporingens grænser, fejl, afbrydelse og kaldegrænser.
Med en egen PostNord-aftale booker BunStack pakker og udskriver labels via PostNords API.
Hvor: Stack › PostNord.
Sendify og PostNord kan bruges samtidig. Hver fragtmetode peger på sin leverandør. Fragtmetoderne bygger du under Fragt.
Tilslut PostNord
- Opret en API-nøgle i PostNords Developer portal.
- Åbn Stack › PostNord og fanen Settings.
- Udfyld felterne i tabellen nedenfor.
- Tryk Connect PostNord.
- Tilføj fragtmetoder med leverandør PostNord under Settings › Shipping.
- Udfyld afsenderadressen i kortet Sender address & default parcel på samme side.
PostNord vises nu som fragtmetode i kassen i alle butikker i workspacet.
| Felt | Hvad du indtaster | Standard |
|---|---|---|
| Customer number (8 digits) | Dit kundenummer hos PostNord. Påkrævet. | – |
| Label format | Labelformatet, der sendes til PostNord. | label |
| Issuer code | Udstederkoden hos PostNord. | Z12 |
| Application id | Applikations-id hos PostNord. | 1438 |
| API key (from PostNord Developer portal) | Nøglen. Én nøgle dækker labels, pakkeshops og sporing. | – |
- Integrationen er tilsluttet, når en nøgle er gemt. BunStack prøver nøglen mod PostNord, men svaret sætter kun en markering for verificeret nøgle.
- Knappen hedder Update connection, når en nøgle allerede findes.
- Test connection laver en søgning efter pakkeshops med nøglen og viser PostNords svar.
- Fanen Service points søger pakkeshops for et svensk postnummer (5 cifre) med Find points. Det er samme søgning, som kassen laver.
Tjenester
| Tjeneste | Pakkeshop kræves |
|---|---|
| PostNord Varubrev | Nej |
| PostNord Paket (hemleverans) | Nej |
| PostNord Ombud / utlämningsställe | Ja |
Hvad der sker hvornår
| Tidspunkt | Hvad BunStack gør |
|---|---|
| Kunden vælger en fragtmetode med pakkeshop | Viser PostNords pakkeshops nær kundens postnummer. |
| Du sender ordren | Booker pakken hos PostNord og gemmer label-PDF'en på forsendelsen. Ordren får sporingsnummeret, og kunden får mailen om sendt ordre. |
| Print shipping label på forsendelsen, eller ⋯ Actions › Shipping labels | Henter den gemte label. BunStack laver ingen ny. |
| ⋯ Actions › Refresh tracking på ordren | Spørger PostNord efter et sporingsnummer, der manglede ved bookingen. |
Bookingen bruger disse oplysninger:
- Modtager: kunden fra ordren, eller pakkeshoppen for PostNord Ombud.
- Afsender: adressen under Settings › Shipping.
- Vægt: linjens gemte vægt, ellers variantens, produktets eller standardpakkens. Mindst 0,1 kg.
Sporing
PostNord giver normalt sporingsnummeret ved bookingen. Sporingslinket på ordren og i mailen går til PostNord.
- Godkender PostNord bookingen uden sporingsnummer, står forsendelsen som ventende. Tryk Refresh tracking på ordren.
- BunStack henter ingen sporingshændelser fra PostNord. Intet planlagt job spørger PostNord.
- Ordren får ingen leveringstid, og kunden får ingen mail om levering.
Fejl og hvor de vises
| Besked | Årsag | Gør sådan |
|---|---|---|
| Leveringsdialogen viser, at PostNord ikke er tilsluttet | Integrationen er ikke tilsluttet, eller nøglen mangler. | Tilslut PostNord under Stack › PostNord. |
| Leveringsdialogen viser, at kundenummeret er forkert | Kundenummeret er ikke 8 cifre. | Ret Customer number (8 digits). |
| Leveringsdialogen viser, at afsenderadressen mangler | Kortet Sender address & default parcel er tomt. | Udfyld afsenderadressen under Settings › Shipping. |
| PostNords fejltekst i leveringsdialogen og på forsendelsen | PostNord afviste bookingen. Intet er booket. | Ret det, fejlteksten nævner, og send igen. |
| Test connection viser en fejl | Nøglen er forkert eller mangler adgang. | Kontrollér nøglen i PostNords Developer portal. |
Afbryd
Disconnect sletter API-nøglen og slår integrationen fra. Booking, labels og pakkeshops stopper. Kundenummeret og de øvrige indstillinger bliver liggende. Tilslut igen ved at indtaste nøglen på ny.
Kaldegrænser
- Pakkeshops: 30 pr. minut pr. IP-adresse og 300 pr. time pr. butik. Når en grænse er nået, viser kassen ingen pakkeshops, før tiden er gået.
- Booking og labels sker i admin. BunStack begrænser dem ikke.