BulkShipment - createMaster

BulkShipment/createMaster

POST https://api.gsped.it/[ISTANZA]/BulkShipment/createMaster

Questo endpoint permette di creare una spedizione consolidata.

Headers

Nome	Descrizione
x-api-key	Apikey fornita da Gsped

Body

Nome	Tipo	Obbligatorio	Descrizione
rcpt_addr	string	Si	Indirizzo del destinatario
rcpt_country_code	string	Si	Nazione destinatario sigla iso 2 char
rcpt_cap	string	Si	CAP del destinatario
rcpt_city	string	Si	Città del destinatario
rcpt_contact	string	No	Persona di contatto presso il destinatario
rcpt_email	string	No	Email del destinatario
rcpt_name	string	Si	Ragione sociale del destinatario
rcpt_phone	string	No	Numero di telefono del destinatario. Obbligatorio per : - DHL
rcpt_prov	string	No	Provincia del destinatario
sender_addr	string	No	Indirizzo del mittente
sender_country_code	string	No	Nazione mittente sigla iso 2 char
sender_cap	string	No	CAP del mittente
sender_city	string	No	Città del mittente
sender_contact	string	No	Persona di contatto presso il mittente
sender_email	string	No	Email del mittente
sender_name	string	No	Ragione sociale del mittente
sender_phone	string	No	Numero di telefono del mittente
sender_prov	string	No	Provincia del mittente
corriere	int	Si	Codice identificativo del corriere da utilizzare
servizio	int	Si	Codice identificativo del servizio. Particolarità : - Per DHL questo campo deve essere valorizzato a 11, che corrisponde al servizio consolidate (BBX)
client_id	int	Si	Codice identificativo del anagrafica dove si trova la configurazione specifica del corriere
pallets	int	Si	Numero di pallets di cui sarà composta la spedizione consolidata
ddt_alpha	string	No	Riferimento alfanumerico
ddt_num	int	No	Riferimento numerico
dati_pallets	array	Si	Array che contiene i dettagli dei singoli pallet
dati_pallets.*.altezza	int	No	Altezza del pallet
dati_pallets.*.larghezza	int	Si	Larghezza del pallet
dati_pallets.*.lunghezza	int	Si	Lunghezza del pallet
dati_pallets.*.volume	float	No	Volume del pallet
date_req_ritiro	string	No	Data di richiesta di ritiro nel formatto YYYY-MM-DD
opening_time	string	No	Orario in formato HH.MM:SS
closing_time	string	No	Orario in formato HH.MM:SS
labelType	string	No	Formato delle etichette da richiedere al corriere. Valori ammessi : - ZPL - PDF
merce	string	Si	Breve descrizione del contenuto della spedizione.
valuta	string	No	Valuta del valore della merce spedita
uploadDocAfterwards	bool	No	Indica che per la spedizione consolidata che si sta creando si vuole caricare i documenti in un secondo momento
addebito_dogana	int	No	Valori ammessi : 1 --> Addebito al mittente 2 --> Addebito a terzo Obbligatorio per : - DHL
iorAccount	string	No	Codice cliente importatore
iorCountryCode	string	No	Nazione in cui è radcato il codice cliente importatore

ATTENZIONE:

L'indirizzo di destino della spedizione consolidata dovrebbe essere l'HUB del corriere nel paese di destino.

Nel caso si DHL il corriere ci segnala quanto segue :

Il destinatario della Spedizione madre deve essere data da DHL (è il nostro punto di accesso doganale del paese)

Il rappresentante sales se non lo sa, deve chiedere al reparto DHL COG Italy.

Esempio di richiesta :

{
    "rcpt_addr": "Franklin House, 19 Crown Rd",
    "rcpt_cap": "EN1 1TH",
    "rcpt_city": "Enfield",
    "rcpt_contact": "DHL HUB GB",
    "rcpt_country_code": "GB",
    "rcpt_email": "[e-mail]",
    "rcpt_name": "DHL HUB GB",
    "rcpt_phone": "[phone]",
    "rcpt_prov": "VA",
    "client_id": 999,
    "corriere": 104,
    "servizio": 11,
    "pallets": 2,
    "dati_pallets": [
        {
            "larghezza": 120,
            "lunghezza": 80
        },
        {
            "larghezza": 120,
            "lunghezza": 80
        }
    ],
    "merce": "Fashion articles",
    "uploadDocAfterwards": true
}

Response

200

{
    "id": "1548765",
    "num_spedizione": "3026253101",
    "dati_pallets": [
        {
            "palletID": "JD014600005286153047",
            "larghezza": "120",
            "lunghezza": "80"
        },
        {
            "palletID": "JD014600005286153048",
            "larghezza": "120",
            "lunghezza": "80"
        }
    ]
}

400

{
    "errore": "The pallets field is required."
}