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
BRT* (1)
Sì
Sì
TNT* (2)
Sì
Sì
PDB Inviosystem (19)
Sì
Sì
Dummy1 (70)
Sì
Sì
Dummy2 (71)
Sì
Sì
Dummy3 (72)
Sì
Sì
Dummy4 (73)
Sì
Sì
Dummy5 (74)
Sì
Sì
Dummy6 (75)
Sì
Sì
Dummy7 (76)
Sì
Sì
Dummy8 (77)
Sì
Sì
Dummy9 (78)
Sì
Sì
Dummy10 (79)
Sì
Sì
Italsempione (90)
Sì
Sì
Logisticando (91)
Sì
Sì
CSI Logistica (92)
Sì
Sì
Ribosped (93)
Sì
Sì
Zust - Tiesse (94)
Sì
Sì
Lynx (95)
Sì
Sì
Speditalia (97)
Sì
Sì
SVL (98)
Sì
Sì
ARCO (100)
Sì
Sì
GLS (101)
Sì
No
Fercam (131)
Sì
Sì
ALT (178)
Sì
Sì
LICCARDI (179)
Sì
Sì
DHL WLA (182)
Sì
Sì
Ferrari Trasporti (190)
Sì
Sì
Bracchi (191)
Sì
Sì
Sending (192)
Sì
Sì
Rhenus Logistics (193)
Sì
Sì
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.
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
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
{
"id_collo": 2,
"id_sped": "123456789",
"labels": {
"jpg": "Stringa base64",
"pdf": "Stringa base64",
"zpl": "Stringa ZPL"
},
"tracking_collo": "JJD01111111111"
}
Oggetto Collo
peso
integer
X
volume
float
X
larghezza
integer
X
altezza
integer
X
lunghezza
integer
X
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"
}
}
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;
}
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
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;
}
Last updated
Was this helpful?