Come collegare Poste Italiane Invio System a ShippyPro

Vediamo come puoi integrare Poste Italiane Invio System con ShippyPro in pochi passaggi, e come usare il Dynamic Multiparcel per aggiungere colli alla stessa spedizione nel tempo.

Sommario

1. Prima di iniziare
2. Come collegare Poste Italiane Invio System
3. Servizi supportati
4. Dynamic Multiparcel
5. Opzioni aggiuntive
6. Risoluzione dei problemi ed errori
7. FAQ

Vediamo come puoi integrare Poste Italiane Invio System con ShippyPro in pochi passaggi, e come usare il Dynamic Multiparcel per aggiungere colli alla stessa spedizione nel tempo.

Sommario

1. Prima di iniziare
2. Come collegare Poste Italiane Invio System
3. Servizi supportati
4. Dynamic Multiparcel
5. Opzioni aggiuntive
6. Risoluzione dei problemi ed errori
7. FAQ

1. Prima di iniziare

Prima di collegare Poste Italiane Invio System a ShippyPro, assicurati di avere:

• Un contratto Poste Italiane Invio System attivo con un range di autoproduzione per i codici di tracking. Il tuo referente commerciale Poste Italiane ti fornisce Station Code (ID5), Customer Identification Code, Sender Address Code e Branch Code.
• Un accesso FTP o SFTP fornito da Poste Italiane (host, porta, username, password). L'account FTP deve avere una cartella Send scrivibile: ShippyPro carica lì il file di closeout.
• Spedizioni solo in Italia: mittente e destinatario devono trovarsi in Italia. Le spedizioni internazionali non sono supportate.
• Accesso alle API di ShippyPro, solo se vuoi usare il Dynamic Multiparcel: si attiva per singola spedizione nella richiesta Ship.

Nota: Poste Italiane non riceve nulla finché il file di closeout non è sul server FTP. Ogni spedizione deve essere chiusa con la closeout (vedi sezione 4.2).

2. Come collegare Poste Italiane Invio System

Vai alla pagina Carriers e clicca sul logo Poste Italiane Invio System. Compila i campi qui sotto e clicca su Save. Al salvataggio ShippyPro verifica le credenziali FTP.

Una volta salvato, Poste Italiane Invio System è disponibile tra i tuoi corrieri e puoi iniziare a creare spedizioni.

3. Servizi supportati

• Destinazioni: solo nazionali, dall'Italia all'Italia (mittente e destinatario).
• Tracking: disponibile per ogni collo tramite il tracking di ShippyPro.
  
  

4. Dynamic Multiparcel

Con il Dynamic Multiparcel crei un collo per ogni chiamata Ship e aggiungi i colli successivi alla stessa spedizione in un secondo momento, fino alla closeout.

• Primo collo → spedizione master. ShippyPro prende un nuovo numero seriale dal tuo range di autoproduzione e genera il codice di tracking master: codice servizio + station code + seriale a 6 cifre.
• Ogni collo successivo → entra nel master. Riceve un proprio codice di tracking, derivato dal codice master. La sua etichetta riporta n/N, dove n è il numero del collo.
• Closeout → invio a Poste. ShippyPro scrive un record per ogni collo nel file di closeout. Il campo Numero Colli contiene il numero totale di colli dell'intero gruppo.

4.1 Creare una spedizione Dynamic Multiparcel

Passaggio 1 – Crea il primo collo

Invia una richiesta Ship con IsDynamicMultiparcel: true e un solo collo. ShippyPro apre la spedizione master e restituisce il codice di tracking master e la prima etichetta.

Passaggio 2 – Aggiungi i colli successivi

Invia una nuova richiesta Ship con IsDynamicMultiparcel: true per ogni collo aggiuntivo. Ogni collo entra nella spedizione master aperta e riceve un proprio codice di tracking e un'etichetta n/N.

Per le regole su quali colli possono entrare nella stessa spedizione master, consulta la documentazione API di ShippyPro – Ship.


Passaggio 3 – Esegui la closeout

Quando hai creato tutti i colli, esegui la closeout (CloseShipments). Solo allora Poste Italiane riceve la spedizione. Vedi sezione 4.2.

4.2 Closeout

La closeout è obbligatoria per ogni spedizione, Standard o Dynamic: è l'unico modo in cui le tue spedizioni arrivano a Poste Italiane.

Per i dettagli su come la closeout gestisce le spedizioni Dynamic Multiparcel, consulta la documentazione API di ShippyPro – Ship.

Per una spedizione Dynamic Multiparcel vengono inclusi tutti i colli del gruppo, e Numero Colli riporta il numero totale di colli del gruppo.

Suggerimento: crea tutti i colli di un gruppo prima di eseguire la closeout.

Importante: per cancellare un collo usa l'API Void prima di eseguire la closeout, come descritto nella documentazione API di ShippyPro. Dopo la closeout i colli non possono più essere cancellati.

5. Opzioni aggiuntive e limitazioni

Test Mode

Attenzione: Poste Italiane Invio System non ha una vera modalità di test. Selezionare Test salta solo la verifica delle credenziali FTP al salvataggio della configurazione. Etichette e codici di tracking vengono comunque presi dal tuo range di autoproduzione reale.

6. Risoluzione dei problemi ed errori

7. FAQ

Quando Poste Italiane riceve la mia spedizione? Solo dopo che il file di closeout è stato caricato sul server FTP. Fino ad allora Poste non ha alcun dato sui tuoi colli.

Posso cancellare o modificare un collo dopo averlo creato? Puoi cancellare un collo con l'API Void, ma solo prima della closeout. La modifica di un collo non è disponibile.

Posso testare il Dynamic Multiparcel senza codici di tracking reali? No. Non esiste una sandbox per questo corriere. L'opzione Test salta solo la verifica delle credenziali FTP.

Posso spedire all'estero con questo corriere? No. Poste Italiane Invio System supporta solo spedizioni dall'Italia all'Italia.

Posso tracciare i colli? Sì. Il tracking è disponibile per ogni collo tramite il tracking di ShippyPro.