Expeditor 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 dvs. pentru a colabora cu echipa dvs. În cazul în care compania dvs. 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 dvs. 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 dvs. de utilizator și parola existente. Dacă ID-ul dvs. 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. Autentificați-vă la FedEx Developer Portal.
2. Din meniu, selectați Proiectele mele, apoi selectați Creare organizație.
3. Introduceți următoarele detalii:
- Pentru Lucrez pentru o companie care, selectați Expediază cu FedEx și trebuie să integreze Interfețe API FedEx în propriile aplicații
- Introduceți numele companiei, site-ul web al companiei și un nume de organizație pe care echipa dvs. îl va recunoaște, cum ar fi numele companiei, departamentul, divizia sau regiunea.
4. Selectați Creare.
Puteți actualiza sau adăuga detalii ulterior, în secțiunea Gestionare organizație din meniu.
Adăugarea unui cont de expediere
1. Selectați Adăugare conturi de expediere în dala Adăugare conturi . Dacă nu aveți un cont FedEx, selectați Creați un cont pentru a crea unul nou sau contactați Asistența FedEx.
2. Selectați + Adăugare cont.
3. Introduceți numărul dvs. de cont FedEx, un pseudonim pentru cont și adresa de facturare utilizată la configurarea contului.
4. Acceptați Acordul de licență pentru utilizatorul final sau transmiteți-l unui reprezentant autorizat din compania dvs.
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.
2. Selectați Adăugare cont de facturare. Conturile de facturare trebuie să fie înregistrate în SUA.
3. Introduceți numărul dvs. de cont FedEx, un pseudonim pentru cont și o adresă de facturare din SUA utilizată la configurarea contului.
4. Citiți și acceptați Acordul de licență pentru utilizatorul final.
Invitarea utilizatorilor ca administrator
1. Din meniu, selectați Gestionare organizație, apoi selectați fila Utilizatori .
2. Selectați + Adăugare utilizatori.
3. Selectați o țară sau un teritoriu și o limbă preferată, apoi alegeți un rol de utilizator: Vizualizator, Contribuitor sau Administrator.
4. (Opțional) Alocați utilizatorul unui proiect. Puteți atribui utilizatori oricând din pagina Prezentare generală a proiectului.
5. 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țiile expiră după 24 de ore.
Crearea unui proiect API
1. Din meniu, selectați Proiectele mele, apoi selectați fila Interfețe API și alegeți + Creare proiect API.
2. Confirmați cerințele pentru interfețele dvs. API
3. Selectați interfețele API de inclus în proiectul dvs.
4. Creați un nume de proiect și selectați țările în care intenționați să expediați pentru a primi un cont de expediere de testare. Pentru expedierile interne europene, aveți nevoie de un cont de testare separat pentru fiecare țară. Puteți adăuga sau elimina țări ulterior.
5. Selectați Setări în Notificări pentru a configura preferințele dvs. de notificare.
6. Citiți și acceptați termenele și condițiile.
Creați un proiect Advanced Integrated Visibility
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 Vizibilitate expediere necesită un cont de facturare înregistrat în SUA ș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 dvs. 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 mai multe informații, consultați documentația noastră Webhook.
Urmați acești pași pentru a verifica integrarea interfeței API și pentru a confirma că aplicația dvs. poate trimite și primi date de testare.
Preluarea acreditărilor 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 dvs. 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 dvs.
4. Solicitați un token de acces OAuth pentru a-l utiliza cu fiecare tranzacție a interfeței API.
Notă: 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 dvs. 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.
Mutarea proiectului dvs. în faza de producție
Configurați-vă setările de producție înainte de ca proiectul să devină activ. Puteți să redenumiți cheia, să adăugați conturi suplimentare după ce proiectul devine activ și verifica numărul de cont selectat în timpul creării proiectului. Acest număr cont mută proiectul dvs. în faza de producție.
Notă: proiectele Advanced Integrated Visibility bazate pe număr de cont nu necesită activare pentru producție.
1. Din meniu, selectați Proiectele mele, apoi selectați Nume proiect.
2. Selectați fila Cheie de producție .
3. Preluați și stocați în siguranță acreditările de producție.
- Copiați cheia interfeței API de producție și cheia secretă într-o locație securizată.
- Când solicitați o cheie de producție, salvați-o într-un loc sigur, deoarece apare o singură dată. Dacă o pierdeți, puteți genera una nouă mai târziu.
4. Selectați Înainte pentru a vizualiza detaliile proiectului dvs. în fila Cheie de producție .
Pentru a adăuga mai multe conturi de expediere, selectați 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 SUA și Canada. Dacă locuiți în afara acestor țări, accesați pagina Validare API pentru a găsi asistență.
Validarea Interfeței dvs. API
Unele interfețe API FedEx necesită validarea etichetei de expediere înainte de a le putea utiliza în faza de producție. 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 dvs. de testare.
3. După finalizarea testării, mutați proiectul în faza de producție în FedEx Developer Portal pentru a începe validarea.
- Când solicitați o cheie de producție, salvați-o într-un loc sigur, deoarece apare o singură dată. Dacă o pierdeți, puteți genera una nouă mai târziu.
4. Furnizați informațiile solicitate în foaia de copertă a etichetei, inclusiv datele de contact, serviciile pe care intenționați să le implementați, numărul de cont și cheia interfeței API de producție.
5. Creați etichete de testare în mediul de testare FedEx, apoi trimiteți-le Grupului de analiză a codurilor de bare FedEx pentru examinare. Acordați trei zile lucrătoare pentru evaluarea etichetelor.
Bune practici pentru evitarea întârzierilor
- 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 dvs., de exemplu, ZPLII pentru imprimante Zebra.
- Folosiți adrese valide de expeditor și destinatar pentru etichetele de probă. Creați etichete doar pentru serviciile pe care intenționați să le folosiți.
- Pentru FedEx Plată ramburs (C.O.D.), includeți eticheta de retur C.O.D.
- Pentru FedEx International Express®, includeți documentul de expediere (AWB) auxiliar (secundar).
- Pentru expedieri formate din mai multe colete (MPS), trimiteți o etichetă pentru fiecare colet.
Trimiteți materialele folosind una dintre următoarele opțiuni:
- Trimiteți prin e-mail PDF-ul și foaia de copertă a etichetei la label@fedex.com.
- Trimitere etichete fizice la:
Servicii FedEx
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Notă: pentru etichetele fizice, asigurați-vă că nu există defecte vizibile, cum ar fi linii de cerneală sau deteriorări. Nu măriți și nu micșorați etichetele la imprimare.
6. Grupul de analiză a codurilor de bare FedEx examinează trimiterea dvs. și aprobă sau respinge etichetele. Dacă etichetele sunt respinse, luați în considerare feedbackul și retrimiteți-le.
7. După aprobare, Grupul de analiză a codurilor de bare FedEx vă trimite un e-mail după ce vă autorizează acreditările de producție pentru tranzacții cu etichete de expediere.
Notă: aprobarea se aplică per proiect. Fiecare proiect nou necesită aprobare.
8. Înlocuiți URL-urile și acreditările de testare cu URL-urile și acreditările de producție.
9. Rulați un test final de producție cu date de probă pentru a confirma că totul funcționează conform așteptărilor.
