> For the complete documentation index, see [llms.txt](https://apidocs.gsped.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/db-schenker.md).

# Db Schenker

## Lista codici Gsped

<table data-full-width="true"><thead><tr><th>Servizio</th><th data-type="number">Codice corriere</th><th data-type="number">Codice servizio</th><th>Note</th></tr></thead><tbody><tr><td>System</td><td>17</td><td>43</td><td></td></tr><tr><td>System Premium</td><td>17</td><td>44</td><td></td></tr><tr><td>System Home</td><td>17</td><td>45</td><td></td></tr><tr><td>Full Load</td><td>17</td><td>71</td><td></td></tr><tr><td>Part Load</td><td>17</td><td>72</td><td></td></tr></tbody></table>

* Il [ritiro contestuale](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/casi-duso/ritiro-contestuale.md) alla spedizione è **OBBLIGATORIO**

```json
{
    "date_req_ritiro":"2023-11-01",
    "opening_time":"08:00:00",
    "closing_time":"12:00:00"
}
```

* Il volume NON può essere 0 e deve essere passato con massimo 2 cifre decimali
* Il **peso** può contenere al massimo 2 cifre decimali
* Il corriere tratta ogni collo come minimo 1 Kg anche se più leggero
* La sezione [incoterm](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/incoterm.md) (location max 35 caratteri) è **OBBLIGATORIA**.

```json
"incoterm": {
    "incoterm_code": "EXW",
    "location": "C.So f. cavallotti 15 Alessandria"
}
```

## Sdoganamento

Per richiedere lo sdoganamento a DB Schenker si usa l'oggetto [courierSpecificData](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/courierspecificdata.md) con chiave `dbschenker`. È facoltativo: se non viene passato, la spedizione viene creata senza richiesta di sdoganamento.

```json
"dbschenker": {
    "customs_clearance": true,
    "customs_clearance_eu": true,
    "export_customs_declarant": "dbschenker",
    "import_customs_declarant": "dbschenker"
}
```

<table data-full-width="true"><thead><tr><th>Campo</th><th>Codifica</th><th>Descrizione</th></tr></thead><tbody><tr><td>customs_clearance</td><td>boolean</td><td>Richiesta di sdoganamento. Se non indicato vale <code>false</code></td></tr><tr><td>customs_clearance_eu</td><td>boolean</td><td>Sdoganamento nel trasporto terrestre europeo</td></tr><tr><td>export_customs_declarant</td><td>string</td><td>Dichiarante per l'export. Valori ammessi: <code>dbschenker</code>, <code>notrequired</code></td></tr><tr><td>import_customs_declarant</td><td>string</td><td>Dichiarante per l'import. Valori ammessi: <code>dbschenker</code>, <code>notrequired</code>, <code>notspecified</code></td></tr></tbody></table>

* I dichiaranti sono facoltativi: se non indicati e `customs_clearance_eu` è `true`, il dichiarante è DB Schenker.
* I campi booleani vanno passati come `true`/`false`, non come stringa.
* Un valore non ammesso, o un campo diverso da quelli elencati, viene rifiutato con errore **400**.

## Documenti doganali (PLT)

DB Schenker è abilitato al [PLT (paperless)](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/corrieri-abilitati-al-plt-paperless.md): i documenti si inviano nel campo [trade\_documents](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents.md) della creazione spedizione, rispettando la convenzione sui nomi dei file.

```json
"trade_documents": [
    {
        "nome": "COMMERCIAL_INVOICE_TESTRIF1234_1.pdf",
        "contenuto": "<pdf in base64>"
    },
    {
        "nome": "PACKING_LIST_TESTRIF1234_1.pdf",
        "contenuto": "<pdf in base64>"
    }
]
```

Tipi di documento accettati:

| Tipo documento          | Tipo comunicato a DB Schenker |
| ----------------------- | ----------------------------- |
| COMMERCIAL\_INVOICE     | Commercial Invoice            |
| PRO\_FORMA\_INVOICE     | Commercial Invoice            |
| CERTIFICATE\_OF\_ORIGIN | Certificate of Origin         |
| PACKING\_LIST           | Packing List                  |
| EXPORT\_LICENSE         | Licenses and Permits          |
| IMPORT\_PERMIT          | Licenses and Permits          |
| OTHER                   | Others                        |

{% hint style="warning" %}
Un file il cui nome non inizia con uno dei tipi della tabella (ad esempio `fattura.pdf`) viene comunicato a DB Schenker come **Others**. Per essere riconosciuta come fattura, deve chiamarsi ad esempio `COMMERCIAL_INVOICE_TESTRIF1234_1.pdf`.
{% endhint %}

* **Solo PDF.** I file in altri formati non vengono trasmessi a DB Schenker: la spedizione viene creata comunque (status 0) e il campo `error` riporta l'avviso *"Documenti non trasmessi a DB Schenker perché in un formato non ammesso: …"*.
* **Massimo 4 MB in totale** per spedizione, come somma dei file. Oltre questo limite la spedizione va in errore (status 0.6) con il messaggio *"Documenti doganali troppo grandi per DB Schenker: X MB in totale, il massimo è 4.0 MB"*.
* I documenti vanno inviati nella **creazione** della spedizione: DB Schenker non prevede l'invio di documenti in un momento successivo.
