FedEx Integrator Provider
Prerequisito
Per effettuare il login a FedEx Developer Portal e creare un'organizzazione, è necessario disporre di un ID utente FedEx.
Unitevi all'organizzazione della vostra azienda per collaborare con il vostro team. Se la vostra azienda non ha 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 accettare l'invito. Se l'invito scade, chiedete all'amministratore di inviarlo nuovamente.
2. Accettate l'invito
Effettuate l'accesso utilizzando il vostro ID utente e la password esistenti. Se il vostro ID utente è associato a un'altra organizzazione, create un nuovo ID.
Creare una nuova organizzazione
Quando create un'organizzazione, diventate l'amministratore. In qualità di amministratore, potete invitare gli utenti a unirsi all'organizzazione, assegnare progetti e ruoli utente e gestire i Codici Cliente di fatturazione.
Per avere ulteriori informazioni sui ruoli utente, consultate le Linee guida per l'amministrazione dell'organizzazione.
1. Selezionate Crea o Unisciti a un'organizzazione nella barra di navigazione.
2. Inserite i seguenti dettagli:
- Per Lavoro per un'azienda che, selezionate Vende o fornisce una soluzione software che utilizza la tecnologia FedEx e vorrebbe registrarsi come FedEx Integrator Provider convalidato
- Inserite il nome della vostra azienda, il sito web e un nome dell'organizzazione che il vostro team riconoscerà, come il nome dell'azienda, il reparto, la divisione o l'area.
- Inserite un'email ufficiale che includa il dominio della vostra azienda, il Paese o territorio in cui la vostra azienda è costituita e i Paesi e territori in cui vendete o distribuite la vostra soluzione software.
3. Selezionate Avanti.
È possibile aggiornare o aggiungere dettagli in un secondo momento nella sezione Gestisci organizzazione del menu.
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.
Nota: usate il vostro Codice Cliente; non può essere il Codice Cliente FedEx di un cliente.
2. Selezionate Aggiungi Codice Cliente di fatturazione.
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.
Nota: l'indirizzo di fatturazione deve corrispondere all'indirizzo che avete utilizzato durante la configurazione del Codice Cliente. Questo Codice Cliente diventa il Codice Cliente di fatturazione predefinito della vostra organizzazione.
4. Scegliete un'opzione di autenticazione.
- La telefonata è disponibile solo per i trasportatori negli Stati Uniti e in Canada.
5. Inserite il codice di autenticazione ricevuto e selezionate Invia.
6. Leggete e accettate l'Accordo di Integrazione FedEx.
Invitare gli utenti come amministratore
1. Accedete a Gestisci organizzazione e selezionate la scheda Utenti.
2. Selezionate + Aggiungi utenti.
3. Inserite i seguenti dettagli:
- Il paese o il territorio
- La lingua preferita
4. Selezionate un ruolo utente (Visualizzatore, Collaboratore o Amministratore).
5. (Opzionale) Assegnate l'utente a un progetto.
- Potete assegnare un utente in qualsiasi momento dalla pagina Panoramica del progetto.
6. Inserite gli indirizzi email degli utenti e fate clic su Invita.
- Potete invitare fino a 20 utenti contemporaneamente, separando ogni indirizzo email con una virgola. L'invito è valido per 24 ore.
Creare un progetto
1. Dal menu, accedete a I miei progetti e selezionate + Crea un progetto.
2. Inserite un Nome del progetto.
- Il formato del nome consigliato Projectname_applicationname. Selezionate Avanti al termine.
3. Selezionate le API e i prodotti di visibilità integrata avanzata per il vostro progetto.
- I prodotti di visibilità integrata avanzata sono disponibili solo per i FedEx Integrator Provider negli Stati Uniti.
- Se selezionate prodotti a pagamento, vi verrà chiesto di assegnare un Codice Cliente di fatturazione al progetto e di accettare i termini richiesti.
Assegnare un Codice Cliente di fatturazione
Nota: questo è necessario solo se scegliete un prodotto a pagamento.
1. Assegnate un Codice Cliente di fatturazione dall'elenco di Codici Cliente aggiunti all'organizzazione. I Codici Cliente di fatturazione devono avere sede negli Stati Uniti.
2. Accettate l'Accordo di licenza FedEx Developer Portal e il Modulo d'ordine e selezionate Crea.
Configurare la visibilità integrata avanzata in un progetto
Prerequisiti
- Rivedete le tariffe: agli utenti iscritti viene addebitata una quota mensile in base al conteggio dei numeri di monitoraggio. Fate riferimento al Modulo d'ordine per scoprire di più sulle 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 richiamate. L'URL deve:
- Utilizzare 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, I miei progetti, quindi selezionate 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 nei propri tool
- FedEx Compatible Provider: è un FedEx Compatible Provider certificato
- FedEx Integrator Provider: vende o fornisce una soluzione software che utilizza 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. Inserisci i dettagli del progetto.
- Inserisci 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 l'Accordo di licenza FedEx Developer Portal e il Modulo d'ordine e selezionate Crea.
Nota: a seconda del tipo di sottoscrizione scelto, potrebbero essere necessari passaggi aggiuntivi. Per i dettagli, consultate la nostra documentazione del webhook.
Seguite questi passaggi per verificare l'integrazione dell'API e confermare che l'applicazione possa inviare e ricevere dati di test.
1. Dal menu, selezionate I miei progetti, poi selezionate 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 utilizzando il pulsante Scarica schema JSON nella parte superiore della pagina della documentazione. Riesaminate le richieste di esempio per gli endpoint utilizzati dall'integrazione.
4. Richiedete un token di accesso OAuth da utilizzare con ogni transazione API. Il token è valido per un'ora e potete configurare la vostra applicazione per aggiornarlo prima che scada. Per dettagli, consultate la documentazione API Authorization.
5. Dal menu, selezionate Catalogo API, scegliete l'API che volete utilizzare e selezionate Documentazione.
6. Dal menu, selezionate l'endpoint.
7. Inviate richieste di esempio utilizzando le credenziali di test e l'URL di test FedEx, quindi confermate che le risposte corrispondano agli esempi della documentazione. Per dettagli, consultate la Guida alla virtualizzazione della sandbox.
8. Eseguite test con Visibilità integrata avanzata per generare dati di esempio e confermare che l'applicazione elabora correttamente le informazioni di monitoraggio.
Nota: il test non autentica l'URL di callback. Per dettagli, consultate la documentazione di Visibilità integrata avanzata.
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.
Per spostare le API in produzione, è necessario convalidarle. Il livello di validazione varia a seconda dell'API. Esaminate i requisiti di convalida delle API prima di iniziare.
1. Dal menu, selezionate I miei progetti, poi selezionate il nome del progetto.
2. Nella scheda Chiavi API, alla voce Chiave test, trovate le vostre credenziali di test.
3. Identificate i casi di test per le regioni o i territori in cui prevedete di implementare la soluzione. Per i dettagli, consultate i riferimenti di base per i casi di test relativi al trasportatore.
4. Completate le transazioni di registrazione utilizzando i Codici Cliente di test forniti prima di eseguire i casi di test.
5. Completate tutti i casi di test richiesti.
6. Compilate il Product Information Worksheet (PIW) con i vostri dati di contatto e la scelta dei servizi FedEx.
7. Compilate il Frontespizio della validazione del trasportatore.
Inviare i deliverable
Inviate tutti i materiali richiesti a validationmtp@fedex.com.
1. Preparate i seguenti documenti da consegnare:
- PIW compilato (PDF)
- Frontespizio della convalida compilato (PDF)
- Transazioni di registrazione del cliente finale con autenticazione a più fattori (JSON)
- Etichette di spedizione scansionate per tutti i casi di test applicabili (PDF/PNG)
- Transazioni di spedizione per i formati di etichetta (PDF, PNG e ZPL (JSON)), per le API applicabili di spedizione e tariffe
- Screenshot (PDF) di quanto segue:
- Soluzione rivolta al cliente che mostra i servizi FedEx e la gestione speciale
- Dichiarazione di esclusione di responsabilità
- Accordo di licenza utente finale (EULA)
- Flusso di registrazione del cliente finale
2. Comprimete tutti i file in un unico file .zip per evitare restrizioni da parte dei provider di posta.
3. Inviate il file .zip tramite email al team di convalida.
Best practice per evitare ritardi
Seguite queste linee guida per ridurre i tempi di revisione:
- 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 FedEx International Express®, includete la Lettera di Vettura Aerea (AWB) ausiliaria (secondaria).
- Includete un'etichetta per ogni collo nelle spedizioni multicollo (MPS).
Valutazione dell'etichetta
Il team di convalida esamina quanto presentato.
- In caso di rifiuto, rispondete al feedback e inviate nuovamente i deliverable.
- Se approvato, riceverete un'email di conferma. Dopo l'approvazione, le vostre credenziali di produzione sono autorizzate per le transazioni di etichette di spedizione.
1. Dal menu, selezionate I miei progetti, poi selezionate il nome del progetto.
2. Nella sezione API , copiate e conservate in tutta sicurezza la chiave API di produzione e la chiave segreta.
Nota: salvate la chiave segreta in un luogo sicuro, poiché viene visualizzata solo una volta. Se la perdete, è possibile generarne una nuova in un secondo momento.
