Come connettere Nova Poshta a ShippyPro

Vediamo come puoi integrare Nova Poshta con ShippyPro in pochi semplici passaggi e iniziare a spedire dall'Ucraina, sia a livello nazionale che internazionale.

Sommario

Prima di iniziare
Step di connessione
Servizi supportati
Opzioni aggiuntive
Errori & Risoluzioni
FAQ

1. Prima di iniziare

Nova Poshta è un corriere ucraino per pacchi e merci. Con questa integrazione puoi creare spedizioni, stampare le etichette e tracciare i tuoi pacchi direttamente da ShippyPro.

Prima di connetterti, assicurati di avere:

Un account business Nova Poshta attivo
La tua API Key Nova Poshta, disponibile nel tuo account Nova Poshta. Se non riesci a trovarla, contatta il tuo account manager Nova Poshta
Un indirizzo mittente in Ucraina: le spedizioni devono partire dall'Ucraina

Facoltativamente, puoi recuperare anche i codici Ref che Nova Poshta utilizza per identificare i dati del mittente (mittente, referente, città e indirizzo). Se li lasci vuoti, ShippyPro li recupererà automaticamente dal tuo account Nova Poshta.

2. Step di connessione

Vai alla pagina Corrieri del tuo account ShippyPro.
Clicca sul logo Nova Poshta.
Compila i campi di connessione:

API Key (obbligatorio): la tua API key Nova Poshta
Sender Ref: il codice Ref del mittente registrato sul tuo account Nova Poshta. Se vuoto, viene recuperato automaticamente
Contact Ref: il codice Ref del referente del mittente. Se vuoto, viene recuperato automaticamente
Sender City Ref: il codice Ref della città del mittente. Se vuoto, viene recuperato automaticamente
Sender Address Ref: il codice Ref dell'indirizzo del mittente. Se vuoto, viene recuperato automaticamente
Label Type (obbligatorio): scegli tra PDF A4 e PDF 100x100
Service Type (obbligatorio): il servizio da utilizzare (attualmente Standard)
Test: attivalo solo se vuoi utilizzare la Test Mode (vedi sezione 4)

Clicca su Connetti per salvare la configurazione.

💡 Suggerimento: se il tuo account Nova Poshta ha più di un mittente o indirizzo, ti consigliamo di compilare tutti i campi Ref, così da utilizzare sempre i dati mittente corretti.

Nota bene: le credenziali non vengono verificate al salvataggio della connessione. Ti consigliamo di creare una prima spedizione per assicurarti che tutto funzioni correttamente.

3. Servizi supportati

Standard: il servizio standard di Nova Poshta. Funziona in due modalità:
- Porta a porta: il pacco viene consegnato all'indirizzo del destinatario (predefinito)
- Porta a filiale: il pacco viene consegnato presso una filiale Nova Poshta, quando è impostata l'opzione Recipient Warehouse Ref (vedi sezione 4)

Nova Poshta supporta inoltre:

Etichette PDF in formato A4 o 100x100
Track & Trace, disponibile anche sul sito di Nova Poshta
Contrassegno, con importo convertito automaticamente in UAH
Assicurazione, con il totale dell'ordine come valore dichiarato
Spedizioni multicollo
Spedizioni nazionali e internazionali in partenza dall'Ucraina

Non sono supportati: cancellazione delle spedizioni (Void), tariffe in tempo reale, prenotazione del ritiro, ricerca dei punti di ritiro, etichette di reso, documenti paperless, etichette ZPL/EPL, CN22/CN23, Proof of Delivery.

4. Opzioni aggiuntive

Consegna presso una filiale Nova Poshta

Per consegnare il pacco presso una filiale Nova Poshta invece che all'indirizzo del destinatario, compila l'opzione Recipient Warehouse Ref con il codice Ref della filiale. La spedizione verrà creata in modalità porta a filiale.

Spedizioni verso aziende

Per spedire verso un'azienda, compila entrambe le opzioni:

Nova Poshta EDRPOU: il codice EDRPOU dell'azienda destinataria
Nova Poshta Ownership Form: il codice della forma giuridica dell'azienda destinataria

Entrambi i campi sono obbligatori: se ne viene compilato solo uno, il destinatario sarà considerato un privato.

Test Mode

⚠️ Importante: Nova Poshta non mette a disposizione un ambiente di test separato. Anche con l'opzione Test attiva, le richieste vengono inviate al sistema reale di Nova Poshta, quindi le spedizioni create potrebbero essere spedizioni reali. Poiché le spedizioni non possono essere cancellate da ShippyPro, contatta Nova Poshta se hai bisogno di annullarne una.

Etichetta personalizzata

L'opzione Etichetta personalizzata non è al momento disponibile per Nova Poshta.

5. Errori & Risoluzioni

Indirizzo non riconosciuto / città o via non trovata

ShippyPro abbina la città e la via del destinatario con l'archivio indirizzi di Nova Poshta. Se l'indirizzo non viene trovato, verifica che:

Il nome della città sia scritto correttamente
Il campo via contenga solo il nome della via e il numero civico, senza note aggiuntive o abbreviazioni
Le informazioni aggiuntive (es. appartamento, piano) siano inserite nella seconda riga dell'indirizzo

Se l'indirizzo è corretto e l'errore persiste, contatta il Supporto ShippyPro.

Dati mittente non trovati

Verifica che l'API Key e i codici Ref inseriti nella connessione siano corretti. Se non sei sicuro dei codici Ref, lasciali vuoti così che ShippyPro possa recuperarli automaticamente.

Errore sulle spedizioni verso aziende

Assicurati che Nova Poshta EDRPOU e Nova Poshta Ownership Form siano entrambi compilati con codici validi.

Internal Server Error / problemi di connessione

Di solito si tratta di un problema temporaneo lato corriere. Attendi qualche minuto e riprova. Verifica inoltre che l'API Key sia stata copiata correttamente, senza spazi aggiuntivi, e che il tuo account Nova Poshta sia attivo. Se il problema persiste, contatta il Supporto ShippyPro indicando i dettagli dell'ordine.

6. FAQ

Posso spedire all'estero con Nova Poshta?

Sì. Nova Poshta supporta sia spedizioni nazionali che internazionali, purché partano dall'Ucraina.

Devo inserire i codici Ref?

No. Solo l'API Key è obbligatoria: se i campi Ref sono vuoti, ShippyPro recupera automaticamente i dati del mittente dal tuo account Nova Poshta.

Posso cancellare una spedizione Nova Poshta da ShippyPro?

No, la cancellazione delle spedizioni non è supportata. Per annullare una spedizione, contatta direttamente Nova Poshta.

Posso consegnare presso una filiale Nova Poshta?

Sì, inserendo il codice Ref della filiale nell'opzione Recipient Warehouse Ref. La ricerca dei punti di ritiro non è disponibile in ShippyPro.

Il contrassegno è supportato?

Sì. L'importo del contrassegno viene convertito automaticamente in grivnie ucraine (UAH).

Quali formati di etichetta sono disponibili?

PDF A4 e PDF 100x100. I formati ZPL ed EPL non sono disponibili.

Posso vedere le tariffe in tempo reale o prenotare un ritiro?

No, le tariffe in tempo reale e la prenotazione del ritiro non sono al momento disponibili per Nova Poshta.

Esiste un ambiente di test?

No. Nova Poshta non ha un ambiente di test separato, quindi le spedizioni create con la Test Mode attiva potrebbero essere reali.