FedEx Integrator ‑ratkaisun tarjoaja
Edellytys
FedEx Developer Portaliin kirjautumiseen ja organisaation luomiseen tarvitaan FedEx-käyttäjätunnus.
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 laskutettavia asiakasnumeroita.
Lue lisää käyttäjärooleista kohdasta Organisaation hallinnan periaatteet.
1. Valitse navigointipalkista Luo organisaatio tai liity siihen.
2. Anna seuraavat tiedot:
- Valitse Työskentelen yrityksessä, joka -kohtaan Myy tai tarjoaa FedEx-teknologiaa käyttävän ohjelmistoratkaisun, ja haluaisin rekisteröityä vahvistetuksi FedEx Integrator ‑ratkaisun tarjoajaksi
- Anna yrityksesi nimi, yrityksesi verkkosivusto ja organisaatiosi nimi, jonka tiimisi tunnistaa, kuten yrityksen nimi, osasto, jaosto tai alue.
- Anna virallinen sähköposti, joka sisältää yrityksesi verkkotunnuksen, maan tai alueen, jossa yrityksesi on rekisteröity, sekä maat ja alueet, joissa myyt tai jakelet ohjelmistoratkaisuasi.
3. Valitse Seuraava.
Voit päivittää tai lisätä tietoja myöhemmin valikon Hallitse organisaatiota ‑kohdassa.
Laskutettavan asiakasnumeron lisääminen
1. Valitse Laskutettavat asiakasnumerot ‑välilehti. Jos sinulla ei ole FedExin laskutettavaa asiakasnumeroa, valitsemalla Avaa laskutettava asiakasnumero voit avata uuden laskutettavan asiakasnumeron tai ota yhteyttä FedExin tukeen.
Huomautus: Käytä omaa asiakasnumeroasi; se ei voi olla asiakkaan FedEx-asiakasnumero.
2. Valitse Lisää laskutettava asiakasnumero.
3. Anna oma FedEx-asiakasnumerosi, asiakasnumerosi lempinimi ja yhdysvaltalainen laskutusosoite, jota käytit asiakasnumeron luomisen yhteydessä.
Huomautus: Laskutusosoitteen on vastattava asiakasnumeron määrityksen yhteydessä käyttämääsi osoitetta. Tästä asiakasnumerosta tulee organisaatiosi oletusarvoinen laskutettava asiakasnumero.
4. Valitse todennusvaihtoehto.
- Puhelinsoitto on saatavilla vain Yhdysvalloissa ja Kanadassa oleville integraattoreille.
5. Syötä saamasi todennuskoodi ja valitse Lähetä.
6. Lue ja hyväksy FedExin integraattorisopimus.
Käyttäjien kutsuminen ylläpitäjänä
1. Siirry kohtaan Hallitse organisaatiota ja valitse Käyttäjät-välilehti.
2. Valitse + Lisää käyttäjiä.
3. Anna seuraavat tiedot:
- Maa tai alue
- Ensisijainen kieli
4. Valitse käyttäjän rooli (Katsoja, Avustaja tai Ylläpitäjä).
5. (Valinnainen) Määritä käyttäjälle projekti.
- Voit määrittää käyttäjän milloin tahansa projektin Yleiskatsaus-sivulta.
6. 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. Kutsu on voimassa 24 tuntia.
Projektin luominen
1. Siirry valikosta kohtaan Omat projektit ja valitse + Luo projekti.
2. Anna projektin nimi.
- Suositeltu nimen muoto on Projektinnimi_sovelluksennimi. Kun olet valmis, valitse Seuraava.
3. Valitse projektillesi API:t ja Laajennettu integroitu näkyvyys ‑tuotteet.
- Laajennettu integroitu näkyvyys ‑tuotteet ovat saatavilla vain yhdysvaltalaisille FedEx Integrator ‑ratkaisun tarjoajille.
- Jos valitset maksullisia tuotteita, sinua pyydetään määrittämään projektille laskutettava asiakasnumero ja hyväksymään vaaditut ehdot.
Laskutettavan asiakasnumeron määrittäminen
Huomautus: Tämä vaaditaan vain, jos valitset maksullisen tuotteen.
1. Määritä laskutettava asiakasnumero organisaatioon lisättyjen asiakasnumeroiden luettelosta. Laskutettavien asiakasnumeroiden tulee sijaita Yhdysvalloissa.
2. Hyväksy FedEx Developer Portalin lisenssisopimus ja tilauslomake ja valitse sitten Luo.
Määritä Laajennettu integroitu näkyvyys projektissa
Ennakkoedellytykset
- Tarkista hinnat: Tilaajilta veloitetaan kuukausimaksu seurantanumeroiden määrän mukaan. Lue lisätietoja hinnoittelusta tilauslomakkeesta.
- 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. Lisätietoja on webhook-dokumentaatiossa.
Näiden vaiheiden avulla voit tarkistaa API-integraatiosi ja varmistaa, että sovelluksesi voi lähettää ja vastaanottaa testidataa.
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. 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.
Vahvistusvaiheet vaihtelevat alueittain
Seuraavat vaiheet koskevat vain Yhdysvalloissa ja Kanadassa sijaitsevia asiakkaita. Jos asut näiden maiden ulkopuolella, löydät tukea API:n vahvistussivulta.
Jotta API:t voidaan siirtää tuotantoon, ne täytyy vahvistaa. Vahvistustaso vaihtelee API:n mukaan. 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. Tunnista testitapausten osalta ne alueet tai territoriot, joilla aiot ottaa ratkaisusi käyttöön. Katso lisätietoja Integrator-testitapausten perustasoasiakirjasta.
4. Suorita rekisteröintitapahtumat käyttämällä annettuja testiasiakasnumeroita ennen testitapausten suorittamista.
5. Suorita kaikki vaaditut testitapaukset.
6. Täytä tuotetietolomake yhteystiedoillasi ja valitsemillasi FedEx-palveluilla.
7. Täytä integraattorin vahvistuksen kansilehti.
Lähetä toimitettavat tiedostot
Lähetä kaikki vaaditut aineistot osoitteeseen validationmtp@fedex.com.
1. Valmistele seuraavat toimitettavat tiedostot:
- Täytetty tuotetietolomake (PDF)
- Täytetty vahvistuksen kansilehti (PDF)
- Loppuasiakkaan rekisteröintitapahtumat monivaiheisella todennuksella (JSON)
- Skannatut osoitelaput kaikille soveltuville testitapauksille (PDF/PNG)
- Lähetystapahtumat kolmelle osoitelappumuodolle: PDF, PNG ja ZPL (JSON) (soveltuville lähetys- ja hinnoittelu-API-rajapinnoille)
- Kuvakaappaukset (PDF), joissa näkyy seuraavat tiedot:
- Asiakkaille suunnattu ratkaisu, jossa FedEx-palvelut ja -erityiskäsittely ovat näkyvissä
- Vastuuvapauslauseke
- Loppukäyttäjän käyttöoikeussopimus (EULA)
- Loppuasiakkaan rekisteröintiprosessi
2. Pakkaa kaikki tiedostot yhdeksi .zip-tiedostoksi sähköpostin tarjoajan rajoitusten välttämiseksi.
3. Lähetä .zip-tiedosto sähköpostilla vahvistustiimille.
Parhaat käytännöt viivästysten välttämiseksi
Noudata näitä ohjeita lyhentääksesi tarkistusaikaa:
- 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.
- FedEx International Express® ‑lähetyksiin tulee sisällyttää myös toissijainen lentorahtikirja (AWB).
- Sisällytä moniosaisissa lähetyksissä (MPS) jokaiseen pakettiin osoitelappu.
Osoitelapun arviointi
Vahvistustiimi tarkistaa lähetyksesi.
- Jos lähetys hylätään, käsittele se palautteen mukaan ja lähetä toimitettavat tiedostot uudelleen.
- Jos lähetys hyväksytään, saat vahvistussähköpostin. Hyväksynnän jälkeen tuotannon tunnistetietosi valtuutetaan osoitelapputapahtumiin.
1. Valitse valikosta Omat projektit ja sitten projektin nimi.
2. Kopioi ja tallenna tuotannon API-avain ja salainen avain turvallisesti API:t-osioon.
Huomautus: Säilytä salaista avaintasi turvallisessa paikassa, sillä se näkyy vain kerran. Jos menetät sen, voit myöhemmin luoda uuden avaimen.
