In questo articolo

Articoli in questa sezione

Service Points per integrazioni API

Team Sendcloud
  • Aggiornato

Obiettivo: In questa guida scoprirai come abilitare i Service points per integrazioni API.

Cos'è il Service Point Picker?

Alcuni corrieri offrono Service Point ai tuoi clienti per l'invio dei loro pacchi, in modo che possano ritirare il pacco da soli, come desiderano, in un luogo vicino. Sendcloud offre il Service Point Picker che può essere facilmente integrato in qualsiasi sistema per fornire un'ottima interfaccia per scegliere tra i punti di servizio disponibili.

Nota: la lingua del selezionatore di Service Points è impostata dalle impostazioni della lingua dell'account e non dalla lingua del browser. 

Come funziona?

Questo articolo si concentra sulla configurazione del Service Point Picker in un shop personalizzato. Questi shop devono essere integrati direttamente alle API SendCloud senza un plugin fornito da noi.

Cronologia delle Versioni

Versione: 1.0.0
Data: 2017-01-11 
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js

Links collegati

Documentazione API SendCloud
https://docs.sendcloud.sc/api/v2/index.html

Esempi di integrazioni Service Point Picker
https://sendcloud.github.io/spp-integration-example/

Archivio di esempio di integrazione di Service Point Picker
https://github.com/SendCloud/spp-integration-example/

Step 1: Ottenere una chiave API

  1. Una volta effettuato l'accesso al tuo pannello, clicca su 'Impostazioni' nel menu in alto a destra
  2. Clicca su Integrazioni
  3. Cerca Sendcloud API nella barra di ricerca e clicca su 'Connetti'
  4. Seleziona la casella 'Service Point'
  5. Abilita i corrieri per cui vuoi attivare i service points 
  6. Clicca su 'Salva' ancora una volta

Step 2: Configurare un'integrazione Service Point Picker

Per poter configurare un'integrazione Service Point Picker, devi prima avere un'integrazione personalizzata completamente utilizzabile con la nostra API. Puoi consultare una guida su come configurarlo qui.

Una volta ottenuta l'integrazione API funzionante, segui la procedura per configurare il Service Point Picker come segue:

  1. Assicurati di aver abilitato i Service Points nelle impostazioni della tua integrazione
  2. Copia il codice integrato JavaScript disponibile nella pagina delle impostazioni di Integrazione
  3. Incolla il codice JavaScript nella tua pagina di checkout
  4. A questo punto, puoi dare un'occhiata ai nostri esempi per Service Point Picker.

Step 3: Una rapida guida passo passo su come integrare il codice JavaScript al tuo codice backend

  1. È necessario chiamare sendcloud.servicePoints.open e fornire un oggetto config, un callback di successo e un callback di errore. (esempio)
  2. Una volta scelto un Service Point, la nostra libreria chiamerà la tua funzione di callback con un Service Point Object. Le informazioni principali che stai cercando sono l'ID del Service Point e tutte le proprietà dell'indirizzo all'interno. È necessario tenere traccia di questo ID in qualche modo, una volta che sarà utilizzato per creare una nuova spedizione nella nostra API
  3. Quando la spedizione del pacco viene creata nella nostra API devi assicurarti di passare tutte le informazioni corrette dell'indirizzo nei campi dell'indirizzo e soprattutto riempire il parametro to_service_point con l'ID del Service Point.

Una volta che hai seguito tutti i passi di cui sopra, la tua integrazione dovrebbe funzionare correttamente.

 

Articoli correlati