Fedex Logo
Developer Portal

Rates and Transit Times API

Bevezetés

Ez a részletes útmutató segít megismerni mindent, amit a tarifákról és a tranzitidőkről tudni kell. A FedEx minden egyes szolgáltatásához megadja a kézbesítés becsült dátumát/időpontját és az árajánlatokat.

Az árajánlatok bekérésekor fontos megadni a küldemény részleteit. Ezek közé tartozik a dátum, pontos küldeményfeladási cím, a rendeltetési cím, a méret és a csomag súlya. Ezen pontos adatok megadásával biztosíthatja, hogy a megfelelő árajánlatot kapja a küldeményére. Amennyiben bármilyen különleges igénye lenne, például veszélyes áruk szállítása, akkor ezt a küldeménnyel kapcsolatos információk között kell megadnia.

Megjegyzés: az Ár API nem ad árajánlatokat a FedEx freight-szolgáltatásaihoz. A FedEx freight-szolgáltatásai árajánlatainak megismeréséhez látogasson el a Freight LTL API dokumentum oldalára.

A FedEx-tarifákat és -tranzitidőket kezelő API részletei

A költségvetés tervezésekor segít, ha ismeri a szállítás becsült költségeit. A FedEx többféle tarifát kínál az Ön igényeinek megfelelően. FedEx-küldeményeihez árajánlatot kérhet. Ezenkívül vannak alapárak, kedvezmények, pótdíjak, díjak és egyéb tényezők, amelyek befolyásolhatják a szállítási tarifákat.

A következő funkciók kapcsolódnak ehhez az API-hoz:

  • Gyors árajánlat

    Azonnal kaphat árajánlatokat és tranzitidőket a csomag részletes adatainak megadása nélkül is.

  • Tranzitidő

    Megtekintheti a kiindulási hely és a rendeltetési hely közötti szolgáltatások tranzitidőit.

  • Részletes árajánlat

    Árajánlatokat és tranzitidőket kaphat belföldi és nemzetközi szállításhoz, valamint megtudhatja a vám- és adóterhek becsült összegét is. Az ügyfeleknek részletes küldeményadatokat kell megadniuk, beleértve a csomag méreteit, a bejelentett érték (DV) összegét és a további szolgáltatási lehetőségeket. A vám- és adóterhek összegének megbecslése csak azon FedEx-ügyfelek számára áll rendelkezésre, akik termékeket/árucikkeket fuvaroztatnak, és nem dokumentumokat.

A FedEx-tarifákat és -tranzitidőket kezelő API előnyei:

  • Egyszerűsíti a szállítmánytervezést a költségek és a tranzitidő meghatározásával a világ bármely küldeményfeladási helyéről bármely rendeltetési helyre.
  • Standard listát és ügyfélszámla-specifikus árajánlatokat is nyújt különböző FedEx-szolgáltatásokhoz.
  • Időt takarít meg az ügyfélszámla-specifikus árakhoz való gyors hozzáféréssel.
  • Pénzt takarít meg azáltal, hogy szolgáltatásonként összehasonlítja az árakat, és lehetővé teszi az Ön számára, hogy a fuvarozási igényei alapján döntsön.
  • Időt takarít meg a szállítási költségekkel és a szállítási dátummal kapcsolatos kérdésekre adott gyors válaszokkal.

Ez az API fuvarozási árajánlatot ad egy adott szolgáltatáskombinációra, a kérelemben megadott küldeményfeladási és rendeltetési adatoktól függően. A vonatkozó adatok a következők:

  • A kedvezményes tarifák minden szolgáltatásra és kiindulási/rendeltetési hely párosra érvényesek.
  • Ez az API megjeleníti a küldeményfeladási hely és a rendeltetési hely szerinti díjat a kért szolgáltatáshoz, és nem ellenőrzi, hogy az adott szolgáltatás elérhető-e az Ön fuvarozási dátumára, valamint a küldeményfeladási hely és rendeltetési hely vonatkozásában.
  • A Mexikón belüli FedEx Express-szállításra vonatkozó árak is lekérdezhetők.
  • A FedEx Ground® Economy (korábbi nevén FedEx SmartPost®) fuvarozásra vonatkozó tarifák is elérhetők.
  • Szolgáltatásspecifikus kötelezettségvállalási és tarifainformációk is megadhatók.

A FedEx által kínált szolgáltatásokkal kapcsolatos részletesebb információkért tekintse meg a FedEx szolgáltatási útmutatóját, amely elérhető elektronikusan.

A FedEx-tarifákat és -tranzitidőket kezelő API működése

Tarifák és tranzitidők

Kérjen egy listát az összes lehetséges árajánlatról és az opcionális tranzitinformációkról a megadott adatok alapján. A kérelemhez kapcsolódó szükséges bemeneti adatok a következők:

  • Ügyfélazonosító szám
  • Küldemény adatai.

Tarifák és tranzitidők kérésekor:

  • Adjon meg minél több részletet a küldeményéről. Ez az információ fontos a helyes szállítási költségek kiszámításához a pótdíjakkal együtt.
  • A RateRequestTypes elemmel LIST- illetve fiókspecifikus díjakat kérvényezhet. Ha elemértékként a LIST-et választja, akkor mind az ügyfélszámla-specifikus árakat, mind az alapárakat megkapja.
  • Egyetlen szolgáltatásra vonatkozó árajánlatok kéréséhez adja meg a szolgáltatást, hogy biztosan a szolgáltatásra vonatkozó tarifaadatok jelenjenek meg. Több szolgáltatás tarifája fog megjelenni, ha nem adja meg a ServiceType értéket.
  • A fuvarozóspecifikus részletes díjszabásokhoz adja meg a fuvarozót a CarrierCode használatával a kérelemben, és a megadott fuvarozó összes szolgáltatására vonatkozó díjszabási adatokat kapja vissza, vagy ne adja meg a CarrierCode értéket, hogy az összes rendelkezésre álló szolgáltatást megkapja az összes fuvarozótól a válaszban.
  • A returnTransitTimes elem használatával belefoglalhatja a tranzitidő információit a válaszba. A FedEx Express, a FedEx Ground és a FedEx Home Delivery (otthoni kézbesítés) tartalmazza a csomag szállításának várható időtartamát és kézbesítésének dátumát az Ön által megadott szállítási dátum alapján.
  • A FedEx Ground® Economy (korábbi nevén FedEx SmartPost®) tranzitidőkre vonatkozó kérésére adott válasz a kérésben megadott értékek alapján konkrét kézbesítési dátumot és a hét napját fogja tartalmazni.
  • Az eredmények szűrésére olyan információk használhatók, mint a fuvarozó kódja, a szolgáltatás típusa vagy a szolgáltatási lehetőség.
  • Az eredmények rendezhetők (elem: rateSortOrder) annak érdekében, hogy az árajánlatadatokat a kívánt módon/formátumban kapja meg.

Tarifákkal és tranzitidőkkel kapcsolatos válasz

E kérés eredménye egy listát ad az összes lehetséges árajánlatról és opcionális tranzitinformációkról a szolgáltatáskóddal, a szolgáltatás típusával, a csomagolási típusokkal és a kötelezettségvállalás részleteivel, mint például a tranzitnapok/-idő és az adott napon történő kézbesítés (szombati kézbesítés).

A válaszként megjelenített árak és díjak a következők:

  • ALAPÁRAK – az ügyfélszámla alapján számított tarifák mellett a közzétett alapárakat jeleníti meg (adott esetben).
  • ELŐNYBEN RÉSZESÍTETT TARIFÁK – a kérelemben megadott preferált pénznemben adja meg a tarifákat.
  • KEDVEZMÉNYES tarifák – promóciós árak.
  • ÜGYFÉLSZÁMLA tarifái – ügyfélszámlához hozzárendelt tarifák.
  • Pótdíjak
  • Kedvezmények
  • Díjak és adók

Megjegyzés: A tarifakérésre adott válaszban nem szerepel az útvonal. Minden árajánlat csak becslés, és eltérhet a ténylegesen kiszámlázott összegtől.

A kedvezményes programokkal kapcsolatos további információkért olvassa el a Kedvezmények című részt.

Speciális FedEx-tarifák

Több darabból álló küldemény tarifái

Ez az opció a következők esetén elérhető: FedEx Domestic, FedEx International több darabból álló küldeményei (MPS), FedEx Domestic illetve International Ground® MPS, FedEx Express International C.O.D. több darabból álló küldeményei, valamint a FedEx Ground International C.O.D. több darabból álló küldeményei.

USA-beli csomag tarifái: FedEx Express Multiweight®

A FedEx Express több darabból álló küldeményei esetén a tarifa a teljes küldemény súlya alapján lehet megadva, ha a teljes küldemény súlya legalább 100 font (legalább 200 font a FedEx Express Saver® küldeményei esetén). A küldeményen belül az átlagos minimális csomagsúlynak 15 fontnak kell lennie. Szorozza meg a fontonkénti díjat a küldemény teljes súlyával. A FedEx Express Multiweight küldeménytarifa vagy a csomagonkénti egyedi árak összege közül a legalacsonyabb árat választjuk ki és alkalmazzuk automatikusan a számlázásban.

Egységes FedEx-tarifa

Az Egységes FedEx-tarifa egy fix tarifájú szállítási szolgáltatás, amely esetén nem szükséges az 50 font alatti küldemények súlyának vagy méretének megadása. Amennyiben a küldemény nem haladja meg az 50 font súlyt, kiválaszthatja azt a dobozt vagy hengert, amelyik a legjobban megfelel a szállítandó tárgy méretének, és amelyik teljesen megtölti a csomagot. Egyszerű, kiszámítható szállítási lehetőséget biztosít fix tarifával az Ön FedEx Express-csomagjaihoz. Az Egységes FedEx-tarifa egy szállítási portfólió, amely a FedEx Express hat szolgáltatási lehetőségén és a FedEx hét saját (fehér) csomagolási típusán alapul.

Az Egységes FedEx-tarifa szolgáltatásban elérhető csomagolások

A One Rate (Egységes tarifa) árazási lehetőség esetén a FedEx érvényes/használható csomagolási típusai:

  • FEDEX_ENVELOPE
  • FEDEX_SMALL_BOX
  • FEDEX_MEDIUM_BOX
  • FEDEX_LARGE_BOX
  • FEDEX_EXTRA_LARGE_BOX
  • FEDEX_PAK
  • FEDEX_TUBE

A saját csomagolás nem fogadható el az Egységes tarifa árképzési lehetősége esetén.

A csomagolási szolgáltatásokról bővebb információt a Csomagolástípusok című dokumentumban olvashat.

Hogyan határozható meg az Egységes tarifa árképzése

Az Egységes FedEx-tarifa árképzéséhez a következő lépéseket végezze el:

  • Adja meg a küldeményre vonatkozó \"FEDEX_ONE_RATE\" különleges szolgáltatást.
  • Adjon meg egy csomagolási típust.
  • Adjon meg egy USA-beli származási helyet és egy USA-beli rendeltetési helyet.
  • Megjegyzés: A Hawaii-szigeteken belüli küldemények esetén nem engedélyezett az Egységes tarifa árképzése.

  • Adja meg valamelyiket az alábbi FedEx Express-szolgáltatástípusok közül:
    • FIRST_OVERNIGHT
    • PRIORITY_OVERNIGHT
    • STANDARD_OVERNIGHT
    • FEDEX_2_DAY
    • FEDEX_2_DAY_AM
    • EXPRESS_SAVER

Megjegyzés: A FedEx ügyfelei egyetlen tarifakérelemben kérhetik az Egységes tarifa szerinti és a súlyalapú (nem Egységes tarifa szerinti) díjszabást is, ha a kérelemben a szolgáltatási opció típusát a következőként adják meg: \"FEDEX_ONE_RATE\".

Változó kezelési díjak és illetékek

Változó kezelési díj

A szállítási műveletek fuvarozási díjain felül felszámított további kezelési díjakat hozzáadjuk a teljes fuvarozási díjhoz. Ezeket a díjakat a tarifaválaszban küldjük vissza, és be lehet állítani, hogy a „Dokumentum” lapra legyenek nyomtatva. További tájékoztatásért olvassa el a Változó kezelési díjak című részt

Tarifapótdíjakkal kapcsolatos válasz

Minden további különleges kezelés vagy szolgáltatás esetén a pótdíjakat a küldemény fuvarozási díjain felül számoljuk fel. Ezeket a díjakat a tarifaválasz tartalmazza.

Az árajánlat a rendelkezésre álló pótdíjakat a tarifa részleteivel együtt jeleníti meg.

A tarifaválaszban visszaküldött pótdíjak a következők:

  • Pótdíjak összesen
  • Adók összesen (Kanadából származó küldemények esetén)
  • Pótdíjak tételes bontásban

További tájékoztatásért olvassa el a „Pótdíjak” című részt.

Díjak és egyéb szállítási információk

Az Ön küldeménye esetén az alaptarifán felül további díjak is fennállhatnak.

  • A FedEx Express USA-beli importküldeményei esetében a díjak a származási országtól függően változnak, azonban minden díj ugyanolyan módon számolódik, mint az USA-beli exportküldemények esetében.
  • Az U.S. Express Package szolgáltatások a következő lehetőségeket foglalják magukban: FedEx First Overnight®, FedEx Priority Overnight®, FedEx Standard Overnight®, FedEx 2Day® A.M., FedEx 2Day® és FedEx Express Saver®.
  • Az U.S. Ground-szolgáltatások a következő lehetőségeket foglalják magukban: FedEx Ground® és FedEx Home Delivery® (otthoni kézbesítés).
  • Az International Express Package szolgáltatások közé tartozik a FedEx International First®, a FedEx International Priority®, a FedEx International Economy® és a FedEx Deferred Freight.
  • Az International Ground szolgáltatás a következő lehetőséget foglalja magában: FedEx International Ground® .[Szolgáltatás ENUM-kódja: FEDEX_GROUND]

Üzleti szabályok

  • Ne feltételezze, hogy egy adott szolgáltatás minden helyzetben elérhető lesz. A STANDARD_OVERNIGHT (többek között) például nem érhető el minden irányítószám-kombináció esetén.
  • Ha egy adott szolgáltatással kapcsolatban kér árajánlatot, a kérelemben tüntesse fel a szolgáltatás típusát. Ez csökkenti a válasz méretét és a tranzakció válaszidejét.
  • A több darabból álló küldemények (MPS) nem jogosultak az egységes FedEx-tarifára.
  • Amennyiben különleges szolgáltatást szeretne igénybe venni egy küldeményhez, akkor a különleges szolgáltatás típusát és részletes adatait is meg kell adnia. Amennyiben a különleges szolgáltatások adatait nem tünteti fel, akkor lehetséges, hogy nem jelzi semmi, hogy a különleges szolgáltatások nem lettek kiválasztva az adott küldeményre.
  • A tarifa vagy küldemény időbélyegzőjének annak az időpontnak kell lennie, amikor a csomagot várhatóan átadják a FedExnek vagy egy FedEx-ügynöknek szállításra. Ez nem feltétlenül az az időpont, amikor a szállítási tranzakciót vagy a tarifatranzakciót végrehajtják. Például egy péntek késő este generált küldeménynek, amelyet a FedEx csak hétfőn vesz át, hétfői időbélyegzővel kell rendelkeznie. Használja a helyes időbélyegzőt, ha az ismert, különben a kézbesítési becslés és a tarifák nem biztos, hogy helyesek lesznek.
  • A tarifákat és tranzitidőket meghatározó alkalmazás a tranzitidő megállapításához csak városneveket vagy irányítószámokat használ. A FedEx csak a FedEx által kiszolgált várost vagy postai irányítószámot jeleníti meg az Ön által kiválasztott származási és rendeltetési országban.
  • A FedEx nem szállít postafiókcímekre az Egyesült Államokban. Kérjük, adja meg az irányítószámot, hogy megismerje a küldemény tranzitidejét, vagy kattintson az „Irányítószám keresése” lehetőségre.
  • A lakóhelyről felvett csomagok esetén egy nappal növekedhet a tranzitidő. A gyorsabb kézbesítés érdekében kérjük, adja le csomagját egy személyzettel rendelkező FedEx kirendeltségen.
  • Gyógyszeripari küldemények esetén nem vehető igénybe a kirendeltségen tartás.

JSON API-gyűjtemény

Rates and Transit Times API (1.0.0)

Rate and Transit times

This endpoint provides the ability to retrieve rate quotes and optionalll transit information. The rate is calculated based on the origin and destination of the shipment. Additional information such as carrier code, service type, or service option can be used to filter the results. If carrier code is provided, the response includes the rate quotes for the specific transportation carrier. This endpoint provides the rates for FedEx Ground and FedEx Express and does not offer rates for FedEx Freight.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters
x-customer-transaction-id
string
Example: 624deea6-b709-470c-8c39-4b5511281492

This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.

content-type
required
string
Example: application/json

This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.

x-locale
string
Example: en_US

This indicates the combination of language code and country code. Click here to see Locales

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_Quote_Rate
  • MinimumSamplePayload_1
  • FreightSamplePayload-RateResourceDetails_1
  • US_Domestic_Rate_shop
  • FDGSamplePayload-RateResourceDetails-IntraEurope
  • Alternate_Currency_Rate_Quote
  • Express_Freight_Rate_Quote
  • International_Hold_At_Location_with_Adult_Signature_Option
  • International_Multi_Piece_Rate_Quote
  • International_Return_Rate_Quote
  • Intra_Canada_Rate_Quote
  • Intra_Europe_Rate_Quote
  • Intra_India_Cash_On_Delivery_Rate_Quote
  • Intra_Mexico_Express_Saver_Rate_Quote
  • Priority_Alert_Rate_Quote
  • Express_Freight_Saturday_Pickup_Rate_Quote
  • SmartPost_Rate_Quote
  • International_Dry_Ice_Rate_Quote
  • US_Domestic_Multi_Piece_Rate_Quote
  • US_Domestic_Priority_Overnight_Rate_Quote
  • Ground_Home_Delivery_Appointment_Delivery_Rate_Quote
  • International_Ground_Rate_Quote
  • International_Priority_Rate_Quote
accountNumber
required
object (AccountNumber)

This is the Account number details.
Note:

  • If the paymentType is Sender, then the account number is optional in shippingChargesPayment.

rateRequestControlParameters
object (RateRequestControlParameters)

Specify the return transit times, services needed on rate failure, choice of variable option and order to sort rate options to filter and sort the expected response.

requestedShipment
required
object (RequestedShipment)

This is shipment data for which a rate quote (or rate-shipping comparison) is requested.

carrierCodes
Array of strings

Specify the four letter code of a FedEx operating company that meets your requirements.
Example: FDXE

  • FDXE - FedEx Express
  • FDXG - FedEx Ground
  • FXSP - FedEx SmartPost
  • FXCC - FedEx Custom Critical.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /rate/v1/rates/quotes

Sandbox Server

https://apis-sandbox.fedex.com/rate/v1/rates/quotes

Production Server

https://apis.fedex.com/rate/v1/rates/quotes

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "rateRequestControlParameters":
    {
    },
  • "requestedShipment":
    {
    },
  • "carrierCodes":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}
CLOSE

Response

Copy