Integrationer & API
PostNord
Koppla ett eget PostNord-avtal: fält, ombud i kassan, bokning och etiketter, spårningens gränser, fel, bortkoppling och anropsgränser.
Med ett eget PostNord-avtal bokar BunStack paket och skriver etiketter via PostNords API.
Var: Stack › PostNord.
Sendify och PostNord kan användas samtidigt. Varje fraktsätt pekar på sin leverantör. Fraktsätten lägger du upp under Frakt.
Koppla PostNord
- Skapa en API-nyckel i PostNords Developer portal.
- Öppna Stack › PostNord och fliken Settings.
- Fyll i fälten i tabellen nedan.
- Tryck Connect PostNord.
- Lägg till fraktsätt med leverantör PostNord under Settings › Shipping.
- Fyll i avsändaradressen i kortet Sender address & default parcel, också under Settings › Shipping.
PostNord syns nu som fraktsätt i kassan i alla butiker i workspacet.
| Fält | Vad du anger | Standard |
|---|---|---|
| Customer number (8 digits) | Ditt kundnummer hos PostNord. Krävs. | – |
| Label format | Etikettformatet som skickas till PostNord. | label |
| Issuer code | Utfärdarkoden hos PostNord. | Z12 |
| Application id | Applikations-id hos PostNord. | 1438 |
| API key (from PostNord Developer portal) | Nyckeln. En nyckel täcker etiketter, ombud och spårning. | – |
- Integrationen är ansluten när en nyckel är sparad. BunStack provar nyckeln mot PostNord, men svaret ändrar bara markeringen för verifierad nyckel.
- Knappen heter Update connection när en nyckel redan finns.
- Test connection gör en ombudssökning med nyckeln och visar PostNords svar.
- Fliken Service points söker ombud för ett svenskt postnummer (5 siffror) med Find points. Det är samma sökning som kassan gör.
Tjänster
| Tjänst | Ombud krävs |
|---|---|
| PostNord Varubrev | Nej |
| PostNord Paket (hemleverans) | Nej |
| PostNord Ombud / utlämningsställe | Ja |
Vad som händer när
| Tillfälle | Vad BunStack gör |
|---|---|
| Kunden väljer ett ombudsfraktsätt | Visar PostNords ombud nära kundens postnummer. |
| Du skickar ordern | Bokar paketet hos PostNord och sparar etikett-PDF:en på försändelsen. Ordern får spårningsnumret och kunden får mejlet om skickad order. |
| Print shipping label på försändelsen, eller ⋯ Actions › Shipping labels | Hämtar den sparade etiketten. BunStack skapar ingen ny. |
| ⋯ Actions › Refresh tracking på ordern | Frågar PostNord efter ett spårningsnummer som saknades vid bokningen. |
Bokningen använder dessa uppgifter:
- Mottagare: kunden från ordern, eller ombudet för PostNord Ombud.
- Avsändare: adressen under Settings › Shipping.
- Vikt: radens sparade vikt, annars variantens, produktens eller standardpaketets. Minst 0,1 kg.
Spårning
PostNord ger normalt spårningsnumret vid bokningen. Spårningslänken på ordern och i mejlet går till PostNord.
- Godtar PostNord bokningen utan spårningsnummer står försändelsen som väntande. Tryck Refresh tracking på ordern.
- BunStack hämtar inga spårningshändelser från PostNord. Inget schemalagt jobb frågar PostNord.
- Ordern får ingen leveranstid och kunden får inget leveransmejl.
Fel och var de syns
| Meddelande | Orsak | Gör så här |
|---|---|---|
| PostNord är inte ansluten för det här workspacet. eller PostNord API key saknas. Anslut integrationen igen. | Integrationen är inte kopplad eller nyckeln saknas. | Koppla PostNord under Stack › PostNord. |
| PostNord-kundnummer ogiltigt (8 siffror): … | Kundnumret är inte 8 siffror. | Rätta Customer number (8 digits). |
| Store settings (avsändaradress) saknas. Fyll i under Settings. | Kortet Sender address & default parcel är tomt. | Fyll i avsändaradressen under Settings › Shipping. |
| PostNord API failed: … följt av PostNords feltext, i leveransdialogen och på försändelsen | PostNord avvisade bokningen. Inget är bokat. | Rätta uppgiften som feltexten nämner och skicka igen. |
| Test connection visar ett fel | Nyckeln är fel eller saknar behörighet. | Kontrollera nyckeln i PostNords Developer portal. |
Koppla bort
Disconnect raderar API-nyckeln och stänger av integrationen. Bokning, etiketter och ombud slutar fungera. Kundnumret och övriga inställningar ligger kvar. Koppla igen genom att ange nyckeln på nytt.
Anropsgränser
- Ombud: 30 per minut per IP-adress och 300 per timme per butik. När en gräns är nådd visar kassan inga ombud tills tiden har gått.
- Bokning och etiketter görs i admin. BunStack begränsar dem inte.