Ontvang verzendmethoden op basis van adres en pakketparameters.
Geeft een lijst met retourmethoden voor een bepaalde partner met extra parameters zoals beschikbaarheid.
POST /v1/shipping-methods/quote
Voorbeeld aanvragen
{ "orderReferenceId": "EXMPL0001234", "currency": "EUR", "options": { "weightUnit": "g", "dimensionUnit": "mm", "label": { "format": "pdf" } }, "partner": { "clientName": "ExampleCustomer" }, "receiver": { "person": { "firstName": "Foo", "lastName": "Bar", "company": "", "email": "[email protected]", "phone": "01273552886" }, "address": { "country": "GB", "state": "East Sussex", "city": "Brighton", "postcode": "BN1 8YQ", "addressLine1": "11 London Rd", "addressLine2": "", "addressLine3": "", "street": "London Rd", "houseNumber": "11", "suburb": null }, "customs": { "vatNumber": null } }, "sender": { "person": { "firstName": "", "lastName": "", "company": "Example Company", "email": "[email protected]", "phone": "01666 123456" }, "address": { "country": "DE", "state": "", "city": "Donauwörth", "postcode": "86609", "addressLine1": "Am Wassergraben 11", "addressLine2": null, "addressLine3": null, "street": "Am Wassergraben", "houseNumber": "11", "suburb": null }, "customs": { "vatNumber": "DE123456789000", "iossNumber": null, "eoriNumber": "GB987654321000", "pcccNumber": null, "australianBusinessNumber": null } }, "packages": [ { "packageReferenceId": "EXMPL0001234-0-1", "grossWeight": 810, "netWeight": 760, "length": 229, "width": 200, "height": 36, "boxType": "rectangle", "volumetricWeight": 700, "items": [ { "itemReferenceId": "EXMPL0001234-0-1-ITEM1", "description": "Mug", "value": 48, "quantity": 4, "weight": 760, "hsCode": "44199090", "countryOfOrigin": "DE" } ] } ]}Voorbeeld van een succesvolle reactie
{ "items": [ { "carrier": { "name": "DHL", "uid": "dhl" }, "method": { "name": "DHL Global Parcel", "uid": "dhl_global_parcel", "price": 3.32, "maxShipmentDays": 5, "minShipmentDays": 2, "deliveryPaddingDays": 0 } }, { "carrier": { "name": "UPS", "uid": "ups" }, "method": { "name": "UPS Standard Tariff", "uid": "ups_standard_tariff", "price": 5.25, "maxShipmentDays": 5, "minShipmentDays": 2, "deliveryPaddingDays": 0 } } ], "count": 2}Voorbeeld van foutmelding
{ "orderReferenceId": "EXMPL0001234", "code": "VALIDATION_ERROR", "message": "There are errors in submitted data", "errors": [ { "code": "NO_SUCH_CHOICE_ERROR", "reference": "options.label.format", "message": "The value you selected is not a valid choice." }, { "code": "IS_BLANK_ERROR", "reference": "receiver.address.country", "message": "This value should not be blank." } ]}Request
Parameter | Type | Beschrijving |
orderReferenceId (verplicht) | string | Uniek ID voor de verzendopdracht. ID verstrekt door jou. |
valuta (verplicht) | string | Valuta van de verzendbestelling in 3-letterformaat. |
opties (optioneel) | Opties | Optionele parameters. |
partner (optioneel) | Partner | Partnergegevens. |
ontvanger (verplicht) | Ontvanger | Gegevens van de ontvanger. |
afzender (verplicht) | Afzender | Gegevens van de afzender. |
pakketten (verplicht) | Pakket[] | Pakketdetails. |
Opties
Parameter | Type | Beschrijving |
Gewichtseenheid (optioneel) | string | Gewichtseenheid. Beschikbare keuzes: g, kg, oz, lb. Standaard: g. |
dimensionUnit (optioneel) | string | Lengte-eenheid. Beschikbare opties: mm, cm, in. Standaard: mm. |
label (optioneel) | Label | Instellingen voor labelformaat. |
Label
Parameter | Type | Beschrijving |
formaat (optioneel) | string | Labelformaat. Beschikbare keuzes: pdf, zpl (*). Standaard: pdf. |
Opmerking: Voor bepaalde verzendmaatschappijen zijn mogelijk geen andere formaten dan pdf ingeschakeld.
Partner
Parameter | Type | Beschrijving |
Klantnaam (optioneel) | string | Verzendprofiel klant. |
Ontvanger
Parameter | Type | Beschrijving |
persoon (vereist) | OntvangerPersoon | Persoonlijke gegevens van de ontvanger. |
adres (verplicht) | Adres | Adresgegevens van de ontvanger. |
gepersonaliseerd (optioneel) | Douane van de ontvanger | Douanegegevens van de ontvanger. |
Afzender
Parameter | Type | Beschrijving |
persoon (verplicht) | Afzenderpersoon | Persoonlijke gegevens van de afzender. |
adres (verplicht) | Adres | Adresgegevens van de afzender. |
Douane (vereist voor internationale verzending) | Douane van de afzender | Douanegegevens van de afzender. |
OntvangerPersoon
Parameter | Type | Beschrijving |
Voornaam (verplicht) | string | Voornaam van de ontvanger. |
Achternaam (verplicht) | string | Achternaam van de ontvanger. |
bedrijf (optioneel) | string | De titel van het bedrijf. |
e-mail (optioneel*) | string | E-mailadres van de persoon. Dit kan worden gebruikt voor verzendmeldingen. |
telefoon (optioneel*) | string | Telefoonnummer van de persoon. Dit kan worden gebruikt voor verzendmeldingen. |
Opmerking: *E-mail en telefoon kunnen verplichte velden zijn, afhankelijk van de verzendmaatschappij
Afzenderpersoon
Parameter | Type | Beschrijving |
Voornaam (optioneel) | string | Voornaam van de afzender. |
Achternaam (optioneel) | string | Achternaam van de afzender. |
bedrijf (verplicht) | string | De titel van het verzendende bedrijf. |
e-mail (optioneel*) | string | E-mailadres van de afzender (persoon/bedrijf). |
telefoon (optioneel*) | string | Telefoonnummer van de afzender (persoon/bedrijf). |
Opmerking: *E-mail en telefoon kunnen verplichte velden zijn, afhankelijk van de verzendmaatschappij
Adres
Parameter | Type | Beschrijving |
land (verplicht) | string | Landcode in 2-letterformaat. |
staat (optioneel*) | string | Staat / provincie / regio. |
stad (verplicht) | string | Stad. |
postcode (verplicht) | string | Postcode. |
adresregel 1 (verplicht) | string | Eerste regel van het postadres. Moet straat en huisnummer bevatten. |
adresregel 2 (optioneel) | string | Tweede regel van het postadres. Appartement / kantoor / etagenummer. |
adresregel 3 (optioneel) | string | Derde regel van het postadres. |
straat (optioneel*) | string | Straat (verplicht voor Duitse adressen). |
huisnummer (optioneel*) | string | Huisnummer (verplicht voor Duitse adressen). |
buitenwijk (optioneel*) | string | Voorstad (verplicht voor AU/NZ-adressen). |
Opmerking: *Deze optionele velden zijn verplicht voor bepaalde landen en vervoerders.
Douane van de ontvanger
Parameter | Type | Beschrijving |
btw-nummer (optioneel) | string | BTW-nummer van de ontvanger. |
Douane van de afzender
Parameter | Type | Beschrijving |
btw-nummer (optioneel*) | string | BTW-nummer van de afzender. |
ioss-nummer (optioneel*) | string | IOSS-nummer van de afzender. |
EORI-nummer (optioneel*) | string | EORI-nummer van de afzender. |
pcccNumber (optioneel*) | string | PCCC-nummer van de afzender. |
australianBusinessNumber (optioneel*) | string | Australisch bedrijfsnummer van de afzender. |
Opmerking: *Afhankelijk van het land van de afzender en de ontvanger kunnen deze velden verplicht zijn.
Verpakking
Parameter | Type | Beschrijving |
packageReferenceId (verplicht) | string | Door de partner verstrekt pakket-ID. |
brutogewicht (verplicht) | nummer | Verpakkingsgewicht + artikelgewicht (standaard in gram). |
netto gewicht (optioneel) | nummer | Gewicht van de artikelen (standaard in gram). |
lengte (vereist) | nummer | Lengte van het pakket (standaard in mm). |
breedte (vereist) | nummer | Breedte van het pakket (standaard in mm). |
hoogte (verplicht) | nummer | Hoogte van het pakket (standaard in mm). |
volumetrisch gewicht (optioneel) | nummer | Gewicht berekend op basis van de grootte van het pakket (standaard in gram). |
boxType (optioneel) | string | Vorm van de doos (bijv. rechthoek, buis). |
waarde (vereist voor internationale verzending) | nummer | Totale waarde van alle artikelen in het pakket (in geselecteerde valuta). |
artikelen (vereist voor internationale verzending) | Artikel[] | Lijst van artikelen in het pakket. |
Artikel*
Parameter | Type | Beschrijving |
itemReferenceId (verplicht) | string | Door de partner verstrekte ID van het pakketitem. |
Beschrijving (verplicht) | string | Beschrijving van het artikel. |
aantal (verplicht) | nummer | Aantal van het artikel. |
waarde (vereist) | nummer | Waarde van het artikel (in geselecteerde valuta). |
gewicht (vereist) | nummer | Gewicht van het artikel (standaard in gram). |
hsCode (verplicht) | string | Harmonized System Code (Wiki). |
land van herkomst (verplicht) | string | Landcode in 2-letterformaat waar het artikel is geproduceerd. |
Opmerking: *Alleen alle artikelparameters zijn vereist voor internationale verzending.
Succesvolle reactie
Parameter | Type | Beschrijving |
aantal | nummer | Aantal gevonden resultaten. |
artikelen | ResponseItems | Een lijst met offertes |
ResponseItems
Parameter | Type | Beschrijving |
vervoerder | ResponseItemsCarrier | Details van de verzendmaatschappij. |
methode | ResponseItemsMethod | Details van de verzendmethode. |
ResponseItemsCarrier
Parameter | Type | Beschrijving |
vervoerder | string | Vervoerder die wordt gebruikt voor de bestelling. |
uid | string | Verzendmethode gebruikt voor de bestelling. |
ResponseItemsMethod
Parameter | Type | Beschrijving |
Naam | string | Naam van de verzendmethode. |
uid | string | UID van verzendmethode. |
prijs | nummer | Geschatte prijs van de verzendmethode voor de partner. |
maxShipmentDays | nummer | Maximale verzenddagen voor de verzendmethode. |
minShipmentDays | nummer | Minimale verzenddagen voor verzendmethode. |
deliveryPaddingDays (optioneel) | nummer | Levertijd in dagen voor verzendmethode. |
Foutmelding
Parameter | Type | Beschrijving |
orderreferentie-id | string | Uniek ID voor de verzendopdracht die door jou is verstrekt. |
code | string | Foutcode. |
Bericht | string | Foutmelding. |
detail (optioneel) | object | Gedetailleerd foutbericht (JSON-object van een willekeurige structuur). |
fouten (optioneel) | ResponseErrorDetails[] | Array met fouten. |
ResponseErrorDetails
Parameter | Type | Beschrijving |
code | string | Foutcode. |
Bericht | string | Foutmelding |
referentie (optioneel) | string | Referentie-ID. |
Volgende stap: 🔗[GCL] Logistics API - Tracking
📝 Niet wat je nodig had?
Help ons dit artikel te verbeteren, stuur ons een e-mail naar [email protected] — vermeld alsjeblieft de titel van het artikel.