Add Parcel
Dynamic parcel handling
General information
The function adds parcel allows adding or remove the parcels in full autonomy, with their corresponding labels.
List of enabled couriers
* see notes
BRT* (1)
Yes
Yes
TNT* (2)
Yes
Yes
PDB Inviosystem (19)
Yes
Yes
Dummy1 (70)
Yes
Yes
Dummy2 (71)
Yes
Yes
Dummy3 (72)
Yes
Yes
Dummy4 (73)
Yes
Yes
Dummy5 (74)
Yes
Yes
Dummy6 (75)
Yes
Yes
Dummy7 (76)
Yes
Yes
Dummy8 (77)
Yes
Yes
Dummy9 (78)
Yes
Yes
Dummy10 (79)
Yes
Yes
Italsempione (90)
Yes
Yes
Logisticando (91)
Yes
Yes
CSI Logistica (92)
Yes
Yes
Ribosped (93)
Yes
Yes
Zust - Tiesse (94)
Yes
Yes
Lynx (95)
Yes
Yes
Speditalia (97)
Yes
Yes
ARCO (100)
Yes
Yes
GLS (101)
Yes
No
Fercam (131)
Yes
Yes
Liccardi (179)
Yes
Yes
DHL WLA (182)
Yes
Yes
The list of enabled couriers is subject to change and modifications.
How the Add Parcel function works
To successfully use the Add Parcel function 3 endpoints must be used:
Shipment POST - For the shipment creation
Parcels POST or DELETE - To add or remove the parcels
ShipmentConfirm POST - For the final shipment confimation. You will no longer be able to change.
PLEASE NOTE: the removal of a parcel in a single-parcel shipment automatically cancels of the shipment.
PLEASE NOTE: the final confirmation blocks the possibility to add or remove one or more parcels from the shipment
Add a single parcel to a shipment
POST
https://api.gsped.it/[INSTANCE]/Parcels
Body in JSON.
\
It works in 2 ways: \
1 - Shipment ID + parcel data
\
2 - Recepient data + parcel data
Request Body
id_sped*
String
Unique Gsped ID
ddt_alpha*
String
Alphanumerical reference of the shipment
rcpt_name*
String
Name of the recepient
rcpt_addr*
String
Address of the recepient
rcpt_city*
String
City of the recepient
rcpt_cap*
String
Zip code of the recepient
rcpt_prov*
String
Province/country of the recepient
rcpt_country_code*
String
Country of the recepient iso code 2 char
collo*
Object
Parcel data
Parcel object
peso (weight)
integer
X
volume
float
X
larghezza (width)
integer
X
altezza (height)
integer
X
lunghezza (lenght)
integer
X
Example of Payload Parcels POST
Example of Snippet Parcel POST
Parcel removal from shipment
DELETE
https://api.gsped.it/[INSTANCE]/Parcels
Form Url-Encoded Body
It works in 2 ways: \
1 Shipment ID + parcel data
\
2 Recepient data + parcel data
Request Body
id_sped
String
Unique Gsped ID
ddt_alpha
String
Alphanumerical shipment reference
rcpt_name
String
Name of the recepient
rcpt_addr
String
Adress of the recepient
rcpt_city
String
City of the recepient
rcpt_cap
String
Zip code of the recepient
rcpt_prov
String
Province/country of the recipient
rcpt_country_code
String
Country of the recepient (iso code 2 char)
Example Snippet Parcels DELETE
Notes
When the customer makes a shipment with AddParcel, it is possible to trace back to the original creation date from the label creation dates, which are visible in the designated bucket on S3.
Last updated