Introducere
FedEx Developer Portal oferă o suită de Application Programming Interfaces (API-uri) pentru a integra FedEx în aplicațiile dvs. Aceste instrucțiuni vă vor ghida în configurarea unei organizații, crearea unui proiect, testarea integrării, trecerea unui proiect la producție și, în unele cazuri, validarea API-ului.
Tipuri de utilizatori:
FedEx oferă servicii de integrare pentru trei tipuri de utilizatori: Expeditori FedEx, soluții software verificate cunoscute sub denumirea de Furnizori compatibili FedEx și Furnizori de servicii tip integrator FedEx.
Expeditor FedEx:
Companie care efectuează expedieri cu FedEx și care trebuie să integreze API- uri FedEx în propriile aplicații.
Furnizor de soluții sau servicii:
Companie care trebuie să se integreze cu API-uri FedEx pentru a construi o soluție, o aplicație sau un plugin care poate fi vândut și/sau distribuit unei organizații externe care efectuează expedieri cu FedEx.
- Furnizor FedEx Compatible: companie verificată cu un acord contractual prin programul FedEx Compatible.
- Furnizor de servicii tip integrator FedEx: companie validată, cu un acord contractual în cadrul Programului pentru integratori FedEx.
Selectați o opțiune de mai jos care descrie cel mai bine activitatea dvs. Indiferent de tipul dvs. de utilizator, există o experiență de inițiere disponibilă pentru dvs.
Selectați pentru a începe.
Which of the following best describes your business?
Select user
- FedEx Shipper: Company who integrates FedEx APIs into their own applications.
- FedEx Compatible Provider: Company validated by the FedEx Compatible program who integrates with FedEx APIs to build a solution, application or plugin that can be sold and/or distributed to an external organization.
- FedEx Integrator Provider: Validated company with a contractual agreement through the FedEx Integrator Program.
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.
În cazul în care compania dumneavoastră nu are o organizație, creați una. În caz contrar, alăturați-vă unei organizații existente.
Crearea unei organizații noi
În bara de navigare, faceți clic pe Creare sau înscriere la organizație.
Notă: în calitate de creator, veți fi desemnat automat ca administrator al organizației.
Administratorii pot:
Invitați utilizatori să se alăture
atribui utilizatorilor roluri (de exemplu, colaborator, vizualizator) și proiecte;
gestiona conturile de expediere.
Pentru mai multe detalii despre aceste roluri, consultați Ghidul nostru privind administrarea organizațiilor.
Pentru tipul de companie, selectați „Vinde sau furnizează o soluție software care utilizează tehnologia FedEx și este un furnizor de servicii tip integrator FedEx validat”.
Furnizați numele companiei, URL-ul site-ului web și un nume unic pentru organizație. Numele organizației poate corespunde numelui companiei dumneavoastră sau poate reprezenta un grup specific (departament, divizie, regiune, locație). Aceste informații sunt necesare pentru validarea solicitării dumneavoastră.
Notă: alegeți un nume de organizație ușor de recunoscut de către ceilalți utilizatori (de exemplu, numele companiei, departament, regiune, locație).
Specificați locația companiei dumneavoastră și zonele în care soluția software va fi vândută sau distribuită.
Adăugarea contului de facturare și autentificarea contului
Notă: în calitate de furnizor de servicii de transport și logistică în cadrul FedEx Integrator Program, trebuie să utilizați propriul număr de cont. Nu puteți utiliza numărul de cont al unui client.
Introduceți numărul de cont FedEx. Dacă nu dețineți un cont FedEx, creați unul pe fedex.com sau contactați un reprezentant al serviciului de asistență FedEx.
Introduceți un pseudonim pentru cont și adresa de facturare asociată contului. Selectați Următorul.
Notă: adresa de facturare trebuie să corespundă înregistrărilor noastre pentru acest cont. Acesta va fi contul de facturare prestabilit pentru organizația dumneavoastră.
Pentru a finaliza crearea organizației, trebuie să vă autentificați contul. Alegeți o opțiune de autentificare (telefon, disponibil doar pentru Integratorii din SUA și Canada, e-mail sau SMS) și selectați Înainte.
După primire, introduceți codul de autentificare și selectați Trimitere.
Acceptați condițiile
Citiți Acordul global pentru integratori și Manualul programului. Bifați căsuțele pentru a confirma acceptarea termenelor, apoi selectați Accept.
Va apărea un ecran de confirmare. Faceți clic pe Administrare organizație pentru a edita detaliile, dacă este necesar.
Invitare utilizatori
Notă: doar administratorii pot invita utilizatori.
Selectați Administrare organizație din meniul de navigare din stânga.
Accesați fila Utilizatori și selectați Adăugare utilizatori.
Completați formularul și atribuiți noului utilizator (sau noilor utilizatori) rolul corespunzător: Vizualizator, Colaborator sau Administrator.
Pentru detalii despre roluri, consultați Ghidul de administrare pentru organizații.
Atribuiți utilizatorii proiectelor (dacă este cazul), din meniul derulant Proiecte.
Introduceți adresele de e-mail ale utilizatorilor și selectați Invitare.
Alăturați-vă unei organizații existente
Solicitați o invitație: cereți administratorului organizației să vă trimită o invitație. Aveți 24 de ore pentru a o accepta. Dacă este nevoie, cereți retrimiterea invitației.
Acceptați invitația conectându-vă cu ID-ul și parola existente. Dacă ID-ul este deja asociat altei organizații, trebuie să creați un nou ID.
Alăturați-vă unei organizații existente
Pasul 1: solicitați administratorului organizației dvs. să vă trimită o invitație.
În cazul în care compania dumneavoastră a creat deja o organizație, cereți-i administratorului organizației să vă invite să vă alăturați. Veți avea la dispoziție 24 de ore pentru a accepta invitația. Dacă nu vă încadrați în acest interval, îi puteți cere oricând să vă retrimită invitația.
Pasul 2: acceptați invitația.
Pentru a accepta invitația, va trebui fie să vă conectați cu ID-ul de utilizator și parola existente, fie, în cazul în care ID-ul de utilizator existent este deja asociat unei organizații, să creați unul nou pentru a vă conecta.
Creați un proiect API
Accesați pagina Proiectele mele și deschideți fila API-uri. Faceți clic pe butonul Creare proiect API.
Pasul 1: selectați API-ul (API-urile) pe care doriți să le includeți în proiectul dvs.
Examinați cotele API, limitele tarifelor și detaliile validării API-ului.
Pasul 2: configurați detaliile proiectului
- Alocați proiectului un nume identificabil, care este unic în cadrul organizației dvs.
- Selectați țările în care planificați expedieri, pentru a putea să vă alocăm un cont de expediere de test. Pentru a testa expedierea internă de colete pe teritoriul unei țări europene, trebuie să aveți câte un cont de test pentru fiecare țară. La nevoie, puteți să adăugați/să eliminați țări mai târziu.
- Pentru a primi notificări despre cele mai recente actualizări ale API-urilor și informații despre întreruperi, setați preferințele dvs. privind notificările.
Pasul 3: citiți și acceptați condițiile, inclusiv Acordul de licență pentru FedEx Developer Portal
După ce acceptați condițiile și faceți clic pe butonul Creare, veți vedea un ecran de confirmare. Apoi veți putea vedea acreditările de test în noul proiect.
Creați un proiect bazat pe webhookuri
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 Ghidul de stabilire a prețurilor pentru mai multe informații despre prețuri.
- Configurare conturi: Webhookul Advanced Integrated Visibility 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 pe pagina Gestionare organizație.
Creați un URL valid (apelare inversă) în aplicația sau platforma dvs. de destinație
URL-ul dvs. de destinație va fi utilizat pentru a primi coduri și mesaje de autentificare, precum și notificări despre datele transmise webhook de la FedEx. URL-ul dvs. trebuie să utilizeze HTTPS pentru a asigura securitatea. URL-ul dvs. va fi blocat dacă include:
- Spațiul RFC1918 IP
- Domeniul fedex.com sau oricare dintre subdomeniile acestuia
- Adresele IP din URL ( inclusiv localhost, 127.0.0.0.1)
Generați un token de securitate
Acest token de securitate poate fi folosit drept cheie secretă pentru a autentifica și valida informațiile transmise între organizația dvs. și FedEx. Tokenul dvs. de securitate trebuie să includă:
- O lungime minimă de 26 de caractere și o lungime maximă de 100 de caractere
- 1 literă mare;
- 1 literă mică;
- 1 caracter numeric.
Exemplu: Y1F6OiVUQW2JPSElmRE9U0IY5
După ce v-ați definit URL-ul și tokenul de securitate, sunteți gata să creați un proiect webhook. Accesați pagina Proiectele mele și deschideți fila Webhookuri. Faceți clic pe butonul Creare proiect webhook .
Selectați tipul de abonament
Expeditorii FedEx își pot înscrie evenimentele la numere de cont sau numere de monitorizare.
Pasul 1: confirmați contul de facturare și selectați caracteristici
- Examinați contul de facturare implicit listat pentru a-l confirma sau selectați unul diferit din organizația dvs.
- Configurați-vă proiectul selectând caracteristici precum opțiunile de confirmare de primire, opțiunile de livrare estimată, evenimentele de monitorizare și filtrarea bazată pe evenimente.
Pasul 2: introduceți detaliile proiectului
- Alocați proiectului un nume identificabil, care este unic în cadrul organizației dvs.
- Introduceți URL-ul de destinație și detaliile tokenului de securitate pe care le-ați creat în timpul autentificării de preconfigurare (consultați pașii de mai sus).
- Pentru a primi notificări cu privire la cele mai recente actualizări webhook și orice informații legate de întreruperi, introduceți o adresă de e-mail și limba preferată.
Pasul 3: citiți și acceptați condițiile
După ce acceptați condițiile, inclusiv Acordul de licență pentru FedEx Developer Portal și Formularul de comandă, și faceți clic pe butonul Creare, veți vedea un ecran de confirmare.
Este posibil să existe pași suplimentari în funcție de tipul de abonament selectat. Accesați documentația pentru a afla mai multe.
În pagina Prezentare generală a proiectului API, obțineți acreditările de testare – cheia API, cheia secretă și contul (conturile) de expediere – din fila Cheie de testare.
Pasul 1: solicitați un token de acces OAuth
Tokenul de acces OAuth trebuie utilizat pentru fiecare tranzacție API. Tokenul este valid doar pentru o oră, așadar, va trebui să vă codați programatic aplicația pentru a reîmprospăta tokenul înainte de a expira sesiunea. Consultați Documentația API Authorization pentru mai multe detalii.
Pasul 2: examinați documentația API-ului
Faceți clic pe documentația pentru fiecare dintre API-urile dvs. pentru a citi contextul de afaceri și a înțelege cum să utilizați API-ul. Conectați-vă pentru a descărca colecția API JSON prin intermediul butonului din partea de sus a paginii dvs. de documentație. Puteți consulta exemple de solicitări pentru punctul final care corespunde integrării dorite.
Pasul 3: utilizați mediul de testare pentru a testa exemple de tranzacții
Faceți clic pe punctul final dorit din partea de navigare din stânga pentru a merge la acel mediu de testare specific. Identificați solicitările de exemple care corespund cazului dvs. de utilizare, apoi utilizați acreditările dvs. de testare și URL-urile de testare FedEx pentru a implementa apelurile către punctul final, așa cum este descris în solicitările de exemple. Asigurați-vă că răspunsurile la apelurile API pe care le primiți corespund cu cele afișate în documentație. Aflați mai multe despre experiența noastră de testare în Ghidul de utilizare a mediului de testare virtual.
Testarea cu webhookURI
Testarea vă poate ajuta să vă faceți o idee mai bună despre validitatea URL-ului creat. Astfel, FedEx va avea permisiunea de a vă identifica adresa URL și de a crea o conexiune cu aceasta, pentru a trimite date. De asemenea, testarea vă poate oferi exemple de date de test, care vă pot ajuta să verificați și să confirmați faptul că puteți procesa datele de monitorizare a expedierilor, furnizate în aplicația dvs. Totuși, testarea nu autentifică URL-ul dvs. Accesați documentația webhookului pentru a afla cum să vă testați URL-ul webhook.
Accesați pagina dvs. Prezentare generală a proiectului și deschideți fila Cheie de producție. Proiectele Abonament pentru număr de cont Advanced Integrated Visibility nu trebuie să fie trecute la producție.
Pasul 1: configurați proiectul
- Redenumiți cheia după cum este necesar.
- Verificați numărul contului de client pe care l-ați selectat la pasul 1 al fluxului de creare a proiectului. Acesta este necesar pentru transferarea proiectului în faza de producție. După ce proiectul dumneavoastră este activ în faza de producție, puteți adăuga mai multe conturi de client, dacă va fi necesar.
Pasul 2: obțineți cheile proiectului
Copiați cheia API de producție și cheia secretă de producție vor fi afișate într-un loc sigur. Pentru a vă păstra în siguranță cheia secretă de producție, o afișăm doar o dată. Dacă o pierdeți, puteți să generați o cheie nouă.
După ce obțineți cheile proiectului și faceți clic pe Înainte, veți vedea detaliile proiectului dvs. în fila Cheie de producție.
- Pentru a adăuga mai multe conturi de expediere la proiectul dvs., faceți clic pe Editare în partea de sus a tabelului de conturi de expediere.
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 de validare API pentru a găsi asistență.
Unele API-uri necesită validare privind eticheta de expediere pentru a fi utilizate în mediul nostru de producție. Verificați dacă API-ul dumneavoastră necesită validare.
Pasul 1: Dezvoltați și testați API-urile FedEx cu aplicația dvs. activată pe web
După ce terminați de dezvoltat aplicația activată pe web, este timpul să realizați testarea utilizând acreditările de testare (conturi de expediere de testare, cheia API și cheia secretă). Cheia API și cheia secretă de testare vor fi afișate pe pagina Prezentare generală proiect și pot fi văzute în orice moment.
Pasul 2: Transferați-vă proiectul în producție
După ce ați realizat testările cu API-urile FedEx, trebuie să începeți procesul de validare transferându-vă proiectul în producție pe FedEx Developer Portal. După ce ați realizat acest lucru cu succes, veți vedea cheia API și cheia secretă de producție. Veți vedea cheia secretă de producție doar o dată, dar veți putea să o generați din nou mai târziu.
Pasul 3: Completați foaia de copertă a etichetei
Completați integral foaia de gardă a etichetei cu informațiile de contact corespunzătoare, precum și cu serviciile pe care intenționați să le implementați. Includeți numărul de cont și cheia de producție.
Pasul 4: generați și trimiteți etichetele de testare grupului de analiză a codurilor de bare
Generați etichete de testare în mediul de testare FedEx asociat cu aplicația și apoi trimiteți etichetele de testare pentru aprobare la echipele de evaluare a etichetelor FedEx. Grupul de analiză a codurilor de bare are nevoie de un interval de trei zile lucrătoare pentru evaluarea etichetei.
Urmați aceste bune practici pentru a evita întârzierile în procesare:
- Etichetele trebuie tipărite și scanate la minimum 600 DPI. NU TRIMITEȚI FIȘIERE GENERATE DE API-uri.
- Pentru imprimantele termice, trebuie solicitat tipul de imagine a etichetei trebuie solicitat în conformitate cu modelul imprimantei. Exemplu: ZPLII pentru imprimantele Zebra.
- Utilizați informațiile adreselor expeditorului/destinatarului atunci când creați mostrele de etichete pentru evaluare. Creați mostre de etichete doar pentru serviciile specifice pentru care sunt aplicate.
- Eticheta Plată ramburs (C.O.D.) trebuie să includă, de asemenea, C.O.D.-ul corespunzător. Etichetă de returnare.
- Expedierile FedEx International Express® trebuie să includă și eticheta auxiliară/secundară a documentului de expediere (AWB).
- Expedierile în mai multe moduri (MPS) trebuie să includă o etichetă pentru fiecare colet din expediere.
- Trimiteți prin e-mail PDF-ul și foaia de gardă a etichetei la label@fedex.com.
- Etichetele fizice pot fi trimise la adresa de mai jos:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Dacă etichetele scanate nu prezintă defecte vizibile (precum linii care traversează codul de bare, pete de cerneală sau prejudicii fizice), este posibil ca acestea să treacă de inspecție și apoi va fi acordată aprobarea.
Dacă trimiteți etichete fizice, aveți grijă să imprimați etichetele la calitatea corespunzătoare și la dimensiunea mărită/micșorată accidentală (adică scalarea). Acestea sunt cele două motive principale pentru care etichetele nu trec de procesul de evaluare a etichetelor.
Pasul 5: analizați evaluarea etichetei
Grupul de analiză a codului de bare va evalua etichetele de testare trimise și va aproba sau va respinge etichetele. Grupul de analiză a codului de bare vă va contacta cu privire la aprobarea sau respingerea etichetelor trimise. Dacă etichetele sunt aprobate, continuați la pasul următor. Dacă etichetele sunt respinse, corectați etichetele conform instrucțiunilor și trimiteți-le din nou pentru aprobare.
Pasul 6: activați aplicația
După ce Grupul de analiză a codului de bare a aprobat etichetele de testare pentru starea producție, vă va autoriza acreditările de producție pentru transmiterea tranzacției privind eticheta de expediere identificată și vă va notifica prin e-mail că ați obținut validarea. Aprobarea se face pe baza fiecărui proiect.
Pasul 7: Înlocuiți URL-ul și acreditările
Înlocuiți URL-ul de testare și acreditările de testare cu URL-ul de producție și acreditările de producție. Retestați implementarea în mediul de producție utilizând mostre de date.
Condiție preliminară
Afacerea dumneavoastră trebuie să fie deja furnizor compatibil FedEx. Dacă afacerea dumneavoastră nu face parte din programul Compatible, modificați selecția de mai sus în „Furnizor necompatibil.”
Pasul 1: primiți invitația de a vă alătura organizației
FedEx va crea o organizație și apoi va invita un membru al echipei să se alăture organizației. Acest utilizator va fi desemnat ca administrator al organizației dumneavoastră.
Pasul 2: acceptați invitația.
Pentru a accepta invitația, va trebui fie să vă conectați cu ID-ul de utilizator și parola existente, fie, în cazul în care ID-ul de utilizator existent este deja asociat unei organizații, să creați unul nou pentru a vă conecta.
Pasul 3: invitați utilizatori
Un administrator poate să invite utilizatorii în organizația sa și să le atribuie roluri și proiecte. Deschideți fila Utilizatori. Faceți clic pe butonul Adăugare utilizatori.
- Selectați un rol de utilizator: Vizualizator, Contribuitor sau Administrator. Aflați mai multe despre rolurile din Ghidul nostru privind administrarea organizației.
- Dacă aveți proiecte existente, atribuiți un proiect utilizatorului. De asemenea, puteți atribui utilizatori la proiecte în orice pagină de prezentare generală a proiectului.
- Introduceți adresele de e-mail ale utilizatorilor care doriți să se alăture organizației dvs. în cadrul rolului selectat.
Accesați Catalogul de API-uri pentru a determina API-urile sau webhookurile potrivite pentru soluția dvs. Specialistul FedEx Customer Technology, dedicat dumneavoastră, și managerul Compatible Channel vă pot ajuta să selectați API-urile adecvate pentru soluția dumneavoastră, în conformitate cu cerințele afacerii pe care o gestionați.
Pasul 1: completați FLIP-ul
Returnați Comunitate furnizori compatibili (CFC) pentru a completa Fișa de lucru cu informații de producție (FLIP).
Pasul 2: examinați proiectul (proiectele) creat(e) de FedEx
După ce FLIP-ul a fost aprobat, FedEx vă va crea proiectul (proiectele). Fiecare versiune a fiecărei soluții va avea un proiect separat în FedEx Developer Portal.
Pasul 3: participați la demonstrația pentru API împreună cu echipa dvs.
Echipa FedEx Compatible împreună cu echipele FedEx CTC și Verificare vor organiza o demonstrație tehnică pentru API-uri cu echipa dvs. Echipa FedEx va discuta despre verificarea Compatible Program, noile caracteristici și funcționalități API și va răspunde la întrebări.
În pagina Prezentare generală a proiectului API, obțineți acreditările de testare – cheia API și cheia secretă – din fila Cheie de testare.
Pasul 1: creați chei de client
Utilizați API-ul de înregistrare a acreditărilor pentru a crea chei de client. Acesta este un API privat care se găsește doar în secțiunea API din partea de jos a paginii Prezentare generală a proiectului API.
Pasul 2: solicitați un token de acces OAuth
Tokenul de acces OAuth trebuie utilizat pentru fiecare tranzacție API. Tokenul este valid doar pentru o oră, așadar, va trebui să vă codați programatic aplicația pentru a reîmprospăta tokenul înainte de a expira sesiunea. Consultați Documentația API Authorization pentru mai multe detalii. Când vizualizați codul eșantion, verificați dacă este selectat „Revânzător” din lista derulantă de eșantioane.
Pasul 3: examinați documentația API-ului
Faceți clic pe documentația pentru fiecare dintre API-urile dvs. pentru a citi contextul de afaceri și a înțelege cum să utilizați API-ul. Conectați-vă pentru a descărca colecția API JSON prin intermediul butonului din partea de sus a paginii dvs. de documentație. Puteți consulta exemple de solicitări pentru punctul final care corespunde integrării dorite.
Pasul 4: utilizați mediul de testare pentru a testa exemple de tranzacții
Faceți clic pe punctul final dorit din partea de navigare din stânga pentru a merge la acel mediu de testare specific. Identificați solicitările de exemple care corespund cazului dvs. de utilizare, apoi utilizați acreditările dvs. de testare și URL-urile de testare FedEx pentru a implementa apelurile către punctul final, așa cum este descris în solicitările de exemple. Asigurați-vă că răspunsurile la apelurile API pe care le primiți corespund cu cele afișate în documentație. Aflați mai multe despre experiența noastră de testare în Ghidul de utilizare a mediului de testare virtual.
Etapa 5: verificați fiecare soluție
După ce v-ați testat completă a soluțiile, trimiteți cazurile de testare echipei de verificare pentru a verifica fiecare soluție. FedEx va examina complet tot ce ați trimis și vă va anunța imediat ce a fost aprobată verificarea.
Testarea cu webhookURI
Dacă organizația dvs. are acces la webhookuri, testarea vă poate ajuta să vă faceți o idee mai bună cu privire la validitatea URL-ului creat. Astfel, FedEx va avea permisiunea de a vă identifica adresa URL și de a crea o conexiune cu aceasta, pentru a trimite date. De asemenea, testarea vă poate oferi exemple de date de test, care vă pot ajuta să verificați și să confirmați faptul că puteți procesa datele de monitorizare a expedierilor, furnizate în aplicația dvs. Totuși, testarea nu autentifică URL-ul dvs. Accesați documentația webhookului pentru a afla cum să vă testați URL-ul webhook.
FedEx vă va trece apoi proiectul (proiectele) la producție. Accesați pagina dvs. Prezentare generală a proiectului API și deschideți fila Cheie de producție. Faceți clic pe linkul Generare cheie secretă de sub coloana Cheie secretă.
Acum puteți să vă retestați implementarea în mediul de producție prin utilizarea datelor eșantion.
Condiție preliminară
You must have a FedEx user ID and account to log into the FedEx Developer Portal and create an organization.
Fie creați o organizație, dacă încă nu există una pentru compania dumneavoastră, fie vă alăturați organizației existente a companiei dumneavoastră.
Creați o organizație nouă
În bara de navigare, faceți clic pe Creare sau înscriere la organizație.
Notă: în calitate de creator, veți fi desemnat automat ca administrator al organizației.
Administratorii pot:
invita utilizatori să se înscrie;
atribui utilizatorilor roluri (de exemplu, colaborator, vizualizator) și proiecte;
gestiona conturile de expediere.
Pentru mai multe detalii despre aceste roluri, consultați Ghidul nostru privind administrarea organizațiilor.
Pentru tipul de companie, selectați „Vinde sau furnizează o soluție software care utilizează tehnologia FedEx și este un furnizor de servicii tip integrator FedEx validat”.
Furnizați numele companiei, URL-ul site-ului web și un nume unic pentru organizație. Numele organizației poate corespunde numelui companiei dumneavoastră sau poate reprezenta un grup specific (departament, divizie, regiune, locație). Aceste informații sunt necesare pentru validarea solicitării dumneavoastră.
Notă: alegeți un nume de organizație ușor de recunoscut de către ceilalți utilizatori (de exemplu, numele companiei, departament, regiune, locație).
Specificați locația companiei dumneavoastră și zonele în care soluția software va fi vândută sau distribuită.
Adăugarea contului de facturare și autentificarea contului
Notă: în calitate de furnizor de servicii de transport și logistică în cadrul FedEx Integrator Program, trebuie să utilizați propriul număr de cont. Nu puteți utiliza numărul de cont al unui client.
Introduceți numărul de cont FedEx. Dacă nu dețineți un cont FedEx, creați unul pe fedex.com sau contactați un reprezentant al serviciului de asistență FedEx.
Introduceți un pseudonim pentru cont și adresa de facturare asociată contului. Selectați Următorul.
Notă: adresa de facturare trebuie să corespundă înregistrărilor noastre pentru acest cont. Acesta va fi contul de facturare prestabilit pentru organizația dumneavoastră.
Pentru a finaliza crearea organizației, trebuie să vă autentificați contul. Alegeți o opțiune de autentificare (telefon, disponibil doar pentru Integratorii din SUA și Canada, e-mail sau SMS) și selectați Înainte.
După primire, introduceți codul de autentificare și selectați Trimitere.
Acceptați condițiile
Citiți Acordul FedEx pentru integratori și Manualul programului. Bifați căsuțele pentru a confirma acceptarea termenelor, apoi selectați Accept.
Va apărea un ecran de confirmare. Faceți clic pe Administrare organizație pentru a edita detaliile, dacă este necesar.
Invitare utilizatori
Notă: doar administratorii pot invita utilizatori.
Selectați Administrare organizație din meniul de navigare din stânga.
Accesați fila Utilizatori și selectați Adăugare utilizatori.
Completați formularul și atribuiți noului utilizator (sau noilor utilizatori) rolul corespunzător: Vizualizator, Colaborator sau Administrator.
Pentru detalii despre roluri, consultați Ghidul de administrare pentru organizații.
Atribuiți utilizatorii proiectelor (dacă este cazul), din meniul derulant Proiecte.
Introduceți adresele de e-mail ale utilizatorilor și selectați Invitare.
Alăturați-vă unei organizații existente
Solicitați o invitație: cereți administratorului organizației să vă trimită o invitație. Aveți 24 de ore pentru a o accepta. Dacă este nevoie, cereți retrimiterea invitației.
Acceptați invitația conectându-vă cu ID-ul și parola existente. Dacă ID-ul este deja asociat altei organizații, trebuie să creați un nou ID.
Crearea unui Proiect API
Accesați pagina Proiectele mele și selectați Creare proiect.
Completați câmpul Nume proiect. Formatul recomandat este „NumeProiect_NumeAplicație”. Selectați Înainte după ce terminați .
Selectați API-urile și produsele Advanced Integrated Visibility pentru proiect.
Notă: produsele Advanced Integrated Visibility sunt disponibile doar pentru furnizorii de servicii tip integrator FedEx din SUA.
Notă: 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 contului de facturare și acceptarea termenelor
Atribuiți un cont de facturare din lista de conturi adăugate în organizație. Această etapă este necesară numai dacă ați selectat anterior un produs cu plată.
Acceptați termenele și condițiile asociate produsului.
Confirmarea detaliilor
Examinați produsele selectate. Verificați contul de facturare.
Consultați și acceptați Acordul de licență pentru FedEx Developer Portal.
Faceți clic pe Creare pentru a genera proiectul și a vizualiza datele de testare.
Configurarea Advanced Integrated Visibility într-un proiect
Condiții preliminare
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 Ghidul de stabilire a prețurilor pentru mai multe informații despre prețuri.
- Configurare conturi: Advanced Integrated Visibility necesită un cont de facturare înregistrat în Statele Unite și cel puțin un cont de expediere, cele două tipuri de cont fiind mutual exclusive. Doar administratorii pot adăuga conturi de facturare și expediere pe pagina Gestionare organizație.
Creați un URL de callback valid în aplicația sau platforma dumneavoastră de destinație – URL-ul aplicației/platformei:
Trebuie să utilizeze HTTPS din motive de securitate.
Nu poate include spațiul de IP conform RFC1918, subdomenii fedex.com sau adrese IP directe (de exemplu, 127.0.0.1).
Generați un token de securitate
Trebuie să aibă între 26 și 100 de caractere și să includă:
- O literă mare
- O literă mică
- O cifră
Exemplu: Y1F6OiVUQW2JPSElmRE9U0IY5
Configurați Advanced Integrated Visibility
Alegeți Advanced Integrated Visibility. Selectați funcționalități precum dovada livrării, data estimată a livrării, evenimente de tracking și filtrare bazată pe evenimente
Introduceți URL-ul de destinație și tokenul de securitate.
Furnizați o adresă de e-mail pentru actualizări și notificări de indisponibilitate privind Advanced Integrated Visibility.
Confirmați detaliile
Revizuiți și acceptați Acordul de licență pentru FedEx Developer Portal și Formularul de comandă.
Selectați Creare pentru a finaliza configurarea.
Notă: pot exista pași suplimentari, în funcție de tipul abonamentului. Consultați documentația pentru detalii.
Obținerea acreditărilor de testare și începerea testării
Consultați documentația API
- Citiți documentația API pentru a înțelege API-urile disponibile, contextul lor de business și procesele de integrare.
- Descărcați schema JSON de pe pagina cu documentația API-ului relevant.
- Examinați exemplele de solicitări pentru punctele finale necesare.
Obțineți acreditările de testare
În pagina Prezentare generală proiect, accesați fila Chei API. Cheia API și cheia secretă sunt listate sub antetul Cheie de testare.
Consultați documentația API
- Un token OAuth este necesar pentru toate tranzacțiile API și expiră în o oră.
- Aplicația trebuie să reînnoiască tokenul înainte de expirare.
- Consultați documentația API Authorization pentru detalii.
Testați tranzacțiile API în sandbox
- Accesați API-ul dorit din Catalogul de API-uri și selectați Documentație.
- Selectați punctul final necesar din meniul din stânga.
- Utilizați exemple de solicitări care se potrivesc cazului dumneavoastră de utilizare.
- Implementați apelurile API folosind acreditările de testare și URL-urile de testare FedEx.
- Verificați răspunsurile în raport cu documentația.
- Consultați Ghidul de virtualizare în sandbox pentru detalii suplimentare.
Testare Advanced Integrated Visibility
Testarea Advanced Integrated Visibility validează formatul URL-ului și contribuie la stabilirea unei conexiuni între FedEx și aplicația dumneavoastră.
Testul furnizează exemple de date de testare pentru procesarea informațiilor de urmărire.
Notă: testarea nu autentifică URL-ul dumneavoastră.
Vizitați documentația Advanced Integrated Visibility pentru a afla mai multe.
Este necesară validarea pentru a transfera API-urile în producție. Nivelul de validare diferă în funcție de API.
Dezvoltați și testați API-urile FedEx
- Utilizați acreditările dumneavoastră de testare (cheia API și cheia secretă) din pagina Prezentare generală proiect.
- Identificați cazurile de testare pentru regiunile/teritoriile în care intenționați să implementați soluția (consultați Referințe legate de cazurile de testare pentru integratori).
- Înainte de a rula cazurile de testare, finalizați tranzacțiile de înregistrare folosind numerele de cont de test furnizate.
- Executați toate cazurile de testare obligatorii.
Accesați pagina Prezentare generală proiect.
Selectați Solicitare chei de producție. FedEx va primi solicitarea dumneavoastră pentru cheile de producție și veți fi notificat(ă) imediat ce acestea sunt aprobate.
Completați documentele Fișa de lucru cu informații despre produs (PIW) și Fișa de validare
Completați documentele Fișa de lucru cu informații despre produs (PIW) și Fișa de validare a integratorului cu detaliile dumneavoastră de contact și serviciile FedEx dorite.
Trimiteți livrabilele
Colectați și arhivați următoarele într-un fișier .zip pentru a evita restricțiile furnizorilor de servicii de e-mail. Trimiteți la validationmtp@fedex.com.
Livrabile obligatorii
- PIW completat (PDF).
- Fișă de validare completată (PDF).
Capturi de ecran (PDF):
Soluția dumneavoastră de contact cu clienții care afișează serviciile FedEx/manipularea specială
Declarația de declinare a responsabilității
Acordul de licență pentru utilizatorul final
Fluxul de înregistrare a clientului final
- 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)
Recomandări pentru evitarea întârzierilor
- Etichetele trebuie imprimate și scanate la minimum 600 DPI.
- Etichetele pentru imprimante termice trebuie să corespundă modelului imprimantei (de exemplu, ZPLII pentru imprimante Zebra).
- Expedierile FedEx International Express® necesită o etichetă auxiliară cu documentul de expediere.
- Expedierile formate din mai multe colete trebuie să includă o etichetă pentru fiecare colet.
Evaluarea etichetelor
Echipa de validare va aproba sau respinge trimiterea dumneavoastră.
- Dacă este respinsă, corectați și retrimiteți pe baza feedbackului primit
- Dacă este aprobată, veți primi un e-mail care confirmă validarea reușită. După primirea e-mailului, acreditările dumneavoastră de producție vor fi autorizate pentru tranzacțiile cu etichete de expediere.
Urmați instrucțiunile post-validare
Consultați și implementați cerințele post-validare, după caz.
După ce primiți notificarea conform căreia cheile de producție au fost aprobate, accesați fila Prezentare generală proiect pentru a le prelua.
- Copiați și stocați în siguranță cheia API de producție și cheia secretă.
- Cheia secretă este afișată o singură dată—dacă este pierdută, trebuie să generați una nouă.
