Prima di iniziare
Per poter configurare il corriere FedEx su Poleepo devi creare un account come Developer sul sito di FedEx: https://developer.fedex.com/api/it-it/home.html
Dovrai accedere o iscriverti inserendo l'ID utente e la Password.
Crea un'organizzazione
Per creare e utilizzare FedEx API nelle transazioni, è necessario essere membri di un'organizzazione. Chiedete a un membro di un'organizzazione di invitarvi a farne parte, o se la vostra azienda è nuova nel portale FedEx Developer, create una nuova organizzazione.
Per creare un'organizzazione, sono necessari un codice Cliente FedEx e alcune informazioni relative alla vostra fatturazione.
Per creare un'organizzazione, devi dare alcune informazioni a FedEx sulla tua azienda.
Nel caso d'esempio nella figura in basso, verrà selezionata la prima opzione.
Dovrai poi inserire il nome della società, il sito web dell'azienda e il nome dell'organizzazione.
1. Crea i tuoi progetti di integrazione
Occorre poi creare i progetti di integrazione: clicca su crea un progetto per iniziare a fare richieste API.
Per creare un progetto API è necessario inanzitutto comunicare il motivo per cui si ha bisogno dell'accesso API.
1) Poleepo Shipping Integration → serve per poter gestire le spedizioni con Poleepo
-Seleziona il pulsante API spedizione, tariffe e di altro tipo)
Occorre poi selezionare tutte le API che vengono fuori dopo aver cliccato il bottone arancione:
Successivamente dovrai dare un nome al progetto e indicare l'Italia come paese dal quale si intende spedire, in modo tale che FedEx potrà assegnarvi un Codice Cliente di prova.
Dovrete poi scegliere se spedire con FedEx Smart Post o FedEx Freight LTL e cliccare su "avanti".
Dovrai poi accettare i termini e creare il progetto API:
Avrai così creato la chiave API Test e la chiave API segreta Test per le spedizioni (copiale poichè dovrai inviarle in seguito all'assistenza di Poleepo insieme alle chiavi API Tracking che mostreremo di seguito come creare)
2) Poleepo Tracking Integration → serve per recuperare il tracking delle spedizioni,
per crearla dovrai creare un nuovo progetto, comunicare a FedEx il motivo per cui si ha bisogno dell'accesso API e selezionare l'opzione API monitoraggio.
Dovrai dare un nuovamente un nome al progetto, selezionare l'Italia come Paese da cui si intende spedire per farti assegnare da FedEx un codice cliente prova e cliccare su avanti.
Avrai così creato la chiave API test e la chiave API segreta Test per il tracking che dovrai copiare e inviare a Poleepo insieme alla coppia di chiavi test per la spedizione precedentemente create.
Invia infine le due coppie di chiavi API test create
(coppia di chiavi API spedizioni e coppia di chiave API tracking) all'assistenza di Poleepo, aprendo un ticket, la quale ti rimanderà 4 spedizioni di test da inoltrare al tuo referente FedEx chiedendo la validazione.
2. Come aggiungo il mio codice cliente su FedEx?
In questi passaggi vedremo invece come aggiungere il codice cliente su FedEx, da inserire nella configurazione del corriere su Poleepo e per creare le chiavi di Produzione Spedizione e Tracking da inserire nella configurazione.
Partendo da menù di FedEx, vai nella sezione "gestire organizzazione" > Codice cliente di spedizione > aggiungere Codice Cliente.
Dovrai poi inserire il Codice Cliente FedEx a nove cifre e il soprannome del Codice Cliente.
Dovrai poi inserire l'indirizzo di fatturazione aziendale, indicando l'Italia come Paese, aggiungendo le altre informazioni nei box, lasciando libero il campo Stato/Provincia e cliccare su "avanti".
Dovrai poi dichiarare che le precedenti dichiarazioni sono veritiere per poter cliccare e aprire il link in alto "accordo di licenza finale".
N.B. se non si aprirà il link all'inizio non si potrà spuntare l'opzione finale "ho letto, compreso e accettato" per poter proseguire.
Dopo aver accettato tutti i termini clicca su "aggiungi codice cliente".
Avrai così aggiunto con successo il codice cliente alla tua organizzazione FedEx che ti servirà per la configurazione del corriere su Poleepo e per portare in produzione le chiavi API per le spedizioni e per il tracking.
3. Come ottengo le mie chiavi di produzione spedizione e tracking?
Per ottenere le chiavi di produzione spedizione e tracking, clicca nella sezione " i miei progetti" del tuo account FedEx.
1) Poleepo Shipping Integration -Clicca su Poleepo Spedizioni
Clicca su "Chiave di produzione".
Dai un nome alla Chiave, seleziona il codice cliente in figura e clicca su avanti.
Avrai così generato le la chiave API e la chiave segreta di produzione per le spedizioni da usare nella configurazione di Poleepo.
Copiale e tienile al sicuro, ricorda che sono informazioni sensibili.
2) Poleepo Tracking Integration -Clicca su Poleepo Tracking
Clicca su "Chiave di produzione".
Dai un nome alla Chiave, seleziona il codice cliente in figura e clicca su avanti.
Avrai così generato le la chiave API e la chiave segreta di produzione per il tracking da usare nella configurazione di Poleepo.
Copiale e tienile al sicuro, ricorda che sono informazioni sensibili.
Una volta create le coppie di chiavi Spedizione e Tracking, dovrai inviarle a FedEx per la convalida.
4. Configura FedEx su Poleepo
Premessa: dove posso trovare i dati richiesti?
I dati necessari alla configurazione di Fedex sono normalmente forniti dal corriere stesso.
Nel campo "Codice Cliente" va inserito il codice cliente, tipicamente è composto da 7 caratteri numerici.
I campi "Chiave API" e "Chiave Segreta" devono essere richiesti a FEDEX specificando che si necessita di un’utenza per l’integrazione tramite API di FEDEX.
La modalità di lavoro "AutoConferma" deve essere decisa in fase di attivazione con il personale FedEx. Con questa modalità operativa, nel momento in cui si affidano le spedizioni a FEDEX, queste spedizioni sono direttamente confermabili dalla filiale di gestione.
Configura FedEx
Per raggiungere la configurazione di FedEx su Poleepo vai su menù > configurazione> corrieri e clicca sul corriere FedEx.
Dovrai compilare i campi richiesti:
Codice Cliente;
Chiave API;
Chiave Segreta;
Nome della configurazione;
Chiave API Tracking;
Chiave Segreta Tracking;
Tipo di stampa predefinito (PDF o ZEBRA);
Gestione costi doganali (se a carico del mittente, del ricevente, a carico di terze parti o pagato alla consegna dal destinatario)
Dovrai selezionare il tipo di servizio di spedizione (nazionali e internazionali)
Spuntare la spunta bianca se hai un ritiro già programmato;
Indicare gli orari di apertura e chiusura del mattino e del pomeriggio, orario della disponibilità della merce e ora del ritiro;
Clicca poi sul pulsante "salva" in basso a destra per salvare la configurazione.
Infine abilita il corriere FedEx con la spunta in alto a destra e scegli se impostarlo come corriere di Default cliccando sulla stella affianco al pulsante.
