Introducere
API-ul Freight LTL vă permite să creați expedieri pentru încărcături parțiale de autocamion (LTL). Mărfurile în regim de încărcătură parțială de autocamion sunt prea voluminoase pentru a fi expediate sub formă de colet, dar nu ocupă un autocamion întreg.
Acest API vă permite să obțineți estimări de tarife, să creați câte o etichetă de expediere pentru fiecare unitate de manipulare în parte (când este necesar), să programați preluări și să urmăriți stări ale expedierilor, să verificați disponibilitatea serviciului de preluare și să programați preluări. Astfel, va crește eficiența în ceea ce privește expedierile dvs. de dimensiuni mari și cu greutate ridicată.
Expedierile LTL prin FedEx Freight oferă urmărire și vizibilitate la nivel de unitate de manipulare pentru expedierile dvs. cu unități de manipulare multiple, precum și expediere internă fără un conosament pe hârtie (BOL) în majoritatea cazurilor. Dacă conosamentul este obligatoriu, poate fi creat. Chiar dacă toate unitățile de manipulare au un număr unic de urmărire, expedierea este însoțită de un singur conosament, o singură chitanță de livrare și o singură declarație de facturare.
Detaliile API-ului Freight LTL
API-ul Freight LTL vă permite să trimiteți expedierile LTL și să creați documentele necesare, precum conosamentul (când este obligatoriu), etichetele de expediere FedEx Freight și diverse alte documente de expediere. În cazul expedierilor de marfă LTL, eticheta principală se aplică pe prima unitate de manipulare, iar eticheta secundară se aplică pe a doua și pe următoarele unități de manipulare. Etichetele secundare au propriul lor număr de urmărire unic, dar fac trimitere la numărul principal de urmărire. Se poate crea un singur conosament pentru fiecare expediere, care să cuprindă toate unitățile și componentele de manipulare.
Fiecare unitate de manipulare poate fi asociată cu un număr de urmărire, iar eticheta este similară cu etichetă FedEx Ground sau Express Parcel, cu excepția unui F, care reprezintă o expediere de marfă.
Valorile maxime pentru unitățile și componentele de manipulare:
- limita maximă de componente per unitate de manipulare este de 9.999;
- Nr. maxim de unități de manipulare – 200 (atunci când tipăriți etichetele unităților de manipulare una câte una).
- Număr maxim de unități de manipulare – 40 (atunci când imprimați simultan etichetele unităților de manipulare)
Expedierile FedEx LTL Freight sunt disponibile în toate cele 50 de state ale Statelor Unite, precum și în Puerto Rico, Insulele Virgine Americane, Canada și Mexic. Unele expedieri necesită un conosament pe lângă etichetele de expediere. Un exemplu de astfel de expedieri sunt cele care conțin materiale (substanțe) periculoase.
FedEx Freight® schimbă industria LTL, facilitând expedierea mai rapidă și economică a mărfii, în cadrul unei rețele LTL optimizate.
În continuare, sunt prezentate caracteristicile disponibile în cadrul acestui API:
- Gestionați preluările LTL Freight
Această caracteristică vă permite să obțineți locațiile de preluare a expedierilor de marfă LTL, să programați o preluare a mărfii și să anulați orice preluare deja programată.
- Obțineți tarife pentru LTL Freight
Această caracteristică vă permite să obțineți tarife pentru o expediere de marfă LTL pe baza locațiilor și opțiunilor de servicii selectate.
- Expediați în regim Freight LTL
Această caracteristică vă permite să creați o expediere de marfă LTL.
În continuare, sunt prezentate caracteristicile API-ului Freight LTL:
- trimiteți o expediere cu colet unic sau o expediere MPS pentru toate tipurile de servicii și generați astfel etichete de expediere și un conosament (dacă este obligatoriu);
- creați o expediere cu mai multe unități de manipulare și urmăriți-o pe fiecare în parte;
- creați expedieri LTL pentru utilizarea serviciilor FedEx Freight Priority și Freight Economy;
- furnizați informațiile privind destinatarul, precum numărul de cont, contactul și adresa;
- furnizați marca temporală, tipul de ambalaj, greutatea totală și diverse alte detalii obligatorii, menționate în schema punctului final;
- furnizați eticheta FedEx elementele de marcă standard și asigurați compatibilitatea cu dimensiunile specificate pentru etichetele termice;
- Primiți notificări prin e-mail sau SMS, în cursul tranzacției de expediere, precum:
- notificarea privind livrarea,
- Livrare estimată
- Notificare privind preluarea
- Generați documente de expediere precum:
- etichete de expediere pentru unități de manipulare individuale,
- Conosament
- Factură comercială
- Factura vamală canadiană
- creați expedieri și imprimați etichete pentru fiecare unitate de manipulare în parte sau procesați simultan toate unitățile de manipulare;
- Regăsiți tarifele pentru o expediere cu colet unic sau o expediere MPS, pentru toate tipurile de servicii.
- Verificați disponibilitatea pentru preluare, programați o preluare a mărfii și anulați o preluare.
- creați și programați preluarea folosind conturi ale unei terțe părți pentru o adresă de facturare alternativă.
Servicii de expediere Freight LTL
Sunt disponibile următoarele servicii de expediere de marfă LTL:
FedEx Freight® Priority
Cu o performanță de prim rang în ceea ce privește expedierile la ora fixată și durate de tranzit reduse, FedEx Freight® Priority vă livrează expedierile repede și în siguranță. Contați pe serviciul nostru regional pentru livrarea extensivă în ziua următoare sau la două zile către clienții dvs., cu garanția rambursării banilor fără comision. *
Caracteristicile serviciului FedEx Freight® Priority:
- Timpi de tranzit reduși datorită serviciului de livrare în ziua următoare la distanțe de până la 600 de mile și serviciilor de livrare a doua zi la distanțe de până la 1.600 de mile
- Livrare directă către toate codurile ZIP din Statele Unite ale Americii, Canada și Mexic.
- Fiabilitate constantă și la ora fixată
- Garanție de rambursare a banilor fără comision*
- Tehnologie a informației de ultimă generație cu vizibilitatea integrală a expedierii
- Echipă dedicată de profesioniști care vă vor oferi asistență pentru toate nevoile legate de expedierea regională de marfă
*Toate serviciile fac obiectul termenilor și condițiilor FXFR 100 Series Rules Tariff.
FedEx Freight Economy
FedEx Freight® Economy oferă livrarea economică LTL (mărfuri în regim de încărcătură parțială de autocamion), axându-se pe nevoile dvs. de bază privind expedierea mărfurilor. Datorită serviciilor de livrare FedEx LTL, cu fiabilitatea la ora fixată și un serviciu Relații Clienți atent, obiectivele sunt îndeplinite.
FedEx Freight® Economy asigură:
- Soluții economice pentru expedierea mărfurilor
- economii crescute pentru expedieri mai puțin urgente, dar care necesită o livrare în siguranță;
- Fiabilitate constantă și la ora fixată
- Livrare directă către toate codurile ZIP din Statele Unite ale Americii, Canada, Mexic și Puerto Rico.
- Tehnologie a informației de ultimă generație cu vizibilitatea integrală a expedierii
- vizibilitate îmbunătățită cu urmărirea integrală a expedierii.
Cum funcționează API-ul Freight LTL
Această secțiune descrie punctele finale și elementele esențiale necesare pentru API-ul Freight LTL FedEx.
Notă: contul dvs. FedEx Freight LTL trebuie activat pentru a putea utiliza API-ul Freight LTL FedEx. Informațiile esențiale obligatorii sunt numerele de cont FedEx Freight și adresa poștală corectă aferentă contului pentru a procesa expedierile LTL.
În continuare, sunt prezentate punctele finale disponibile în cadrul acestui API:
Trimiteți expedieri de marfă LTL
Utilizați acest punct final pentru validarea și crearea expedierii FedEx de marfă în regim de încărcătură parțială de autocamion.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- Numărul de cont Freight
- Adresa poștală aferentă contului
- expedierea Freight solicitată;
- Opțiuni de răspuns etichete – Etichete care se returnează sub formă codificată sau ca URL.
- Detalii număr de urmărire principal – Doar în cazul în care trebuie să se proceseze o expediere MPS și etichetele trebuie să se imprime una câte una și nu toate odată (când elementul singleShotMPS nu este furnizat sau când i s-a adăugat valoarea fals).
Răspunsul reușit la această solicitare creează o expediere LTL, indică detaliile de urmărire și detaliile de alertă. De asemenea, returnează erori și descrieri în cazul unor eșecuri.
Notă: Adresa poștală poate fi diferită de adresa de expediere reală.
Verificați disponibilitatea serviciului de preluare a expedierilor de marfă LTL
Utilizați acest punct final pentru a solicita o listă cu toate locațiile disponibile de preluare a mărfii cu detaliile de programare a preluării, precum transportatorul, ultima oră disponibilă pentru preluare, ultima oră disponibilă implicită, disponibilitatea pentru preluare, ora la care coletul este pregătit de preluare, mențiune dacă adresa este rezidențială, ora limită pentru preluare și accesul conducătorului auto pentru a prelua coletul.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- Adresă/detalii coduri poștale pentru preluare
- Tip de preluare solicitat (de ex.: aceeași zi/zi ulterioară).
- Dacă este o preluare internă sau internațională.
Notă: utilizați o adresă de ridicare corectă și validă.
Răspunsul reușit la această solicitare va furniza o listă cu toate locațiile disponibile de preluare a mărfii, ziua de livrare, disponibilitatea (marcaj), data preluării, ora limită, timpul de acces, disponibilitatea rezidențială (marcaj), ora închiderii (marcaj), ora închiderii și ora locală. De asemenea, returnează erori și descrieri în cazul unor eșecuri.
Creați preluări de marfă LTL
Utilizați acest punct final pentru a crea și a programa o preluare de marfă LTL.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- Numărul de cont Freight, care va fi indicat pe factură pentru preluare.
- Detaliile privind originea (adresă, locație și tipul adresei de preluare, precum cont/expeditor/alta).
- Detaliile adresei pentru contul asociat.
Solicitarea de preluare reușită va returna un număr de confirmare a preluării, notificarea privind preluarea și codul locației pentru preluarea programată. De asemenea, returnează erori și descrieri în cazul unor eșecuri.
Notă: utilizați adresa corectă și validă pentru preluare și de asemenea, indicați adresa de cont înregistrată corectă pentru a programa preluarea. Este indicat să nu se introducă o oră trecută a pregătirii coletului, o dată trecută sau o dată care este prea îndepărtată în viitor pentru programarea unei preluări. Preluările anonime nu sunt permise. Puteți programa preluarea pentru conturi ale unei terțe părți furnizând detaliile unei adrese alternative valide.
Anulați preluări de marfă LTL
Utilizați acest punct final pentru a anula o solicitare de preluare deja programată pentru un colet LTL. Anularea reușită a preluării va returna un număr de confirmare și un mesaj de confirmare a anulării preluării.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- Cod de confirmare a preluării (obținut la trimiterea unei solicitări de preluare)
- Data programată (data la se efectuează preluarea)
- Locație (locația FedEx Express responsabilă pentru procesarea solicitării de preluare)
Solicitarea reușită va returna un număr de confirmare a preluării, notificarea privind preluarea și codul locației pentru preluarea programată. De asemenea, returnează erori și descrieri în cazul unor eșecuri.
Notă: transmiteți numărul de confirmare a preluării și codul corespunzător al locației (se aplică doar pentru FDXE) pentru a anula preluarea care a fost programată. Numărul de confirmare a preluării și codul corespunzător al locației (se aplică doar pentru FDXE) sunt obținute la transmiterea unei solicitări de preluare. De asemenea, utilizați adresa de cont înregistrată corectă pentru a anula preluarea. O notificare de eroare va fi trimisă dacă încercați să anulați o preluare după ce un curier FedEx a fost trimis la o locație de preluare.
Aflați tarife pentru expedierile de marfă LTL
Utilizați acest punct final pentru a solicita o listă cu toate tarifele Freight posibile și informațiile de tranzit opționale bazate pe detaliile introduse. Tarifele regăsite se bazează pe origine, destinație și alte diverse detalii introduse în expediere. Informațiile suplimentare, precum codul transportatorului, tipul de serviciu sau opțiunea de serviciu, pot fi utilizate pentru a obține mai multe rezultate precise.
Informațiile de intrare necesare asociate cu această solicitare sunt:
- Numărul de cont Freight
- Expedierea Freight solicitată.
Răspunsul reușit la această solicitare va returna lista cu toate tarifele posibile și codul locației pentru preluarea programată. De asemenea, returnează erori și descrieri în cazul unor eșecuri.
Expediere cu mai multe colete (MPS) Freight LTL
O expediere cu mai multe colete (MPS) constă din două sau mai multe unități de manipulare expediate la aceeași adresă de destinație. Prima unitate de manipulare dintr-o solicitare de expediere este considerată unitatea principală.
Pentru a crea o expediere cu mai multe colete:
- Introduceți informațiile referitoare la expediere cum ar fi detaliile privind serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail și requestedPackageLineItems. [Notă: sequenceNumber pentru coletul principal trebuie să fie egal cu 1.]
- Pentru imprimarea etichetei pentru fiecare unitate de manipulare, includeți detaliile numărului de urmărire principal în elementul masterTrackingId pentru toate unitățile de manipulare subsecvente.
În continuare, sunt prezentate opțiunile de procesare a expedierilor cu mai multe colete disponibile în cadrul acestui API:
Imprimați etichetele unităților de manipulare una câte una
Acest API vă permite să procesați expedierile MPS și să obțineți etichetele una câte una.
Atunci când aveți nevoie de această capabilitate pentru expedierile dvs., alături de toate elementele MPS necesare, furnizați elementul oneLabelAtATime as true în solicitare.
Rezultatul primei solicitări ar trebui să genereze eticheta și numărul de urmărire care este numărul de urmărire principal. Indicați acest număr de urmărire principal în elementul masterTrackingId pentru a procesa solicitarea de expediere următoare și a genera etichete cu numere de urmărire (numere de urmărire fiu) pentru numărul de colete total definit (totalPackageCount).
Notă: numărul maxim permis de unități de manipulare este de 200.
Imprimați simultan toate etichetele unităților de manipulare
Acest API vă permite să procesați expedierile MPS și să obțineți etichetele într-o singură tranzacție. Aceasta este una dintre metodele de procesare ideale, care este utilizată atunci când o expediere conține cel mult 40 de unități de manipulare (totalPackageCount<=40) trimise la aceeași adresă a destinatarului din expediere.
Setați oneLabelAtATime as false în solicitarea expedierii cu cel mult 40 de unități de manipulare și generați etichetele generate instantaneu.
Notă: Numărul maxim de 40 de unități de manipulare este orientativ și nu reprezintă o limită fixă. Limita depinde, de asemenea, de combinația dintre numărul de unități de manipulare și mărfuri. Contactați directorul de relații cu clienții FedEx pentru informații suplimentare privind aceste aspecte.
Exemplu: solicitarea dvs. de expediere conține zece unități de manipulare; atunci când este transmisă, se vor genera zece etichete și, conform solicitării, fie etichete sub formă de URL-uri, fie etichete codificate vor fi furnizate în răspuns.
FedEx Freight Direct
Acest serviciu oferă clienților o experiență superioară pentru livrarea de mărfuri mari și paletizate, inclusiv livrarea de expedieri grele și voluminoase la reședințele sau afacerile clienților.
Serviciul oferă opțiuni precum comunicări proactive, opțiuni de livrare flexibile și prețuri combinate care includ taxe suplimentare pentru servicii.
În continuare puteți găsi câteva dintre caracteristicile acestui serviciu:
- Permite crearea expedierilor FedEx Freight Direct de bază, de bază prin delegare, standard și premium și a expedierilor de retur/preluărilor de bază în Statele Unite continentale, Alaska și Hawaii.
- Permite obținerea unei estimări complete a tarifului pentru o expediere FedEx Freight Direct prin utilizarea unui număr de cont FedEx Freight Direct și posibilitatea de a anula o preluare FedEx Freight Direct.
- Nu vor fi returnate estimări de tarife pentru Alaska și Hawaii. Clienții trebuie să contacteze echipa Asistență Clienți FedEx pentru a solicita o cotație pentru aceste stări.
- Pentru a anula preluarea programată pentru aceeași zi, clientul trebuie să apeleze serviciul Relații Clienți FedEx.
- Vă permite să trimiteți notificări prin e-mail expeditorului/destinatarului inițial, astfel încât clientul să poată:
- Să programeze o livrare
- Să primească confirmarea de livrare și/sau de preluare
- Să primească notificări de livrare și/sau de preluare
- Să primească notificări de pe traseu
- Sondaj pentru clienți privind expedierile livrate
- Regulile comerciale pentru validarea codului poștal, dimensiuni, greutate per bucată și greutate a unității de manipulare vor fi aplicabile pentru FedEx Freight Direct, pentru a stabili combinația corectă între transportul pe distanțe mari și serviciile pentru prima /ultima milă.
FedEx Freight Direct vă oferă diferite tipuri de servicii
Acest API oferă următoarele caracteristici pentru serviciul Freight Direct:
Obținere tarife Freight Direct
Folosiți acest punct final pentru a obține tarife Freight Direct și taxe suplimentare pentru următoarele opțiuni speciale de servicii Freight Direct: Serviciu de bază, Serviciu de bază prin delegare, Serviciu standard, Serviciu premium.
În continuare puteți vedea detaliile necesare care urmează să însoțească solicitarea de tarif pentru punctul final Rate Freight LTL:
- Tip Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Tip de transport Freight Direct (DELIVERY, PICKUP)
- Tip de număr de telefon, dacă este furnizat numărul de telefon (HOME, MOBILE, WORK)
- Greutate
- Dimensiuni (lungime, lățime și înălțime, numere non-negative)
Creare expediere Freight Direct
Folosiți acest punct final pentru a expedia un singur articol sau o expediere MPS pentru următoarele opțiuni speciale de servicii Freight Direct: Serviciu de bază, Serviciu de bază prin delegare, Serviciu standard, Serviciu premium și pentru a obține o etichetă de expediere sau un conosament, inclusiv documentația necesară pentru procesarea unui expedieri Freight Priority.
În continuare puteți vedea detaliile necesare care urmează să însoțească solicitarea de expediere pentru punctul final Ship Freight LTL:
- Tip Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Tip de transport Freight Direct (DELIVERY, PICKUP)
- Adresă de e-mail, număr de telefon și tip de telefon
- Greutate
- Dimensiuni (lungime, lățime și înălțime, numere non-negative)
Conosamentul rezultat va avea tipărite noile nume pentru serviciul Freight Direct. Mai jos puteți vedea valorile tipărite pe conosament, în funcție de serviciul selectat:
- LIVRARE DIRECT DE BAZĂ
- LIVRARE DIRECT DE BAZĂ PRIN DELEGARE
- LIVRARE DIRECT PREMIUM
- LIVRARE DIRECT STANDARD
- PRELUARE DIRECT DE BAZĂ
- PRELUARE DIRECT DE BAZĂ PRIN DELEGARE
- PRELUARE DIRECT PREMIU
- PRELUARE DIRECT STANDARD
Preluare Freight Direct
Folosiți acest punct final pentru a verifica disponibilitatea serviciului de preluare Freight LTL Freight Direct și pentru a crea o solicitare de preluare pentru coletul care urmează să fie preluat sau pentru a anula o solicitare de preluare existentă.
În continuare puteți vedea detaliile necesare care urmează să însoțească solicitarea de preluare când se folosește punctul final Verificare disponibilitate transport de mărfuri LTL, Creare preluare pentru transport de mărfuri LTL și Anulare preluare pentru transport de mărfuri LTL.
- Tip Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Tip de transport Freight Direct (DELIVERY, PICKUP)
- Adresă de e-mail (pentru crearea unei solicitări de preluare)
- Număr de telefon și tip de telefon (pentru crearea unei solicitări de preluare)
- Greutate
Reguli pentru afaceri
- Un număr principal de urmărire (Pro) este atribuit primei unități de manipulare a unei expedieri de marfă LTL și fiecărei unități de manipulare ulterioare i se atribuie numere secundare de urmărire.
- Fiecare unitate de manipulare din expediere poate fi urmărită individual sau ca parte a întregii expedieri.
- Anumitor expedieri (de exemplu, expedieri de materiale (substanțe) periculoase [HazMat] și expedieri internaționale) li se pot aplica alte documente.
- Conturile LTL Freight și Bill to LTL Freight nu pot fi adăugate la portalul FedEx Developer.
- Pentru a utiliza serviciile Freight Direct, clientul poate folosi fie numărul de cont LTL unic pe termen lung, fie numărul de cont FedEx Freight Direct.
- Capabilitățile de evaluare FedEx Freight Direct sunt disponibile numai în API-ul LTL obișnuit.
- Toate erorile/mesajele noi vor fi doar în limba engleză.
- Adresa de e-mail și numărul de telefon sunt necesare ca parte a solicitării opțiunii de serviciu FedEx Freight Direct în timpul creării expedierilor.
Colecție de API-uri JSON
Response