# UPS

## 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>Nazionale Express Saver</td><td>103</td><td>0</td><td>Domestico</td></tr><tr><td>Nazionale Express</td><td>103</td><td>1</td><td>Domestico</td></tr><tr><td>Nazionale Express Plus</td><td>103</td><td>2</td><td>Domestico</td></tr><tr><td>Nazionale Standard</td><td>103</td><td>3</td><td>Domestico</td></tr><tr><td>Internazionale Express</td><td>103</td><td>6</td><td>Internazionale</td></tr><tr><td>Internazionale Express Plus</td><td>103</td><td>7</td><td>Internazionale</td></tr><tr><td>Internazionale Standard</td><td>103</td><td>8</td><td>Internazionale</td></tr><tr><td>Internazionale Saver</td><td>103</td><td>9</td><td>Internazionale</td></tr><tr><td>Expedited</td><td>103</td><td>10</td><td>Internazionale</td></tr></tbody></table>

## Trade documents

Disponibile nelle chiamate in POST e PATCH

```json
"trade_documents":[
    {
        "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf",
        "contenuto":""
    }
]
```

Documentazione specifica per i trade documents : [trade\_documents](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents "mention")

## Oneri dogana e costi spedizione

Con UPS è possibile indicare i codici clienti di un soggetto terzo per addebitargli i costi di spedizione e/o gli oneri doganali.

Di seguito alcuni esempi di payload da utilizzare nelle varie casistiche :&#x20;

**Costi spedizione e oneri doganali a terzo :**&#x20;

```json
"parties": {
        "freightPayer": {
            "zipcode": "15121",
            "country": "IT",
            "clientCode": "abcdef"
        },
        "customsPayer": {
            "zipcode": "15121",
            "country": "IT",
            "clientCode": "ghjki"
        }
    }
```

**Costi spedizione a terzo e oneri doganali al mittente :**

```json
"parties": {
        "freightPayer": {
            "zipcode": "15121",
            "country": "IT",
            "clientCode": "abcdef"
        }
    }
```

**Costi spedizione al mittente e oneri doganali a terzo :**

```json
"parties": {
        "customsPayer": {
            "zipcode": "15121",
            "country": "IT",
            "clientCode": "ghjki"
        }
    }
```

## Consegna Diretta

Per usufruire della consegna diretta di UPS nella chiamata di creazione spedizione aggiungere il seguente campo :&#x20;

```json
"ups": {
        "directDelivery": true
    }
```

## Consegna a indirizzo in zona residenziale

Per indicare al corriere che il luogo di consegna si trova in una zona residenziale, nella chiamata di creazione spedizione aggiungere il seguente campo :&#x20;

```json
"ups": {
        "residentialLocation": true
    }
```

## Spedizione che contiene articoli soggetti a restrizioni

Per indicare al corriere che la spedizione è composta da articoli soggetti a restrizioni, , nella chiamata di creazione spedizione aggiungere il seguente campo :&#x20;

```json
"ups": {
        "restrictedArticle": "RESTRICTED_ARTICLE"
    }
```

Dove **RESTRICTED\_ARTICLE** può assumere uno dei seguenti valori :&#x20;

* alcoholic
* diagnosticSpeciments
* perishables
* plants
* seeds
* specialExceptions
* tobacco

## Spedizioni di reso

Ci sono diverse modalità con cui può essere generata una spedizione di reso. Le modalità che attualmente gestiamo sono le seguenti :&#x20;

| Tipo di reso                                               | Codice da utilizzare | Descrizione                                                                                                                                                                    |
| ---------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Reso standard                                              | 1                    |                                                                                                                                                                                |
| Reso con 1 tentativo di presa                              | 2                    |                                                                                                                                                                                |
| Reso con 3 tentativo di presa                              | 3                    |                                                                                                                                                                                |
| Resco con eEtichette elettronica (Electronic Return Label) | 4                    | In questo caso il corriere al momento di generare la spedizione NON restituisce l'etichetta in risposta. Quest'ultima viene mandata direttamente al mittente della spedizione. |

Questi codici reso possono essere utilizzati attraverso il campo **flag\_reso** al momento della generazione della spedizione


---

# 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/shipment/corrieri/ups.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.