Nogle produkter kræver, at et afleveringssted vælges på forsendelsen. Et afleveringssted er adressen på et servicepunkt eller pakkeshop, hvor kunderne kan afhente leveringen.
Hvis afleveringsstedets adresse udelades i forespørgslen, og produktet kræver et afleveringssted, kan Shipment Server vælge et afleveringssted baseret på modtagerens adresse. Der er også nogle produkter, der skal kombineres med en service for at kunne bruge afleveringssteder.
Læs mere om:
- Hent afleveringssteder ved brug af GetDropPoints-metoden
- Inkluder en afleveringsstedsadresse på en forsendelse
- Opslag af afleveringssted ved hjælp af ID
-
Eksempelforespørgsler fra forskellige transportører
Hent afleveringssteder ved brug af GetDropPoints-metoden
Ved at bruge GetDropPoints-metoden kan du hente afleveringssteder for et givent produkt, hvis produktet understøtter det.
Eksempel på forespørgsel:
{
"ProdConceptID": 60,
"ResultCount": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "John Doe",
"Street1": "Test address 1",
"PostCode": "0580",
"City": "OSLO",
"CountryCode": "NO"
}
]
}
Forventet svar:
Succesfuld forespørgsel:
{
"DropPoints": [
{
"OriginalID": "3807542",
"RoutingCode": "ALF",
"Name1": "POSTNORD PICK UP POINT",
"Street1": "HARALDRUDV 11",
"PostCode": "0581",
"City": "OSLO",
"CountryCode": "NO",
"Distance": 0.891,
"Latitude": 59.9303385682,
"Longitude": 10.8246658266
},
]
}
Ikke understøttet på produkt:
{
"ErrorMessages": [
"DropPoint selection not supported for this product."
]
}
Betingelser ikke opfyldt:
{
"ErrorMessages": [
"Cannot use DropPoint service, conditions not met."
]
}"Betingelser ikke opfyldt" betyder normalt, at en service er påkrævet for at bruge afleveringssteder på produktet. Nogle produkter kan bruges både med og uden afleveringssteder, og derfor kan det være obligatorisk at inkludere en afleveringsstedsservice, hvis en afleveringsstedsadresse er med i forespørgslen. På denne type produkter sikrer valideringen, at en afleveringsstedsadresse aldrig tillades uden den korrekte servicekode.
Inkluder en afleveringsstedsadresse på en forsendelse
Afleveringsstedsadressen defineres i forsendelsesobjektet i sektionen for Addresses med Kind sat til 10. Eksemplet nedenfor viser en SubmitShipment-forespørgsel, der inkluderer en afleveringsstedsadresse.
{
"Kind": 1,
"ActorCSID": 63,
"ProdConceptID": 296,
"Addresses": [
{
"Kind": 2,
"Name1": "Test sender",
"Street1": "Test Address",
"PostCode": "51162",
"City": "SKENE",
"Mobile": "04799999999",
"Attention": "test",
"CountryCode": "SE"
},
{
"Kind": 1,
"Name1": "Jane Doe",
"Street1": "Testv\u00e4gen 10",
"PostCode": "64551",
"City": "STR\u00c4NGN\u00c4S",
"CountryCode": "SE"
},
{
"Kind": 10,
"Name1": "ULFH\u00c4LLSKIOSKEN",
"Street1": "MARIEFREDSV\u00c4GEN 36",
"PostCode": "64540",
"City": "STR\u00c4NGN\u00c4S",
"CountryCode": "SE"
}
],
"Lines": [
{
"PkgWeight": 5000,
"GoodsTypeKey1": "XP",
"Pkgs": [
{
"ItemNo": 1
}
]
}
]
}
Opslag af afleveringssted ved ID
Nogle transportører understøtter opslag på afleveringssteds-ID. Brug variablen CustNo og inkluder afleveringssteds-ID'et. Shipment Server vil derefter foretage et opslag på dette ID og udfylde afleveringsstedsadressen. Denne løsning er relevant, hvis du tilbyder valg af afleveringssted i din webshop.
{
"Kind":10,
"CustNo": "3535747"
}Hvis afleveringssteds-ID'et ikke matcher hos os, vil Shipment Server svare med en fejl, og du skal rette det for at kunne indsende forsendelsen.
Hvis du angiver nogle afleveringsstedsdata i din forespørgsel, vil Shipment Server ikke foretage et opslag, men bruge de angivne data – selvom de ikke er gyldige hos transportøren. I eksemplet nedenfor vil dataene blive brugt, og der foretages ikke opslag.
{
"Kind":10,
"CustNo": "3535747",
"Name1": "RIMI SINSEN AVD 3821"
"Street1": "SINSENV 55",
"Postcode": "0585",
"City": "OSLO",
"CountryCode": "NO"
}
Eksempelforespørgsler fra forskellige transportører
Tabellen nedenfor viser nogle eksempler på produkter, der understøtter afleveringssteder. Hvis kolonnerne for service og service-ID er udfyldt, indikerer det, at produktet skal kombineres med en service for at kunne bruge afleveringssteder.
| Transportørnavn | ProdName | ProdConceptID | Service | Service ID |
| Bring (NO) | Bedriftspakke ekspress over natt 0900 | 1034 | Valgfritt Postkontor | 142002 |
| Bring (NO) | Klimanøytral servicepakke | 1041 | Valgfritt Postkontor | 142002 |
| PostNord (DK) | MyPack (Indland) | 92 | Servicepoint | 9081 |
| PostNord (DK) | MyPack Collect (Udland) | 749 | Servicepoint | 9071 |
| PostNord (DK) | MyPack Collect Samsending | 571 | Servicepoint | 9071 |
| DB Schenker (SE) | Parcel ombud | 296 |
Ved at bruge metoden GetProducts får du en liste over alle produkter og services på din Shipment Server-konto. Hvis et produkt understøtter en service med et navn, der indikerer, at det er en afleveringsstedsservice (servicepunkt, pakkeshop osv.), betyder det som regel, at denne service skal inkluderes for at kunne bruge afleveringssteder.
Eksempelforespørgsler
I Bring- og PostNord-eksemplerne nedenfor vil Shipment Server slå et afleveringssted op, fordi en afleveringsstedsservice er valgt. Hvis du ikke ønsker, at Shipment Server skal slå et afleveringssted op, skal du inkludere afleveringsstedsadressen som i DB Schenker-eksemplet.
Bring (NO): Produktet "Klimanøytral servicepakke" inklusive servicen "Valgfritt Postkontor":
{
"ProdConceptID": 1041,
"ResultCount": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "John Doe",
"Street1": "Test address 1",
"PostCode": "0580",
"City": "OSLO",
"CountryCode": "NO"
}
],
"Services": [
142002
]
}
PostNord (DK): Produktet "MyPack" inklusive servicen "Servicepoint":
{
"ProdConceptID": 92,
"ResultCount": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "John Doe",
"Street1": "Vestergade 1",
"PostCode": "8000",
"City": "AARHUS",
"CountryCode": "DK"
}
],
"Services": [
9081
]
}
DB Schenker (SE): Produktet "Parcel Ombud":
{
"Kind": 1,
"ActorCSID": 63,
"ProdConceptID": 296,
"Addresses": [
{
"Kind": 2,
"Name1": "Test sender",
"Street1": "Test Address",
"PostCode": "51162",
"City": "SKENE",
"Mobile": "04799999999",
"Attention": "test",
"CountryCode": "SE"
},
{
"Kind": 1,
"Name1": "Jane Doe",
"Street1": "Testv\u00e4gen 10",
"PostCode": "64551",
"City": "STR\u00c4NGN\u00c4S",
"CountryCode": "SE"
},
{
"Kind": 10,
"Name1": "ULFH\u00c4LLSKIOSKEN",
"Street1": "MARIEFREDSV\u00c4GEN 36",
"PostCode": "64540",
"City": "STR\u00c4NGN\u00c4S",
"CountryCode": "SE"
}
],
"Lines": [
{
"PkgWeight": 5000,
"GoodsTypeKey1": "XP",
"Pkgs": [
{
"ItemNo": 1
}
]
}
]
}