Configurazione per integrazione con Qapla’
Grazie alla compatibilità di GEL Proximity con Qapla’ è possibile proporre agli utenti finali la selezione di un Punto di Ritiro come indirizzo di spedizione direttamente al checkout del proprio eCommerce tramite le soluzioni di GEL Proximity, e gestire la generazione dell’etichetta e il monitoraggio della spedizione direttamente da Qapla’.
Per utilizzare il servizio è necessario essere in possesso delle chiavi di accesso generate in automatico dal sistema a seguito della creazione di un account e configurare un webhook dedicato.
Nel caso non si sia in possesso di un account è necessario completare il processo di onboarding o contattare il supporto di GEL Proximity. Per maggiori informazioni consultare la sezione Introduzione Merchant.
Al fine di rendere il flusso di comunicazione tra GEL Proximity e Qapla’ completamente compatibile è necessario che per ogni Rete abilitata su GEL Proximity ci sia il relativo corriere abilitato su Qapla’.
È inoltre necessario che l’ordine venga comunicato a GEL Proximity il prima possibile, idealmente quando l’ordine viene pagato dall’utente finale e il checkout viene completato. Questo è possibile farlo:
- nel caso si utilizzino integrazioni custom, utilizzando le API di creazione dell’ordine;
- nel caso si utilizzi uno dei plugin di GEL Proximity, configurando gli opportuni stati di conferma dell’ordine;
Se queste configurazioni non vengono rispettate alcuni ordini presenti su Qapla’ diretti a Punti di Ritiro non saranno gestibili da Qapla’.
Il primo step di configurazione è quello di ottenere i propri codici identificativi forniti da GEL Proximity. Per farlo è necessario navigare sulla piattaforma di GEL Proximity nella sezione API e Integrazioni > Chiavi di Accesso.
I dati necessari per la configurazione di Qapla’ sono i campi Merchant Code e API Key Server.
Successivamente è necessario configurare un webhook per comunicare i dati degli ordini diretti ai Punti di Ritiro a Qaplà.
Per abilitare la funzionalità è necessario configurare un nuovo webhook andando nella sezione API e Integrazioni > Webhooks sulla piattaforma GEL Proximity, impostando il campo Tipo Evento in “Creazione di una spedizione” e il campo Destination URL con l’URL https://api.qapla.it/gelproximity/webhooks/index.php.
Una volta configurato il webhook sarà possibile visualizzarne i dettagli cliccando due volte sul webhook: il dato necessario per la configurazione di Qapla’ è il campo Token.
Una volta ottenuti i tre dati Merchant Code, API Key Server e Token del webhook, è necessario configurarli sulla piattaforma Qapla’ nella sezione dedicata a GEL Proximity.
La guida di configurazione di Qapla’ è consultabile a questo link.