Passa al contenuto
Italiano
Vai a ShippyPro
  • Non sono presenti suggerimenti perché il campo di ricerca è vuoto.

Come funziona Checkout

Ecco come il nostro strumento Checkout può semplificare il processo di spedizione

Consentire ai tuoi clienti di scegliere il metodo di spedizione che preferiscono può migliorare la loro esperienza di acquisto e incoraggiarli ad acquistare nuovamente dai tuoi canali di vendita.

ShippyPro Checkout è lo strumento perfetto per aumentare le conversioni del tuo ecommerce!

Mostrare la nostra Mappa dei Punti di Consegna offre ai tuoi clienti molta più flessibilità.

 

Sommario:


1. Prima di iniziare

 Checkout è una suite di API che consente al tuo cliente di scegliere autonomamente un punto di ritiro selezionandolo direttamente al checkout del tuo shop. 

2. Benefici dell'utilizzo di Checkout

Integrare i punti di ritiro (PUDO e locker) nel processo di checkout ti aiuterà:

  • A ridurre i costi di stoccaggio: Con quasi il 100% del primo tentativo di consegna, elimini i costi extra applicati dai corrieri per le spedizioni in attesa.

  • A risparmiare sui costi di integrazione: Il team IT non dovrà integrare separatamente le API del servizio di ritiro per ogni corriere.

  • A aumentare il tasso di conversione: Offrendo disponibilità 24/7, vicinanza al luogo di lavoro e tempo di conservazione fino a oltre 5 giorni potrai ridurre notevolmente l'abbandono del carrello.

Se applicato al processo di reso, ciò significa etichette di reso più convenienti e, ancora una volta, maggiore flessibilità per i tuoi clienti.

3. Costo

Tutti i piani (Professional ed Enterprise) includono 500 sessioni di Checkout al mese gratis, con azzeramento il primo giorno di ogni mese. Una sessione di checkout viene conteggiata ogni volta che viene eseguita una chiamata API per aggiornare le informazioni sui punti di ritiro al checkout.

Ad esempio:

  • quando un cliente inserisce il proprio indirizzo e la mappa carica i punti di ritiro nelle vicinanze, questo conta come una sessione;
  • se il cliente modifica l'indirizzo o sposta il pin sulla mappa e i punti di ritiro vengono aggiornati, questo conta come una sessione aggiuntiva.


Superate le 500 sessioni, si applica la seguente struttura di costo: 


Checkout sessioni / mese

Costo mensile mappe

 500

Gratis

501–1,000

€29

1,001–3,000

€79

3,001–6,000

€129

6,001+

€0.03 per caricamento aggiuntivo



4. Elenco di Corrieri e Marketplace

Corrieri supportati

Puoi trovare l'elenco completo dei corrieri che prevedono la consegna ai PUDO, facendo click sulla funzione "Punti di ritiro" da questa pagina: Comparazione mappa corrieri

Ecco un elenco parziale:

  • BRT API: FermoPoint

  • Colis Privé: Point Relais

  • Colissimo: Point Retrait

  • Correos: Citypaq

  • Correos Express

  • Chronopost: Points Relais Pickup

  • Chronopost Portugal: DPD PT Pickup

  • DHL EXPRESS: DHL Service Point

  • DHL Parcel: DHL Service Point

  • FedEx: Ship Centrer

  • InPost: Locker Inpost 24

  • Lietuvos Pastas v2 

  • Mondial Relay: Point Relais

  • MRW: Point Corner / Point Office

  • Nexive: Nexive inZona

  • Poste Italiane: Rete Punto Poste

  • Relais Colis: Point Relais Colis

  • San Marino Mail: Drop Off Points

  • Seur: Pickup Points

  • TNT Italy: TNT Point

  • UPS: Access Point

 

Marketplace supportati

Tutti i marketplace e i siti customizzati sono supportati, ma è richiesto un modulo personalizzato sviluppato dal tuo team IT.

Shopify

Se utilizzi Shopify, è necessario scaricare l'app Atlas per gestire la mappa dei PUDO al checkout.

Per integrare i PUDO al tuo Checkout Shopify, consulta la nostra guida dedicata su Atlas Pickup Points: Come utilizzare Atlas Pickup Points con ShippyPro

 

5. Configurazione

⚠️ Il processo di configurazione descritto di seguito richiede un effort elevato. Pertanto, è consigliata solo a chi ha accesso a un team di sviluppo in grado di creare un modulo personalizzato.⚠️

Per utilizzare Checkout segui questi step:
 
  1. Vai nella sezione Checkout > Impostazioni e:
    1. seleziona corrieri che vuoi mostrare al checkout
    2. associa un corriere a un paese specifico (opzionale)
  2. Effettua la chiamata GetDropOffPoints: restituisce i punti di ritiro più vicini per tutti i corrieri collegati, insieme alle informazioni come orari di apertura etc… così puoi mostrarli al cliente nel tuo checkout (su una mappa o in forma di lista). Puoi effettuare la ricerca per posizione utilizzando città, CAP e paese oppure, in alternativa, le coordinate lat e lng; puoi inoltre limitare la ricerca a corrieri specifici, impostare un limite al numero di risultati restituiti (fino a 50, valore predefinito 20) e definire il raggio di ricerca in chilometri (1-20 km).

  3. Hai quindi 2 possibilità:

    • Spedizione tramite API: trasmettere il Point ID nel campo CarrierOption corrispondente della chiamata Ship;
    • Spedizione tramite piattaforma: è necessaria una chiamata API aggiuntiva, ChoosePoint, per associare correttamente il punto di ritiro selezionato all'ordine in entrata. Questo processo garantisce che l'opzione del corriere PUDO venga preselezionata automaticamente durante la creazione della spedizione, evitando così qualsiasi selezione manuale.

    Di seguito un esempio del processo:

    1. Puoi implementare un callback che ti permetta di ricevere e gestire le informazioni del punto selezionato dal cliente finale durante il checkout;

    2. Effettua una prima chiamata ChoosePoint con le informazioni del punto selezionato - esempio:

    {
    "Method": "ChoosePoint",
    "Params": {
    "url": "www.........it",
    "point_id": "IT1234",
    "point_name": "IT Cartoleria",
    "point_address": "P.zza Vittorio Veneto 12, 24060, Brusaporto (BG)",
    "courier_name": "BRT",
    "point_type": false,
    "apikey": "1234"
    }
    }

  4.  Riceverai un ID nella risposta, ad esempio: 

     

      {
      "id": "1234",
      "Result": "OK"
      }

       

    1. Effettua una seconda chiamata ChoosePoint, con l'ID ricevuto precedentemente nel parametro « selected_id » + il tuo « order_id » (il tuo Transaction ID interno). Questo passaggio è necessario per associare correttamente il Point ID fornito allo specifico Transaction ID.

      {
      "Method": "ChoosePoint",
      "Params": {
      "url": "www.........it",
      "selected_id": "1234",
      "order_id": "001522"
      }
      }
    2. Genera l’etichetta di spedizione: inserisci l'ID del punto scelto dal cliente nella Carrier Option del corriere durante la chiamata Ship.

     

    6. FAQ

    • 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.