# Spedizioni consolidate

{% hint style="info" %}
**ATTENZIONE 1 :** Questa funzionalità sarà disponibile intorno a fine aprile / inizio maggio
{% endhint %}

La spedizione consolidata consiste nell'unire più ordini (spedizioni singole) diretti verso la stessa nazione in un unico carico palletizzato. Questo permette di ottimizzare i costi e la logistica: una volta che il carico arriva alla filiale del corriere nel paese di destinazione, viene 'spacchettato' e le singole spedizioni vengono inviate separatamente ai destinatari finali.

### Come si possono gestire le spedizioni consolidate su Gsped?

Il meccanismo di funzionamento è il seguente : 

#### 1 - Creazione della spedizione consolidata

In questa fase vengono indicate i dettagli iniziali della consolidata, come ad esempio mittente / destinatario ed il numero di pallet di cui sarà composto

**Endpoint di riferimento :** [BulkShipment - createMaster](https://apidocs.gsped.com/spedizioni-e-dintorni/spedizioni-consolidate/bulkshipment-createmaster#bulkshipment-createmaster)

#### 2 - Creazione spedizioni figlie

In questa fase vengono generate tutte le spedizioni che saranno inserite all'interno della spedizione consolidata creata nel punto precedente.

Queste spedizioni andranno create via API, attraverso la **Shpment - POST** nelle consuete modalità.

Come dati particolari, **bisognerà indicare l'ID della consolidata e l'identificativo del pallet** in cui si sarà posizionata la spedizione che si sta creando. Questi due dati saranno forniti in risposta all'operazione di creazione consolidata.

**Esempio dei dati da aggiungere alla chiamata API :** 

```json
"courierData": {
        "idSpedizioneConsolidata": ID_SPEDIZIONE_CONSOLIDATA,
        "identificativoPallet": IDENTIFICATIVO_PALLET
    },
```

{% hint style="danger" %}
**ATTENZIONE :** 

Senza questi dati la spedizione generata **NON sarà associata a nessuna consolidata**.
{% endhint %}

#### 3 - Chiusura spedizione consolidata

Una volta create tutte le spedizioni associate alla spedizione consolidata creata al punto 1, di potrà procedere con la chiusura della spedizione consolidata.

In questa fase, si comunicherà al corriere che la spedizione è completa e verranno restituite le etichette da utilizzare per gli N pallet di cui è composta la spedizione consolidata.

{% hint style="warning" %}
**IMPORTANTE :**

Una volta che la spedizione consolidata è stata chiusa, non sarà possibile associare nuove spedizioni a quest'ultima.

Inoltre, bisogna tenere a mente che la spedizione consolidata non si potrà chiudere fin tanto risultino dei Pallet a cui non sono ancora spedizioni associate ad essi.
{% endhint %}

**Endpoint di riferimento :** [BulkShipment - closeMaster](https://apidocs.gsped.com/spedizioni-e-dintorni/spedizioni-consolidate/bulkshipment-closemaster#bulkshipment-closemaster)

#### 4 - Aggiunta di un nuovo pallet (Opzionale)

Per i corrieri che lo permettono, sarà possibile aggiungere un nuovo pallet alla spedizione consolidata.

Questa operazione sarà permessa solo se la spedizione **non è ancora chiusa**.

**Endpoint di riferimento :** [BulkShipment - Aggiungere Pallet](https://apidocs.gsped.com/spedizioni-e-dintorni/spedizioni-consolidate/bulkshipment-aggiunta-rimozione-pallets#aggiunta-di-un-nuovo-pallet)

#### 5 - Rimozione dell'ultimo pallet (Opzionale)

Per i corrieri che lo permettono, sarà possibile rimuovere l'ultimo pallet aggiunto alla spedizione consolidata.

Questa operazione sarà permessa solo se la spedizione **non è ancora chiusa** e se **non risulta nessuna spedizione "figlia" associato a quest'ultimo**.

**Endpoint di riferimento :** [BulkShipment - Rimozione Pallet](https://apidocs.gsped.com/spedizioni-e-dintorni/spedizioni-consolidate/bulkshipment-aggiunta-rimozione-pallets#rimozione-dellultimo-pallet-che-e-stato-aggiunto)

### Elenco dei corrieri che mettono a disposizione questo servizio

| Corriere  | Nome del servizio |
| --------- | ----------------- |
| DHL (104) | Break Bulk (BBX)  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.gsped.com/spedizioni-e-dintorni/spedizioni-consolidate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.