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 |
{% hint style="info" %}
**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.***
{% endhint %}
**Esempio di richiesta :**
```json
{
"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": "test@gsped.com",
"rcpt_name": "DHL HUB GB",
"rcpt_phone": "+391231231234",
"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**
{% tabs %}
{% tab title="200" %}
```json
{
"id": "1548765",
"num_spedizione": "3026253101",
"dati_pallets": [
{
"palletID": "JD014600005286153047",
"larghezza": "120",
"lunghezza": "80"
},
{
"palletID": "JD014600005286153048",
"larghezza": "120",
"lunghezza": "80"
}
]
}
```
{% endtab %}
{% tab title="400" %}
```json
{
"errore": "The pallets field is required."
}
```
{% endtab %}
{% endtabs %}