FedEx-lähettäjä | FedEx Developer Portal

1 Organisaation luominen tai siihen liittyminen

Liity yrityksesi organisaatioon ja tee yhteistyötä tiimisi kanssa. Jos yritykselläsi ei ole organisaatiota, voit luoda sellaisen.

Liittyminen olemassa olevaan organisaatioon

1. Pyydä kutsu

Pyydä organisaatiosi ylläpitäjää lähettämään sinulle kutsu. Sinulla on 24 tuntia aikaa hyväksyä se. Jos kutsu vanhenee, pyydä ylläpitäjää lähettämään se uudelleen.

2. Hyväksy kutsu

Kirjaudu sisään nykyisellä käyttäjätunnuksellasi ja salasanallasi. Jos käyttäjätunnuksesi on liitetty toiseen organisaatioon, luo uusi tunnus.

Uuden organisaation luominen

Kun luot organisaation, sinusta tulee sen ylläpitäjä. Ylläpitäjänä voit kutsua käyttäjiä liittymään organisaatioon, määrittää projekteja ja käyttäjärooleja sekä hallita lähettäviä asiakasnumeroita.

Lue lisää käyttäjärooleista kohdasta Organisaation hallinnan periaatteet.

1. Kirjaudu sisään FedEx Developer Portaliin.

2. Valitse valikosta Omat projektit ja sitten Luo organisaatio.

3. Anna seuraavat tiedot:

Valitse Työskentelen yrityksessä, joka käyttää -kohdassa FedExin lähetyspalveluita, ja meidän tarvitsee integroida FedExin API:t omiin sovelluksiimme
Anna yrityksesi nimi, yrityksesi verkkosivusto ja organisaatiosi nimi, jonka tiimisi tunnistaa, kuten yrityksen nimi, osasto, jaosto tai alue.

4. Valitse Luo.

Voit päivittää tai lisätä tietoja myöhemmin valikon Hallitse organisaatiota ‑kohdassa.

Lähettäjän asiakasnumeron lisääminen

1. Valitse Lisää lähettäjän asiakasnumeroita -kohdassa Lisää asiakasnumeroita . Jos sinulla ei ole FedEx-asiakasnumeroa, avaa uusi asiakasnumero valitsemalla Luo asiakasnumero tai ota yhteyttä FedEx-tukeen.

2. Valitse + Lisää asiakasnumero.

3. Anna oma FedEx-asiakasnumerosi, asiakasnumerosi lempinimi ja laskutusosoite, jota käytit asiakasnumeron määrityksen yhteydessä.

4. Hyväksy Loppukäyttäjän käyttöoikeussopimus tai lähetä se yrityksesi valtuutetulle edustajalle.

Laskutettavan asiakasnumeron lisääminen

1. Valitse Laskutettavat asiakasnumerot ‑välilehti. Jos sinulla ei ole FedExin laskutettavaa asiakasnumeroa, valitsemalla Avaa laskutettava asiakasnumero voit avata uuden sellaisen . Voit myös ottaa yhteyttä FedExin tukeen.

2. Valitse Lisää laskutettava asiakasnumero. Laskutettavien asiakasnumeroiden tulee sijaita Yhdysvalloissa.

3. Anna oma FedEx-asiakasnumerosi, asiakasnumerosi lempinimi ja yhdysvaltalainen laskutusosoite, jota käytit asiakasnumeron luomisen yhteydessä.

4. Lue ja hyväksy Loppukäyttäjän käyttöoikeussopimus.

Käyttäjien kutsuminen ylläpitäjänä

1. Valitse valikosta Hallitse organisaatiota ja valitse sitten Käyttäjät-välilehti.

2. Valitse + Lisää käyttäjiä.

3. Valitse maa tai alue ja ensisijainen kieli ja valitse sitten käyttäjärooli: katsoja, osallistuja tai ylläpitäjä.

4. (Valinnainen) Määritä käyttäjälle projekti. Voit määrittää käyttäjiä milloin tahansa projektin Yleiskatsaus-sivulta.

5. Anna käyttäjien sähköpostiosoitteet ja napsauta Kutsu. Voit kutsua enintään 20 käyttäjää kerralla niin, että erotat kunkin sähköpostin pilkulla. Kutsut vanhenevat 24 tunnin jälkeen.

Luo organisaatio

2 Luo projekti

API-projektin luominen

1. Valitse valikosta Omat projektit, valitse sitten API:t-välilehti ja valitse + Luo API-projekti.

2. Vahvista API-tarpeesi.

3. Valitse projektiin sisällytettävät API:t.

4. Luo projektille nimi ja valitse maat, joihin aiot lähettää, saadaksesi testausta varten lähettäjän asiakasnumeron. Jotta voit testata pakettien lähettämistä yhden maan sisällä Euroopassa eli tehdä kotimaan lähetyksiä, jokaisella maalla pitää olla erillinen testiasiakasnumero. Voit lisätä tai poistaa maita myöhemmin.

5. Valitse Ilmoitukset-kohdasta Asetukset ja määritä ilmoitusasetukset.

6. Lue ja hyväksy käyttöehdot.

Luo Laajennettu integroitu näkyvyys -projekti

Ennakkoedellytykset

Tarkista hinnat: Tilaajilta veloitetaan kuukausimaksu seurantanumeroiden määrän mukaan. Lue lisätietoja hinnoista hinnoitteluoppaasta.
Avaa asiakkuudet: Lähetysten näkyvyys ‑webhookia varten tarvitaan Yhdysvalloissa oleva laskutettava asiakasnumero ja vähintään yksi lähettäjän asiakasnumero. Nämä asiakasnumerotyypit ovat toisensa poissulkevia. Vain ylläpitäjät voivat lisätä laskutettavan ja lähettäjän asiakasnumeron Hallitse organisaatiota ‑sivulle.

1. Luo sovelluksessa tai alustalla määränpään URL-osoite takaisinkutsujen vastaanottamiseksi. URL-osoitteen:

täytyy käyttää HTTPS-protokollaa
on oltava sisältämättä IP-osoiteavaruutta RFC1918, osoitetta fedex.com ja sen aliverkkotunnuksia ja IP-osoitteita (esim. localhost tai 127.0.0.1)

2. Luo suojaustunniste todennusta varten. Tunnisteen tulee:

sisältää 26–100 merkkiä, vähintään yksi iso kirjain, vähintään yksi pieni kirjain ja vähintään yksi numero

3. Valitse valikosta Omat projektit ja valitse sitten Laajennettu integroitu näkyvyys ‑välilehti.

4. Valitse Luo Laajennettu integroitu näkyvyys ‑projekti.

5. Valitse käyttäjätyyppi.

FedEx-lähettäjä: Yritys, joka käyttää FedExin lähetyspalveluita ja jonka täytyy integroida FedExin API:t omiin sovelluksiinsa
FedEx Compatible ‑ratkaisun tarjoaja: Yritys on sertifioitu FedEx Compatible ‑ratkaisun tarjoaja
FedEx Integrator ‑ratkaisun tarjoaja: Yritys myy tai tarjoaa FedExin teknologiaa hyödyntävää ohjelmistoratkaisua, ja se on vahvistettu FedEx Integrator ‑ratkaisun tarjoaja

6. Valitse tilaustyyppi. Voit tilata tapahtumia asiakasnumeroiden tai seurantanumeroiden perusteella.

7. Vahvista laskutettava asiakasnumero ja valitse haluamasi ominaisuudet, kuten toimitustodistus, arvioitu toimituspäivä, tapahtumien seuranta tai tapahtumapohjainen suodatus.

8. Anna projektin tiedot.

Anna projektille yksilöllinen ja tunnistettava nimi.
Anna määränpään URL-osoite ja suojaustunniste, jotka loit.
Anna sähköpostiosoite ja ensisijainen kieli Laajennettu integroitu näkyvyys ‑päivitysten ja ‑katkojen ilmoituksia varten.

9. Hyväksy FedEx Developer Portalin lisenssisopimus ja tilauslomake ja valitse sitten Luo.

Huomautus: Valitsemasi tilaustyypin mukaan sinulla voi olla lisävaiheita suoritettavana. Katso lisätietoja webhook-dokumentaatiosta.

SIIRRY OMIIN PROJEKTEIHISI

3 Integraation testaaminen

Näiden vaiheiden avulla voit tarkistaa API-integraatiosi ja varmistaa, että sovelluksesi voi lähettää ja vastaanottaa testidataa.

Testitunnistetietojen hakeminen

1. Valitse valikosta Omat projektit ja sitten projektin nimi.

2. Etsi testitunnistetietosi API-avaimet-välilehden Testiavain-kohdasta.

3. Kirjaudu sisään ja lataa JSON API ‑nouto käyttämällä Lataa JSON-malli ‑painiketta dokumentaatiosivun yläosassa. Tarkista esimerkkipyynnöt päätepisteille, joita integraatiosi käyttää.

4. Pyydä OAuth-käyttöoikeustunnusta käytettäväksi jokaisessa API-tapahtumassa.

Huomautus: Tunnus on voimassa tunnin ajan, ja voit määrittää sovelluksesi päivittämään sen ennen sen voimassaolon päättymistä. Katso lisätietoja API Authorization ‑dokumentaatiosta.

5. Valitse valikosta API-luettelo, valitse API, jota haluat käsitellä, ja valitse sitten Dokumentaatio.

6. Valitse valikosta päätepiste.

7. Lähetä esimerkkipyyntöjä käyttämällä testitunnistetietojasi ja FedEx-testi-URL-osoitetta ja vahvista sitten, että vastaukset vastaavat dokumentaatioesimerkkejä. Katso lisätietoja testivirtualisointioppaasta.

8. Suorita testit Laajennettu integroitu näkyvyys ‑toiminnolla luodaksesi näytetietoja ja varmistaaksesi, että sovelluksesi käsittelee seurantatiedot oikein.

Huomautus: Testaaminen ei todenna takaisinkutsun URL-osoitetta. Lisätietoja on saatavilla Laajennetun integroidun näkyvyyden dokumentaatiossa.

4 Siirtäminen tuotantoon

Projektin siirtäminen tuotantoon

Määritä tuotantokokoonpanosi ennen julkaisua. Voit nimetä avaimen uudelleen, lisätä asiakasnumeroita projektin julkaisun jälkeen ja tarkistaa projektin luonnin aikana valitun asiakasnumeron. Tämä asiakasnumero siirtää projektisi tuotantoon.

Huomaa: Asiakasnumeroon perustuvat Laajennettu integroitu näkyvyys ‑projektit eivät vaadi tuotannon aktivointia.

1. Valitse valikosta Omat projektit ja sitten projektin nimi.

2. Valitse Tuotantoavain-välilehti.

3. Nouda ja tallenna tuotantotiedot turvallisesti.

Kopioi tuotannon API-avain ja salainen avain turvalliseen paikkaan.
Kun pyydät tuotantoavainta, säilytä sitä turvallisessa paikassa, sillä se näkyy vain kerran. Jos menetät sen, voit myöhemmin luoda uuden avaimen.

4. Valitse Seuraava, jotta voit tarkastella projektin tietoja Tuotantoavain-välilehdellä.

Voit lisätä muita lähettäjän asiakasnumeroita valitsemalla Muokkaa lähettäjien asiakasnumeroiden taulukon yläosasta.

5 API:n vahvistaminen

API:n vahvistaminen

Jotkin FedExin API-rajapinnat edellyttävät osoitelapun vahvistamista ennen kuin niitä voidaan käyttää tuotannossa. Tarkista API-vahvistusvaatimukset, ennen kuin aloitat.

1. Valitse valikosta Omat projektit ja sitten projektin nimi.

2. Etsi testitunnistetietosi API-avaimet-välilehden Testiavain-kohdasta.

3. Kun testaus on valmis, siirrä projektisi tuotantoon FedEx Developer Portalissa ja aloita vahvistus.

Kun pyydät tuotantoavainta, säilytä sitä turvallisessa paikassa, sillä se näkyy vain kerran. Jos menetät sen, voit myöhemmin luoda uuden avaimen.

4. Anna osoitelapun kansiarkissa tarvittavat tiedot, mukaan lukien yhteystiedot, käyttöön otettavat palvelut, asiakasnumero ja tuotannon API-avain.

5. Luo testiosoitelappuja FedExin testiympäristössä ja lähetä ne sitten FedExin viivakoodianalyysiryhmälle tarkistettavaksi. Varaa kolme arkipäivää osoitelapun arviointiin.

Parhaat käytännöt viivästysten välttämiseksi:

Tulosta ja skannaa osoitelaput vähintään 600 DPI:n tarkkuudella. Älä lähetä tiedostoja, jotka on luotu suoraan API-rajapinnoista.
Jos käytät lämpötulostimia, pyydä tulostintasi vastaavaa kuvatyyppiä, esimerkiksi ZPLII Zebra-tulostimien osalta.
Käytä kelvollisia lähettäjän ja vastaanottajan osoitteita näyteosoitelapuissa. Luo osoitelappuja vain niille palveluille, joita aiot käyttää.
FedExin maksu toimituksen yhteydessä (COD) -lähetyksiä varten liitä mukaan palautuksen osoitelappu.
FedEx International Express® ‑lähetyksiin tulee sisällyttää myös toissijainen lentorahtikirja (AWB).
Jos kyseessä on moniosainen lähetys (MPS), lähetä yksi osoitelappu kutakin pakettia kohti.

Lähetä aineistosi jollakin seuraavista vaihtoehdoista:

Lähetä PDF ja osoitelapun kansilehti sähköpostitse osoitteeseen label@fedex.com.
Lähetä fyysiset osoitelaput osoitteeseen:

FedEx Services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017, USA

Huomautus: Varmista, että fyysisissä osoitelapuissa ei ole näkyviä vikoja, kuten musteviivoja tai vaurioita. Älä suurenna tai pienennä osoitelappuja tulostuksen aikana.

6. FedExin viivakoodien analysointiryhmä tarkistaa lähetyksesi ja hyväksyy tai hylkää osoitelaput. Jos osoitelaput hylätään, korjaa laput palautteen mukaan ja lähetä ne hyväksyttäväksi uudelleen.

7. Hyväksynnän jälkeen FedExin viivakoodien analysointiryhmä lähettää sinulle sähköpostiviestin, kun se on valtuuttanut tuotannon tunnistetietosi lähettäjän osoitelapputapahtumia varten.

Huomautus: Hyväksyntä koskee yhtä projektia. Jokainen uusi projekti vaatii erillisen hyväksynnän.

8. Korvaa testi-URL-osoitteet ja -tunnistetiedot omilla tuotanto-URL-osoitteillasi ja tunnistetiedoillasi.

9. Suorita lopullinen tuotantotesti näytetiedoilla varmistaaksesi, että kaikki toimii odotetulla tavalla.