Johdanto
LTL-rahdin APIlla voit luoda lähetyksiä osakuormille (LTL). LTL-rahti on liian suurta lähetettäväksi pakettina, mutta sen kuljettamiseen ei tarvita kokonaista rekkaa.
Tämän avulla saat hinta-arvioita ja voit luoda yksilöllisiä lähetysosoitekortteja yksittäisille käsittely-yksiköille ja konossementeille (tarvittaessa), ajastaa noutoja, seurata lähetyksen tiloja sekä tarkistaa noutojen saatavuuden ja ajastaa niitä. Näin voit tehostaa suurten ja painavien lähetysten käsittelyä.
FedEx Freight -palvelun LTL-lähetykset tarjoavat käsittely-yksikkötason seurannan ja näkyvyyden monia käsittely-yksiköitä sisältäville lähetyksille sekä kotimaisille lähetyksille, joilla ei useimmiten ole paperista konossementtia. Konossementti voidaan luoda tarvittaessa. Vaikka kaikilla käsittely-yksiköillä onkin yksilöllinen seurantanumero, lähetyksellä on yksi yhteinen konossementti, toimituskuitti ja lasku.
LTL-rahdin API -tiedot
LTL-rahdin APIlla voidaan tehdä LTL-lähetyksiä ja luoda tarvittavat asiakirjat, kuten konossementti (tarvittaessa), FedEx Freight -lähetysten osoitekortit ja monta muuta lähetysasiakirjaa. LTL-rahtilähetyksen pääosoitekortti kiinnitetään ensimmäiseen käsittely-yksikköön ja alaosoitekortti toiseen ja sitä seuraaviin käsittely-yksiköihin. Alaosoitekorteilla on oma yksilöllinen seurantanumero, mutta niissä mainitaan myös pääseurantanumero. Lisäksi voidaan luoda yksi lähetyskohtainen konossementti, johon sisältyvät kaikki käsittely-yksiköt ja -osat.
Kukin käsittely-yksikkö voidaan yhdistää seurantanumeroon, ja osoitekortti on samankaltainen kuin FedEx Ground- tai Express Parcel -osoitekortti – poikkeuksena on F-kirjain, joka edustaa rahtilähetystä.
Käsittely-yksiköiden ja käsittely-yksikkökohtaisten osien enimmäismäärät:
- Käsittely-yksikkökohtaisten osien enimmäismäärä: 9 999
- Käsittely-yksiköiden enimmäismäärä – 200 (kun tulostetaan käsittely-yksikön osoitelappuja yksi kerrallaan)
- Käsittely-yksiköiden enimmäismäärä – 40 (kun tulostetaan käsittely-yksikön osoitelaput kerralla)
FedEx LTL -rahtilähetykset ovat saatavilla Yhdysvaltain kaikkiin 50 osavaltioon sekä Puerto Ricoon, Yhdysvaltain Neitsytsaarille, Kanadaan ja Meksikoon. Jotkin lähetykset edellyttävät osoitekorttien lisäksi konossementtia. Esimerkki tällaisista lähetyksistä ovat vaarallisia aineita sisältävät lähetykset.
FedEx Freight® muuttaa LTL-alaa tekemällä rahdin nopeista ja edullisista lähetyksistä helppoja yhden virtaviivaistetun LTL-verkoston avulla.
Tässä APIssa ovat käytettävissä seuraavat ominaisuudet:
- LTL-rahdin noutojen hallinta
Tämän toiminnon avulla voit selvittää LTL-rahdin noutopaikat, ajastaa rahdin noudon ja peruuttaa jo varatun noudon.
- Pyydä hintatarjous LTL-rahtilähetyksestä
Tämän ominaisuuden avulla voit saada hintatarjoukset LTL-rahtilähetykselle valittujen paikkojen ja palveluvaihtoehtojen perusteella.
- Lähetä LTL-rahtilähetys
Tämän ominaisuuden avulla voit luoda LTL-rahtilähetyksen.
LTL-rahdin APIin liittyvät seuraavat ominaisuudet:
- Lähetä yksittäinen osa tai moniosainen lähetys kaikkien palvelutyyppien osalta ja luo siten lähetysosoitekortti tai -kortit tai konossementti (mikäli tarpeen).
- Luo monta käsittely-yksikköä sisältävä lähetys ja seuraa kutakin käsittely-yksikköä erikseen.
- Luo LTL-rahtilähetyksiä käyttämällä FedEx Freight Priority- ja Freight Economy -palveluita.
- Anna vastaanottajan tiedot, kuten tilinumero, yhteyshenkilö ja osoite.
- Anna aikaleima, pakkaustyyppi, kokonaispaino ja muut tarvittavat tiedot, jotka mainitaan päätepisterakenteessa.
- Tarjoa FedEx-osoitekortti vakiobrändäyksellä ja tue lämpötarrojen erikseen määritettyjä kokoja.
- Vastaanota sähköposti- tai tekstiviesti-ilmoituksia lähetystapahtuman aikana, esimerkkeinä seuraavat:
- Lähetysilmoitus
- Arvioitu toimitus
- Noutoilmoitus
- Luo yleisiä lähetysasiakirjoja, esim. seuraavat:
- Yksittäisen käsittely-yksikön lähetysosoitekortit
- Konossementti
- Kauppalasku
- Kanadan tullin lasku
- Luo lähetyksiä ja tulosta osoitekortteja yksi käsittely-yksikkö kerrallaan tai käsittele kaikki käsittely-yksiköt yhdellä kertaa.
- Nouda hinnasto yhdelle osalle tai moniosaiselle lähetykselle kaikkien palvelutyyppien osalta.
- Tarkista noudon saatavuus, ajasta rahdin nouto ja peruuta varattu nouto.
- Luo ja tilaa nouto kolmannen osapuolen asiakasnumeroilla, jos haluat vaihtoehtoisen laskutusosoitteen.
LTL-rahtilähetyspalvelut
Käytettävissä ovat seuraavat LTL-rahtilähetyspalvelut:
FedEx Freight® Priority
Toimialan huippua olevan oikea-aikaisuuden ja nopeiden kuljetusaikojen ansiosta FedEx Freight® Priority toimittaa lähetyksesi nopeasti ja luotettavasti. Voit luottaa alueellisen palvelumme laajamittaisiin toimituksiin asiakkaille seuraavana päivänä tai kahden päivän päästä. Kaiken tämän lisäksi saat vielä maksuttoman rahat takaisin -takuun. *
FedEx Freight® Priority -palvelun ominaisuudet:
- Nopeat kuljetusajat (seuraavan päivän toimitus jopa 965 km:n päähän ja toimitus toisena arkipäivänä jopa 2 575 km:n päähän).
- Suora toimitus lähes jokaiselle postinumeroalueelle Yhdysvalloissa, Kanadassa ja Meksikossa.
- Johdonmukaiset ja luotettavat toimitukset aikataulun mukaisesti.
- Maksuton rahat takaisin -takuu*.
- Moderni IT-teknologia ja lähetysten seurattavuus kaikissa vaiheissa alusta loppuun.
- Erillinen ammattilaistiimi, joka auttaa sinua kaikissa alueellisissa rahtilähetyksiin liittyvissä tarpeissasi.
*Kaikkia palveluita koskevat FXFR 100 Series -sääntötariffin ehdot.
FedEx Freight Economy
FedEx Freight® Economy -palvelu tarjoaa edulliset LTL (osakuorma) -toimitukset, jotka keskittyvät perusrahdin lähetysvaatimuksiin. FedEx LTL -toimituspalveluissa paketit toimitetaan luotettavasti aikataulun mukaan ja asiakaspalveluhenkisesti varovasti käsiteltyinä.
FedEx Freight® Economy tarjoaa:
- Edulliset rahtiratkaisut.
- Suuremmat säästöt lähetyksille, jotka ovat vähemmän kiireellisiä mutta jotka on kuitenkin toimitettava luotettavasti.
- Johdonmukaiset ja luotettavat toimitukset aikataulun mukaisesti.
- Suora toimitus lähes jokaiselle postinumeroalueelle Yhdysvalloissa, Kanadassa, Meksikossa ja Puerto Ricossa.
- Moderni IT-teknologia ja lähetysten seurattavuus kaikissa vaiheissa alusta loppuun.
- Parannettu näkyvyys seurannalla alusta loppuun.
Kuinka LTL-rahdin API toimii
Tässä osiossa kuvataan päätepisteet ja avainelementit, joita tarvitaan FedExin LTL-rahdin APIn käyttöön.
Huomautus: FedExin LTL-rahtitililläsi tulee olla oikeus käyttää FedExin LTL-rahdin APIa. LTL-lähetysten käsittelyyn vaaditut avaintiedot ovat FedEx Freight -asiakasnumero(t) ja asiakkaan oikea postiosoite.
Tässä APIssa ovat käytettävissä seuraavat päätepisteet:
Tee LTL-rahtilähetys
Käytä tätä päätepistettä FedExin LTL-rahtilähetyksen vahvistukseen ja luontiin.
Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:
- Rahtiasiakasnumero.
- Asiakkaan postiosoite.
- Pyydetty rahtilähetys.
- Osoitekortin vastausvaihtoehdot – toimitetaanko osoitekortit koodattuina vai URL-osoitteena.
- Pääseurantatiedot – vain silloin, kun käsiteltävänä on moniosainen lähetys ja osoitekortit on tulostettava yksi kerrallaan sen sijaan, että ne kaikki tulostettaisiin kerralla (kun elementtiä singleShotMPS ei ole annettu tai sen arvoksi on määritetty epätosi).
Onnistunut vastaus tähän pyyntöön luo LTL-lähetyksen sekä toimittaa seurantatiedot ja hälytystiedot vastausviestissä. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Huomautus: Postiosoite voi olla eri kuin lähetysosoite.
Tarkista LTL-rahdin noudon saatavuus
Tätä päätepistettä käyttämällä voit pyytää luetteloa kaikista käytettävissä olevista rahdin noutopaikoista ja noutoaikatauluista, kuten kuriiri, myöhäisin saatavilla oleva noutoaika, oletusarvoisesti myöhäisin saatavilla oleva noutoaika, noutojen saatavuus, aika, jolloin paketti on valmis noudettavaksi, ilmoitus siitä, onko kyseessä asuinrakennus, noudon katkaisuaika ja tapa, jolla kuljettaja pääsee noutamaan paketin.
Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:
- Nouto-osoite-/postiosoitetiedot.
- Noutopyynnön tyyppi (esim. sama päivä / päivä tulevaisuudessa).
- Onko kyseessä kotimaisen vai kansainvälisen lähetyksen nouto.
Huomautus: käytä oikeaa ja kelvollista nouto-osoitetta.
Onnistunut vastaus tähän pyyntöön tarjoaa luettelon kaikista käytettävissä olevista rahdin noutopaikoista, toimituspäivistä, saatavuudesta (merkintä), noutopäivistä, katkaisuajasta, palvelun käyttöajasta, asuinrakennusten käytettävyydestä (merkintä), palvelun sulkemisajasta (merkintä), sulkemisajasta ja paikallisesta ajasta. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Luo LTL-rahdin nouto
Käytä tätä päätepistettä LTL-rahdin noudon luontiin ja ajastamiseen.
Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:
- Rahtiasiakasnumero, jota laskutetaan noudosta.
- Alkuperätiedot (osoite, sijainti ja nouto-osoitetyyppi, kuten asiakasnumero/lähettäjä/muu).
- Liittyvät asiakasnumeron osoitetiedot.
Onnistunut noutopyyntö määrittää ajastettavalle noudolle noudon vahvistusnumeron, noutoilmoituksen ja paikkakoodin. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Huomautus: Ilmoita noudolle oikea osoite sekä anna oikeat asiakasnumeron osoitetiedot noudon tilaamista varten. Älä anna noutoa tilatessasi menneessä ajassa olevaa noutoaikaa tai päivämäärää äläkä päivämäärää, joka on liian kaukana tulevaisuudessa. Nimettömiä noutoja ei sallita. Voit tilata noudon kolmannen osapuolen asiakasnumeroilla antamalla vaihtoehtoiset, oikeat osoitetiedot.
Peruuta LTL-rahdin nouto
Käytä tätä päätepistettä LTL-paketin jo varatun noudon peruuttamiseen. Onnistunut noudon peruutus palauttaa vahvistusnumeron ja peruutuksen vahvistusviestin.
Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:
- Noudon vahvistuskoodi (saadaan noutopyynnön lähettämisen yhteydessä).
- Ajastuspäivä (päivä, jolloin nouto tapahtuu).
- Sijainti (FedEx Express -sijainti, joka on vastuussa noutopyynnön käsittelystä).
Onnistunut pyyntö määrittää ajastettavalle noudolle noudon vahvistusnumeron, noutoilmoituksen ja paikkakoodin. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Huomautus: Lähetä noudon vahvistusnumero ja sitä vastaava sijaintikoodi (koskee vain FDXE:tä) peruuttaaksesi jo varatun noudon. Noudon vahvistusnumero ja sitä vastaava sijaintikoodi (koskee vain FDXE:tä) saadaan samalla, kun lähetetään noutopyyntö. Käytä noudon perumiseen myös oikeaa, tiedossamme olevaa asiakkaan osoitetta. Saat ilmoituksen epäonnistumisesta, jos yrität peruuttaa noudon sen jälkeen, kun FedEx-kuriiri on lähtenyt noutopaikalle
LTL-rahtihinnasto
Tätä päätepistettä käyttämällä voit pyytää luettelon kaikista mahdollisista rahdin hintatarjouksista ja kuljetustiedoista annettujen tietojen perusteella. Noudetut hinnat perustuvat lähetyksen alkuperään ja määränpäähän sekä moniin muihin lähetyksestä annettuihin tietoihin. Hakutuloksia voidaan tarkentaa antamalla lisätietoja, kuten kuriirikoodi, palvelutyyppi tai palveluvaihtoehto.
Seuraavat tähän pyyntöön liittyvät tiedot ovat pakollisia:
- Rahtiasiakasnumero.
- Pyydetty rahtilähetys.
Onnistunut vastaus tähän pyyntöön määrittää luettelon kaikista ajastettavalle noudolle saatavilla olevista hinnoista ja sijaintikoodeista. Se palauttaa myös tiedot virheistä ja kuvaukset epäonnistumisista.
Moniosainen LTL-rahtilähetys
Moniosainen lähetys (MPS) muodostuu vähintään kahdesta käsittely-yksiköstä, jotka lähetetään samaan vastaanotto-osoitteeseen. Lähetyspyynnön ensimmäistä käsittely-yksikköä pidetään pääyksikkönä.
Moniosaisen lähetyksen luonti:
- Sisällytä lähetystason tiedot, kuten serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail ja requestedPackageLineItems. [Huomautus: pääpaketin sequenceNumber-arvon on oltava 1.]
- Jos haluat tulostaa osoitekortit käsittely-yksiköittäin, lisää pääseurantatiedot elementtiin masterTrackingId kaikille seuraaville käsittely-yksiköille.
Tässä APIssa ovat käytettävissä seuraavat moniosaisen lähetyksen käsittelyvaihtoehdot:
Tulosta käsittely-yksiköiden osoitekortit yksi kerrallaan
Tämän APIn avulla voit käsitellä moniosaisia lähetyksiä ja saada osoitelaput yksi kerrallaan.
Kun tarvitset tätä ominaisuutta lähetyksiäsi varten, määritä kaikkien tarvittavien MPS-elementtien ohella pyynnössäsi elementin oneLabelAtATime arvoksi tosi.
Ensimmäisen pyynnön pitäisi luoda osoitekortti ja seurantanumero, joka on pääasiallinen seurantanumero. Anna tämä pääasiallinen seurantanumero elementtiin masterTrackingId myöhemmän lähetyspyynnön käsittelyä varten sekä seurantanumerolla (alaseurantanumerolla) varustettujen osoitekorttien luomiseksi tarkan pakettien määrän (totalPackageCount) selvittämiseksi.
Huomautus: käsittely-yksiköiden enimmäismäärä on 200.
Tulosta kaikki käsittely-yksiköiden osoitekortit yhdellä kertaa
Tämän APIn avulla voit käsitellä moniosaisia lähetyksiä ja saada kaikki osoitelaput kerralla. Tämä on ihanteellinen käsittelytapa silloin, kun lähetyksessä on enintään 40 käsittely-yksikköä (totalPackageCount<=40), jotka on osoitettu samaan vastaanottajan osoitteeseen.
Aseta lähetyspyynnössä oneLabelAtATime -arvoksi epätosi, kun käsittely-yksiköitä on enintään 40, ja luo kaikki osoitekortit heti.
Huomautus: Käsittely-yksiköiden enimmäismäärä 40 on vain viitteellinen eikä kiinteä raja. Raja riippuu myös käsittely-yksiköiden ja hyödykkeiden määrän yhdistelmästä. Ota yhteyttä FedExin edustajaan lisätietoja varten.
Esimerkki: Lähetyspyyntösi käsittää 10 käsittely-yksikköä, joiden lähettäminen luo vastauksena 10 osoitekorttia ja valinnan mukaan joko osoitekorttien URL-osoitteet tai koodatut osoitekortit.
FedEx Freight Direct
Tämä palvelu tarjoaa ylivertaisen asiakaskokemuksen suurten lähetysten ja lavalähetysten toimituksessa, kuten raskaiden ja kookkaiden lähetysten toimituksissa asiakkaiden kotien tai yritysten sisätiloihin.
Palvelun sisältämiä vaihtoehtoja ovat esimerkiksi ennakoiva viestintä, joustavat toimitusvaihtoehdot ja useita lisämaksuja sisältävä niputettu hinnoittelu.
Tämä palvelu sisältää muun muassa seuraavat ominaisuudet:
- Mahdollistaa FedEx Freight Direct Basic -lähetysten, Basic ajanvarauksella -lähetysten, Standard- ja Premium-toimituslähetysten sekä Basic-palautuslähetysten/-noutojen luomisen Yhdysvaltain mantereella, Alaskassa ja Havaijilla.
- Sisältää mahdollisuuden hankkia täydellisen hinta-arvion FedEx Freight Direct -lähetykselle FedEx Freight Direct -asiakasnumerolla ja peruuttaa FedEx Freight Direct -noudon.
- Hinta-arviot eivät kata Alaskan ja Havaijin alueita. Asiakkaat voivat pyytää hinta-arvion näitä osavaltioita varten soittamalla FedExin asiakaspalveluun.
- Jos asiakas haluaa peruuttaa noudon noutopäivänä, hänen on soitettava FedEx-asiakaspalveluun.
- Sallii sähköposti-ilmoitusten lähettämisen alkuperäiselle lähettäjälle/vastaanottajalle, jotta asiakas voi
- ajoittaa toimituksen
- vastaanottaa toimitus- ja/tai noutovahvistuksen
- vastaanottaa toimitus ja/tai nouto matkalla -ilmoituksen
- vastaanottaa lähetys matkalla määränpäähän -ilmoituksia
- vastata toimitettuja lähetyksiä koskevaan asiakaskyselyyn.
- Postinumeron todennusta, mittoja sekä osien ja käsittely-yksiköiden painoa koskevat liiketoimintasäännöt ovat voimassa FedEx Freight Direct -palvelussa, jotta voidaan määrittää, mikä on kuljetuksen asianmukainen linjaliikenteen ja ensimmäisen/viimeisen osuuden yhdistelmä.
FedEx Freight Directissä on valittavana erityyppisiä palveluita.
Tämä API tarjoaa Freight Direct -palvelun kanssa seuraavat ominaisuudet:
Oikeus Freight Direct -hintoihin
Tällä vaihtoehdolla voit saada Freight Direct -hinnat ja -lisämaksut seuraaviin Freight Direct -palveluvaihtoehtoihin: Basic, Basic ajanvarauksella, Standard ja Premium.
LTL-rahtihinnasto-vaihtoehdon hintapyyntöön on liitettävä seuraavat tiedot:
- Freight Direct -tyyppi (BASIC, BASIC_AJANVARAUKSELLA, PREMIUM, STANDARD)
- Freight Direct -kuljetustyyppi (TOIMITUS, NOUTO)
- puhelinnumeron tyyppi, jos puhelinnumero annetaan (KOTI, MATKAPUHELIN, TYÖ)
- Paino
- mitat (ei-negatiivinen pituus, leveys ja korkeus)
Freight Direct -lähetyksen luominen
Tällä vaihtoehdolla voit lähettää yksiosaisen lähetyksen tai MPS-lähetyksen ja valita seuraavista Freight Direct -palveluvaihtoehdoista: Basic, Basic ajanvarauksella, Standard ja Premium. Tämän avulla saat myös osoitelapun tai konossementin, mukaan lukien Freight Priority -lähetysten käsittelyyn vaadittavat asiakirjat.
Tee LTL-rahtilähetys -vaihtoehdon lähetyspyyntöön on liitettävä seuraavat tiedot:
- Freight Direct -tyyppi (BASIC, BASIC_AJANVARAUKSELLA, PREMIUM, STANDARD)
- Freight Direct -kuljetustyyppi (TOIMITUS, NOUTO)
- sähköpostiosoite, puhelinnumero ja puhelimen tyyppi
- Paino
- mitat (ei-negatiivinen pituus, leveys ja korkeus)
Lähtevään konossementtiin tulostetaan uudet Freight Direct -palvelunimet. Valituista palveluista riippuen konossementissa näkyvät jotkin seuraavista arvoista:
- DIRECT BASIC DELIVERY
- DIRECT BASIC BY APPOINTMENT DELIVERY
- DIRECT PREMIUM DELIVERY
- DIRECT STANDARD DELIVERY
- DIRECT BASIC PICKUP
- DIRECT BASIC BY APPOINTMENT PICKUP
- DIRECT PREMIUM PICKUP
- DIRECT STANDARD PICKUP
Freight Direct -nouto
Tällä vaihtoehdolla voit tarkistaa LTL-rahdin Freight Direct -noutopalvelun saatavuuden, luoda noutopyynnön paketille tai peruuttaa olemassa olevan noutopyynnön.
Vaihtoehtojen Tarkista LTL-rahdin noudon saatavuus, Luo LTL-rahdin nouto ja Peruuta LTL-rahdin nouto noutopyyntöön on liitettävä seuraavat tiedot:
- Freight Direct -tyyppi (BASIC, BASIC_AJANVARAUKSELLA, PREMIUM, STANDARD)
- Freight Direct -kuljetustyyppi (TOIMITUS, NOUTO)
- sähköpostiosoite (noutopyynnön luominen)
- puhelinnumero ja puhelimen tyyppi (noutopyynnön luominen)
- Paino
Yrityssäännöt
- Pääseurantanumero määritetään LTL-rahtilähetyksen ensimmäiselle käsittely-yksikölle, ja kaikille seuraaville käsittely-yksiköille määritetään alaseurantanumerot.
- Kutakin lähetykseen sisältyvää käsittely-yksikköä voidaan seurata erikseen tai osana koko lähetystä.
- Muut asiakirjat voivat koskea tiettyjä lähetyksiä (esimerkiksi rahti, vaarallinen materiaali [HazMat] ja kansainväliset lähetykset).
- Vain LTL-rahdin asiakasnumeroa ja laskutettavaa LTL-rahdin asiakasnumeroa ei voida lisätä FedEx Developer Portaliin.
- Asiakas voi käyttää Freight Direct -palveluissa joko pysyvää LTL-asiakasnumeroaan tai FedEx Freight Direct -asiakasnumeroaan.
- FedEx Freight Direct -hinnoitteluominaisuudet ovat käytettävissä vain tavallisessa LTL-rahdin APIssa.
- Kaikki uudet virheilmoitukset ja viestit ovat aina englanninkielisiä.
- Sähköpostiosoite ja puhelinnumero edellytetään FedEx Freight Direct -palveluvaihtoehtojen pyynnöissä lähetysten luomisen yhteydessä.
JSON API -kokoelma
Response