> 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/spedizioni-e-dintorni/shipment/corrieri/fercam.md).

# Fercam

## Limitazioni campi corriere

| Campo               | Limitazione |
| ------------------- | ----------- |
| ddt\_alpha          | Max 35 char |
| rcpt\_addr          | Max 35 char |
| rcpt\_cap           | Max 8 char  |
| rcpt\_city          | Max 25 char |
| rcpt\_country\_code | Max 2 char  |
| rcpt\_name          | Max 20 char |
| rcpt\_prov          | Max 2 char  |

## Lista codici Gsped

A gennaio 2026 Fercam ha rinominato i propri servizi nell'ambito dell'integrazione con DACHSER. I codici servizio Gsped non cambiano: è variata solo la denominazione, riportata di seguito con il nome precedente tra parentesi.

<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>Speed &#x26; Book</td><td>131</td><td>0</td><td>Domestico. Deprecato, vedi <a href="#prenotazione-telefonica-e-servizio-book">Prenotazione telefonica e servizio Book</a></td></tr><tr><td>Targo Fix (ex Fix)</td><td>131</td><td>1</td><td>Domestico</td></tr><tr><td>Targo Flex (ex Flex)</td><td>131</td><td>2</td><td>Domestico</td></tr><tr><td>Targo Speed (ex Speed)</td><td>131</td><td>3</td><td>Domestico</td></tr><tr><td>Targo On site (ex Private)</td><td>131</td><td>5</td><td>Domestico</td></tr><tr><td>Speed &#x26; Book Internazionale</td><td>131</td><td>6</td><td>Internazionale. Deprecato, vedi <a href="#prenotazione-telefonica-e-servizio-book">Prenotazione telefonica e servizio Book</a></td></tr><tr><td>Targo Fix Internazionale (ex Fix Internazionale)</td><td>131</td><td>7</td><td>Internazionale</td></tr><tr><td>Targo Flex Internazionale (ex Flex Internazionale)</td><td>131</td><td>8</td><td>Internazionale</td></tr><tr><td>Targo Speed Internazionale (ex Speed Internazionale)</td><td>131</td><td>9</td><td>Internazionale</td></tr><tr><td>Home delivery</td><td>131</td><td>20</td><td>Vedere <a href="#fercam-home-delivery">sezione dedicata</a></td></tr></tbody></table>

## Prenotazione telefonica e servizio Book

Il corriere ha dismesso il servizio Book: la prenotazione telefonica non è più un servizio a sé stante, ma un accessorio attivabile su qualunque servizio, Targo Fix e Targo Speed compresi.

Per richiederla è sufficiente valorizzare il campo `preavviso_telefonico` con `S`, indicando il recapito del destinatario in `rcpt_phone`. I codici servizio 0 e 6 restano accettati per compatibilità, ma per le nuove integrazioni usare Targo Flex (2 e 8) o Targo Speed (3 e 9) insieme a `preavviso_telefonico`.

## Fercam home delivery

Per questo tipo di consegna il corriere richiede informazioni sulle operazioni di installazione/montaggio dei prodotti consegnati.

Nella chiamata alla Shipment POST andrà incluso un array di oggetti denominato fercam\_hd.

```json
"fercam_hd":[
    {
        "assembly_type":"",
        "qty":"",
        "code":"",
        "description":""
    }
]
```

Per ogni oggetto dovranno essere indicate le seguenti informazioni:

<table data-full-width="true"><thead><tr><th width="179">Campo</th><th width="104" data-type="checkbox">Required</th><th width="79">Type</th><th>Descrizione</th></tr></thead><tbody><tr><td>assembly_type</td><td>true</td><td>string</td><td>codifica Fercam del tipo di operazione da fare a destino</td></tr><tr><td>qty</td><td>true</td><td>int</td><td>numero di installazioni da fare per l'assembly_type</td></tr><tr><td>code</td><td>true</td><td>string</td><td>codice del prodotto da installare</td></tr><tr><td>description</td><td>true</td><td>string</td><td>descrizione del prodotto da installare</td></tr></tbody></table>
