Come connettere Maersk Global eCommerce

In questo articolo scoprirai come collegare Maersk Global eCommerce a ShippyPro e come configurare i servizi di consegna a domicilio, consegna ai punti di ritiro (PUDO), resi e chiusura delle spedizioni (manifest).

Maersk Global eCommerce è la piattaforma europea di Maersk per le spedizioni e-commerce. È la nuova integrazione Maersk, disponibile da maggio 2026. Se utilizzi ancora la connessione precedente, consulta l'articolo Come connettere Maersk E-Delivery Final Mile.

Sommario:

1. Prima di iniziare
2. Configurazione corriere
3. Opzioni aggiuntive
4. Errori & Risoluzioni

1. Prima di iniziare

Per configurare Maersk Global eCommerce ti servono:

• un contratto attivo con Maersk;
• Consumer Key e Consumer Secret, le credenziali API della tua applicazione sul Maersk Developer Portal. Se non le hai ancora, richiedile al tuo Account Manager Maersk;
• il tuo magazzino registrato da Maersk come punto di partenza delle spedizioni. Maersk deve completare l'onboarding del tuo account e associare il tuo indirizzo di magazzino.

❗ L'indirizzo mittente che usi in ShippyPro deve corrispondere al magazzino registrato da Maersk. Se non corrisponde, Maersk rifiuta la creazione dell'etichetta.

2. Configurazione corriere

1. Vai alla sezione Corrieri e clicca sul logo Maersk Global eCommerce (basta scrivere "Maersk" nella barra di ricerca e lo troverai in pochi secondi).

2. Inserisci le credenziali ricevute da Maersk:

• Consumer Key
• Consumer Secret

Assicurati di non includere spazi vuoti prima o dopo le credenziali quando le incolli. ShippyPro verifica le credenziali al salvataggio.

3. Compila ora gli altri dati:

Service: il servizio predefinito per le tue spedizioni. Puoi scegliere tra Home Delivery, Home Delivery International, PUDO Delivery e PUDO Return (vedi la sezione Tipi di servizio).

Label Type:

• PDF 4x6 (predefinito)
• ZEBRA 10x15 (203 DPI)

Pre-sort: attiva questa opzione se Maersk ti ha chiesto di consegnare le spedizioni già smistate in un unico sacco o contenitore (overpack). Alla chiusura delle spedizioni ShippyPro genera anche l'etichetta dell'overpack. Con il Pre-sort attivo, tutte le spedizioni chiuse insieme devono andare verso lo stesso paese di destinazione.

Overpack Customer Code: obbligatorio se il Pre-sort è attivo. È un codice di esattamente 5 caratteri (lettere A-Z e numeri 0-9) assegnato da Maersk.

Custom label name: facoltativo. Il nome con cui vedrai questa connessione in ShippyPro.

Test Mode: per Maersk Global eCommerce questa opzione non ha effetto. È la Consumer Key a determinare se la connessione è di test o di produzione: usa le credenziali di test fornite da Maersk per fare delle prove.

4. Clicca su Salva per completare la connessione.

3. Opzioni aggiuntive

Destinazioni

Nazionali: dipendono dal paese del tuo magazzino registrato da Maersk. Maersk opera in tutta Europa, ad esempio in Italia, Germania, Paesi Bassi, Francia, Spagna, Austria, Belgio, Danimarca e Regno Unito.

Internazionali:

• verso paesi UE: servizio Home Delivery, senza dati doganali;
• verso paesi extra-UE o zone soggette a dogana (ad esempio Regno Unito e Isole Canarie): ShippyPro usa automaticamente Home Delivery International. Assicurati che l'ordine contenga i dati doganali: codice HS e paese di origine di ogni articolo, EORI e Partita IVA del mittente. Se presenti, vengono inviati anche IOSS ed EORI.

Opzioni

• Label Type: PDF 4x6, ZPL 10x15 (203 DPI)
• Track & Trace: disponibile
• PickUp/DropOff (PUDO): disponibile
• Cash On Delivery: disponibile
• Return Labels: disponibile
• Return Labels (in the box): NON disponibile
• Multiparcel: disponibile
• Delete Shipment (Void): disponibile
• Closeout: disponibile (obbligatorio per tutte le spedizioni)
• Credentials Validation: disponibile
• Checkout: disponibile
• Live Rates: NON disponibile
• Book/Schedule Pickup: NON disponibile (Maersk ritira la merce presso il tuo magazzino registrato)
• Address Check: NON disponibile
• Insurance: NON disponibile
• Non-Delivery Options: NON disponibile
• Paperless: NON disponibile (resi con QR code in arrivo)
• Proof Of Delivery (POD): NON disponibile (in arrivo)
• CN22 / CN23: NON necessari. Maersk gestisce la dogana con i dati inviati nella spedizione.

Tipi di servizio

• Home Delivery: consegna a domicilio nazionale e verso paesi UE.
• Home Delivery International: consegna a domicilio verso paesi extra-UE e zone soggette a dogana. Se hai configurato Home Delivery, ShippyPro passa automaticamente a questo servizio quando la destinazione lo richiede.
• PUDO Delivery: consegna presso un punto di ritiro Maersk. Richiede l'opzione corriere Pickup Point ID.
• PUDO Return: reso con etichetta stampata dal cliente, che consegna il pacco in un qualsiasi punto di ritiro Maersk aderente. Viene utilizzato automaticamente per tutte le spedizioni di reso.

In arrivo: i servizi Select (Select Home, Select PUDO, Select PUDO Return) ed Essential. Aggiorneremo questo articolo quando saranno disponibili.

Opzioni corriere

Chiusura delle spedizioni (Closeout)

Con Maersk Global eCommerce devi chiudere tutte le spedizioni per inviare il manifest a Maersk. Alcune regole:

• chiudi insieme solo spedizioni affidate allo stesso corriere di ultimo miglio (ad esempio DHL Parcel NL): Maersk lo assegna alla creazione dell'etichetta;
• con il Pre-sort attivo, chiudi insieme solo spedizioni verso lo stesso paese di destinazione. Riceverai anche l'etichetta dell'overpack da applicare al sacco o al contenitore.

Resi

Le etichette di reso usano il servizio PUDO Return: il tuo cliente stampa l'etichetta e consegna il pacco in un qualsiasi punto di ritiro Maersk aderente. Il pacco arriva al tuo magazzino registrato.

📌 Alcuni corrieri di ultimo miglio non permettono di annullare l'etichetta di reso (ad esempio DHL Parcel NL nei Paesi Bassi). In questi casi contatta Maersk per cancellarla.

Checkout

Maersk Global eCommerce è disponibile anche in ShippyPro Checkout: puoi mostrare ai tuoi clienti la consegna a domicilio e la consegna ai punti di ritiro Maersk.

4. Errori & Risoluzioni

No matching Maersk facility found
L'indirizzo mittente non corrisponde al magazzino registrato da Maersk. Verifica con Maersk l'indirizzo registrato e usa lo stesso indirizzo come mittente in ShippyPro.

Pickup Point ID mancante
Il servizio PUDO Delivery richiede un punto di ritiro. Aggiungi l'opzione corriere Pickup Point ID alla spedizione.

Invalid PUDO
Il punto di ritiro non esiste più o non è valido per l'indirizzo del destinatario. Verifica che si trovi nello stesso paese del destinatario e selezionane uno nuovo.

No Routing Available
La tratta richiesta (paese di partenza, paese di destinazione e servizio) non è abilitata sul tuo account Maersk. Contatta il tuo Account Manager Maersk per attivarla.

declaredValue is required and must be greater than 0 for Premium coverage customers
Il tuo account Maersk ha la copertura Premium, che richiede un valore dichiarato. Contatta il nostro supporto per verificare la configurazione.

Void operation is not supported for carrier …
Il corriere di ultimo miglio non permette di annullare questa etichetta (ad esempio i resi DHL Parcel NL). Contatta Maersk per cancellarla.

Errore di chiusura: final supplier mancante o diverso
Le spedizioni selezionate sono affidate a corrieri di ultimo miglio diversi. Chiudi separatamente le spedizioni di ogni corriere.

Errore di chiusura con Pre-sort attivo
Controlla che l'Overpack Customer Code sia di esattamente 5 caratteri (A-Z, 0-9) e che tutte le spedizioni selezionate vadano verso lo stesso paese.

Invalid Credentials
Consumer Key o Consumer Secret non sono corretti. Controlla di averli copiati senza spazi.