Comparative Rate

Preventive analysis of shipment costs

The Comparative Network endpoint allows to estimate in advance the costs of a shipment via your (active or passive) price lists, that have been saved on Gsped, such as;

• Rental (base cost of the shipment)

• Predictable incidental expenses

  • COD Cost

  • Insurance cost

  • FUEL

  • Remote areas or islands

  • Additional services (delivery to the floor or on Saturday, etc)

  • Charges due to oversize

  • Etc.

There are two kinds of rating:

• ACTIVE: needs a costs analysis only related to active price lists

• PASSIVE:costs analysis related to the price lists agreed upon with the courier in the contracting stage. This modality takes account of the ACTIVE rating to compare the shipping costs and incomes.

ComparativeRate

GET https://api.gsped.it/[INSTANCE]/RateComparativa

Path Parameters

Name	Type	Description
istanza	string	Instance to call; if not setted, redirected on shared instance.

Query Parameters

Name	Type	Description
departure_date_time	string	Datetime in YYYY-MM-DD HH:MM:SS format. \ If not valued, the datetime is setted at the time of request.
tipo_listino	string	{attivo|passivo} Identifies the kind of rating to execute \ PLEASE NOTE:If PASSIVE, both are returned
gls_exchange	string	{N|S} Identifies the request for EXCHANGE service to the GSped courier.
al_piano	string	{0|1} Identifies if the delivery to the floor is requested (only if the service is provided by the courier)
al_sabato	string	{0|1} Identifies if the Saturday delivery is requested (only if the service is provided by the courier)
client_id	integer	Client ID to be rated
invoiced_client_id	integer	Client ID to be rated with the ACTIVE costs in the RESELLER instances.
colli	integer	Number of parcels of the shipment
daticolli	array	Parcel size in CM | KG | CU M \ - height \ - width \ - lenght \ - weight \ - volume
peso	number	Overall weight of the shipment (KG)
volume	number	Total volume of the shipment (M CU)
sender_addr	string	Adress of the sender
sender_city	string	City of the sender
sender_prov	string	Province code of the sender
sender_cap	string	Zip code of the sender
sender_country_code	string	ISO 2 code of the sender's country
rcpt_addr	string	Address of the recipient
rcpt_city	string	City of the recipient
rcpt_prov	string	Province code of the recipient
rcpt_cap	string	Zip code of the recipient
rcpt_country_code	string	ISO 2 code of the recipient's country
contrassegno	number	COD value
valore	number	Amount of the insurance
documenti	string	{0|1} Identifies a document shipment
preavviso_telefonico	string	{S|N} Identifies if a telephone notice is required

Headers

Name	Type	Description
accept	string	Gzip,deflate
x-api-key	string	Authentication Key given by GSped

Some example snippets in different languages:

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.gsped.it/sandbox/RateComparativa?colli=1&contrassegno=&documenti=&peso=104&preavviso_telefonico=&rcpt_addr=via%20felrina%20sud%20172&rcpt_cap=31044&rcpt_city=Montebelluna&rcpt_country_code=IT&rcpt_prov=BG&sender_addr=VIA%20FERRANTE%20CARACCIOLO&sender_cap=24040&sender_city=LECCE&sender_country_code=IT&sender_prov=BG&tipo_listino=passivo&valore=&volume=0&invoiced_client_id=1249",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "Accept: */*",
    "Cache-Control: no-cache",
    "Connection: keep-alive",
    "Host: apigsped.it",
    "accept-encoding: gzip, deflate",
    "cache-control: no-cache",
    "x-api-key: YOUR_API_KEY"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

GO

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.gsped.it/sandbox/RateComparativa?colli=1&contrassegno=&documenti=&peso=104&preavviso_telefonico=&rcpt_addr=via%20felrina%20sud%20172&rcpt_cap=31044&rcpt_city=Montebelluna&rcpt_country_code=IT&rcpt_prov=BG&sender_addr=VIA%20FERRANTE%20CARACCIOLO&sender_cap=24040&sender_city=LECCE&sender_country_code=IT&sender_prov=BG&tipo_listino=passivo&valore=&volume=0&invoiced_client_id=1249"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "YOUR_API_KEY")
	req.Header.Add("Accept", "*/*")
	req.Header.Add("Cache-Control", "no-cache")
	req.Header.Add("Host", "api.gsped.it")
	req.Header.Add("accept-encoding", "gzip, deflate")
	req.Header.Add("Connection", "keep-alive")
	req.Header.Add("cache-control", "no-cache")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

PYTHON

import requests

url = "https://api.gsped.it/sandbox/RateComparativa"

querystring = {"colli":"1","contrassegno":"","documenti":"","peso":"104","preavviso_telefonico":"","rcpt_addr":"via%20felrina%20sud%20172","rcpt_cap":"31044","rcpt_city":"Montebelluna","rcpt_country_code":"IT","rcpt_prov":"BG","sender_addr":"VIA%20FERRANTE%20CARACCIOLO","sender_cap":"24040","sender_city":"LECCE","sender_country_code":"IT","sender_prov":"BG","tipo_listino":"passivo","valore":"","volume":"0","invoiced_client_id":"1249"}

headers = {
    'x-api-key': "YOUR_API_KEY",
    'Accept': "*/*",
    'Cache-Control': "no-cache",
    'Host': "api.gsped.it",
    'accept-encoding': "gzip, deflate",
    'Connection': "keep-alive",
    'cache-control': "no-cache"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

C#

var client = new RestClient("https://api.aws.gsped.it/sandbox/RateComparativa?colli=1&contrassegno=&documenti=&peso=104&preavviso_telefonico=&rcpt_addr=via%20felrina%20sud%20172&rcpt_cap=31044&rcpt_city=Montebelluna&rcpt_country_code=IT&rcpt_prov=BG&sender_addr=VIA%20FERRANTE%20CARACCIOLO&sender_cap=24040&sender_city=LECCE&sender_country_code=IT&sender_prov=BG&tipo_listino=passivo&valore=&volume=0&invoiced_client_id=1249");
var request = new RestRequest(Method.GET);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("Connection", "keep-alive");
request.AddHeader("accept-encoding", "gzip, deflate");
request.AddHeader("Host", "api.gsped.it");
request.AddHeader("Cache-Control", "no-cache");
request.AddHeader("Accept", "*/*");
request.AddHeader("x-api-key", "YOUR_API_KEY");
IRestResponse response = client.Execute(request);

JAVA

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("http://api.gsped.it/sandbox/RateComparativa?client_id=0000002&colli=1&contrassegno=&documenti=&peso=104&preavviso_telefonico=&rcpt_addr=via%20felrina%20sud%20172&rcpt_cap=31044&rcpt_city=Montebelluna&rcpt_country_code=IT&rcpt_prov=BG&sender_addr=VIA%20FERRANTE%20CARACCIOLO&sender_cap=24040&sender_city=LECCE&sender_country_code=IT&sender_prov=BG&tipo_listino=passivo&valore=&volume=0&invoiced_client_id=1249")
  .get()
  .addHeader("x-api-key", "YOUR_API_KEY")
  .addHeader("Accept", "*/*")
  .addHeader("Cache-Control", "no-cache")
  .addHeader("Host", "apistaging.aws.gsped.it")
  .addHeader("accept-encoding", "gzip, deflate")
  .addHeader("Connection", "keep-alive")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();