Select Courier API

Connecting the World

Introductie

De Select Courier API biedt een snelle en eenvoudige manier om toegang te krijgen tot service-informatie via internet.
Met deze API kunt u eenvoudig de Select Courier-technologie integreren in uw eigen applicaties of website. De gebruikers die uw applicaties of website gebruiken, kunnen snel en veilig toegang krijgen tot alle Select Courier-services.

Elke tool die vloeiend is in HTTP kan communiceren met onze API door simpelweg de juiste URI op te vragen. Verzoeken moeten worden gedaan met behulp van het HTTPS-protocol, zodat het verkeer wordt versleuteld. De API reageert op verschillende methoden, afhankelijk van de vereiste actie.

Nadat de API is geïmplementeerd, kunt u de services die we aanbieden verkrijgen, offertes genereren, boekingen plaatsen, labels genereren, collecties regelen en trackinginformatie krijgen.

Vereisten
! JSON-bibliotheek en internetverbinding.
! API ondersteunt alleen ASCII-tekens.

Authenticatie

Om een API-verzoek te kunnen doen, raden we u aan om de cURL-bibliotheek te gebruiken. U hebt ook een API-key en API-secret nodig. API-key's zijn unieke codes die u of uw applicatie identificeert wanneer u één van onze API's aanroept. API-secret is een andere code die als wachtwoord fungeert voor de API-key. Nadat u een account bij ons heeft aangemaakt, kunt u een API-key en API-secret genereren in uw gebruikersinstellingen.

Request code samples

cURL PHP
curl -X POST -k \
-u API_KEY:API_SECRET \
-H "Content-Type: application/json" \
-d '{"action": "quote"}' \
https://www.selectcourier.com/api/json
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.selectcourier.com/api/json");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array("action" => "quote")));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
     "Authorization: Basic " . base64_encode(API_KEY . ":" . API_SECRET)
));
$response = curl_exec($ch);
curl_close($ch);
$response = json_decode($response, true);
return $response;

Quoting

Gebruik deze methode om informatie te krijgen over beschikbare services en prijzen. Vereist 'authentication request elements'.

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht Beschrijft welk type verzoek naar de server wordt verzonden. quote
o_company Optioneel Bedrijfsnaam afzender. SelectCourier
o_name Verplicht Contactpersoon afzender. John White
o_email Optioneel E-mailadres afzender. test@selectcourier.com
o_phone Verplicht Telefoonnummer afzender. 001123456789
o_street_1 Verplicht Adres afzender. Examplestreet
o_street_2 Optioneel Adresregel 2 afzender. Second floor
o_street_3 Optioneel Adresregel 3 afzender. Room 8
o_street_no Verplicht Huisnummer afzender. 27B
o_postal Conditioneel Postcode afzender. 100010
o_city Verplicht Plaats afzender. New York
o_province Conditioneel Provincie afzender. NY for New York,
BC for British Columbia
o_country Verplicht Landcode afzender. US
o_eori Conditioneel EORI-Nuimmer afzender
(Economic Operators Registration
and Identification number).		 NL012345678
o_date Optioneel Voorkeur collectie datum (YYYY-MM-DD). 2020-01-25
d_company Optioneel Bedrijfsnaam ontvanger. SelectCourier
d_name Verplicht Contactpersoon ontvanger. David Black
d_email Optioneel E-mailadres ontvanger. test@selectcourier.com
d_phone Verplicht Telefoonnummer ontvanger. 0123-456789
d_street_1 Verplicht Adres ontvanger. Teststreet
d_street_2 Optioneel Adresregel 2 ontvanger. 1st floor
d_street_3 Optioneel Adresregel 3 ontvanger. Room 212
d_street_no Verplicht Huisnummer ontvanger. 27C
d_postal Conditioneel Postcode ontvanger.  3045 AB
d_city Verplicht Plaats ontvanger. Rotterdam
d_province Conditioneel Provincie ontvanger. Zuid Holland
d_country Verplicht Landcode ontvanger.  NL
d_eori Conditioneel EORI-nummer ontvanger
(Economic Operators Registration
and Identification number).		  
type Verplicht Zending type
(Parcel, Document, Pallet).		 Parcel
reference Optioneel Zendingsreferentie. AB0000
inco Optioneel Incoterms. DAP (default value) or DDP
stackable Optioneel Stapelbaar of niet (1 or 0). 1
has_batteries Optioneel Bevat zending batterijen of niet (1 or 0). 0
own_customs_invoice Optioneel Geeft aan of uw eigen douanefactuur wordt gebruikt. Gebruik 'Upload Documenten' na het aanmaken van een zending om uw eigen douanefactuur te uploaden. 0
delivery_instructions Optioneel Heeft u instructies voor aflevering. Deliver at door.
return_service Verplicht Wilt u een retourlabel aanmaken om te ruilen? (1 or 0). 1
items Verplicht Array van items.  
third_party Optioneel Array voor derde adres.  
customs Optioneel Array voor Douane.  


Items child elements:
Naam Vereist Beschrijving Voorbeeld
contents Verplicht Zendingsinhoud. Electronic Device.
value Verplicht Waarde van item. 55.00
value_currency Optioneel Valuta. EUR
weight Verplicht Gewicht van zending (in kg). 10.5
length Verplicht Lengte van zending (in cm). 35
width Verplicht Breedte van zending (in cm). 35
height Verplicht Hoogte van zending (in cm). 35
hs_code Conditioneel Harmonized System Code. 85183000
products Optioneel Array van producten.  


Products child elements:
Naam Vereist Beschrijving Voorbeeld
quantity Verplicht Hoeveelheid van zelfde soort producten. 2
product_code Verplicht Artikelnummer.   
o_country Verplicht Land van oorsprong.  NL 
weight Verplicht Gewicht van product (in kg).  5.3 
description Verplicht Productbeschrijving. Headset 
value Verplicht Stukprijs van product.  20.00 
value_currency Verplicht Valuta.  EUR 
hs_code Verplicht Harmonized System Code. 85183000 


Third party child elements:
Naam Vereist Beschrijving Voorbeeld
type Verplicht Derde adres type (Broker, Importer, Notifying Party) Broker
company Optioneel Derde adres bedrijfsnaam. SelectCourier
name Verplicht Contacpersoon derde adres. David Black
email Optioneel Enailadres derde adres. test@selectcourier.com
phone Verplicht Telefoonnummer derde adres. 0123-456789
street_1 Verplicht Straatnaam derde adres. Teststreet
street_2 Optioneel Adresregel 2 derde adres, zoals gebouw, kamer of verdieping. 1st floor
street_3 Optioneel

Adresregel 3 derde adres, zoals kamer of verdieping.

 Room 212
street_no Verplicht Huisnummer derde adres. 27C
postal Conditioneel Postcode derde adres. Vereist indien geadresseerden land gebruik maakt van postcodes. 3045 AB
city Verplicht Plaatsnaam derde adres. Rotterdam
province Conditioneel Provincie/staat derde adres. Vereist voor de Verenigde Staten en Canada. Zuid Holland
country Verplicht Landcode derde adres. NL
eori Conditioneel EORI nummer derde adres.
(Economic Operators Registration
and Identification number).		  


Customs child elements:
Naam Vereist Beschrijving Voorbeeld
transport_costs Optioneel Transportkosten die op de douanefactuur worden vermeld. 120.00
insurance_costs Optioneel Verzekeringkosten die op de douanefactuur worden vermeld. 130.00
other_costs Optioneel Overige kosten die op de douanefactuur worden vermeld. 40.00
export_declaration Optional Export verklaring die op de douanefactuur worden vermeld. The exporter of the products covered by this document (customs authorization No………(1) declares that, except where otherwise clearly indicated, these products are of ………….(2) preferential origin.

Request code samples

JSON PHP 
{
  "action": "quote",
  "shipment": {
    "o_company": "Test",
    "o_name": "Test",
    "o_email": "test@test.com",
    "o_phone": "0000000",
    "o_eori": "",
    "o_street_1": "Test street",
    "o_street_no": "27B",
    "o_postal": "3045 AB",
    "o_city": "Rotterdam",
    "o_province": "",
    "o_country": "NL",
    "d_company": "Test",
    "d_name": "Test",
    "d_email": "test@test.com",
    "d_phone": "0000000",
    "d_eori": "",
    "d_street_1": "Test street ",
    "d_street_no": "35C",
    "d_postal": "1000",
    "d_city": "Brussels",
    "d_province": "",
    "d_country": "BE",
    "type": "Parcel",
    "reference": "AB0000",
    "stackable": "1",
    "items": [
      {
        "contents": "Keyboard",
        "value": "55.00",
        "weight": "5.0",
        "length": "50",
        "width": "15",
        "height": "5"
      },
      {
        "contents": "Electronic Device",
        "value": "10.00",
        "weight": "10",
        "length": "15",
        "width": "20",
        "height": "15",
        "products": [
          {
            "quantity": "2",
            "product_code": "023232",
            "o_country": "NL",
            "weight": "5.3",
            "description": "Headset",
            "value": "20.0",
            "value_currency": "EUR",
            "hs_code": "85183000"
          }
        ]
      }
    ]
  }
}
$request += array(
    "action" => "quote",
    "shipment" => array(
        "o_company" => "Test",
        "o_name" => "Test",
        "o_email" => "test@test.com",
        "o_phone" => "0000000",
        "o_eori" => "",
        "o_street_1" => "Test street",
        "o_street_no" => "27B",
        "o_postal" => "3045 AB",
        "o_city" => "Rotterdam",
        "o_province" => "",
        "o_country" => "NL",
        "d_company" => "Test",
        "d_name" => "Test",
        "d_email" => "test@test.com",
        "d_phone" => "0000000",
        "d_eori" => "",
        "d_street_1" => "Test street ",
        "d_street_no" => "35C",
        "d_postal" => "1000",
        "d_city" => "Brussels",
        "d_province" => "",
        "d_country" => "BE",
        "type" => "Parcel",
        "reference" => "AB0000",
        "stackable" => "1",
        "items" => array(
            array(
                "contents" => "Keyboard",
                "value" => "55.00",
                "weight" => "5.0",
                "length" => "50",
                "width" => "15",
                "height" => "5",
            ),
            array(
                "contents" => "Electronic Device",
                "value" => "10.00",
                "weight" => "10",
                "length" => "15",
                "width" => "20",
                "height" => "15",
                "products" => array(
                    array(
                        "quantity" => "2",
                        "product_code" => "023232",
                        "o_country" => "NL",
                        "weight" => "5.3",
                        "description" => "Headset",
                        "value" => "20.0",
                        "value_currency" => "EUR",
                        "hs_code" => "85183000",
                    )
                )
            )
        )
    )
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met
informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.


Result child elements
Naam Beschrijving Voorbeeld
services Dataset van oplossingen.  


Services child elements
Naam Beschrijving Voorbeeld
service_id Service ID 12604
courier_keycode Vervoerder keycode. sc
courier_name Naam van vervoerder. SELECTCOURIER
service_keycode Service keycode. EXPRESS WORLDWIDE
service_name Naam van service. Express Worldwide
etc Verwachtte collectie tijd (ETC). 2021-01-25 before 18:00
eta Verwachtte aflevertijd (ETA). 2021-01-25 before 23:30
origin_service_points Oorspronkelijke service punt beschikbaarheid indicator (1=beschikbaar, 0=niet beschikbaar). 1
destination_service_points Bestemming service punt  beschikbaarheid indicator (1=beschikbaar, 0=niet beschikbaar). 0
co2 CO2 beschikbaarheid indicator (1=beschikbaar, 0=niet beschikbaar). 1
co2_price CO2 prijs. 1.37
insurance Verzekering beschikbaarheid indicator(1=beschikbaar, 0=niet beschikbaar). 1
insurance_price Verzekering prijs. 9.38
sub_total Prijs zonder BTW. 18.00
vat_total BTW. 3.21
total_price Totale prijs. 21.21
currency Valuta. EUR

Response code samples

JSON PHP 
{
  "result": {
    "services": [
      {
        "service_id": 12613,
        "courier_keycode": "sc",
        "courier_name": "SELECT COURIER",
        "service_keycode": "EXPRESS 12:00",
        "service_name": "Express 12:00",
        "etc": "2021-01-25 before 20:00",
        "eta": "2021-01-25 before 12:00",
        "origin_service_points": 1,
        "destination_service_points": 1,
        "currency": "EUR",
        "co2": 1,
        "co2_price": 1.37,
        "insurance": 1,
        "insurance_price": 9.38,
        "sub_total": 29.91,
        "vat_total": 5.68,
        "total_price": 35.59
      }
    ]
  },
  "errors": []
}
$response = array(
    "result" => array(
        "services" => array(
            0 => array(
                "service_id" => 12613,
                "courier_keycode" => "sc",
                "courier_name" => "SELECT COURIER",
                "service_keycode" => "EXPRESS 12:00",
                "service_name" => "Express 12:00",
                "etc" => "2021-01-25 before 20:00",
                "eta" => "2021-01-25 before 12:00",
                "origin_service_points" => 1,
                "destination_service_points" => 1,
                "currency" => "EUR",
                "co2" => 1,
                "co2_price" => 1.37,
                "insurance" => 1,
                "insurance_price" => 9.38,
                "sub_total" => 29.91,
                "vat_total" => 5.68,
                "total_price" => 35.59
            )
        )
    ),
    "errors" => array()
);

Verzenden

Gebruik deze methode om een boeking te maken. Verzendinglabels worden gegenereerd als PDF. Vereist 'authentication request elements'.

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht  Beschrijft welk type verzoek naar de server wordt verzonden. ship
service_id Verplicht Service-ID opgehaald uit quote proces.  3851
co2 Optioneel Gebruik '1' om uw CO2 te compenseren. 0 (default value) or 1
insurance Optioneel Gebruik '1' om uw zending te verzekeren. 0 (default value) or 1
label_format Optioneel Beschrijft welk bestandstype uw document is.  PDF (default value) or ZPL 
d_sp_name Optioneel Naam service punt bestemming. Royal Mini Market 
d_sp_keycode Optioneel Service punt bestemming keycode. 1382551
d_sp_street_1 Optioneel Adres service punt bestemming. Burgemeester Baumannlaan 151
d_sp_street_2 Optioneel Adresregel 2 service punt bestemming.  
d_sp_street_3 Optioneel Adresregel 3 service punt bestemming.  
d_sp_postal Optioneel Postcode service punt bestemming. 3042 AC 
d_sp_city Optioneel Plaats service punt bestemming. Rotterdam
d_sp_province Optioneel Provincie service punt bestemming.  
d_sp_country Optioneel Landcode service punt bestemming. NL 

Request code samples

JSON PHP 
{
  "action": "ship",
  "service_id": "3851",
  "co2": 0,
  "insurance": 1
}
$request += array(
    "action" => "ship",
    "service_id" => "3851",
    "co2" => 0,
    "insurance" => 1
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met
informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten. 

Result child elements
Name Description Example
order_no Ordernummer. SCTEST
consignment_no Zendingsnummer vervoerder. COURIERCONN
label Label als PDF of ZPL.  
remarks Additionele documenten als PDF.  
items Zending item details.  

Response code samples

JSON PHP 
{
  "result": {
    "order_no": "SCTEST",
    "consignment_no": "COURIERCONN",
    "label": "DawNjE1MiAwMDAwMCBuIAp0cmFp...",
    "remarks": "RawNjE1MiAwMDAwMCBuIAp0cmFp..."
  },
  "errors": []
}
$response = array(
    "result" => array(
        "order_no" => "SCTEST",
        "consignment_no" => "COURIERCONN",
        "label" => "DawNjE1MiAwMDAwMCBuIAp0cmFp...",
        "remarks" => "RawNjE1MiAwMDAwMCBuIAp0cmFp...",
    ),
    "errors" => array()
);

Chauffeur inplannen

Gebruik deze methode om collecties in te plannen. Vereist 'authentication request elements'.

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht  Beschrijft welk type verzoek naar de server gestuurd wordt. Pickup
date Verplicht Collectie datum. 2022-01-01 
r_time Verplicht Ready time.   09:00
c_time Verplicht Closing time.  17:00
instructions Optioneel Instructies voor vervoerder.  Pickup at front door
shipments Verplicht Array van ordernummers.   
o_sp_name Optioneel Naam oorspronkelijk service punt. Royal Mini Market
o_sp_keycode Optioneel Keycode oorspronkelijk service punt. 1382551
o_sp_street_1 Optioneel Adres oorspronkelijk service punt. Burgemeester Baumannlaan 151
o_sp_street_2 Optioneel Adresregel 2 oorspronkelijk service punt.  
o_sp_street_3 Optioneel Adresregel 3 oorspronkelijk service punt.  
o_sp_postal Optioneel Postcode oorspronkelijk service punt. 3042 AC 
o_sp_city Optioneel Plaats oorspronkelijk service punt. Rotterdam 
o_sp_province Optioneel Provincie oorspronkelijk service punt.  
o_sp_country Optioneel Land oorspronkelijk service punt. NL 

Request code samples

JSON PHP 
{
  "action": "pickup",
  "date": "2021-01-24",
  "r_time": "09:00",
  "c_time": "17:00",
  "instuctions": "test collection",
  "shipments": [
    "SCXXXXXX1",
    "SCXXXXXX2"
  ]
}
$request += array(
    "action" => "pickup",
    "date" => "2021-01-24",
    "r_time" => "09:00",
    "c_time" => "17:00",
    "instuctions" => "test collection",
    "shipments" => array(
        "SCXXXXXX1", "SCXXXXXX2"
    )
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met
informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.
Result child elements
Naam Beschrijving Voorbeeld
collection_no Collectienummer. 12604
manifest Manifest gecodeerd als PDF.  

Response code samples

JSON PHP 
{
  "result": {
    "collection_no": "SCTEST",
    "manifest": "RawNjE1MiAwMDAwMCBuIAp0cmFp..."
  },
  "errors": []
}
$response = array(
    "result" => array(
        "collection_no" => "SCTEST",
        "manifest" => "RawNjE1MiAwMDAwMCBuIAp0cmFp..."
    ),
    "errors" => array()
);

Webhooks

Met webhooks kunt u eenvoudig trackingupdates toevoegen aan een specifieke URL. Om webhooks te activeren, voegt u uw URL toe in accountinstellingen. Wilt u zeker weten of het gelukt is? U kunt het meteen testen.

Wanneer er een event plaatsvindt, doet ons systeem een HTTP POST-verzoek naar uw geconfigureerde URL om de webhook te ontvangen. Webhook-data wordt naar de geconfigureerde URL verzonden als een webhook-payload in JSON-formaat.

Track & Trace

Gebruik deze methode om informatie over uw bestelling te ontvangen (status, locatie, datum, tijd).

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht  Beschrijft welk type verzoek naar de server wordt verzonden. track
order_numbers Verplicht Array van ordernummers.
(Voor tracking van meerdere zendingen)		 “SCXXXXXX1”, “SCXXXXXX2”

Request code samples

JSON PHP 
{
  "action": "track",
  "order_numbers": [
    "SCXXXXXX1",
    "SCXXXXXX2"
  ]
}
$request += array(
    "action" => "track",
    "order_numbers" => array(
        "SCXXXXXX1",
        "SCXXXXXX2"
    )
);

Response elements

Name Description
result Dit element bevat een reactie van de server met
informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.


Result child elements
Naam Beschrijving Voorbeeld
order_no Ordernummer. SCXXXXXX1
status Order status. Arranged
consignment_no Zendingnummer vervoerder. COURIERCONN
courier_keycode Vervoerder keycode. sc
courier_name Naam vervoerder. SELECTCOURIER
service_keycode Service keycode. EXPRESS_WORLDWIDE
service_name Service naam. Express Worldwide
items Array van items.  


Items child elements
Naam Beschrijving Voorbeeld
item_no Item nummer. SCXXXXXXX-1
status Item status. Arranged
tracking_no Tracking nummer. XXXXXXXXX
courier_tracking_link Hyperlink naar tracking van vervoerder. https://courier.com/trackingpage
trackings Array van track en trace informatie.  


Tracking child elements
Naam Beschrijving Voorbeeld
status Order status. Collected
courier_status Leveringsstatus van de zending vanaf de lokale gebeurtenisdatum en -tijd. Shipment collected
location Locatie waar de status is bijgewerkt. Rotterdam
date Datum en tijd waarop de status is bijgewerkt. 2021-01-24 15:46:59
signer De persoon die tekent voor ontvangst van de zending. J. Smith

Response code samples

JSON PHP 
{
  "result": {
      "order_no": "SCXXXXXX1",
      "status": "Collected",
      "consignment_no": "COURIERCONN",
      "courier_keycode": "sc",
      "courier_name": "SELECT COURIER",
      "service_keycode": "EXPRESS_WORLDWIDE",
      "service_name": "Express Worldwide",
      "items": [
        {
          "item_no": "SCXXXXXX1-1",
          "status": "Collected",
          "tracking_no": "XXXXXXXXX",
          "courier_tracking_link": "https:\/\/courier.com\/trackingpage",
          "trackings": [
            {
              "status": "Collected",
              "courier_status": "Shipment collected",
              "location": "Rotterdam",
              "date": "2021-01-24 15:46:59",
              "signer": ""
            }
          ]
        }
      ]
    },
    {
      "order_no": "SCXXXXXX2",
      "status": "Delivered",
      "consignment_no": "COURIERCONN",
      "courier_keycode": "sc",
      "courier_name": "SELECT COURIER",
      "service_keycode": "standard",
      "service_name": "Standard",
      "items": [
        {
          "item_no": "SCXXXXXX2-1",
          "status": "Booked",
          "tracking_no": "XXXXXXXXX",
          "courier_tracking_link": "https:\/\/courier.com\/trackingpage",
          "trackings": [
            {
              "status": "Delivered",
              "courier_status": "Delivered",
              "location": "Rotterdam",
              "date": "2017-06-07 10:55:45",
              "signer": "J. Smith"
            },
            {
              "status": "In Transit",
              "courier_status": "In Transit",
              "location": "Delft",
              "date": "2017-06-06 10:55:19",
              "signer": ""
            }
          ]
        }
      ]
    }
  ],
  "errors": []
}
$response = array(
    "result" => array(
        0 => array(
            "order_no" => "SCXXXXXX1",
            "status" => "Collected",
            "consignment_no" => "COURIERCONN",
            "courier_keycode" => "sc",
            "courier_name" => "SELECT COURIER",
            "service_keycode" => "EXPRESS_WORLDWIDE",
            "service_name" => "Express Worldwide",
            "items" => array(
                0 => array(
                    "item_no" => "SCXXXXXX1-1",
                    "status" => "Collected",
                    "tracking_no" => "XXXXXXXXX",
                    "courier_tracking_link" => "https://courier.com/trackingpage",
                    "trackings" => array(
                        0 => array(
                            "status" => "Collected",
                            "courier_status" => "Shipment collected",
                            "location" => "Rotterdam",
                            "date" => "2021-01-24 15:46:59",
                            "signer" => ""
                        )
                    )
                )
            )
        ),
        1 => array(
            "order_no" => "SCXXXXXX2",
            "status" => "Delivered",
            "consignment_no" => "COURIERCONN",
            "courier_keycode" => "sc",
            "courier_name" => "SELECT COURIER",
            "service_keycode" => "standard",
            "service_name" => "Standard",
            "items" => array(
                0 => array(
                    "item_no" => "SCXXXXXX2-1",
                    "status" => "Booked",
                    "tracking_no" => "XXXXXXXXX",
                    "courier_tracking_link" => "https://courier.com/trackingpage",
                    "trackings" => array(
                        0 => array(
                            "status" => "Delivered",
                            "courier_status" => "Delivered",
                            "location" => "Rotterdam",
                            "date" => "2017-06-07 10:55:45",
                            "signer" => "J. Smith"
                        ),
                        1 => array(
                            "status" => "In Transit",
                            "courier_status" => "In Transit",
                            "location" => "Delft",
                            "date" => "2017-06-06 10:55:19",
                            "signer" => ""
                        )
                    )
                )
            )
        )
    ),
    "errors" => array()
);

Labels

Gebruik deze methode om meerdere of enkele zendingslabels op te halen nadat er al een zending is aangemaakt. Vereist 'authentication request elements'.

Request elements

Naam Vereist Beschrijving Voorbeeld
order_numbers Verplicht Array van ordernummers.
(Voor tracking meerdere zendingen)		 “SCXXXXXX1”, “SCXXXXXX2”

Request code samples

JSON PHP 
{
  "action": "labels",
  "order_numbers": [
    "SCXXXXXX1",
    "SCXXXXXX2"
  ]
}
$request += array(
    "action" => "labels",
    "order_numbers" => array(
        "SCXXXXXX1",
        "SCXXXXXX2"
    )
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.


Result child elements:
Naam Beschrijving Voorbeeld
order_numbers Ordernummers. SCTEST
labels Labels gecodeerd als PDF of ZPL.  

Response code samples

JSON PHP 
{
  "result": {
    "order_numbers": [
      "SCXXXXXX1",
      "SCXXXXXX2"
    ],
    "labels": "DawNjE1MiAwMDAwMCBuIAp0cmFp..."
  },
  "errors": []
}
$response = array(
    "result" => array(
        "order_numbers" => array(
            "SCXXXXXX1",
            "SCXXXXXX2"
        ),
        "labels" => "DawNjE1MiAwMDAwMCBuIAp0cmFp..."
    ),
    "errors" => array()
);

Servicepunten

Deze methode wordt gebruikt om het adres, de openingstijden en de afstand van servicepunten op te vragen.
Er kunnen twee soorten verzoeken zijn, afhankelijk van het type servicepunt. Het eerste verzoek is het servicepunt van herkomst
waar de zending door de afzender wordt afgegeven. Voor dit type aanvraag is het ordernummer vereist.
Het tweede verzoek is het servicepunt van bestemming waar de zending wordt opgehaald door de ontvanger. Voor dit type aanvraag, is de quote service-ID vereist. Vereist 'authentication request elements'.

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht Beschrijft welk type verzoek naar de server wordt verzonden. service_points
type Verplicht Herkomst - servicepunt waar de zending door de afzender wordt afgegeven; Bestemming - servicepunt waar de zending wordt opgehaald door de ontvanger. “origin” or “destination”
order_no Conditioneel Ordernummer. Vereist voor servicepunten van het type herkomst. SCXXXXXXX
service_id Conditioneel Service-ID opgehaald uit offerteproces. Vereist voor servicepunten van het type bestemming. 3851

Request code samples

JSON PHP 
{
  "action": "service_points",
  "type": "origin",
  "order_no": "SCXXXXXXX"
}
$request += array(
    "action" => "service_points",
    "type" => "origin",
    "order_no" => "SCXXXXXXX"
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met
informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.

Result child elements:
Name Description Example
keycode Service punt keycode. 1382551
name Name van service punt. Royal Mini Market
street_1 Adres service punt. Burgemeester Baumannlaan 151
postal Postcode service punt. 3042 AC
city Plaats service punt. Rotterdam
country Land service punt. NL
lat Coördinaten service punt —breedtegraad. 51.9364411250671
lng Coördinaten service punt —lengtegraad. 4.42779022507839
business_hours Openingstijden service punt.   
distance Afstand in kilometers van service punt tot afzender / ontvanger.  Bepaald per type servicepunt. 2


Openingstijden child elements:
Naam Beschrijving Voorbeeld
Monday Openingstijden servicepunt op maandag. 08.00-17.30
Tuesday Openingstijden servicepunt op dinsdag. 08.00-17.30
Wednesday Openingstijden servicepunt op woensdag. 08.00-17.30
Thursday Openingstijden servicepunt op donderdag. 08.00-17.30
Friday Openingstijden servicepunt op vrijdag. 08.00-17.30
Saturday Openingstijden servicepunt op zaterdag. 08.00-17.30
Sunday Openingstijden servicepunt op zondag. 08.00-17.30

Response code samples

JSON PHP 
{
  "result": [
    {
      "keycode": "1382551",
      "name": "Royal Mini Market",
      "street_1": "Burgemeester Baumannlaan 151",
      "postal": "3042 AC",
      "city": "Rotterdam",
      "country": "NL",
      "lat": "51.9364411250671",
      "lng": "4.42779022507839",
      "business_hours": {
        "Monday": "08.00-20.00",
        "Tuesday": "08.00-20.00",
        "Wednesday": "08.00-20.00",
        "Thursday": "08.00-20.00",
        "Friday": "08.00-20.00",
        "Saturday": "08.00-20.00",
        "Sunday": []
      },
      "distance": 2
    },
    {
      "keycode": "1364013",
      "name": "Primera",
      "street_1": "Burgemeester Baumannlaan 191",
      "postal": "3042 AD",
      "city": "Rotterdam",
      "country": "NL",
      "lat": "51.9345596226563",
      "lng": "4.42854295007801",
      "business_hours": {
        "Monday": "08.00-17.30",
        "Tuesday": "08.00-17.30",
        "Wednesday": "08.00-17.30",
        "Thursday": "08.00-17.30",
        "Friday": "08.00-17.30",
        "Saturday": "10.00-17.00",
        "Sunday": []
      },
      "distance": 2.16
    }
  ],
  "errors": []
}
$response = array(
    "result" => array(
        0 => array(
            "keycode" => "1382551",
            "name" => "Royal Mini Market",
            "street_1" => "Burgemeester Baumannlaan 151",
            "postal" => "3042 AC",
            "city" => "Rotterdam",
            "country" => "NL",
            "lat" => "51.9364411250671",
            "lng" => "4.42779022507839",
            "business_hours" => array(
                "Monday" => "08.00-20.00",
                "Tuesday" => "08.00-20.00",
                "Wednesday" => "08.00-20.00",
                "Thursday" => "08.00-20.00",
                "Friday" => "08.00-20.00",
                "Saturday" => "08.00-20.00",
                "Sunday" => array()
            ),
            "distance" => 2
        ),
        1 => array(
            "keycode" => "1364013",
            "name" => "Primera",
            "street_1" => "Burgemeester Baumannlaan 191",
            "postal" => "3042 AD",
            "city" => "Rotterdam",
            "country" => "NL",
            "lat" => "51.9345596226563",
            "lng" => "4.42854295007801",
            "business_hours" => array(
                "Monday" => "08.00-17.30",
                "Tuesday" => "08.00-17.30",
                "Wednesday" => "08.00-17.30",
                "Thursday" => "08.00-17.30",
                "Friday" => "08.00-17.30",
                "Saturday" => "10.00-17.00",
                "Sunday" => array()
            ),
            "distance" => 2.16
        )
    ),
    "errors" => array()
);

Upload documenten

Gebruik deze methode om documenten voor uw zending te uploaden die nodig zijn voor douane- en andere doeleinden.

Request elements

Naam Vereist Beschrijving Voorbeeld
action Verplicht  Beschrijft welk type verzoek naar de server wordt verzonden. upload_documents
order_no Verplicht Ordernummer SCXXXXXX1
documents Verplicht Array van documents.  


Documents child elements
Naam Vereist Beschrijving Voorbeeld
document_type Verplicht Mogelijke waardes "Customs Invoice" of "Certificate of Origin" Customs Invoice
name Verplicht Naam Customs Invoice.pdf
type Verplicht Type application/pdf
content Verplicht Met Base64 gecodeerde inhoud van het bestand. DawNjE1MiAwMDAwMCBuIAp0cmFp...

Request code samples

JSON PHP 
{
  "action": "upload_documents",
  "order_no": "SCXXXXXX1",
  "documents": [
     {
       "document_type": "Customs Invoice",
       "name": "Customs Invoice.pdf",
       "type": "application/pdf",
       "content": "DawNjE1MiAwMDAwMCBuIAp0cmFp..."
     }
   ]
}
$request += array(
    "action" => "upload_documents",
    "order_no" => "SCXXXXXX1",
    "documents" => array(
        0 => array(
            "document_type" => "Customs Invoice",
            "name" => "Customs Invoice.pdf"
            "type" => "application/pdf",
            "content" => "DawNjE1MiAwMDAwMCBuIAp0cmFp..."
        )
     )
);

Response elements

Naam Beschrijving
result Dit element bevat een reactie van de server met informatie over beschikbare diensten en prijzen.
errors Dit element bevat error berichten.


Result child elements:
Naam Beschrijving Voorbeeld
success Succes. 1

Response code samples

JSON PHP 
{
  "result": {
    "success": "1"
  },
  "errors": []
}
$response = array(
    "result" => array(
        "success" => "1"
    ),
    "errors" => array()
);

Ga naar productie

Onze API gebruikt standaard een ontwikkelomgeving (sandbox).
Wanneer u klaar bent met het testen van de vereiste methoden, kunt u de omgevingsvariabele die in de 'request elements' is doorgegeven, wijzigen in 'production', zodat u daadwerkelijk kunt beginnen met het verzenden van uw zendingen via ons platform.

Request elements

Naam Vereist Beschrijving Voorbeeld
environment Verplicht Gebruik 'production' omgeving Om te starten met verzenden. “production” or “development”
account Optioneel Gebruikt indien een gebruiker meerdere accounts heeft.  

Request code samples

JSON PHP 
{
  "environmet": "production"
  "action": "ship",
  ....
}
$request += array(
    "environmet" => "production"
    "action" => "ship",
    ...
);

Registreer gratis en ontdek ons innovatief verzendplatform.

Start direct met verzenden, haal nóg meer uit uw account en profiteer van extra voordelen met onze integratiemodules.

Select Courier Connect

€ 125,-

per maand

Koppel eenvoudig uw eigen transportcontract en bedrijfssoftware!

  • Alle functionaliteiten van 'Select Courier platform'.
  • Koppel één eigen vervoerscontract, zoals DHL, PostNL, DPD, UPS en veel meer.
  • Max. 1500 zendingen per maand.
  • Onbeperkt koppelen met webshops, zoals: WooCommerce, Magento en Shopify.
  • Eén marketplace integratie, zoals Bol.com en Ebay. Uitbreiding mogelijk.
  • Koppel één bedrijfssysteem zoals, AFAS en Exact. Uitbreiding mogelijk.
  • Resource management.
  • *additionele toepassingen beschikbaar. Contacteer Sales. 
Module aanvragen

Select Courier Platform

Gratis

account

Hét zakelijke verzendplatform voor al uw wereldwijde zendingen!

  • Onbeperkt verzenden op onze vervoerscontracten.
  • Multi-Carrier Solutions.
  • Aantrekkelijke all-in tarieven opvragen.
  • Creëer verzendlabels en regel de chauffeur.
  • Realtime transittijden en tracking.
  • Ordermanagement.
  • Gebruikersmanagement.
  • Verzenddocumentatie beheer.
  • Gepersonaliseerde notificaties.
  • Automatisch adressen valideren.
  • Geïntegreerde Proof of Delivery (POD).
  • Zendingen additioneel verzekeren tot € 100.000,-.
  • Geïntegreerde CO₂-calculator
  • Data exporteren.
  • Betrokken klantenservice en advies.
  • API beschikbaar.
Gratis account

Select Courier Connect+

€ 175,-

per maand

Uitgebreide integratie van uw gepersonaliseerde verzendproces

  • Alle functionaliteiten van 'Select Courier Connect'.
  • Koppel twee eigen vervoerscontracten, zoals DHL, PostNL, DPD, UPS en veel meer.
  • Max. 2500 zendingen per maand.
  • Meerdere marketplace integraties.
  • Twee bedrijfssoftware koppelingen. Uitbreiding mogelijk.
  • Rapportages
  • Slimme verzendregels aanmaken.
  • Gevaarlijke goederen versturen
  • **additionele toepassingen beschikbaar. Contacteer Sales. 
Module aanvragen

Wilt u meer weten over de verzendoplossingen van Select Courier?

Heeft u andere vragen of opmerkingen? Neem contact met ons op.

+31 (0) 10 223 7006
Adres

Rotterdam Airportplein 27
3045 AP Rotterdam
Nederland

Bedrijfsinformatie

KvK: 52767574
BTW Nr./TAX ID: NL823638017B03

Stuur ons een email

Heeft u vragen over het versturen van uw zendingen, ons platform en diensten of over iets heel anders? Onze Customer Service staat van maandag t/m vrijdag van 08:45 t/m 17:30 uur voor u klaar.

api
Om u de beste ervaring te bieden, stemmen we onze site af op uw behoeften door instellingen en keuzes in cookies op te slaan.
Kijk hier voor meer informatie over cookies of om onze cookies niet toe te staan.