Add Parcel

Gestione dei colli in modo dinamico

Generalità

La funzionalità Add Parcel da la possibilità, una volta creata la spedizione principale, di aggiungere o rimuovere colli in modo indipendente ottenendo le relative etichette.

Lista corrieri supportati

* vedi note

CORRIERE (ID Gsped)

AGGIUNTA COLLI

RIMOZIONE COLLI

BRT* (1)

Sì

TNT* (2)

Sì

DPDFrance (6)

PDB Inviosystem (19)

Sì

Fedex (20)

RKS (28)

Dummy1 (70)

Sì

Dummy2 (71)

Sì

Dummy3 (72)

Sì

Dummy4 (73)

Sì

Dummy5 (74)

Sì

Dummy6 (75)

Sì

Dummy7 (76)

Sì

Dummy8 (77)

Sì

Dummy9 (78)

Sì

Dummy10 (79)

Sì

Italsempione (90)

Sì

Logisticando (91)

Sì

CSI Logistica (92)

Sì

Ribosped (93)

Sì

Zust - Tiesse (94)

Sì

Lynx (95)

Sì

Speditalia (97)

Sì

SVL (98)

Sì

ARCO (100)

Sì

GLS (101)

Sì

Fercam (131)

Sì

ALT (178)

Sì

LICCARDI (179)

Sì

DHL WLA (182)

Sì

Ferrari Trasporti (190)

Sì

Bracchi (191)

Sì

Sending (192)

Sì

Rhenus Logistics (193)

Sì

La lista dei corrieri abilitati è soggetta a modifiche, si prega i verificare gli aggiornamenti ad intervalli regolari

Note sui corrieri

BRT -> solamente soluzione B2
TNT -> solo per la stessa data di creazione etichetta e prima della data/ora ritiro della stessa. Se necessario allungare questa data consultare sezione Data previsto affidamento
ALT e Liccardi -> comunicare a Gsped l'intenzione di effettuare chiamate di Add/Delete Parcels (richiede un cambio di configurazione)

Logica di funzionamento processo Add Parcel

Per utilizzare nel modo corretto la funzionalità Add Parcel bisogna utilizzare 3 endpoint:

Shipment POST - Per la creazione della spedizione
Parcels POST o DELETE - Per l'aggiunta o la rimozione dei colli
ShipmentConfirm POST - Per la conferma finale della spedizione e relativa chiusura alle modifiche

ATTENZIONE: La rimozione dell'unico collo di una spedizione equivale alla cancellazione della stessa.

ATTENZIONE: La conferma di una spedizione inibisce la possibilità di aggiungere o rimuover colli da una spedizione

Aggiunta singolo collo a spedizione

POST https://api.gsped.it/[istanza]/Parcels

Body in JSON. Utilizzabile in 2 modi: 1 - Solo con ID spedizione + dati del collo 2 - Dati del destinatario + dati del collo

Request Body

Name

Type

Description

id_sped*

String

ID univoco Gsped

ddt_alpha*

String

Riferimento alfanumerico della spedizione

rcpt_cap*

String

Cap destinatario

rcpt_city*

String

Città destinatario

rcpt_addr*

String

Indirizzo destinatario

rcpt_name*

String

Nome destinatario

rcpt_prov*

String

Provincia/Stato destinatario

rcpt_country_code*

String

Nazione destinatario iso code 2 char

collo*

Object

Dati del collo

{
    "id_collo": 2,
    "id_sped": "123456789",
    "labels": {
        "jpg": "Stringa base64",
        "pdf": "Stringa base64",
        "zpl": "Stringa ZPL"
    },
    "tracking_collo": "JJD01111111111"
}

Oggetto Collo

Attributo

Tipo

Required

peso

integer

volume

float

larghezza

integer

altezza

integer

lunghezza

integer

codice_collo

string

Esempio Payload Parcels POST

{
  "id_sped":"1234567",
  "collo": {
    "peso": "5",
    "volume": "0.01",
    "larghezza": "35",
    "altezza": "15",
    "lunghezza": "10",
    "codice_collo": "identificativo1234"
  }
}

{
  "ddt_alpha":"test_parcel_8",
  "rcpt_name":"Rossi Gino",
  "rcpt_addr":"Via Milano 8",
  "rcpt_cap":"20123",
  "rcpt_city":"Milano",
  "rcpt_prov":"MI",
  "rcpt_country_code" : "IT",
  "collo": {
    "peso": "5",
    "volume": "0.01",
    "larghezza": "35",
    "altezza": "15",
    "lunghezza": "20",
    "codice_collo": "identificativo1234"
  }
}

Snippet codice di esempio Parcel POST

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gsped.it/sandbox/Parcels",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\n  \"id_sped\":\"1\",\n  \"collo\": {\n    \"peso\": \"5\",\n    \"volume\": \"0.01\",\n    \"larghezza\": \"35\",\n    \"altezza\": \"15\",\n    \"lunghezza\": \"10\"\n  }\n}",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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;
}

import http.client

conn = http.client.HTTPSConnection("api.gsped.it")

payload = "{\n  \"id_sped\":\"1\",\n  \"collo\": {\n    \"peso\": \"5\",\n    \"volume\": \"0.01\",\n    \"larghezza\": \"35\",\n    \"altezza\": \"15\",\n    \"lunghezza\": \"10\"\n  }\n}"

headers = {
    'Content-Type': "application/json",
    'x-api-key': "YOUR-API-KEY"
    }

conn.request("POST", "/sandbox/Parcels", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"id_sped\":\"1\",\n  \"collo\": {\n    \"peso\": \"5\",\n    \"volume\": \"0.01\",\n    \"larghezza\": \"35\",\n    \"altezza\": \"15\",\n    \"lunghezza\": \"10\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "YOUR-API-KEY")

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

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

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

}

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.gsped.it/sandbox/Parcels"),
    Headers =
    {
        { "x-api-key", "YOUR-API-KEY" },
    },
    Content = new StringContent("{\n  \"id_sped\":\"1\",\n  \"collo\": {\n    \"peso\": \"5\",\n    \"volume\": \"0.01\",\n    \"larghezza\": \"35\",\n    \"altezza\": \"15\",\n    \"lunghezza\": \"10\"\n  }\n}")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

curl --request POST \
  --url https://api.gsped.it/sandbox/Parcels \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR-API-KEY' \
  --data '{
  "id_sped":"1",
  "collo": {
    "peso": "5",
    "volume": "0.01",
    "larghezza": "35",
    "altezza": "15",
    "lunghezza": "10"
  }
}'

Rimozione collo da spedizione

DELETE https://api.gsped.it/[istanza]/Parcels

Form Url-Encoded Body Utilizzabile in 2 modi: 1 - Solo con ID spedizione + dati del collo 2 - Dati del destinatario + dati del collo

Request Body

Name

Type

Description

id_sped

String

ID univoco Gsped

ddt_alpha

String

Riferimento alfanumerico spedizione

rcpt_name

String

Nome destinatario

rcpt_addr

String

Indirizzo destinatario

rcpt_city

String

Città destinatario

rcpt_cap

String

Cap destinatario

rcpt_prov

String

Provincia/Stato destinatario

rcpt_country_code

String

Nazione destinatario iso code 2 char

{
    "id": "50000723",
    "num_spedizione": "7004525883",
    "num_collo": 1
}

Snippet di codice esempio Parcels DELETE

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gsped.it/sandbox/Parcels",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => "id_sped=69562763",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded",
    "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;
}

import http.client

conn = http.client.HTTPSConnection("api.gsped.it")

payload = "id_sped=69562763"

headers = {
    'Content-Type': "application/x-www-form-urlencoded",
    'x-api-key': "YOUR-API-KEY"
    }

conn.request("DELETE", "/sandbox/Parcels", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

package main

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

func main() {

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

	payload := strings.NewReader("id_sped=69562763")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
	req.Header.Add("x-api-key", "YOUR-API-KEY")

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

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

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

}

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Delete,
    RequestUri = new Uri("https://api.gsped.it/sandbox/Parcels"),
    Headers =
    {
        { "x-api-key", "YOUR-API-KEY" },
    },
    Content = new FormUrlEncodedContent(new Dictionary<string, string>
    {
        { "id_sped", "69562763" },
    }),
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}c

curl --request DELETE \
  --url https://api.gsped.it/sandbox/Parcels \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'x-api-key: YOUR-API-KEY' \
  --data id_sped=69562763

PreviousUpload Documents NextCloseDoc

Last updated 22 days ago

Was this helpful?

hashtagGeneralità

hashtagLista corrieri supportati

hashtagLogica di funzionamento processo Add Parcel

hashtagAggiunta singolo collo a spedizione

hashtagRequest Body

hashtagOggetto Collo

hashtagEsempio Payload Parcels POST

hashtagSnippet codice di esempio Parcel POST

hashtagRimozione collo da spedizione

hashtagRequest Body

hashtagSnippet di codice esempio Parcels DELETE

Generalità

Lista corrieri supportati

Logica di funzionamento processo Add Parcel

Aggiunta singolo collo a spedizione

Request Body

Oggetto Collo

Esempio Payload Parcels POST

Snippet codice di esempio Parcel POST

Rimozione collo da spedizione

Request Body

Snippet di codice esempio Parcels DELETE