Mittente FedEx
Prerequisito
Per effettuare il login a FedEx Developer Portal e creare un'organizzazione, è necessario disporre di un ID utente FedEx.
Unitevi all'organizzazione aziendale per collaborare con il vostro team. Se l'azienda non dispone di un'organizzazione, createne una.
Unirsi a un'organizzazione esistente
1. Richiedete un invito
Chiedete all'amministratore dell'organizzazione di inviarvi un invito. Avete 24 ore per accettarlo. Se l'invito scade, chiedete all'amministratore di inviarlo di nuovo.
2. Accettate l'invito
Effettuate l'accesso la combinazione di ID utente e password esistente. Se il vostro ID utente è associato a un'altra organizzazione, create un nuovo ID.
Creare una nuova organizzazione
Quando create un'organizzazione, ne diventate amministratori. In qualità di amministratori, potete invitare gli utenti a unirsi all'organizzazione, assegnare progetti e ruoli utente e gestire i Codici Cliente di spedizione.
Per avere ulteriori informazioni sui ruoli utente, consultate le Linee guida per l'amministrazione dell'organizzazione.
1. Effettuate l'accesso al FedEx Developer Portal.
2. Dal menu, selezionate prima I miei progetti e poi Crea un'organizzazione.
3. Inserite i seguenti dettagli:
- Per Lavoro per un'azienda che, selezionate Spedisce con FedEx e ha bisogno di integrare API FedEx nelle proprie applicazioni
- Inserite il nome dell'azienda, il sito web e un nome dell'organizzazione che il team riconoscerà, come il nome dell'azienda, il reparto, la divisione o l'area.
4. Selezionate Crea.
È possibile aggiornare o aggiungere dettagli in un secondo momento nella sezione Gestisci organizzazione del menu.
Aggiungere un Codice Cliente di spedizione
1. Selezionate Aggiungi Codici Cliente di spedizione nel riquadro Aggiungi Codici Cliente. Se non avete un Codice Cliente FedEx, selezionate Crea un Codice Cliente per aprirne uno nuovo oppure contattate l'Assistenza FedEx.
2. Selezionate + Aggiungi Codice Cliente.
3. Inserite il vostro Codice Cliente FedEx, un nickname per il Codice Cliente e l'indirizzo di fatturazione usato durante la configurazione del Codice Cliente.
4. Accettate l'Accordo di licenza utente finale oppure inoltratelo a un rappresentante autorizzato della vostra azienda.
Aggiungere un Codice Cliente di fatturazione
1. Selezionate la scheda Codici Cliente di fatturazione. Se non avete un Codice Cliente di fatturazione FedEx, selezionate Apri Codice Cliente di fatturazione per aprirne uno nuovo oppure contattate l'Assistenza FedEx.
2. Selezionate Aggiungi Codice Cliente di fatturazione. I Codici Cliente di fatturazione devono avere sede negli Stati Uniti.
3. Inserite il vostro Codice Cliente FedEx, un nickname per il Codice Cliente e l'indirizzo di fatturazione statunitense usato durante la configurazione del Codice Cliente.
4. Leggete e accettate l'Accordo di licenza utente finale.
Invitare gli utenti come amministratori
1. Dal menu, selezionate prima Gestisci organizzazione e poi la scheda Utenti.
2. Selezionate + Aggiungi utenti.
3. Selezionate un Paese o un territorio e la lingua preferita, quindi scegliete un ruolo utente: visualizzatore, collaboratore o amministratore.
4. (Facoltativo) Assegnate l'utente a un progetto. Potete assegnare utenti in qualsiasi momento dalla pagina Panoramica del progetto.
5. Inserite gli indirizzi email degli utenti e fate clic su Invita. Potete invitare fino a 20 utenti alla volta, separando ogni indirizzo email con una virgola. Gli inviti scadono dopo 24 ore.
Crea un progetto API
1. Dal menu, selezionate prima I miei progetti, poi la scheda API t e quindi scegliete + Crea progetto API.
2. Confermate le vostre esigenze di API.
3. Selezionate le API da includere nel progetto.
4. Assegnate un nome al progetto e selezionate i Paesi in cui intendete spedire per ricevere un Codice Cliente di spedizione di prova. Per le spedizioni nazionali europee, è necessario un Codice Cliente di prova separato per ciascun Paese. Potrete aggiungere o rimuovere Paesi in un secondo momento.
5. Selezionate Impostazioni in Notifiche per impostare le preferenze di notifica.
6. Leggete e accettate i termini e le condizioni.
Creare un progetto di Visibilità integrata avanzata
Prerequisiti
- Rivedete le tariffe: agli utenti iscritti viene addebitata una quota mensile in base alla quantità di numeri di monitoraggio. Per saperne di più, consultate la Guida alle tariffe.
- Impostate i Codici Cliente: il webhook Visibilità di spedizione richiede un Codice Cliente di fatturazione con sede negli Stati Uniti e almeno un Codice Cliente di spedizione. Questi due tipi di Codice Cliente sono mutualmente esclusivi. Solo gli amministratori possono aggiungere Codici Cliente di fatturazione e spedizione nella pagina Gestisci organizzazione.
1. Create un URL di destinazione nella vostra applicazione o piattaforma per ricevere callback. L'URL deve:
- Usare il protocollo HTTPS
- Escludere lo spazio IP RFC1918, fedex.com e i suoi sottodomini, e gli indirizzi IP come localhost o 127.0.0.1.
2. Generate un token di sicurezza per l'autenticazione. Il token deve:
- Contenere da 26 a 100 caratteri, almeno una lettera maiuscola, almeno una lettera minuscola e almeno un numero
3. Dal menu, selezionate prima I miei progetti e poi la scheda Visibilità integrata avanzata.
4. Selezionate Crea progetto di Visibilità integrata avanzata.
5. Selezionate il tipo di utente.
- Mittente FedEx: chi spedisce con FedEx e ha bisogno di integrare API FedEx nelle proprie applicazioni
- FedEx Compatible Provider: è un FedEx Compatible Provider certificato
- FedEx Integrator Provider: vende o fornisce una soluzione software che usa la tecnologia FedEx ed è un FedEx Integrator Provider convalidato
6. Selezionate il tipo di sottoscrizione. Potete iscrivervi agli eventi tramite Codici Cliente o Numeri di Lettera di Vettura FedEx.
7. Confermate il Codice Cliente di fatturazione e selezionate le funzionalità desiderate, come prova di consegna, consegna stimata, eventi di monitoraggio o filtraggio basato sugli eventi.
8. Inserite i dettagli del progetto.
- Inserite un nome di progetto univoco e riconoscibile.
- Inserite l'URL di destinazione e il token di sicurezza creati.
- Inserite un indirizzo email e la lingua preferita per le notifiche sugli aggiornamenti e le interruzioni di Visibilità integrata avanzata.
9. Accettate il Modulo d'ordine e l'Accordo di licenza FedEx Developer Portal e selezionate Crea.
Nota: a seconda del tipo di sottoscrizione scelto, potrebbero essere necessari passaggi aggiuntivi. Per maggiori informazioni, consultate la documentazione sui webhook.
Seguite questi passaggi per verificare l'integrazione dell'API e confermare che l'applicazione possa inviare e ricevere dati di test.
Recuperare le credenziali di test
1. Dal menu, selezionate prima I miei progetti e poi il nome del progetto.
2. Nella scheda Chiavi API, alla voce Chiave test, trovate le vostre credenziali di test.
3. Effettuate il login e scaricate la raccolta API JSON usando il pulsante Scarica schema JSON nella parte superiore della pagina della documentazione. Riesaminate le richieste di esempio relative agli endpoint usati dall'integrazione.
4. Richiedete un token di accesso OAuth da usare per ogni transazione API.
Nota: il token è valido per un'ora e potete configurare la vostra applicazione per aggiornarlo prima che scada. Per conoscere i dettagli, consultate la documentazione su API Authorization.
5. Dal menu, selezionate Catalogo API, scegliete l'API che volete usare e selezionate Documentazione.
6. Dal menu, selezionate l'endpoint.
7. Inviate richieste di esempio usando le credenziali di test e l'URL di test FedEx, quindi verificate che le risposte corrispondano agli esempi della documentazione. Per conoscere i dettagli, consultate la Guida alla virtualizzazione della sandbox.
8. Eseguite test con Visibilità integrata avanzata per generare dati di esempio e verificare che l'applicazione elabori correttamente le informazioni di monitoraggio.
Nota: il test non autentica l'URL di callback. Per conoscere i dettagli, consultate la documentazione su Visibilità integrata avanzata.
Spostare il progetto in produzione
Definite la configurazione di produzione prima della pubblicazione. Potete rinominare la chiave, aggiungere Codici Cliente supplementari dopo la pubblicazione del progetto e rivedere il Codice Cliente selezionato durante la creazione del progetto. Questo Codice Cliente trasferirà il progetto all'ambiente di produzione.
Nota: i progetti di Visibilità integrata avanzata basati sul Codice Cliente non richiedono l'attivazione della produzione.
1. Dal menu, selezionate prima I miei progetti e poi il nome del progetto.
2. Selezionate la scheda Chiave di produzione.
3. Recuperate e conservate al sicuro le credenziali di produzione.
- Copiate la chiave API e la chiave segreta di produzione in un luogo sicuro.
- Quando richiedete una chiave di produzione, salvatela in un luogo sicuro, perché viene visualizzata solo una volta. Se la perdete, sarà possibile generarne una nuova in un secondo momento.
4. Selezionate Avanti per visualizzare i dettagli del progetto nella scheda Chiave di produzione.
Per aggiungere ulteriori Codici Cliente, selezionate Modifica nella parte superiore della tabella dei Codici Cliente di spedizione.
La procedura di convalida varia in base alla regione
La procedura seguente è valida solo per i clienti in Stati Uniti e Canada. Se non siete residenti in questi Paesi, visitate la pagina Convalida API per trovare assistenza.
Convalida della vostra API
Alcune API FedEx richiedono una convalida dell'etichetta di spedizione per poterle usare nell'ambiente di produzione. Prima di iniziare, esaminate i requisiti di convalida delle API.
1. Dal menu, selezionate prima I miei progetti e poi il nome del progetto.
2. Nella scheda Chiavi API, alla voce Chiave test, trovate le vostre credenziali di test.
3. Dopo aver completato il test, trasferite il progetto all'ambiente di produzione nel FedEx Developer Portal per cominciare la convalida.
- Quando richiedete una chiave di produzione, salvatela in un luogo sicuro, perché viene visualizzata solo una volta. Se la perdete, sarà possibile generarne una nuova in un secondo momento.
4. Fornite le informazioni richieste sul frontespizio dell'etichetta, tra cui informazioni di contatto, servizi che intendete adottare, Codice Cliente e chiave API di produzione.
5. Create etichette di test nell'ambiente di test FedEx, quindi inviatele al gruppo di analisi del codice a barre di FedEx per la revisione. La valutazione dell'etichetta può richiedere fino a tre giorni lavorativi.
Best practice per evitare ritardi:
- Stampate e scansionate etichette con un minimo di 600 DPI. Non inviate file generati direttamente dalle API.
- Per le stampanti termiche, richiedete il tipo di immagine che corrisponde alla vostra stampante, ad esempio ZPLII per le stampanti Zebra.
- Per le etichette campione, usate indirizzi di mittente e destinatario validi. Create etichette solo per i servizi che intendete usare.
- Per il servizio di pagamento in contrassegno (COD) FedEx, includete l'etichetta di reso COD.
- Per FedEx International Express®, includete la Lettera di Vettura Aerea (AWB) ausiliaria (secondaria).
- Per le spedizione multicollo, inviate un'etichetta per ciascun collo.
Inviate i materiali attraverso una delle seguenti opzioni:
- Inviate un'email con il PDF e il frontespizio dell'etichetta a label@fedex.com.
- Spedite le etichette fisiche al seguente indirizzo:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Nota: per le etichette fisiche, assicuratevi che non ci siano difetti visibili, come linee di inchiostro o danni. Non ingrandite o rimpicciolite le etichette in fase di stampa.
6. Il gruppo di analisi del codice a barre di FedEx valuterà le etichette presentate per approvarle o rifiutarle. In caso di rifiuto, seguite le indicazioni del feedback e inviatele di nuovo.
7. In seguito all'approvazione, il gruppo di analisi del codice a barre di FedEx vi invierà un'email dopo aver autorizzato le credenziali di produzione per le transazioni relative a etichette di spedizione.
Nota: l'approvazione è valida per il singolo progetto. Ogni nuovo progetto richiede una nuova approvazione.
8. Sostituite l'URL e le credenziali di test con l'URL e le credenziali di produzione.
9. Eseguite un test di produzione finale con i dati campione per confermare che tutto funzioni come previsto.
