> 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/gsped-api-english-version/spedizioni-e-dintorni/shipment/corrieri/tnt.md).

# TNT

## Courier field limitations

| Field               | Limitation  |
| ------------------- | ----------- |
| ddt\_alpha          | Max 25 char |
| rcpt\_addr          | Max 30 char |
| rcpt\_cap           | Max 9 char  |
| rcpt\_city          | Max 30 char |
| rcpt\_country\_code | Max 2 char  |
| rcpt\_name          | Max 25 char |
| rcpt\_prov          | Max 2 char  |

## Gsped code list

<table data-full-width="true"><thead><tr><th>Service</th><th data-type="number">Courier code</th><th data-type="number">Service code</th><th>Notes</th></tr></thead><tbody><tr><td>Express</td><td>2</td><td>0</td><td>Domestic</td></tr><tr><td>12:00 Express</td><td>2</td><td>1</td><td>Domestic</td></tr><tr><td>10:00 Express</td><td>2</td><td>2</td><td>Domestic</td></tr><tr><td>Economy Express</td><td>2</td><td>3</td><td>Domestic</td></tr><tr><td>International Express</td><td>2</td><td>6</td><td>International</td></tr><tr><td>International 12:00 Express</td><td>2</td><td>7</td><td>International</td></tr><tr><td>International Economy Express</td><td>2</td><td>8</td><td>International</td></tr><tr><td>International 12:00 Economy Express</td><td>2</td><td>9</td><td>International</td></tr><tr><td>International 10:00</td><td>2</td><td>10</td><td>International</td></tr><tr><td>International 9:00</td><td>2</td><td>11</td><td>International</td></tr></tbody></table>

## Expected handover date

**Available in calls: POST and PATCH**

You can force the **date on the label and the addParcel in the future** by changing the courier's collectionDate. To do so, set data\_previsto\_affidamento inside courierData.

```json
"courierData":{
    "data_previsto_affidamento":"2024-12-31"
}
```

{% hint style="info" %}
The date can be set from today up to max 60 days from today and **ONLY WITH THE APPROVAL of the TNT technical department** (this feature is not available to all clients). Check with your TNT sales / technical contact.
{% endhint %}

Note that once the shipments are confirmed, the shipment start date "date\_created" becomes the confirmation date. In this case, to find out when the shipment was actually created, you need to check on S3 when the labels were generated.