Come connettere Royal Mail v2 a ShippyPro

Vediamo come puoi integrare Royal Mail v2 con ShippyPro in pochi semplici passi.

Riepilogo

Prima di iniziare
Passaggi per la connessione
Servizi supportati
Opzioni aggiuntive
Risoluzione dei problemi ed errori
FAQ

1. Prima di iniziare

Prima di connettere Royal Mail v2 a ShippyPro, assicurati di avere a disposizione le seguenti informazioni. Per recuperare queste credenziali, contatta il tuo Account Manager di Royal Mail.

Account Number: Il tuo numero di account di spedizione Royal Mail (10 cifre, di solito inizia con 0)
Posting Location Code: Il tuo identificativo di sede Royal Mail (10 cifre, di solito inizia con 9000)
Royal Mail OBA registered email: L'indirizzo email registrato con l'Online Business Account di Royal Mail

Una volta ottenute queste informazioni, apri un ticket di supporto su ShippyPro e inviaci questi dettagli. Il nostro team completerà la configurazione e ti fornirà l'Account ID.

Nota: Royal Mail v2 supporta solo spedizioni con origine nel Regno Unito.

2. Passaggi per la connessione

Segui questi passaggi per connettere Royal Mail v2 al tuo account ShippyPro:

Passaggio 1: Contatta il tuo Account Manager di Royal Mail per ottenere:

Royal Mail Account Number (10 cifre, di solito inizia con 0)
Royal Mail OBA registered email
Posting Location Code (10 cifre, di solito inizia con 9000)

Passaggio 2: Apri un ticket di supporto su ShippyPro andando su Supporto > Crea Ticket e fornisci le informazioni ottenute nel Passaggio 1.

Passaggio 3: Attendi che il team di supporto ShippyPro configuri le tue credenziali OAuth2 e ti fornisca l'Account ID.

Passaggio 4: Una volta ricevute le credenziali, accedi al tuo account ShippyPro e vai alla pagina Corrieri dal menu principale.

Passaggio 5: Individua e clicca sul logo Royal Mail v2 dall'elenco dei corrieri disponibili.

Passaggio 6: Seleziona Royal Mail v2 se sono disponibili più versioni.

Passaggio 7: Compila i campi obbligatori nella finestra di connessione:

Account ID: Inserisci l'ID fornito dal supporto ShippyPro
Location ID: Inserisci il tuo identificativo di sede Royal Mail (ShippingLocationId).
📌 Se più di una sede è collegata al tuo Account, inserisci il Location ID che desideri utilizzare nella connessione del corriere; se c'è una sola sede, puoi lasciare questo campo vuoto.

Passaggio 8: Clicca su Salva o Connetti per completare l'integrazione.

Passaggio 9: Il sistema convaliderà le tue credenziali tramite la generazione del token OAuth. Riceverai un messaggio di conferma una volta che l'integrazione sarà andata a buon fine.

3. Servizi supportati

Una volta connesso, Royal Mail v2 offre vari servizi di spedizione tramite ShippyPro:

Servizi nazionali (solo Regno Unito)

CRL1 - Tracked 24 High Volume: Servizio nazionale 24 ore
CRL2 - Tracked 48 High Volume: Servizio nazionale 48 ore
BPL1 - Tracked Letter 1st Class: Servizio lettera 1a classe
BPL2 - Tracked Letter 2nd Class: Servizio lettera 2a classe
BPR1 - Tracked Returns 1st Class: Resi firmati 1a classe
BPR2 - Tracked Returns 2nd Class: Resi firmati 2a classe
TPN - Tracked 24: Servizio tracciato standard 24 ore
TPC - Tracked 24 Signed: Servizio tracciato 24 ore con firma
TPS - Tracked 48: Servizio tracciato standard 48 ore
TPD - Tracked 48 Signed: Servizio tracciato 48 ore con firma

Servizi internazionali (in tutto il mondo dal Regno Unito)

OLA - International Standard: Servizio internazionale standard
OLS - International Economy: Servizio internazionale economico
OSA - International Signed: Servizio internazionale con firma
OTA - International Tracked: Servizio internazionale tracciato
OTC - International Tracked & Signed: Servizio internazionale tracciato con firma (potrebbero applicarsi restrizioni per paese)

4. Opzioni aggiuntive

Firma richiesta

Puoi aggiungere l'opzione Firma richiesta ai servizi che non includono già la firma per impostazione predefinita. Questo miglioramento del servizio garantisce che sia richiesta una firma alla consegna.

Nota: Servizi come TPC (Tracked 24 Signed) e TPD (Tracked 48 Signed) includono già la firma per impostazione predefinita, quindi questa opzione non è necessaria per questi servizi.

Per abilitare questa opzione:

Seleziona la casella Firma richiesta durante la creazione della spedizione, cliccando su Opzioni corriere al checkout
Questo aggiungerà il miglioramento del servizio "Signed" ai servizi compatibili

Formati etichetta

Royal Mail v2 supporta diversi formati di etichetta:

PDF A4: Formato A4 standard per la stampa su carta normale
PDF A6: Formato A6 predefinito per stampanti di etichette
ZPL: Formato A6 per stampanti Zebra

Seleziona il formato preferito in base al tipo di stampante e alle tue esigenze.

Supporto multipacco

Royal Mail v2 supporta più colli per spedizione, permettendoti di spedire diversi pacchi con un unico ordine.

Funzionalità spedizioni internazionali

Per le spedizioni internazionali, Royal Mail v2 include automaticamente:

Fattura commerciale: Generata e restituita separatamente dall'etichetta di spedizione
Dichiarazione articoli: Con codici HS per lo sdoganamento
Informazioni doganali: Inclusi gli Incoterms (DDU/DAP/DDP)

Supporto pre-registrazione:

IOSS (Import One-Stop Shop): Per spedizioni UE
UKIMS (UK Internal Market Scheme): Per spedizioni B2B dalla Gran Bretagna all'Irlanda del Nord oltre £135

Chiusura/Manifesto

Royal Mail v2 supporta la funzionalità di Chiusura per manifestare tutte le spedizioni in una sede specifica.

Importante: Il processo di chiusura manifesta tutti gli ordini creati con lo stesso Location ID, non solo i singoli ordini.

5. Risoluzione dei problemi ed errori

Errori comuni

Codice errore: 1015 - Errore di limitazione della frequenza

Causa: Questo errore si verifica quando vengono inviate troppe richieste all'API di Royal Mail in un breve periodo
Soluzione: Attendi alcuni istanti (30-60 secondi) e riprova la richiesta. Il limite di frequenza si ripristinerà automaticamente

Autenticazione OAuth non riuscita

Causa: Account ID non valido o scaduto
Soluzione: Verifica che le tue credenziali siano corrette. Se il problema persiste, contatta il supporto ShippyPro per rigenerare le tue credenziali OAuth

Account Number o Location Number non valido

Causa: Il formato dell'Account Number o del Location Number non è corretto
Soluzione: Assicurati che il tuo Account Number sia di 10 cifre (di solito inizia con 0) e che il tuo Posting Location Code sia di 10 cifre (di solito inizia con 9000). Contatta il tuo Account Manager di Royal Mail per verificare i numeri corretti

Origine spedizione non nel Regno Unito

Causa: Royal Mail v2 supporta solo spedizioni con origine nel Regno Unito
Soluzione: Verifica che l'indirizzo di origine della spedizione sia nel Regno Unito. Per spedizioni da altri paesi, utilizza un corriere diverso

La chiusura restituisce "Nessuna spedizione pronta per essere manifestata"

Causa: Tutte le spedizioni nella sede specificata sono già state manifestate
Soluzione: Questo viene effettivamente trattato come un successo poiché le spedizioni sono già chiuse. Non è necessaria alcuna azione ulteriore

Timeout della connessione o errore interno del server

Causa: Problemi temporanei di connettività con i server API di Royal Mail
Soluzione: Attendi alcuni minuti e riprova la connessione. Se il problema persiste per più di 30 minuti, contatta il supporto ShippyPro

6. FAQ

D: Come posso ottenere le mie credenziali Royal Mail?

R: Contatta il tuo Account Manager di Royal Mail per richiedere il tuo Account Number, l'email registrata OBA e il Posting Location Code. Quindi apri un ticket di supporto su ShippyPro con queste informazioni e il nostro team ti fornirà l'Account ID OAuth.

D: Perché ricevo l'"errore codice: 1015"?

R: Questo è un errore di limitazione della frequenza dall'API di Royal Mail. Significa che hai inviato troppe richieste in poco tempo. Attendi alcuni istanti (30-60 secondi) e riprova la richiesta.

D: Posso spedire a livello internazionale con Royal Mail v2?

R: Sì, Royal Mail v2 supporta spedizioni internazionali in tutto il mondo, ma tutte le spedizioni devono avere origine nel Regno Unito. I servizi internazionali includono opzioni Standard, Economy, Tracked e Signed.

D: Perché la chiusura ha successo senza restituire un manifesto?

R: Se tutte le spedizioni nella sede erano già state manifestate, Royal Mail restituisce un messaggio "nessuna spedizione pronta". Il connettore tratta questo come un successo poiché le spedizioni sono già chiuse. Ricorda: la chiusura viene eseguita sul Location ID, quindi TUTTI gli ordini creati con quel Location ID verranno chiusi, non solo i singoli ordini.

D: Quali servizi supportano l'opzione firma_richiesta?

R: Il miglioramento firma può essere aggiunto ai servizi che non includono già la firma per impostazione predefinita (ad es. TPS - Tracked 48, TPN - Tracked 24). Servizi come TPC (Tracked 24 Signed) e TPD (Tracked 48 Signed) includono già la firma, quindi questa opzione non è necessaria per loro.

D: Quali formati di etichetta sono disponibili?

R: Royal Mail v2 supporta PDF A4, PDF A6 (formato predefinito) e formato ZPL A6 per stampanti Zebra. Scegli il formato più adatto alla tua attrezzatura di stampa.

D: Posso annullare o eliminare una spedizione dopo la creazione?

R: Sì, Royal Mail v2 supporta la funzionalità di eliminazione spedizione (annullamento) utilizzando lo ShipmentId dagli attributi della spedizione. Questo deve essere fatto prima che la spedizione venga chiusa/manifestata.

D: Cosa succede con la documentazione doganale per le spedizioni internazionali?

R: Royal Mail v2 genera automaticamente documenti di Fattura commerciale (restituiti separatamente dall'etichetta), include la dichiarazione degli articoli con codici HS e supporta informazioni doganali con Incoterms (DDU/DAP/DDP). La pre-registrazione IOSS e UKIMS è supportata anche per le spedizioni idonee.