Spedizioni FedEx con Kliveer: preventivo, lettera di vettura e ritiro

Il modulo Spedizioni FedEx ti permette di creare le spedizioni FedEx direttamente dagli ordini e dai documenti di Kliveer: chiedi le tariffe a FedEx, scegli il servizio, generi la lettera di vettura (LDV) con un'etichetta per ogni collo e, se vuoi, prenoti il ritiro. Il costo e il codice di tracking tornano sul documento, e lo stato della spedizione si aggiorna da solo.

Cosa ti serve prima

• Il modulo FedEx attivo e assegnato agli utenti che spediscono. Se non l'hai ancora fatto, segui la guida come attivare un modulo dal marketplace.
• Un Codice Cliente FedEx della tua azienda.
• Un progetto API nel FedEx Developer Portal, con le API di autorizzazione, tariffe e tempi di transito, disponibilità dei servizi, Ship, tracking, ritiro e validazione indirizzi. Dal progetto ricavi API Key, Secret Key e Account Number.

Nel menu del gestionale il modulo si chiama FedEx e contiene le voci Spedizioni, Nuova LDV, Impostazioni, Automazioni, Log e storico e Guida. La Guida interna ha le schermate del portale FedEx: tienila aperta mentre crei il progetto.

Configurare il collegamento con FedEx

1. Nel FedEx Developer Portal crea l'organizzazione della tua azienda. Alla domanda sul tipo di azienda scegli l'opzione per chi spedisce con FedEx e ha bisogno di integrare le API FedEx nel proprio sistema: usare un gestionale non ti rende un fornitore di software.
2. Crea il progetto API e copia le chiavi di TEST: API Key, Secret Key e Account Number di test.
3. In Kliveer apri FedEx > Impostazioni, scegli l'Ambiente TEST e inserisci API Key come Client ID, Secret Key come Client Secret e l'Account Number.
4. Scegli il Corriere FedEx della tua azienda, il Formato PDF delle etichette e la Modalità ritiro, poi premi Salva impostazioni e Test OAuth per controllare che le chiavi funzionino.
5. Quando le prove in TEST sono andate bene e hai completato le verifiche richieste da FedEx, inserisci le chiavi e l'Account Number di produzione e passa l'ambiente a PRODUZIONE. Non riutilizzare le chiavi di test: cambiando ambiente Kliveer non carica un secondo set di credenziali, quindi controlla i tre valori prima di salvare.

In TEST le email e i messaggi WhatsApp delle automazioni sono sempre simulati e le tariffe di prova non sono quelle commerciali: usa documenti di prova.

Nella stessa pagina trovi i Valori predefiniti spedizione: il contenuto e il collo iniziale proposti, l'Origine predefinita delle nuove spedizioni e i Tipi di documento con il pulsante Genera LDV, cioè i documenti in fondo ai quali vuoi vedere il pulsante FedEx.

Creare una spedizione da un ordine

1. Apri l'ordine o il documento e scegli FedEx dal menu azioni. In alternativa vai su FedEx > Nuova LDV e indica il numero del documento.
2. Scegli l'origine: Spedizione dalla mia azienda oppure Drop shipping da fornitore, che richiede un fornitore collegato all'ordine. Se cambi origine premi Aggiorna mittente prima di compilare il resto.
3. Controlla mittente e destinatario. Puoi correggerli nella maschera senza modificare l'anagrafica del cliente. Per gli indirizzi italiani usa la sigla della provincia, per esempio RM.
4. Per ogni collo inserisci peso in kg e dimensioni in cm, poi la data e il contenuto. Se spedisci merci pericolose, batterie al litio o ghiaccio secco, indicalo nel campo Opzioni collo.
5. Se spedisci in un altro Paese compila anche il blocco Dogana e documenti ETD: righe merce, scopo della spedizione, Incoterm e chi paga dazi e tasse. Puoi far generare la fattura commerciale a FedEx oppure caricare i tuoi documenti (PDF, PNG o JPG fino a 5 MB).
6. Premi Calcola spedizione. Kliveer ti mostra costo, servizio, tempi di transito e supplementi restituiti da FedEx. Se vuoi vedere anche le date di ritiro disponibili, spunta Verifica anche le disponibilità di ritiro.
7. Scegli la tariffa e premi Genera LDV. Il preventivo vale 30 minuti: dopo va ricalcolato.
8. Apri o scarica le etichette dal dettaglio della spedizione: ogni collo ha la sua, ristampabile in qualsiasi momento.

Il costo del corriere e il tracking vengono riportati sul documento, e il costo entra tra le Spese di spedizione dei costi accessori, così il margine dell'ordine resta corretto. Quando apri il composer email del documento, le LDV FedEx sono già proposte come allegati.

Prenotare il ritiro

Puoi prenotare il ritiro insieme alla LDV oppure dopo:

• Insieme alla LDV: se nel preventivo hai chiesto le disponibilità di ritiro, nel riquadro Ritiro FedEx è già spuntato Prenota il ritiro insieme alla LDV. Scegli data e orari e premi Genera LDV una sola volta.
• In un secondo momento: nel dettaglio della spedizione apri Ritiro FedEx, premi Verifica disponibilità ritiro, scegli Merce pronta alle e Chiusura sede alle tra gli orari proposti da FedEx e premi Conferma ritiro.

Conserva il codice di conferma che compare nel dettaglio. Con i servizi Freight (pallet) il ritiro va richiesto dal portale FedEx o per telefono.

Tracking e automazioni

Kliveer controlla periodicamente lo stato delle spedizioni FedEx; l'intervallo (in ore) si imposta in FedEx > Impostazioni. Se non vuoi aspettare, nel modulo trovi Esegui controllo ora. In FedEx > Automazioni puoi creare regole che, al cambio di stato, inviano al cliente un'email o un messaggio WhatsApp con i modelli già preparati nei rispettivi moduli.

Errori comuni

• EXPRESS.SERVICE.INVALID: FedEx non trova servizi per i dati e la data indicati. Controlla prima la data (prova un giorno lavorativo), poi che CAP, città e provincia siano coerenti.
• FORBIDDEN.ERROR durante la creazione della LDV: FedEx ha rifiutato la spedizione anche se il preventivo funzionava. Apri il registro delle chiamate nel dettaglio e verifica chiavi, Account Number e abilitazioni del tuo contratto.
• Timeout o pagina ricaricata durante la generazione: non creare subito una nuova LDV. Nel dettaglio usa Verifica esito incerto per registrare il tracking trovato su FedEx o confermare che la spedizione non è stata creata.
• Riferimento o istruzioni di ritiro troppo lunghi: il riferimento LDV accetta al massimo 30 caratteri e le istruzioni di ritiro 25. Il contatore diventa rosso e Kliveer blocca l'invio invece di tagliare il testo.