# 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>International Priority Distribution</td><td>20</td><td>13</td><td>false</td><td>Internazionale</td></tr><tr><td>International Distribution Freight</td><td>20</td><td>14</td><td>false</td><td>Internazionale</td></tr><tr><td>International Economy Distribution</td><td>20</td><td>15</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></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](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine)
* Opzionale: invoice\_number

## [Trade documents](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents)

**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à