Furnizor integrator FedEx
Condiție preliminară
Este necesar să aveți un ID de utilizator FedEx pentru a vă autentifica în FedEx Developer Portal și a crea o organizație.
Alăturați-vă organizației companiei dumneavoastră pentru a colabora cu echipa dumneavoastră. În cazul în care compania dumneavoastră nu are o organizație, creați una.
Alăturarea la o organizație existentă
1. Solicitați o invitație
Solicitați-i administratorului organizației dumneavoastră să vă trimită o invitație. Aveți la dispoziție 24 de ore să o acceptați. Dacă invitația expiră, solicitați-i administratorului să o retrimită.
2. Acceptați invitația
Autentificați-vă folosind ID-ul dumneavoastră de utilizator și parola existente. Dacă ID-ul dumneavoastră de utilizator este asociat cu o altă organizație, creați un ID nou.
Crearea unei organizații noi
Când creați o organizație, deveniți administrator. Ca administrator, puteți invita utilizatori să se alăture organizației, să atribuiți proiecte și roluri de utilizator și să gestionați conturi de expediere.
Pentru a afla mai multe despre rolurile utilizatorilor, consultați Ghidul de administrare a organizației..
1. Selectați Creare sau alăturare organizație în bara de navigare.
2. Introduceți următoarele detalii:
- Pentru Lucrez pentru o companie care, selectați Vinde sau furnizează o soluție software care utilizează tehnologia FedEx și doriți să vă înregistrați ca furnizor FedEx integrator Validat
- Introduceți numele companiei, site-ul web al companiei și un nume de organizație pe care echipa dumneavoastră îl va recunoaște, cum ar fi numele companiei, departamentul, divizia sau regiunea.
- Introduceți o adresă de e-mail oficială care include domeniul companiei dumneavoastră, țara sau teritoriul în care este înființată și țările și teritoriile în care vindeți sau distribuiți soluția software.
3. Selectați Următorul.
Puteți actualiza sau adăuga detalii ulterior, în secțiunea Gestionare organizație din meniu.
Adăugarea unui cont de facturare
1. Selectați fila Conturi de facturare . Dacă nu aveți un cont de facturare FedEx, selectați Deschidere cont de facturare pentru a deschide unul nou sau contactați Asistența FedEx.
Notă: folosiți numărul contului dumneavoastră; nu poate fi numărul contului FedEx al unui client.
2. Selectați Adăugare cont de facturare.
3. Introduceți numărul dvs. de cont FedEx, un pseudonim pentru cont și o adresă de facturare din SUA utilizată la configurarea contului.
Notă: adresa de facturare trebuie să corespundă cu adresa utilizată la configurarea contului. Acest cont devine contul de facturare implicit al organizației dumneavoastră.
4. Alegeți o opțiune de autentificare.
- Apelul telefonic este disponibil pentru integratori doar din Statele Unite și Canada.
5. Introduceți codul de autentificare pe care îl primiți și selectați Trimitere.
6. Citiți și acceptați Acordul FedEx pentru integratori.
Invitarea utilizatorilor ca administrator
1. Navigați la Gestionare organizație și selectați fila Utilizatori.
2. Selectați + Adăugare utilizatori.
3. Introduceți următoarele detalii:
- Țara sau teritoriul
- Limba preferată
4. Selectați un rol de utilizator (Vizualizator, Contribuitor sau Administrator).
5. (Opțional) Alocați utilizatorul unui proiect.
- Puteți atribui un utilizator oricând din pagina Prezentare generală a proiectului.
6. Introduceți adresele de e-mail ale utilizatorilor și faceți clic pe Invitare.
- Puteți invita până la 20 de utilizatori simultan, fiecare adresă de e-mail fiind separată prin virgulă. Invitația este valabilă timp de 24 de ore.
Crearea unui proiect
1. Navigați la Proiectele mele din meniu și selectați + Creați un proiect.
2. Introduceți un nume de proiect.
- Formatul recomandat este NumeProiect_NumeAplicație. Selectați Înainte după ce terminați .
3. Selectați interfețele API și produsele Advanced Integrated Visibility pe care să le includeți în proiectul dumneavoastră.
- Produsele Advanced Integrated Visibility sunt disponibile doar pentru furnizorii de servicii tip integrator FedEx din SUA.
- Dacă selectați un produs cu plată, vi se va cere să atribuiți un cont de facturare și să acceptați termenele aferente.
Atribuirea unui cont de facturare
Notă: acest lucru este necesar numai dacă selectați un produs plătit.
1. Atribuiți un cont de facturare din lista de conturi adăugate în organizație. Conturile de facturare trebuie să fie înregistrate în SUA.
2. Acceptați Acordul de licență și Formularul de comandă pentru FedEx Developer Portal și selectați Creare.
Configurarea Advanced Integrated Visibility într-un proiect
Condiții preliminare
- Examinarea prețurilor: abonaților li se percepe o taxă lunară în funcție de numărul de coduri de monitorizare. Consultați acest Formular decomandă pentru mai multe informații despre prețuri.
- Configurare conturi:webhookul Vizibilitate expediere necesită un cont de facturare înregistrat în Statele Unite și cel puțin un cont de expediere, cele două tipuri de cont fiind reciproc exclusive. Doar administratorii pot adăuga conturi de facturare și expediere în pagina Gestionare organizație.
1. Creați o adresă URL de destinație în aplicația sau platforma dumneavoastră pentru a primi apeluri inverse. URL-ul trebuie:
- Utilizați HTTPS
- Excludeți spațiul IP RFC1918, fedex.com și subdomeniile sale, precum și adresele IP precum localhost sau 127.0.0.1
2. Generați un token de securitate pentru autentificare. Tokenul trebuie:
- să conțină între 26 și 100 de caractere, cel puțin o literă mare, cel puțin o literă mică și cel puțin o cifră
3. Din meniu, Proiectele mele, apoi selectați fila Advanced Integrated Visibility.
4. Selectați Creați un proiect Advanced Integrated Visibility.
5. Selectați tipul de utilizator:
- Expeditor FedEx: expediază cu FedEx și trebuie să integreze interfețe API FedEx în propriile aplicații
- Furnizor compatibil FedEx: este un Furnizor compatibil FedEx certificat
- Furnizor Integrator FedEx: vinde sau oferă o soluție software care utilizează tehnologia FedEx și este un Furnizor integrator FedEx validat
6. Selectați tipul de înregistrare. Vă puteți înregistra la evenimente după numere de cont sau numere de urmărire.
7. Confirmați contul de facturare și selectați funcționalitățile dorite, cum ar fi confirmarea de primire, livrarea estimată, evenimentele de urmărire sau filtrarea bazată pe evenimente.
8. Introduceți detaliile proiectului.
- Introduceți un nume de proiect unic și ușor de recunoscut.
- Introdu URL-ul destinației și tokenul de securitate pe care l-ați creat.
- Introduceți o adresă de e-mail și o limbă preferată pentru notificări despre actualizările și întreruperile funcționalității Advanced Integrated Visibility.
9. Acceptați Acordul de licență și Formularul de comandă pentru FedEx Developer Portal și selectați Creare.
Notă: în funcție de tipul de înregistrare ales, este posibil să urmați pași suplimentari. Pentru detalii, consultați documentația noastră privind webhookurile.
Urmați acești pași pentru a verifica integrarea interfeței API și pentru a confirma că aplicația dumneavoastră poate trimite și primi date de testare.
1. Din meniu, selectați Proiectele mele, apoi selectați Nume proiect.
2. În fila Chei API , în secțiunea Cheie de testare, găsiți acreditările dumneavoastră de testare.
3. Autentificați-vă și descărcați colecția de interfețe API JSON utilizând butonul Descărcare schemă JSON din partea de sus a paginii de documentație. Examinați exemple de solicitări pentru punctele finale utilizate de integrarea dumneavoastră.
4. Solicitați un token de acces OAuth pentru a-l utiliza cu fiecare tranzacție a interfeței API. Tokenul este valabil o oră și puteți configura aplicația să-l reîmprospăteze înainte de expirare. Pentru detalii, consultați documentația API Authorization.
5. Din meniu, selectați Catalog de interfețe API, alegeți interfața API cu care doriți să lucrați și selectați Documentație.
6. Din meniu, selectați punctul final.
7. Trimiteți exemple de solicitări folosind acreditările de testare și URL-ul de testare FedEx, apoi confirmați că răspunsurile corespund cu exemplele de documentație. Pentru detalii, consultați Ghidul de utilizare a mediului de testare virtual.
8. Rulați teste cu Advanced Integrated Visibility pentru a genera date de probă și a confirma dacă aplicația dumneavoastră procesează corect urmărirea informațiilor.
Notă: testarea nu autentifică URL-ul de apelare inversă. Pentru detalii, consultați documentația pentru Advanced Integrated Visibility.
Pașii pentru validare diferă în funcție de regiune
Pașii următori se aplică doar clienților din Statele Unite ale Americii și Canada. Dacă locuiți în afara acestor țări, accesați pagina Validare API pentru a găsi asistență.
Pentru a muta interfețele API în producție, acestea trebuie validate. Nivelul de validare variază în funcție de Interfață API. Examinați Cerințele de validare a interfețelor API înainte de a începe.
1. Din meniu, selectați Proiectele mele, apoi selectați Nume proiect.
2. În fila Chei API , în secțiunea Cheie de testare, găsiți acreditările de testare.
3. Identificați cazurile de testare pentru regiunile sau teritoriile în care intenționați să implementați soluția. Pentru detalii, consultați setul de bază al cazurilor de test pentru integrator.
4. Finalizați tranzacțiile de înregistrare folosind numerele de cont de test furnizate înainte de a rula cazurile de test.
5. Finalizați toate cazurile de testare necesare.
6. Completați Fișa cu informații despre produs (PIW) cu datele dumneavoastră de contact și opțiunile dumneavoastră pentru serviciile FedEx.
7. Completați fișa de copertă pentru validarea integratorului.
Trimiteți livrabilele
Trimiteți toate materialele necesare la validationmtp@fedex.com.
1. Pregătiți următoarele livrabile:
- PIW completat (PDF)
- Fișă de validare completată (PDF)
- Tranzacții de înregistrare ale clientului final cu autentificare multifactor (JSON)
- Etichete de transport scanate pentru toate cazurile de test aplicabile (PDF/PNG)
- Tranzacții de expediere pentru trei formate de etichete: PDF, PNG și ZPL (JSON) (pentru API-urile Expediere și Evaluare aplicabile)
- Capturi de ecran (PDF) care prezintă:
- Soluție orientată către client care afișează serviciile FedEx și manipulările speciale
- Declarația de declinare a responsabilității
- Acord de licență pentru utilizatorul final (EULA)
- Fluxul de înregistrare a clientului final
2. Comprimați toate fișierele într-un singur fișier .zip pentru a evita restricțiile furnizorului de e-mail.
3. Trimiteți fișierul .zip prin e-mail către echipa de validare.
Bune practici pentru evitarea întârzierilor
Urmați aceste instrucțiuni pentru a reduce timpul de examinare:
- Imprimați și scanați etichetele la o rezoluție minimă de 600 DPI. Nu trimiteți fișiere generate direct din interfețe API.
- Pentru imprimante termice, solicitați tipul de imagine care corespunde imprimantei dumneavoastră, de exemplu, ZPLII pentru imprimante Zebra.
- Pentru FedEx International Express®, includeți documentul de expediere (AWB) auxiliar (secundar).
- Includeți o etichetă pentru fiecare colet în expedierile formate din mai multe colete (MPS).
Evaluarea etichetelor
Echipa de validare examinează trimiterea dumneavoastră.
- Dacă este respinsă, răspundeți la feedback și retrimiteți livrabilele.
- Dacă este aprobată, veți primi un e-mail de confirmare. După aprobare, acreditările dumneavoastră de producție sunt autorizate pentru tranzacțiile cu etichete de expediere.
1. Din meniu, selectați Proiectele mele, apoi selectați Nume proiect.
2. În secțiunea Interfețe API , copiați și stocați în siguranță cheia API de producție și cheia secretă.
Notă: salvați-vă cheia secretă într-o locație securizată deoarece apare doar o singură dată. Dacă o pierdeți, puteți genera una nouă mai târziu.
