Scopo: In questa guida ti spieghiamo come attivare i service points per le integrazioni API. Questo articolo si concentra sulla configurazione del selettore dei service points in un negozio online personalizzato e costruito su misura, al quale Sendcloud si collega tramite un'integrazione API e non tramite un plugin plug and play.
API di Sendcloud
Le API di Sendcloud forniscono le funzionalità e gli strumenti per aiutarti a costruire l'automazione delle spedizioni intorno alla piattaforma Sendcloud, in modo da semplificare il processo di spedizione e automatizzare il flusso logistico.
Puoi integrare le principali funzionalità di Sendcloud con il tuo sistema di e-commerce personalizzato. Puoi trovare la nostra documentazione completa sull'integrazione dell'API di Sendcloud sul Portale degli sviluppatori.
L'API Service Point
L'API Service Point ti fornisce le informazioni necessarie per consegnare i tuoi pacchi in un service point o per inviarli a un punto di ritiro (service point) scelto dal tuo cliente. L'API fornisce quattro endpoint che ti permettono di recuperare le ubicazioni, verificarne la disponibilità e memorizzarle nella tua piattaforma Sendcloud per utilizzarle durante il processo di pagamento.
Vedi la nostra Guida all'API Service Point.
Integrazione del selettore dei punti di ritiro
Sendcloud offre un selettore di punti di ritiro che può essere facilmente integrato nel tuo sistema. Nella tua pagina di pagamento apparirà una mappa dalla quale i tuoi clienti potranno scegliere dove ritirare il loro pacco. Per saperne di più sui punti di ritiro, clicca qui.
Tieni presente che il nome del punto di ritiro è visibile nella lingua impostata nel tuo account e non nella lingua del browser web.
Prima di iniziare, assicurati di aver
- Ottenuto le chiavi API
- Attivato i service point (punti di ritiro) per i corrieri che desideri utilizzare. Vai su Impostazioni > Integrazioni.
Per integrare il selettore di service point di Sendcloud con il tuo negozio personalizzato:
- Prova questo esempio live. Quando selezioni un service point, riceverai come risultato un service point object e un post number, se ne hai inserito uno. Questi dati ti serviranno in seguito quando creerai una nuova spedizione tramite la nostra API di spedizione (vedi la sezione Create a parcel (Crea una spedizione) nella nostra Guida di riferimento all'API di spedizione).
-
Assicurati di completare i parametri
to_service_point
eto_post_number
quando invii i dati. - Puoi copiare il codice che troverai quando scorri verso il basso qui, nella sezione Usage.
Per integrarlo con il codice del tuo backend:
- Devi effettuare una richiesta a sendcloud.servicePoints.open e fornire un oggetto di configurazione, un callback di successo e un callback di errore (esempio).
- Una vez seleccionado un punto de servicio, nuestra biblioteca llamará a tu función callback con un objeto de punto de servicio. Este contendrá las propiedades de la dirección del punto de servicio y el identificador
service_point_id
único. Una volta selezionato un punto di ritiro, chiameremo la tua funzione di callback con un oggetto service point. Contiene le proprietà dell'indirizzo del service point e l'identificatore unicoservice_point_id
. - Quando crei una spedizione tramite l'API, dovrai strutturare la tua richiesta in modo da includere le informazioni sull'indirizzo del punto di ritiro. Nel parametro
to_service_point
, includi l'ID del punto di ritiro. - Puoi trovare una guida sulla creazione di spedizioni presso i punti di ritiro tramite l'API Sendcloud qui.
Link utili:
- Documentazione API di Sendcloud:
https://api.sendcloud.dev/docs/sendcloud-public-api/ - Esempio di integrazione del selettore di punti di ritiro:
https://sendcloud-public.gitlab.io/spp-integration-example/ - Archivio di esempi di integrazione di punti di ritiro:
https://gitlab.com/sendcloud-public/spp-integration-example
Cronologia delle versioni
Versione: 1.0.0
Data: 11-01-2017
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js