Fedex Logo

Inleiding

Met de Freight LTL-API maakt u zendingen aan voor less than truckload (LTL). LTL Freight-zendingen zijn te groot om als pakket te worden verstuurd, maar nemen minder ruimte in beslag dan een hele vrachtwagen.

Op deze manier kunt u geschatte tarieven ontvangen, unieke verzendetiketten voor individuele afhandelingseenheden en, indien nodig, vrachtbrieven maken, de beschikbaarheid van ophalingen controleren, ophalingen plannen en de status van zendingen volgen. Dit alles zorgt voor een hogere efficiëntie wanneer u grotere en zwaardere zendingen wilt versturen.

LTL-verzending met FedEx Freight biedt tracering en zichtbaarheid van elke afzonderlijke afhandelingseenheid, wanneer u meerdere afhandelingseenheden verzendt. Daarnaast is het in de meeste gevallen mogelijk om zonder papieren vrachtbrief binnenlandse verzendingen te versturen. Indien nodig kan een vrachtbrief worden aangemaakt. Hoewel alle afhandelingseenheden over een uniek trackingnummer beschikken, heeft de zending in zijn geheel één vrachtbrief, ontvangstbewijs en factuuroverzicht.

Meer informatie over de Freight LTL-API

De Freight LTL-API maakt LTL-zendingen mogelijk en maakt de benodigde documenten aan, zoals de vrachtbrief (op verzoek), FedEx Freight-verzendetiketten en diverse andere verzenddocumenten. De eerste afhandelingseenheid van de Freight LTL-zending wordt voorzien van het hoofdetiket. Op de tweede en daaropvolgende afhandelingseenheden wordt een ondergeschikt etiket aangebracht. De ondergeschikte etiketten hebben elk een eigen uniek traceernummer, maar zijn ook gekoppeld aan het voornaamste traceernummer. Per zending kan een enkele vrachtbrief worden aangemaakt die alle afhandelingseenheden en -stuks omvat.

Elke afhandelingseenheid kan worden gekoppeld aan een trackingnummer. Het etiket is vergelijkbaar met dat van een FedEx Ground- of Express Parcel-zending, maar heeft de toevoeging van een F, die verwijst naar een vrachtzending.

Het maximale aantal af te handelen stuks per afhandelingseenheid:

  • Het maximumaantal stuks per afhandelingseenheid: 9.999
  • Maximale verwerkingstijd – 200 (bij het één-voor-één afdrukken van etiketten voor afhandelingseenheden).
  • Maximale verwerkingstijd – 40 (bij het in één keer afdrukken van labels voor afhandelingseenheden) 

FedEx LTL Freight-zendingen zijn mogelijk in alle 50 staten en in Puerto Rico, de Amerikaanse Maagdeneilanden, Canada en Mexico. Voor sommige zendingen zijn zowel een verzendetiket als een vrachtbrief vereist. Dit is bijvoorbeeld het geval voor zendingen die gevaarlijke goederen bevatten.

FedEx Freight® brengt een verschuiving in de LTL-sector teweeg door een snelle en kostenefficiënte vrachtzending mogelijk te maken binnen één gestroomlijnd LTL-netwerk.

Deze API biedt de volgende functies:

  • Freight LTL-ophalingen beheren

    Met deze functie kunt u Freight LTL-ophaallocaties opvragen, de ophaling van vrachtzendingen plannen en geplande ophalingen annuleren.

  • Freight LTL-prijsopgaven ontvangen

    Deze functie stelt u in staat prijsopgaven voor Freight LTL-zendingen te ontvangen op basis van de door u geselecteerde locaties en serviceopties.

  • Freight LTL-zendingen versturen

    Met deze functie maakt u een Freight LTL-zending aan.

De Freight LTL-API biedt de volgende functies:

  • Het versturen van een enkele of MPS-zending via alle servicetypes en (indien nodig) daarvoor verzendetiket(ten) of een vrachtbrief aan te maken.
  • Het aanmaken van een zending die uit meerdere afhandelingseenheden bestaat, waarbij u elke afhandelingseenheid afzonderlijk kunt traceren.
  • Het aanmaken van LTL-zendingen die u wilt versturen via FedEx Freight Priority of Freight Economy.
    • Vermelding van de gegevens van de ontvanger, zoals het klantnummer, de contactpersoon en het adres.
    • Vermelding van de tijdstempel, het verpakkingstype, het totaalgewicht en verschillende andere vereiste gegevens die in het eindpuntschema worden vermeld.
  • FedEx-etiketten met standaard branding en ondersteuning van specifieke formaten voor thermische etiketten.
  • Het ontvangen van meldingen via e-mail of sms gedurende de verzendtransactie, waaronder:
    • Verzendbericht
    • Geschatte aflevering
    • Ophaalbericht
  • Het genereren van verzenddocumenten, zoals:
    • Verzendetiketten voor afzonderlijke afhandelingseenheden
    • Vrachtbrief
    • Handelsfactuur
    • Canadese inklaringsfactuur
  • Zendingen aanmaken en etiketten afdrukken voor één afhandelingseenheid tegelijk of alle afhandelingseenheden in één keer verwerken.
  • Voor alle servicetypen de tarieven opvragen voor een enkele of MPS-zending.
  • De beschikbaarheid voor ophaling controleren, ophaling van een Freight-zending plannen of een ophaling annuleren.
  • Een ophaling aanmaken en inplannen met externe accounts voor een alternatief factuuradres.

Freight LTL-verzendservices

De volgende Freight LTL-verzendservices zijn beschikbaar:

FedEx Freight® Priority

FedEx Freight® Priority biedt toonaangevende, stipte prestaties en een snelle transittijd, waardoor uw zendingen snel en betrouwbaar worden afgeleverd. Met onze regionale service kunt u ervan op aan dat uw zendingen de volgende of de daaropvolgende dag aan uw klanten worden afgeleverd en profiteert u van een gratis geld-terug-garantie. *

De FedEx Freight® Priority-service biedt:

  • Snelle transittijden: voor bestemmingen binnen een straal van 965 km is aflevering op de volgende dag mogelijk en binnen een straal van 2575 km wordt uw zending de daaropvolgende dag bezorgd.
  • Directe aflevering aan vrijwel elke postcode in de VS, Canada en Mexico.
  • Consistente, tijdige betrouwbaarheid
  • Gratis geld-terug-garantie*
  • Ultramoderne informatietechnologie met end-to-endzichtbaarheid van zendingen
  • Een toegewijd team van professionals bij wie u terechtkunt voor al uw regionale vrachtbehoeften

*Alle services zijn onderworpen aan de algemene voorwaarden van het FXFR 100 Series Rules Tariff.

FedEx Freight Economy

FedEx Freight® Economy biedt voordelige LTL-aflevering (less than truckload) en is gericht op uw basisbehoeften voor vrachtverzendingen. FedEx LTL-services garanderen een tijdige, betrouwbare aflevering en een zorgvuldig handelende klantenservice.

FedEx Freight® Economy biedt:

  • Betaalbare vrachtoplossingen
  • Een kostenefficiënte en betrouwbare manier voor het versturen van zendingen die minder tijdgevoelig zijn
  • Consistente, tijdige betrouwbaarheid
  • Directe aflevering aan vrijwel elke postcode in de VS, Canada, Mexico en Puerto Rico.
  • Ultramoderne informatietechnologie met end-to-endzichtbaarheid van zendingen
  • Een verbeterde zichtbaarheid met end-to-endtracking van zendingen

Zo werkt de Freight LTL-API

In deze paragraaf worden de eindpunten en belangrijkste elementen beschreven die nodig zijn voor de FedEx Freight LTL-API.

Houd er rekening mee dat uw FedEx Freight LTL-account moet zijn ingeschakeld om gebruik te maken van de FedEx Freight LTL-API. De belangrijkste gegevens die zijn vereist voor het verwerken van LTL-zendingen zijn het/de FedEx Freight-klantnummer(s) en het juiste postadres van het klantnummer.

Met deze API zijn de volgende eindpunten beschikbaar:

Freight LTL versturen

Gebruik dit eindpunt voor het valideren en aanmaken van de FedEx Freight LTL-zending.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

  • Freight-klantnummer
  • Postadres van het klantnummer
  • Freight-verzoek voor de zending
  • Etiketresponsopties: etiketten die moeten worden geretourneerd als gecodeerd of als URL.
  • Gegevens van het hoofdtrackingnummer: alleen in het geval dat de MPS-zending moet worden verwerkt en de etiketten allemaal tegelijk, maar één voor één moeten worden afgedrukt (wanneer het element singleShotMPS niet is opgegeven of wordt toegevoegd met de waarde false).

Een succesvolle respons op dit verzoek leidt tot de aanmaak van de LTL-zending en een respons met daarin de tracking- en meldingsgegevens. In het geval van eventuele mislukkingen, worden de fouten en beschrijvingen geretourneerd.

Opmerking: het is mogelijk dat het postadres niet overeenkomt met het werkelijke verzendadres.

De beschikbaarheid van Freight LTL-ophaling controleren

Gebruik dit eindpunt voor het opvragen van een lijst van alle beschikbare Freight-ophaallocaties met informatie over het ophaalschema, zoals de vervoerder, de laatst beschikbare ophaaltijd, de standaard laatst beschikbare tijd, de beschikbaarheid voor ophalen, de eerst mogelijke en uiterste tijd voor ophaling van het pakket, een indicatie of het adres een woonadres is en de toegang voor de koerier om het pakket op te halen.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

  • Ophaaladres/postgegevens.
  • Type ophaalverzoek (bijvoorbeeld dezelfde dag/toekomstige dag).
  • Of er sprake is van ophalen in het binnenland/buitenland.

Opmerking: Gebruik het juiste en een geldig ophaaladres. 

Een succesvol respons op dit verzoek levert een lijst op van alle beschikbare Freight-ophaallocaties, afleverdag, beschikbaarheid (markering), ophaaldatum, de eerst mogelijke en uiterste tijd voor ophaling, residentiële beschikbaarheid (markering), sluitingstijd (markering), sluitingstijd en lokale tijd. In het geval van eventuele mislukkingen, worden de fouten en beschrijvingen geretourneerd.

Freight LTL-ophaling aanmaken

Gebruik dit eindpunt voor het aanmaken en inplannen van een Freight LTL-ophaling.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

  • Het Freight-klantnummer dat voor de ophaling wordt gefactureerd.
  • Herkomstgegevens (adres, de locatie en het type ophaaladres, zoals klantnummer/verzender/overig).
  • Adresgegevens voor het gekoppelde account.

Een succesvolle ophaalrespons retourneert een ophaalbevestigingsnummer, ophaalmelding en locatiecode voor de geplande ophaling. In het geval van eventuele mislukkingen, worden de fouten en beschrijvingen geretourneerd.

Opmerking: Gebruik het juiste en geldige adres voor de ophaling en geef ook het juiste adres van het klantnummer op om de ophaling te plannen. Vul voor het inplannen van een ophaling geen ophaaltijd of datum in die in het verleden of te ver in de toekomst ligt. Anonieme ophalingen zijn niet toegestaan. U kunt een ophaling voor externe accounts inplannen door alternatieve geldige adresdetails te verstrekken.

Freight LTL-ophaling annuleren

Gebruik dit eindpunt om een gepland ophaalverzoek voor een LTL-zending te annuleren. Een succesvolle annulering van de ophaling retourneert een bevestigingsnummer en een bericht waarin het annuleren van de ophaling wordt bevestigd.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

  • Ophaalbevestigingscode (deze is verkregen na het indienen van een ophalingsverzoek).
  • Geplande datum (de datum waarop de ophaling wordt verzonden)
  • Locatie (de FedEx Express-locatie die verantwoordelijk is voor het verwerken van het ophaalverzoek)

Een succesvol verzoek retourneert een ophaalbevestigingsnummer, ophaalmelding en locatiecode voor de geplande ophaling. In het geval van eventuele mislukkingen, worden de fouten en beschrijvingen geretourneerd.

Opmerking: voor het annuleren van de geplande ophaling verstrekt u het ophaalbevestigingsnummer en de bijbehorende locatiecode in (alleen van toepassing op FDXE). Het ophaalbevestigingsnummer en de bijbehorende locatiecode (alleen van toepassing op FDXE) ontvangt u tijdens het indienen van een ophaalverzoek. Gebruik daarnaast de juiste adresvermelding van het klantnummer om de ophaling te annuleren. Er wordt een foutmelding verzonden wanneer u een ophaling probeert te annuleren waarvoor de FedEx-koerier al onderweg is naar de ophaallocatie.

Freight LTL-tarieven

Gebruik dit eindpunt voor het opvragen van een lijst van alle mogelijke Freight-tariefoffertes en optionele transitinformatie die is gebaseerd op invoergegevens. De opgevraagde tarieven zijn gebaseerd op de herkomst, bestemming en diverse andere invoergegevens betreffende de zending. Voor nauwkeurigere resultaten kunt u aanvullende gegevens verstrekken, zoals de expediteurscode, het servicetype of de serviceoptie.

De vereiste invoergegevens die bij dit verzoek horen, zijn:

  • Freight-klantnummer
  • Freight-verzoek voor de zending.

Een succesvolle respons op dit verzoek retourneert een lijst met alle mogelijke tarieven en locatiecodes voor de geplande ophaling. In het geval van eventuele mislukkingen, worden de fouten en beschrijvingen geretourneerd.

Freight LTL-zending die uit meerdere pakketten bestaat

Een zending die uit meerdere pakketten bestaat (MPS), omvat twee of meer afhandelingseenheden die naar hetzelfde ontvangersadres worden verzonden. De eerste afhandelingseenheid van de zendingsaanvraag wordt gezien als de hoofdafhandelingseenheid.

Het aanmaken van een zending die uit meerdere pakketten bestaat:

  • Verstrek de gegevens op zendingniveau, zoals serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail en de requestedPackageLineItems. [Opmerking: het sequenceNumber van het hoofdpakket moet gelijk zijn aan 1.]
  • Voor het afdrukken van een etiket per afhandelingseenheid dient u de voornaamste traceergegevens in het element masterTrackingId op te nemen voor alle daaropvolgende afhandelingseenheden.

Deze API biedt de volgende verwerkingsopties voor zendingen die uit meerdere pakketten bestaan:

Etiket voor verwerkingseenheid één voor één afdrukken

Met deze API kunt u MPS-zendingen verwerken en etiketten één voor één afdrukken.

When you need this capability for your shipments, along with all necessary MPS elements, provide element oneLabelAtATime as true in the request.

De uitvoer van het eerste verzoek levert een etiket en het hoofdtrackingnummer op. Voer dit hoofdtrackingnummer in het element masterTrackingId in voor het verwerken van opvolgende verzendingsverzoeken en het genereren van etiketten met (onderliggende) trackingnummers voor het opgegeven totaalaantal pakketten (totalPackageCount).

Opmerking: het maximumaantal afhandelingseenheden is 200.

In één keer alle etiketten voor afhandelingseenheden afdrukken

Met deze API kunt u in één keer MPS-zendingen verwerken en de bijbehorende etiketten genereren. Deze verwerkingsmethode is ideaal voor zendingen die uit maximaal 40 afhandelingseenheden bestaan (totalPackageCount<=40) en allemaal voor hetzelfde ontvangstadres zijn bestemd.

Stel in de zendingsaanvraag voor maximaal 40 afhandelingseenheden oneLabelAtATime in als false en genereer onmiddellijk de bijbehorende etiketten.

Opmerking: de maximale limiet van 40 afhandelingseenheden is indicatief en geen vaststaand maximum. Het maximale aantal is ook afhankelijk van de combinatie van het aantal afhandelingseenheden en artikelen. Neem voor meer informatie hierover contact op met uw FedEx-vertegenwoordiger.

Voorbeeld: uw zendingsaanvraag bestaat uit tien afhandelingseenheiden. Na indiening van dit verzoek worden tien etiketten gegenereerd en ontvangt u een respons met daarin ofwel etiket-URL's of gecodeerde etiketten.

FedEx Freight Direct

Deze service biedt een superieure klantenervaring voor de levering van grote en op pallets geplaatste goederen, waaronder de levering van zware, omvangrijke zendingen bij klanten thuis of op kantoor.

De service biedt opties, zoals proactieve communicatie, flexibele afleveropties en gebundelde prijzen met verschillende toeslagen.

Deze service omvat onder meer de volgende functies:

  • De mogelijkheid om zendingen van FedEx Freight Direct Basic, Basic op afspraak, Standaard en Premium en Basic retourzendingen/ophalingen aan te maken binnen het vasteland van de Verenigde Staten, Alaska en Hawaï.
  • Inclusief de mogelijkheid om een volledige tarieframing voor een FedEx Freight Direct-zending te ontvangen met behulp van een FedEx Freight Direct-accountnummer en de mogelijkheid om een FedEx Freight Direct-ophaling te annuleren.
    • Schattingen van het tarief worden niet gegeven voor Alaska en Hawaii. Klanten moeten contact opnemen met de klantenservice om een offerte aan te vragen voor deze staten.
    • Om een voor dezelfde dag geplande ophaling te annuleren, moet de klant de FedEx-klantenservice bellen.
  • Hiermee kunt u e-mailmeldingen naar de oorspronkelijke afzender/geadresseerde versturen, zodat de klant:
    • Een aflevering kan plannen
    • Een bevestiging van aflevering en/of ophaling kan ontvangen
    • Een melding voor een onderweg zijnde levering en/of ophaling kan ontvangen
    • Meldingen kan ontvangen als de bezorger onderweg is
    • Klantenenquête voor afgeleverde zendingen
  • De bedrijfsregels van postcodevalidatie, afmetingen, stukgewicht en gewicht voor afhandelingseenheden zijn op FedEx Freight Direct van toepassing om de juiste combinatie van line-haul- en first-/last-mile-services te bepalen.

Bij FedEx Freight Direct kunt u kiezen uit verschillende services.

Deze API biedt de volgende functies met de Freight Direct-service:

Freight Direct-tarieven ophalen

Gebruik dit eindpunt om Freight Direct-tarieven en -toeslagen op te halen voor de volgende speciale Freight Direct-serviceopties: Basic-service, Basic-service op afspraak, Standaard-service, Premium-service.

Hieronder volgen de vereiste gegevens die aan de tariefaanvraag via het eindpunt Freight LTL-tarief moeten worden toegevoegd:

  • Type Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
  • Type Freight Direct Transportation (DELIVERY, PICKUP)
  • Type telefoonnummer, indien het telefoonnummer is opgegeven (HOME, MOBILE, WORK)
  • Gewicht
  • Afmetingen (Non-Negative Length, Width and Height)

Freight Direct-zending maken

Gebruik dit eindpunt om een enkele zending of MPS-zending te verzenden voor de volgende speciale Freight Direct-serviceopties: Basic-service, Basic-service op afspraak, Standaard-service, Premium-service. U ontvangt vervolgens een verzendetiket of vrachtbrief, inclusief de vereiste documentatie voor de verwerking van Freight Priority-zendingen.

Hieronder volgen de vereiste gegevens die aan de zendingsaanvraag via het eindpunt Freight LTL versturen moeten worden toegevoegd:

  • Type Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
  • Type Freight Direct Transportation (DELIVERY, PICKUP)
  • E-mailadres, telefoonnummer en type telefoonnummer
  • Gewicht
  • Afmetingen (Non-Negative Length, Width and Height)

Op de uitgevoerde vrachtbrief worden de nieuwe namen van de Freight Direct-service afgedrukt. De volgende waarden worden op de vrachtbrief afgedrukt, afhankelijk van de gekozen service:

  • 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-ophaling

Gebruik dit eindpunt om de beschikbaarheid van de ophaalservice van LTL Freight Direct te controleren, een ophaalverzoek voor een op te halen pakket te maken of een bestaand ophaalverzoek te annuleren.

Hieronder volgen de vereiste gegevens die bij het ophaalverzoek via het eindpunt moeten worden toegevoegd De beschikbaarheid van Freight LTL-ophaling controleren, Freight LTL-ophaling maken en Freight LTL-ophaling annuleren.

  • Type Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
  • Type Freight Direct Transportation (DELIVERY, PICKUP)
  • E-mailadres (ophaalverzoek maken)
  • Telefoonnummer en type telefoonnummer (ophaalverzoek maken)
  • Gewicht

Bedrijfsregels

  • Aan de eerste afhandelingseenheid van een Freight LTL-zending wordt een mastertrackingnummer (Pro) toegewezen en elke daaropvolgende afhandelingseenheid wordt voorzien van een onderliggend trackingnummer.
  • Elke afhandelingseenheid van de zending kan afzonderlijk of als onderdeel van de gehele zending worden getraceerd.
  • Op specifieke zendingen kunnen andere documenten van toepassing zijn (bijvoorbeeld Freight-zendingen die gevaarlijke goederen bevatten of internationale zendingen).
  • Alleen LTL-vracht- en Factureren aan LTL-vrachtaccounts kunnen niet worden toegevoegd aan het FedEx Developer Portal.
  • De klant kan het enkele LTL-accountnummer voor lange termijn of het FedEx Freight Direct-accountnummer gebruiken om van de Freight Direct-services gebruik te maken.
  • De tariefmogelijkheden van FedEx Freight Direct zijn alleen beschikbaar in de reguliere LTL-API.
  • Alle nieuwe (fout)meldingen worden alleen in het Engels weergegeven.
  • Als onderdeel van de FedEx Freight Direct-serviceoptie bij het maken van zendingen, zijn het e-mailadres en telefoonnummer vereist.

JSON API-verzameling

CLOSE

Response

Copy