# 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