Come connettere Poste Go Fresh a ShippyPro

Poste Go Fresh è il servizio di Poste Italiane per la consegna di pacchi a temperatura controllata (freschi e surgelati) in Italia. Vediamo come puoi integrare Poste Go Fresh con ShippyPro in pochi semplici passaggi.

Sommario

Prima di iniziare
Come collegare Poste Go Fresh
Servizi supportati
Opzioni aggiuntive
Risoluzione dei problemi ed errori
FAQ

1. Prima di iniziare

Per collegare Poste Go Fresh ti serve un contratto attivo con Poste Italiane per il servizio Go Fresh. Chiedi al tuo referente commerciale Poste Italiane queste credenziali:

Private Key
Public Key
Shipper ID

Tieni presente che Poste Go Fresh effettua spedizioni solo in Italia. Le spedizioni internazionali non sono supportate.

2. Come collegare Poste Go Fresh

Vai alla pagina Corrieri e clicca sul logo di Poste Go Fresh.
Compila il modulo di connessione con i campi indicati sotto.
Clicca su Collega per salvare il corriere.

Campo	Obbligatorio	Descrizione
Private Key	Sì	La chiave privata API di Poste Go Fresh.
Public Key	Sì	La chiave pubblica API di Poste Go Fresh.
Shipper ID	Sì	Il tuo identificativo mittente, fornito da Poste Italiane.
Parcel Type	Sì	Tipo di collo: Standard, Bulky (voluminoso) o Frozen (surgelato).
Additional Shipping Days	Sì	Giorni lavorativi da aggiungere alla data di consegna. Imposta 0 per usare la prima data disponibile di Poste Go Fresh per il CAP di destinazione.
Service Type	Sì	Standard (unica opzione disponibile).
Label Type	No	PDF A6 o ZPL (100x150 mm, 203 DPI).
Test Mode	No	Collega l'ambiente di test di Poste Go Fresh.

Importante: ShippyPro non verifica le credenziali quando salvi il corriere. Se una chiave o lo Shipper ID non sono corretti, vedrai l'errore alla creazione della prima spedizione.

3. Servizi supportati

Servizio	Descrizione
Standard	Consegna nazionale a temperatura controllata. La data di consegna viene calcolata in base alla disponibilità del corriere per il CAP di destinazione, oppure in base all'impostazione Additional Shipping Days.

Cosa è supportato:

Etichette: PDF A6 e ZPL (100x150 mm, 203 DPI)
Tracking: sì

4. Opzioni aggiuntive

Test Mode

Attiva Test Mode per creare spedizioni di prova sull'ambiente di test di Poste Go Fresh.

⚠️ Attenzione: le spedizioni create in Test Mode non sono reali. Le etichette generate in Test Mode non devono essere usate per spedire. Ricordati di disattivare Test Mode prima di andare in produzione.

Fascia oraria di consegna

Puoi indicare una fascia oraria di consegna preferita con l'opzione corriere time_range, nel formato YYYY-MM-DDTHH:MM/YYYY-MM-DDTHH:MM (ad esempio 2026-11-05T09:00/2026-11-05T13:00).

5. Risoluzione dei problemi ed errori

Errore	Cosa fare
Autenticazione / credenziali non valide	Controlla Private Key, Public Key e Shipper ID. Copiali di nuovo da Poste Italiane, senza spazi in eccesso.
Destinazione non coperta	Poste Go Fresh non serve il CAP del destinatario. Verifica il CAP o usa un altro corriere per quella destinazione.
Destinazione non italiana	Poste Go Fresh spedisce solo in Italia. Usa un altro corriere per le spedizioni internazionali.
Etichetta non generata	Verifica che Test Mode sia coerente con le credenziali che stai usando (test o produzione), poi riprova.
Internal Server Error	Di solito è un problema temporaneo lato corriere. Attendi qualche minuto e riprova. Se persiste, contatta il Supporto ShippyPro.
Problemi di connessione	Verifica che tutti i campi obbligatori siano compilati, poi salva di nuovo il corriere.

6. FAQ

Cosa mi serve per collegare Poste Go Fresh? Un contratto Poste Go Fresh attivo con Poste Italiane, più le tue credenziali Private Key, Public Key e Shipper ID.

Posso spedire fuori dall'Italia? No. Poste Go Fresh supporta solo spedizioni nazionali in Italia.

Come viene calcolata la data di consegna? Con Additional Shipping Days impostato a 0, ShippyPro usa la prima data disponibile di Poste Go Fresh per il CAP di destinazione. Con un valore maggiore di 0, vengono aggiunti quei giorni lavorativi.

Posso spedire prodotti surgelati? Sì. Seleziona Frozen come Parcel Type nelle impostazioni del corriere. Puoi scegliere anche Standard o Bulky.

Posso annullare una spedizione da ShippyPro? No, l'annullamento (void) non è disponibile per Poste Go Fresh. Contatta Poste Italiane per annullare una spedizione.

Posso tracciare le spedizioni Poste Go Fresh? Sì. Gli aggiornamenti di tracking sono disponibili in ShippyPro come per gli altri corrieri.