# Fedex

{% hint style="warning" %}
Fedex è disponibile con due tecnologie differenti in Gsped:

* Fedex SOAP (102)
  * Implementazione obsoleta (pre-2024)
  * Andrà a scomparire con il passaggio al WS
* Fedex WS (20)
  * implementazione 2024
    {% endhint %}

## Limitazioni campi corriere

| Campo               | Limitazione |
| ------------------- | ----------- |
| ddt\_alpha          | Max 40 char |
| rcpt\_addr          | Max 35 char |
| rcpt\_cap           | Max 10 char |
| rcpt\_city          | Max 30 char |
| rcpt\_country\_code | Max 2 char  |
| rcpt\_name          | Max 35 char |
| rcpt\_prov          | Max 2 char  |

## Lista codici Gsped Fedex WS

<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 data-type="checkbox">addParcel (pasgo)</th><th>Note</th></tr></thead><tbody><tr><td>Priority Overnight</td><td>20</td><td>0</td><td>true</td><td>Domestico</td></tr><tr><td>First</td><td>20</td><td>1</td><td>true</td><td>Domestico</td></tr><tr><td>Priority Express</td><td>20</td><td>2</td><td>true</td><td>Domestico</td></tr><tr><td>Priority</td><td>20</td><td>3</td><td>true</td><td>Domestico</td></tr><tr><td>Priority Express Freight</td><td>20</td><td>4</td><td>true</td><td>Domestico</td></tr><tr><td>Priority Freight</td><td>20</td><td>5</td><td>true</td><td>Domestico</td></tr><tr><td>International Priority Express</td><td>20</td><td>6</td><td>true</td><td>Internazionale</td></tr><tr><td>International Priority Freight</td><td>20</td><td>7</td><td>false</td><td>Internazionale</td></tr><tr><td>International Priority</td><td>20</td><td>8</td><td>true</td><td>Internazionale</td></tr><tr><td>International Connect Plus</td><td>20</td><td>9</td><td>true</td><td>Internazionale</td></tr><tr><td>International Economy</td><td>20</td><td>10</td><td>true</td><td>Internazionale</td></tr><tr><td>International Economy Freight</td><td>20</td><td>11</td><td>false</td><td>Internazionale</td></tr><tr><td>International First</td><td>20</td><td>12</td><td>false</td><td>Internazionale</td></tr><tr><td>Regional Economy</td><td>20</td><td>16</td><td>true</td><td>Internazionale</td></tr><tr><td>Regional Economy Freight</td><td>20</td><td>17</td><td>true</td><td>Internazionale</td></tr><tr><td>International Deferred Freight</td><td>20</td><td>19</td><td>false</td><td>internazionale</td></tr></tbody></table>

## Lista codici Gsped Fedex SOAP

<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>Priority Overnight</td><td>102</td><td>0</td><td>Domestico</td></tr><tr><td>International Priority</td><td>102</td><td>6</td><td>Internazionale</td></tr><tr><td>International First</td><td>102</td><td>7</td><td>Internazionale</td></tr><tr><td>International Economy</td><td>102</td><td>8</td><td>Internazionale</td></tr><tr><td>International Connect Plus</td><td>102</td><td>10</td><td>Internazionale</td></tr><tr><td>Regional Economy</td><td>102</td><td>11</td><td>Internazionale</td></tr></tbody></table>

## ICS2

Per le spedizioni non domestiche il corriere richiede obbligatoriamente che vengano valorizzati:

* [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine.md)
* Opzionale: invoice\_number

## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents.md)

**Disponibile nelle chiamate: POST e PATCH**

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

## Export Compliance Statement

Questo campo permette di inserire un numero/dichiarazione AES, permettendo all'utente di confermare spedizioni dall'America all'estero con un valore doganale superiore ai 2500 dollari.

### Fedex (20)

```json
"fedexrest": {
        "exportComplianceStatement": "AES X20240115123456"
}
```

### Spedizione verso zona residenziale (20)

È possibile indicare a Fedex se si sta spedendo verso un indirizzo residenziale

```json
"rcpt_residential" : 1
```

### Identificativo destinatario per la dogana (20)

Campo utile per passare a Fedex un identificativo del mittente per spedizioni doganali

```json
"fedexrest": {
    "recipientCustomsId": {
            "type": "PASSPORT",
            "value": 12345678
        }
    }
```

I possibili valori del type e relativo valore sono i seguenti:

| type       | value                                  |
| ---------- | -------------------------------------- |
| PASSPORT   | Numero del passaporto del destinatario |
| INDIVIDUAL | Codice fiscale del destinatario        |
| COMPANY    | Partita iva del destinatario           |

### Forzatura tins per lo shipper (20)

```json
"fedexrest": {
    "shipper": {
        "tins": {
            "tinType": "BUSINESS_UNION",
            "number": "IT12345678901"
        }
    }
}
```

Possibili valori per il tinType:

* BUSINESS\_NATIONAL
* BUSINESS\_STATE
* BUSINESS\_UNION
* PERSONAL\_NATIONAL
* PERSONAL\_STATE

{% hint style="warning" %}
**ATTENZIONE!**

Questo parametro va in sovrascrittura di un eventuale EORI configurato per il sender
{% endhint %}

### Forzatura rateRequestType (20)

```json
"fedexrest": {
    "rateRequestType": "ACCOUNT"
}
```

Possibili valori:

* LIST
* INCENTIVE
* ACCOUNT
* PREFERRED
* RETAIL

Default: ACCOUNT

### Dettagli dangerousGoods (20)

```json
"fedexrest": {
    "dangerousGoodsDetail": {
        "accessibility": "ACCESSIBLE",
        "cargoAircraftOnly": true
    }
}
```

Valori possibili:

| campo             | valori                  |
| ----------------- | ----------------------- |
| accessibility     | ACCESSIBLE/INACCESSIBLE |
| cargoAircraftOnly | true/false              |

## Gestione documenti

Per alcune destinazioni è obbligatorio allegare documenti doganali alla spedizione.&#x20;

#### Caricamento dei documenti elettronici contestualmente alla creazione della spedizione

Soluzione da privilegiare, quanto possibile, aggiungendo la sezione trade\_documents alla shipment POST

#### Caricamento postumo dei documenti elettronici

Nel caso si voglia allegare in un secondo momento i documenti elettronici è possibile farlo aggiungendo il seguente parametro in shipment POST.

```json
"fedexrest": {
        "willUploadDocAfterShipment": true
}
```

Con l'aggiunta di questo parametro se gli ETD fossero obbligatori la spedizione viene creata ugualmente ma è assolutamente necessario procedere con il caricamento dei documenti mediante shipment PATCH. Senza il caricamento dei documenti c'è la possibilità che la merce venga bloccata in dogana.

#### Aggiunta dei documenti in formato cartaceo

Modalita sconsigliata, ma se inevitabile contattare l'assistenza per poter abiltare la funzionalità

{% hint style="danger" %}
**Attenzione!!!**

Con la modalità ***pasgo*** attiva il caricamento postumo del documento ( ***willUploadDocAfterShipment*** ) è implicito quindi è **SEMPRE** responsabilità del cliente caricare i documenti elettronici per le destinazioni che lo richiedono **PRIMA** di confermare la spedizione.
{% endhint %}


---

# 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/fedex.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.