Come funziona Checkout: i punti di ritiro nel checkout del tuo ecommerce

Cos'è un punto di ritiro al checkout?

Un punto di ritiro (detto anche punto di consegna, PUDO o locker) è un luogo di ritiro che il cliente sceglie direttamente al checkout del tuo ecommerce, al posto della consegna a domicilio. Con ShippyPro Checkout, una suite di API, i tuoi clienti scelgono il punto in autonomia, su una mappa o in forma di lista.

In che modo i punti di ritiro aumentano il tasso di conversione del checkout?

I punti di ritiro offrono disponibilità 24/7, vicinanza al luogo di lavoro e tempo di conservazione fino a oltre 5 giorni. Questi vantaggi riducono l'abbandono del carrello e danno ai clienti più flessibilità al checkout.

Quanto costa ShippyPro Checkout?

Tutti i piani (Professional ed Enterprise) includono 500 sessioni di Checkout al mese gratis. Oltre questa soglia, il costo mensile delle mappe è di €29 fino a 1.000 sessioni, €79 fino a 3.000, €129 fino a 6.000, poi €0,03 per ogni caricamento aggiuntivo.

Serve uno sviluppatore per aggiungere i punti di ritiro al checkout?

Sì, per i siti customizzati e la maggior parte dei marketplace è richiesto un modulo personalizzato sviluppato dal tuo team IT. Se utilizzi Shopify, puoi invece gestire la mappa dei PUDO al checkout con l'app Atlas.

Posso usare i punti di ritiro anche per i resi?

Sì. Applicati al processo di reso, i punti di ritiro significano etichette di reso più convenienti e maggiore flessibilità per i tuoi clienti.

Come posso attivare Checkout?

La sezione Checkout è già attiva nel tuo profilo

Posso mostrare le tariffe applicate ai miei clienti al checkout del mio shop tramite ShippyPro?

Sì, puoi mostrare le Live Rates (tariffe in tempo reale) al checkout tramite la chiamata API GetRates, che restituisce le tariffe dei tuoi corrieri. Successivamente, dovrai sviluppare un modulo personalizzato che ti permetta di applicare sovrapprezzi o adeguare queste tariffe a quelle effettivamente applicate ai tuoi clienti finali.

Non riesco a visualizzare i punti PUDO per nessun corriere

Controllare le credenziali del corriere nella pagina Corrieri. Se si hanno più vettori, deselezionarne uno alla volta dalla pagina Checkout > Impostazioni per vedere quale ha le credenziali sbagliate.

We can't find zip from coordinates

L'errore indica che è stato inserito nella barra di ricerca un dato impreciso, ricorda che è necessario inserire un indirizzo ed un cap specifico per poter permettere la ricerca dei PUDO.

Posso configurare prezzi dinamici?

No, non è possibile configurare prezzi dinamici tipo "spedizione gratuita oltre una certa spesa".

Riscontro errore "Ship and Collect feature is not enabled for this user", come mai?

Hai esaurito le 500 mappe mensili gratuite, quindi è necessario attivare il piano a consumo cliccando su Attiva Piano dalla sezione Checkout:

❓ Perché ricevo "Domain not found" o non trovo le impostazioni dei domini?

Non trovi dove aggiungere i domini dei tuoi negozi nella nuova interfaccia? Puoi comunque accedere direttamente alla configurazione dei domini.

1. Accedi al tuo account ShippyPro.
2. Apri la pagina di configurazione dei domini in un'altra scheda del browser.
3. Clicca su Aggiungi dominio per aggiungere il dominio del tuo negozio.
4. In Associated ShippyPro Marketplace, seleziona la connessione che importa gli ordini di quel negozio.
5. Salva la configurazione.

Aggiungi separatamente tutti i domini dei tuoi negozi e associa ciascuno alla connessione marketplace corretta prima di riprovare ChoosePoint.

📌 Nota: Il parametro url inviato in entrambe le chiamate ChoosePoint deve appartenere al negozio associato a quell'ordine. Se gestisci più negozi, non inviare il dominio di un altro negozio.

❓ Come posso accedere al widget legacy?

Il nostro Team di Supporto può abilitare il widget legacy, che consente di accedere alle vecchie funzioni all'interno di Checkout. Per richiederne l'attivazione, scrivi al nostro Team di Supporto tramite il pulsante HELP nel tuo account.

Se il salvataggio dei domini restituisce "Operation not permitted", segnala l'errore anche se l'interfaccia mostra "SAVED". Includi i domini, i passaggi eseguiti, screenshot o dettagli dell'errore e indica se compare in una risposta API. L'apertura della pagina di configurazione o l'abilitazione del widget legacy non sono soluzioni confermate per gli errori di autorizzazione.

❓ Come associo un punto di ritiro PrestaShop a un ordine CTT v2?

CTT v2 supporta le spedizioni verso punti di ritiro. L'associazione automatica del punto selezionato su PrestaShop richiede uno sviluppo personalizzato: non è disponibile nativamente. Non esiste uno script pronto per questa integrazione. I tuoi sviluppatori possono usare GetDropOffPoints per creare l'interfaccia di selezione dei punti.

Per le istruzioni di connessione, consulta Come connettere CTT v2 e Come connettere PrestaShop. Per la selezione manuale, consulta Come aggiungere un Punto di Consegna alle tue spedizioni.

⚠️ Importante: Inserire i dati del punto nella ragione sociale o nell'indirizzo del destinatario non sostituisce l'opzione corriere PUDO richiesta. Recupera il PointID tramite GetDropOffPoints e usalo senza modificarlo. Non costruirlo aggiungendo un prefisso con il codice paese.

Per le etichette create dalla piattaforma, il tuo sviluppatore deve seguire questo flusso CTT v2/PrestaShop:

1. Importa un nuovo ordine PrestaShop in ShippyPro.
2. Esegui la prima chiamata ChoosePoint con i dati del punto selezionato.
3. Usa l'id di conferma restituito in una seconda chiamata ChoosePoint subito dopo, per associare la selezione all'ordine.
4. Controlla le opzioni corriere dell'ordine in Ready to Ship: il punto di ritiro scelto dovrebbe essere preselezionato.

Prima chiamata ChoosePoint: parametri

• url: il dominio configurato del negozio a cui appartiene l'ordine.
• point_id: il PointID restituito da GetDropOffPoints, senza modifiche.
• point_name: il nome del punto selezionato.
• point_address: l'indirizzo del punto selezionato.
• courier_name: CTTv2, non CTT.
• point_type: il tipo di punto.
• apikey: la tua chiave API.

La prima chiamata restituisce un id di conferma. È questo il valore da inviare come selected_id, non il PointID del punto di ritiro.

Seconda chiamata ChoosePoint: parametri

• url: lo stesso dominio del negozio usato nella prima chiamata.
• selected_id: l'id di conferma restituito dalla prima chiamata.
• order_id: il Transaction ID interno dell'ordine PrestaShop.

📌 Nota: Per questo flusso, esegui la seconda chiamata entro 30 minuti dalla prima. L'ordine deve essere stato creato su PrestaShop da meno di tre ore. Importa prima un nuovo ordine, poi esegui entrambe le chiamate una subito dopo l'altra. Questi requisiti temporali, da soli, non dimostrano il motivo di un tentativo precedente non riuscito.

❓ Serve ChoosePoint per creare etichette CTT v2 tramite Ship API?

No. Nella richiesta Ship, includi una voce CarrierOptions con name cttv2pointid e il PointID non modificato come value.

❓ Cosa devo controllare se il punto continua a non comparire?

• Verifica che ogni dominio sia registrato e associato alla connessione che importa gli ordini di quel negozio.
• Verifica che entrambe le chiamate inviino il dominio del negozio a cui appartiene l'ordine interessato.
• Verifica che courier_name sia CTTv2, selected_id contenga l'id di conferma restituito e order_id contenga il Transaction ID interno.
• Verifica che entrambe le chiamate rispettino la sequenza e le tempistiche indicate sopra.
• Evita connessioni PrestaShop duplicate che puntano allo stesso sito e gestiscono gli stessi ordini: possono causare anomalie di importazione.

Se l'associazione continua a non riuscire, lascia un ordine recente importato in Ready to Ship senza generare l'etichetta o modificarlo. Scrivi al nostro Team di Supporto tramite il pulsante HELP nel tuo account e fornisci il riferimento dell'ordine, entrambe le chiamate ChoosePoint con le relative risposte e la conferma della configurazione dominio-marketplace.