Caratteristiche di Sistema
In questa sezione viene presentato il servizio di GEL Proximity, la piattaforma e le sue caratteristiche per consentire una corretta integrazione del servizio.
GEL Proximity è un servizio che permette di effettuare spedizioni e resi a Punti di Ritiro. Allo stesso modo, consente alle Reti ed eventualmente anche agli stessi eCommerce di mettere a disposizione i propri Punti di Ritiro e di gestire i flussi operativi di cui una Rete di Punti di Ritiro ha bisogno.
La piattaforma di GEL Proximity consente di effettuare l’integrazione tramite librerie e API dedicate utilizzabili da qualsiasi sistema informatico senza limitazioni. Lo scopo di GEL Proximity è quello di rendere l’integrazione con differenti Reti di Punti di Ritiro semplice e unificata, gestendo internamente tutte le complessità di uniformare dati eterogenei ed esponendo metodi di integrazione univoci e scalabili.
La piattaforma di GEL Proximity è pensata per gestire un alto numero di volumi di operazioni in modo efficiente. Per questo motivo la gestione delle richieste è spesso gestita in modo asincrono e massivo. Qui di seguito vengono illustrate le logiche principali di funzionamento asincrono da comprendere per effettuare una corretta integrazione.
Il sistema di GEL Proximity registra tutte le richieste di conferma di nuovi ordini di spedizione o reso che vengono effettuati da ogni Merchant. In questa fase gli ordini, definiti ordini temporanei, non sono visibili in piattaforma e devono prima essere processati: ogni minuto un processo automatizzato identifica in modo massivo gli ordini di spedizione e reso da importare, e una volta verificati li rende disponibili in piattaforma. Questa operazione è detta importazione di un ordine.
La generazione delle etichette di ordini di spedizione e reso su GEL Proximity può avvenire in due modi:
La modalità di generazione automatica delle etichette non è abilitata di default. Per attivarla è necessario contattare il supporto di GEL Proximity.
Le notifiche email relative all’aggiornamento di spedizioni e resi vengono inviate automaticamente dalla piattaforma ogni 5 minuti. Gli eventi che scatenano una notifica possono essere gestiti dal Merchant nel proprio pannello di amministrazione.
Per consentire di verificare l’integrazione sui propri sistemi GEL Proximity offre due tipologie differenti di ambienti: Test e Produzione.
L’ambiente di Test è l’ambiente da utilizzare in fase di integrazione con GEL Proximity o durante qualsiasi attività di test. Tutte le richieste che verranno effettuate in ambiente di Test non genereranno nessun ordine definitivo nè li comunicheranno alle Reti di competenza.
Per utilizzare l’ambiente di Test è necessario apporre davanti ad ogni endpoint o dove richiesto l’URL:
https://test-platform.gelproximity.com/
L’ambiente di Produzione è l’ambiente da utilizzare solamente in un processo che genera ordini reali di spedizione e reso.
Per utilizzare l’ambiente di Produzione è necessario apporre davanti ad ogni endpoint o dove richiesto l’URL:
https://platform.gelproximity.com/
Tutte le chiamate che verranno effettuate nell’ambiente di Produzione genereranno ordini reali di spedizione e reso. È necessario utilizzare questo ambiente solamente nella versione di produzione del sistema del Merchant.