Fedex Logo
Developer Portal

ShipConsolidation

Inleiding

Met de consolidatie-API kunt u afzonderlijke zendingen consolideren voor douaneafhandeling bij een enkele invoer. Na de afhandeling wordt de zending opgesplitst in kleinere zendingen in het land van bestemming om te distribueren naar afzonderlijke ontvangers. Deze API is gunstig voor afzenders die hun FedEx Express®- en International Ground®-zendingen willen consolideren.
De Consolidation Ground-zending is specifiek voor Canadese zendingen en geeft gekwalificeerde Amerikaanse afzenders de mogelijkheid FedEx Ground-zendingen te consolideren voor distributie binnen Canada via FedEx Logistics® of een inklaringsagent naar keuze. Zodra de zending als een enkele zending door de Canadese douane is ingeklaard, wordt deze in Canada in afzonderlijke kleinere zendingen verdeeld. U hebt toegang tot het alle FedEx-services nadat uw zending door de douane is ingeklaard.

Opmerking:

  • Het accountnummer moet zijn ingeschakeld voor de consolidatie-API-services om API-transacties uit te voeren.
  • De consolidaties en consolidatiezendingen worden verwijderd als ze niet binnen het einde van de vijfde dag na het aanmaken van de consolidatie worden bevestigd.

Details consolidatie-API

De consolidatie-API biedt de mogelijkheid om een enkele zending door de douane te laten inklaren op de plaats van bestemming. De hele zending wordt verzonden naar (en ingeschreven met) de naam van slechts één officiële importeur (IOR). De zending moet ook afkomstig zijn van één officiële exporteur. Individuele stukken binnen de zending worden afgeleverd aan de ontvanger die op elk FedEx Express Shipping- of Express Manifest-label staat aangegeven.
Consolidatiezending biedt ook Single Point of Clearance (SPOC), waarmee u een geconsolideerde zending kunt versturen die pakketten voor meerdere landen in de Europese Unie bevat.
Normen en beperkingen van International Priority Freight (IPF) voor grootte, gewicht en type artikelen zijn van toepassing op afzonderlijke pakketten in een vrachtconsolidatiezending.
Opmerking: U moet een servicecontract met FedEx hebben voordat u uw consolidatiezendingen kunt verwerken. Voor meer informatie neemt u contact op met uw FedEx accountmanager.

International DirectDistribution-service

De consolidatie-API stelt klanten in staat gebruik te maken van Direct Distribution wanneer zij meer dan één pakket internationaal verzenden, op voorwaarde dat het land van bestemming voor al deze pakketten hetzelfde is.
De service Direct Distribution verbetert de levertijden en vermindert de inklarings- en magazijnkosten voor afzenders. FedEx consolideert de zendingen van klanten die naar dezelfde locatie (het buitenland) worden vervoerd voor douaneafhandeling en heft de consolidatie vervolgens weer op voor rechtstreekse levering aan uw klanten.
Klanten kunnen nu ook zendingen vanuit Canada naar de VS sturen door middel van de service International DirectDistribution (IDD) (voorheen de service Transborder Distribution). FedEx International DirectDistribution Surface Solutions (IDD Surface) biedt klanten uit Canada en Mexico een geconsolideerde, grensoverschrijdende afleveroptie voor verzending naar meerdere ontvangers in de VS. International DirectDistribution (IDD) moet in Canada of Mexico zijn gevestigd en er moet een ID van de afleverlocatie voor het opgegeven account zijn ingesteld.

Internationale documenten

De geconsolideerde handelsfactuur (CCI) met zendingsgegevens is een van de minimaal vereiste douanedocumenten die nodig zijn om de geconsolideerde zending de internationale grens van het land van bestemming te laten passeren.

De zendingsgegevens van de geconsolideerde handelsfactuur bevatten de volgende informatie:

  • Het rapport met zendingsgegevens van de geconsolideerde handelsfactuur levert de verzendinformatie voor alle pakketten in de consolidatie die via een inklaringsagent lopen (PAPS) en groepeert/vermeldt de pakketten per 'koper' (d.w.z. de partij 'Verkocht aan').
    Opmerking: onderliggende zendingen worden vermeld in de geconsolideerde handelsfactuur onder één van de volgende voorwaarden:
    • Onderliggende zendingen die niet voldoen aan de voorwaarden van Sectie 321, worden vermeld in de geconsolideerde handelsfactuur voor douane-invoer door de aangewezen agent.
    • De afzender geeft aan dat alle onderliggende zendingen in de consolidatie voor invoer moeten worden ingediend door de agent.

Het IDD-linehaulrapport bevat de volgende informatie:

  • Welke kopers en bijbehorende zendingen in aanmerking komen voor Sectie 321 en welke voor PAPS.
  • De afleverlocatie en het afleveradres.
  • Informatie over de afleverlocatie of -faciliteit van derden.
  • Opmerking: Dit rapport wordt ook wel een geconsolideerd douane-linehaulrapport genoemd en wordt gegenereerd voor inkomende zendingen uit Canada of Mexico.

In de tabel International DirectDistribution-services – FedEx Express- en FedEx Ground-services vindt u een overzicht van de services van FedEx in de VS die beschikbaar zijn voor Internationale DirectDistribution-zendingen nadat ze de VS zijn binnengekomen.

FedEx Express Services - International Priority DirectDistribution (IPD)

Verzendbehoefte Aangeboden service

Vroegste aflevering 's ochtends op de volgende werkdag.

FedEx First Overnight®

's Ochtends op de volgende werkdag.

FedEx Priority Overnight®

's Middags op de volgende werkdag.

FedEx Standard Overnight®

2 werkdagen.

FedEx 2Day®

Binnen 2 werkdagen om 10:30 uur naar de meeste zakelijke gebieden; voor bepaalde zendingen naar Alaska en Hawaï is de levertijd 3 werkdagen.

FedEx 2Day® A.M.

3 werkdagen.

FedEx Express Saver®

Binnen 1, 2 of 3 werkdagen binnen de VS voor pakketten van meer dan 68 kg per stuk.

FedEx 1Day® Freight,

FedEx 2Day® Freight,

FedEx 3Day® Freight

 

FedEx Ground Services - International Priority DirectDistribution (IPD) Surface-oplossingen

Verzendbehoefte Aangeboden service

Betaalbare levering over land naar zakelijke adressen.

FedEx Ground®

Betaalbare levering over land naar woonadressen in de VS.

FedEx Home Delivery®

Hieronder volgen de services voor zendingen die beschikbaar zijn voor de consolidatie-API.

FedEx Express International DirectDistribution-services

  • De International Priority DirectDistribution- (IPD) en de International Economy DirectDistribution-service (IED) bieden geconsolideerde FedEx Express®-zendingen die bij de douane in één keer worden ingeklaard en daarna worden afgeleverd bij individuele ontvangers in het land van bestemming. Deze services worden enkel op contractuele basis aangeboden.
  • International DirectDistribution (IDD) maakt geconsolideerde, internationale zendingen vanuit Canada en Mexico naar verschillende ontvangers in de Verenigde Staten mogelijk.

FedEx Express International DirectDistribution Freight-service

  • U kunt vrachtzendingen met meerdere delen (meer dan 68 kg) consolideren en verzenden met FedEx International Priority DirectDistribution Freight (IDF). Alle stukken moeten op een pallet worden geplaatst om als IDF te verzenden. International Priority DirectDistribution Freight (IDF) maakt het mogelijk om met één internationale luchtvrachtbrief van FedEx® zendingen te consolideren van één locatie van herkomst naar verschillende ontvangers in één land van bestemming. Nadat uw zending de VS is binnengekomen, kan deze worden beheerd door FedEx U.S.-services, waaronder FedEx Express, FedEx Ground en FedEx Home Delivery.

Proces van consolidatiezending

Consolidatiezendingen kunnen op twee manieren worden verwerkt, synchroon en asynchroon, afhankelijk van het aantal pakketten per zending of het pakketniveau van de artikelen in een zending.
Voor een synchrone verwerking mag een transactie maximaal 39 onderliggende pakketten per consolidatie bevatten.
Als de transactie synchroon wordt verwerkt, bevat het antwoord de pakketlabels en verzendrapporten, zoals de handelsfactuur (CI).
Als de transactie asynchroon wordt verwerkt, bevestigt het antwoord alleen dat het verzoek in een wachtrij is geplaatst voor asynchrone verwerking. Mogelijk is de zending zelf niet verwerkt, waardoor de overeenkomstige methode Resultaten van consolidatiezending moet worden gebruikt om te controleren of de zendingen zijn verwerkt. Geef de zendingen wat tijd om te worden verwerkt, voordat u de resultaten ophaalt.

De volgende stappen kunnen worden gevolgd om de zending asynchroon te verwerken:

  1. Consolidatie maken: gebruik dit eindpunt om een nieuwe consolidatie met een unieke index te maken. De succesvolle respons genereert de trackingnummers van de consolidatie.
    Opmerking: indien de index niet in het verzoek wordt vermeld, wordt het trackingnummer als index beschouwd.
  2. Consolidatiezending maken: gebruik dit eindpunt voor het maken van een asynchrone zending voor meer dan 40 pakketten. De succesvolle respons genereert een jobID van de consolidatiezending.
  3. Resultaten consolidatiezending: gebruik dit eindpunt met de gegenereerde jobID om het trackingnummer en de labels van de zending te verkrijgen.
  4. Consolidatie bevestigen: gebruik dit eindpunt met het consolidatietype en de gegenereerde index om uw gemaakte consolidatie te bevestigen. De succesvolle respons genereert een jobID
  5. Consolidatieresultaten bevestigen: gebruik dit eindpunt met de gegenereerde jobID uit Consolidatie bevestigen om de trackingnummers, labels en documenten voor uw consolidatie te verkrijgen.

Volg de volgende stappen om de zending synchroon te verwerken:

  1. Consolidatie maken: gebruik dit eindpunt om een nieuwe consolidatie met een unieke index te maken. De succesvolle respons genereert de trackingnummers van de consolidatie.
    Opmerking: indien de index niet in het verzoek wordt vermeld, wordt het trackingnummer als index beschouwd.
  2. Consolidatiezending maken: gebruik dit eindpunt om een synchrone zending te maken voor maximaal 40 pakketten. De succesvolle respons genereert de trackingnummers en labels van de consolidatiezending.
  3. Consolidatie bevestigen: gebruik dit eindpunt met het consolidatietype en de gegenereerde index om uw gemaakte consolidatie te bevestigen. De succesvolle respons genereert een jobID
  4. Consolidatie bevestigen: gebruik dit eindpunt met de gegenereerde jobID uit Consolidatie bevestigen om de trackingnummers, labels en documenten voor uw consolidatie te verkrijgen.

De volgende stappen kunnen worden gevolgd om een gemaakte consolidatie of consolidatiezending te wijzigen of te verwijderen:

  • Consolidaties wijzigen: gebruik dit eindpunt om de gegevens van een bestaand consolidatieverzoek te wijzigen voordat de consolidatie wordt bevestigd.
  • Consolidatiezending verwijderen: gebruik dit eindpunt om FedEx Express-, Express Freight- en Ground-zendingen te annuleren die niet aan FedEx zijn aangeboden. De succesvolle respons toont de status van de verwijderde consolidatiezending en genereert "cancelledShipment": true.
  • Consolidatie verwijderen: gebruik dit eindpunt om een consolidatie te verwijderen voordat deze is bevestigd.
    Opmerking: hierdoor worden ook alle zendingspakketten verwijderd die als onderdeel van de consolidatie zijn verwerkt.
  • Consolidatie ophalen: gebruik dit eindpunt om de gegevens van uw consolidatie op te halen.

De consolidatie-API gebruiken

De belangrijkste kenmerken van de consolidatie-API zijn:

Consolidaties maken

Gebruik dit eindpunt om een consolidatie te maken met de vereiste consolidatiegegevens.
De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Accountnummer - Het FedEx-accountnummer voor verzenden
  • requestedConsolidation
    • consolidatietype - Geef het consolidatietype op
    • Afzender: verstrek de gegevens van de afzender en het btw-nummer
    • Labelspecificatie - Verstrek de gegevens over het type afbeelding, afdrukformaat en briefhoofd voor het label.
    • Gegevens International Distribution
      • Aangegeven valuta
      • Totale afmetingen
      • ID van afhandelingslocatie
    • Douaneafhandelingsgegevens: geef de officiële importeur op.
    • Consolidatiedocumenten - Geef de documenten op die zijn vereist wanneer de consolidatie is bevestigd.

De succesvolle respons op dit verzoek brengt de consolidatie tot stand en genereert de mastertracking-id en consolidatiesleutel. Houd er rekening mee dat er geen labels worden gegenereerd in de respons.

Consolidaties wijzigen

Gebruik dit eindpunt om informatie te wijzigen van een bestaand consolidatieverzoek, voordat de consolidatie wordt bevestigd.
De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Consolidatiesleutel - Geef het consolidatietype, de index en de consolidatiedatum op in de respons op Consolidatie maken.
  • Accountnummer - Het FedEx-accountnummer voor verzenden.
  • requestedConsolidation
    • Consolidatietype: geef het consolidatietype op.
    • Verzender
    • Labelspecificatie - Verstrek de gegevens over het type afbeelding, afdrukformaat en briefhoofd voor het label. U kunt hier ook klantspecifieke gegevens specificeren zoals documenttekst, wettelijke labels en maskeergegevens op het label
    • Douaneafhandeling - Geef de gegevens van de douaneafhandeling met de officiële importeur op.

Na een succesvol verzoek werken we de beoogde informatie bij en worden de bijgewerkte consolidatiegegevens weergegeven.

Consolidaties ophalen

Gebruik dit eindpunt om de consolidatie voor de opgegeven consolidatiesleutel op te halen. De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Accountnummer - Het FedEx-accountnummer voor verzenden.
  • Consolidatiesleutel - Geef het consolidatietype, de index en de consolidatiedatum vanuit Consolidatie maken op

Bij een succesvol verzoek worden de consolidatiegegevens opgevraagd.

Consolidaties verwijderen

Gebruik dit eindpunt om de openstaande consolidatie te verwijderen voordat de consolidatie is bevestigd.
Opmerking: indien nodig, moet dit eindpunt worden gebruikt vóór Consolidatie bevestigen.

De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Accountnummer - Het FedEx-accountnummer voor verzenden.
  • Consolidatiesleutel - Geef het consolidatietype, de index en de consolidatiedatum op.
  • TrackingId - Geef de mastertracking-id op die wordt gegenereerd in de respons op Consolidatie maken.

Na een succesvol verzoek wordt de beoogde consolidatie verwijderd en wordt in de uitvoer de transactionID en de status voor het element cancelledShipment als waar geretourneerd.

Consolidatiezending maken

Gebruik dit eindpunt om de pakketten van een zending toe te voegen onder één consolidatiesleutel.
Opmerking: er zijn minimaal twee zendingen nodig om een consolidatiezending te maken.

De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Labelresponsopties - Moet URL_ONLY/LABEL zijn
  • Open verzendactie - BEVESTIGEN
  • Accountnummer - Het FedEx-accountnummer voor verzenden.
  • Consolidatiesleutel - Geef het consolidatietype, de index en de consolidatiedatum vanuit Consolidatie maken op
  • requestedShipment
    • Consolidatietype - Geef het consolidatietype op
    • Gegevens afzender
    • Gegevens geadresseerden
    • Type ophaling
    • Servicetype - Geef de Express-/Ground-servicetypen op
    • Type verpakking
    • Betaalmethode voor zending (SENDER/THIRD_PARTY en Payor ACCOUNT)
    • Douaneafhandelingsgegevens
    • Pakket-lijnartikelen
      • gewicht
      • artikelen

Bij een succesvolle respons voor 40 of minder onderliggende pakketten per consolidatie in een zending, worden de verzendgegevens in de FedEx-systemen geüpload en worden trackingnummers en pakketlabels gegenereerd. Een succesvolle bevestigingsrespons voor meer dan 40 onderliggende pakketten per consolidatie in een zending bevestigt dat het verzoek in de wachtrij is geplaatst en retourneert de jobId om het resultaat later op te halen met behulp van Resultaten van de consolidatiezending.

Consolidatie bevestigen

Gebruik dit eindpunt om de consolidatie te bevestigen.
De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Accountnummer
  • processingOptionType - ALLOW_ASYNCHRONOUS
  • Consolidatiesleutel
  • Labelspecificatie

Na het antwoord op dit verzoek worden asynchrone verwerkingsresultaten, een job-id en gegevens van een voltooide consolidatie weergegeven, waaronder shipmentRoleType, requestedShipments-gegevens en andere zendingsinformatie.

Consolidatie resultaten bevestigen

Gebruik dit eindpunt om een consolidatie te voltooien. Als de consolidatie is voltooid, retourneert de respons de labelbuffers en alle toepasselijke documenten.

De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • jobId
  • Accountnummer

Bij een succesvol antwoord op dit verzoek worden de bevestigde resultaten van de consolidatiezending geretourneerd, waaronder het trackingnummer en specifieke informatie over het verzenddocument of het etiket.

Resultaten van consolidatieverzoek

Gebruik dit eindpunt om de verzendgegevens van de consolidatiezending te valideren en te uploaden naar de FedEx-systemen zodra alle pakketten zijn toegevoegd aan het verzendverzoek. Dit eindpunt biedt de mogelijkheid om te controleren of de asynchrone verwerking van openstaande zendingen is voltooid. Zo ja, dan worden de etiketten en toepasselijke documenten als antwoord teruggezonden. De werkmaatschappijen voor dit verzoek zijn FedEx Express en FedEx Ground.
De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • jobId
  • Accountnummer

De succesvolle respons op dit verzoek levert de verzendgegevens, waaronder het trackingnummer en de labels.

Consolidatiezendingen verwijderen

Gebruik dit eindpunt om FedEx Express-, Express Freight- en Ground-zendingen te annuleren die niet aan FedEx zijn aangeboden.
De belangrijkste gegevens die voor dit verzoek moeten worden ingevoerd, zijn:

  • Accountnummer
  • Trackingnummer
  • deletionControl - DELETE_ALL_PACKAGES

De succesvolle respons op dit verzoek toont de status van de verwijderde consolidatiezending en genereert de "cancelledShipment": true.

Bedrijfsregels

  • Er is een maximum van 300 pakketten per zending toegestaan.
  • Momenteel is een gecombineerd totaal van 400 pakketten in één consolidatie toegestaan voor een FedEx-consolidatie.
  • Maximaal 999 unieke artikelen (FedEx Express en FedEx Ground, indien van toepassing) per consolidatie. Meestal bevat een consolidatie veel minder artikelen.
  • Alleen 'Rekening afzender' en 'Rekening aan derden' zijn toegestaan voor transportkosten en voor btw en invoerrechten.
  • U kunt voor een Internationale Priority DirectDistribution-vrachtzending geen afzonderlijk stuk verzenden dat minder dan 68 kg weegt.
  • Gegevens over kleine formaten en het gewicht van een pakket, die de geldende afmetingen en het geldend gewicht binnen de Verenigde Staten van FedEx Express, FedEx Ground en FedEx Home Delivery niet overschrijden.
  • Rembourszending (COD, Collect on delivery) is niet beschikbaar met de consolidatie-API van FedEx.
  • U kunt een enkele valuta kiezen voor de opgegeven waarde voor de douane van de hele transactie. Nadat de consolidatiezending van FedEx is geopend, blijft de door u geselecteerde valuta voor het eerste pakket in de zending dezelfde voor alle andere pakketten in de consolidatie.
  • Als u pakketten verzendt met FedEx Ground of FedEx Home Delivery dan moet u de afmetingen in pond (LB) en inch (IN) coderen.
  • De consolidaties en consolidatiezendingen worden verwijderd als ze niet binnen het einde van de vijfde dag na het aanmaken van de consolidatie worden bevestigd.

ShipConsolidation (API)

Modify Consolidations

Modify Consolidation endpoint is intended to modify a new consolidation request with preliminary information ( Shipper, recipient, origin info etc.,) so that the customers can modify the consolidations.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXXXX

This is the confidential client token which authorize the user.

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.

Request Body schema: application/json
One of
  • Full_Schema_ModifyConsolidation
  • SamplePayload-ModifyConsolidation
consolidationKey
required
object (ConsolidationKey)

Identifies the consolidation to which this open shipment should be added after successful creation.

requestedConsolidation
required
object (RequestedConsolidation)

Specify the requested consolidation

accountNumber
required
object (AccountNumber)

This is the FedEx Account number.
Example: 123456789

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

put /ship/v1/consolidations

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations

Production Server

https://apis.fedex.com/ship/v1/consolidations

Request samples - Modify Consolidations

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "consolidationKey":
    {
    },
  • "requestedConsolidation":
    {
    },
  • "accountNumber":
    {
    }
}

Response samples - Modify Consolidations

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

Create Consolidations

Create Consolidation endpoint is intended to create a new consolidation request with preliminary information ( Shipper, recipient, origin info etc.,) so that the customers can consolidate their shipment.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXXXX

This is the confidential client token which authorize the user.

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.

Request Body schema: application/json
One of
  • Full_Schema_CreateConsolidation
  • SamplePayload-CreateConsolidation_IPD
  • SamplePayload-CreateConsolidation_IED
  • SamplePayload-CreateConsolidation_IDF
  • SamplePayload-CreateConsolidation_IGD
  • SamplePayload-CreateConsolidation_TD
consolidationIndex
string

Specifies the cosolidation index.
Example: Key2710

requestedConsolidation
required
object (RequestedConsolidation)

Specify the requested consolidation

accountNumber
required
object (AccountNumber)

This is the FedEx Account number.
Example: 123456789

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations

Production Server

https://apis.fedex.com/ship/v1/consolidations

Request samples - Create Consolidations

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "consolidationIndex": "Key2710",
  • "requestedConsolidation":
    {
    },
  • "accountNumber":
    {
    }
}

Response samples - Create Consolidations

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

Create Consolidation Shipment

Create Consolidation Shipment service would help the customer to create a shipment and confirm it with the required shipping information.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_CreateConsolidationShipment
  • CreateConsolidationShipment_Sync_IPD
  • CreateConsolidationShipment_Async_IPD
  • CreateConsolidationShipment_Sync_IED
  • CreateConsolidationShipment_Async_IED
  • CreateConsolidationShipment_Sync_IDF
  • CreateConsolidationShipment_Sync_IGD
  • CreateConsolidationShipment_Sync_TD
accountNumber
required
object

This is the FedEx Account number.

consolidationKey
required
object (ConsolidationKey)

Identifies the consolidation to which this open shipment should be added after successful creation.

processingOptionType
string
Value: "ALLOW_ASYNCHRONOUS"

This is used to specify processing options related to synchronous or asynchronous processing.

index
string

This is a unique value for the shipment (must be unique for stand-alone open shipments, or unique within consolidation if consolidation key is provide). 'Note: If index is not provided while create Consolidation then the master tracking id of create Consolidation will act as index for the shipment.

shipAction
string
Enum: "CONFIRM" "TRANSFER"

Indicates the optional actions that can be performed during create consolidation shipment

requestedShipment
required
object (RequestedConsolidationShipment)

The consolidation shipment details

labelResponseOptions
string (LableResponseOptions)
Enum: "URL_ONLY" "LABEL"

This is to specify whether the encoded bytecode or the Label URL to be returned in the response.

Valid values:

  • LABEL – Indicates request is for encoded bytecode.
  • URL_ONLY – Indicates label URL request.
Note: For asynchronous shipment (More than 40 packages) request only the value LABEL is suported.


Note: With URL_ONLY option, the URL once created will be active for 12 hours.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations/shipments

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/shipments

Production Server

https://apis.fedex.com/ship/v1/consolidations/shipments

Request samples - Create Consolidation Shipment

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber": "XXXXX2842",
  • "consolidationKey":
    {
    },
  • "processingOptionType": "ALLOW_ASYNCHRONOUS",
  • "index": "Test1234",
  • "shipAction": "CONFIRM",
  • "requestedShipment":
    {
    },
  • "labelResponseOptions": "LABEL"
}

Response samples - Create Consolidation Shipment

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

ConsolidationShipmentResults

This endpoint provides the ablity to find out if the asyncronous processing for open shipments is complete. If complete, the response returns the label buffers and any applicable documents.
Operating Companies - FedEx Express, FedEx Ground


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • ConsolidationShipmentResultsInputVO
  • MinimumSamplePayload-ConsolidationShipmentResults
jobId
required
string

Unique identification for a job

accountNumber
required
object (PartyAccountNumber)

This FedEx Account number details.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations/results

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/results

Production Server

https://apis.fedex.com/ship/v1/consolidations/results

Request samples - ConsolidationShipmentResults

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "jobId": "efj222ee23dc3200s0362377",
  • "accountNumber":
    {
    }
}

Response samples - ConsolidationShipmentResults

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

Confirm Consolidations

Confirm Consolidation endpoint is intended to confirm a new consolidation request with preliminary information so that the customers can confirm the consolidation .


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

ISO locale

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXXXX

This is the confidential client token which authorize the user.

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.

Request Body schema: application/json
One of
  • Full_Schema_ConfirmConsolidation
  • MinimumSamplePayload-confirmConsolidation
edtRequestType
string
Enum: "ALL" "NONE"

Specifies whether the customer wishes to have Estimated Duties and Taxes provided with the rate quotation on this shipment.Only applies with shipments movinf under International Shipment

rateRequestType
string
Enum: "ACCOUNT" "CUSTOM" "INCENTIVE" "LIST" "NONE" "PREFERRED" "RATED" "RETAIL"

Specifies the rate request type for the consolidation

labelSpecification
required
object (LabelSpecification)

These are label specification details includes the image type, printer format, and label stock for label. Can also specify specific details such as doc-tab content, regulatory labels, and masking data on the label.
Mandatory as it is needed during confirming consolidation. If it is not passed while creating consolidation it will fail during confirming consolidation.

consolidationKey
required
object (ConsolidationKey)

Identifies the consolidation to which this open shipment should be added after successful creation.

processingOptionType
required
string
Value: "ALLOW_ASYNCHRONOUS"

Specifying the processing option.

accountNumber
required
object (AccountNumber)

This is the FedEx Account number.
Example: 123456789

consolidationDocumentSpecification
object (ConsolidationDocumentSpec)

Details of consolidation document specification

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations/confirmations

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/confirmations

Production Server

https://apis.fedex.com/ship/v1/consolidations/confirmations

Request samples - Confirm Consolidations

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "edtRequestType": "ALL",
  • "rateRequestType": "ACCOUNT",
  • "labelSpecification":
    {
    },
  • "consolidationKey":
    {
    },
  • "processingOptionType": "ALLOW_ASYNCHRONOUS",
  • "accountNumber":
    {
    },
  • "consolidationDocumentSpecification":
    {
    }
}

Response samples - Confirm Consolidations

Content type
application/json
Copy
Expand all Collapse all
{
  • "output":
    {
    }
}

Confirm Consolidation Results

Confirm Consolidation Results endpoint is intended to confirm a new consolidation request with preliminary information so that the customers can confirm the consolidation.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_ConfirmConsolidationResults
  • MinimumSamplePayload-confirmConsolidationResults
accountNumber
required
object (AccountNumber)

This is the FedEx Account number.
Example: 123456789

jobId
required
string

When the confirm consolidation is processed asynchronously, job Id is generated which is passed in confirm consolidation results to get complete consolidation results

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations/confirmationresults

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/confirmationresults

Production Server

https://apis.fedex.com/ship/v1/consolidations/confirmationresults

Request samples - Confirm Consolidation Results

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "jobId": "b8r763490cj7462n8907"
}

Response samples - Confirm Consolidation Results

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

Retrieve Consolidation

Retrieve Consolidation service is intended to retrieve the consolidations which were created with the preliminary information ( Shipper, recipient, origin info etc.,) based on the Consolidation key.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

ISO locale

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_RetrieveConsolidation
  • MinimumSamplePayload-RetrieveConsolidation
accountNumber
required
object (AccountNumber_2)

This is the FedEx Account number.
Example: Your account number

consolidationKey
required
object (ConsolidationKey)

Identifies the consolidation to which this open shipment should be added after successful creation.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/consolidations/retrieve

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/retrieve

Production Server

https://apis.fedex.com/ship/v1/consolidations/retrieve

Request samples - Retrieve Consolidation

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "consolidationKey":
    {
    }
}

Response samples - Retrieve Consolidation

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

Delete Consolidation Shipments

Use this endpoint to delete the Express or Ground consolidations shipments that have not been tendered to FedEx. The request would cancel one/all packages within the shipment.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • FullSchema-DeleteShipment
  • MinimumSamplePayload-DeleteShipment
accountNumber
required
object

The account number (account value) associated with the shipment.

deletionControl
string
Enum: "DELETE_ALL_PACKAGES" "DELETE_ONE_PACKAGE"

Specifies which packages in a shipment to be canceled.
Valid Values are
DELETE_ONE_PACKAGE which will cancel only the single package indicated in the trackingNumber element below.
DELETE_ALL_PACKAGESwhich will cancel all tracking numbers associated to the shipment.

trackingNumber
required
string

This is an unique number assigned by FedEx to the packages for tracking.
Example: "794953555571"

resourceKey
string

This is a unique number assigned by FedEx to the packages for tracking. This will help in the identification of the dangerous goods shipments to mark it for removal on the manifest report.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

put /ship/v1/consolidations/shipments/delete

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/shipments/delete

Production Server

https://apis.fedex.com/ship/v1/consolidations/shipments/delete

Request samples - Delete Consolidation Shipments

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "deletionControl": "DELETE_ONE_PACKAGE",
  • "trackingNumber": "794953555571",
  • "resourceKey": "86ea9b69e068191a59f0e2721b8fbfee"
}

Response samples - Delete Consolidation Shipments

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

Delete Consolidation

Delete Consolidation endpoint is intended to delete a new consolidation request with preliminary information ( Shipper, recipient, origin info etc.,) so that the customers can consolidate their shipments.


EXPAND ALLCOLLAPSE ALL
header Parameters
X-locale
string
Example: en_US

These are locale details.
Example: 'en_US'
click here to see locales
Note: If the locale is left blank or an invalid locale is entered, an error message is returned in response.

X-customer-transaction-id
string
Example: AnyCo_order123456789

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.

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_deleteConsolidation
  • MinimumSamplePayload-deleteConsolidation
accountNumber
required
object (AccountNumber)

This is the FedEx Account number.
Example: 123456789

consolidationKey
required
object (ConsolidationKey)

Identifies the consolidation to which this open shipment should be added after successful creation.

trackingId
required
object (TrackingIds)

The field is present to allow use of preassigned Master Airway Bill tracking number.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

put /ship/v1/consolidations/delete

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/consolidations/delete

Production Server

https://apis.fedex.com/ship/v1/consolidations/delete

Request samples - Delete Consolidation

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "consolidationKey":
    {
    },
  • "trackingId":
    {
    }
}

Response samples - Delete Consolidation

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

Response

Copy