Fedex Logo
Developer Portal

Consolidation API

Introdução

A API de consolidação permite consolidar uma recolha de expedições individuais para desalfandegamento numa única entrada. Após o desalfandegamento, a expedição é dividida em expedições mais pequenas no país de destino para distribuição a destinatários individuais. Esta API é vantajosa para expedidores que pretendam consolidar as respetivas expedições internacionais FedEx Express® e Ground®.
A Expedição Ground de consolidação é específica a expedições no Canadá e permite que os expedidores americanos qualificados consolidem expedições FedEx Ground para distribuição no Canadá através do FedEx Logistics® ou de um despachante à escolha. Após a expedição ser desalfandegada pela alfândega canadiana como uma única expedição, será dividida em expedições individuais mais pequenas no Canadá. Terá acesso a todos os serviços FedEx após a sua expedição ter sido desalfandegada.

Nota:

  • O número de conta deve ser ativado com os serviços da API de consolidação para executar transações da API.
  • As Consolidações e as expedições de Consolidação serão eliminadas se não forem confirmadas até ao final do quinto dia a partir da criação das Consolidações.

Detalhes da API de consolidação

A API de consolidação disponibiliza o desalfandegamento da expedição na alfândega de destino como uma única expedição. Toda a expedição é consignada a apenas um Importador registado (IOR) e é dada entrada em nome do mesmo. A expedição também tem de ser proveniente de apenas um exportador registado. As peças individuais da expedição são entregues ao destinatário indicado em cada etiqueta da expedição FedEx Express ou Manifesto Express.
A expedição de consolidação também disponibiliza um Ponto Único de Desalfandegamento (SPOC), o que permite enviar uma expedição consolidada que inclua volumes para vários países da União Europeia.
As normas e restrições relativas ao tamanho, peso e tipos de mercadoria do serviço International Priority Freight (IPF) aplicam-se a volumes individuais numa carga consolidada.
Nota: é necessário ter um contrato de serviço registado na FedEx antes de poder processar as suas expedições de consolidação. Para obter mais informações, contacte os seus Gerentes de conta FedEx.

Serviço International DirectDistribution

A API de consolidação permite aos clientes utilizar a Distribuição direta ao enviar mais do que um volume internacionalmente, mediante a condição de o país de destino desses volumes ser o mesmo.
O serviço de Distribuição direta melhora o tempo de entrega e reduz as taxas de desalfandegamento, assim como os custos de armazém para os expedidores. A FedEx consolida as suas expedições que vão para a mesma localização (país estrangeiro) para desalfandegamento e, em seguida, desconsolida-as para entrega direta aos seus clientes.
Os clientes também já podem enviar expedições do Canadá para os EUA através do serviço International DirectDistribution (IDD, anteriormente denominado serviço Transborder Distribution). As FedEx International DirectDistribution Surface Solutions (IDD Surface) fornecem aos clientes do Canadá e do México uma opção de entrega consolidada transfronteiriça para enviar para vários destinatários nos EUA. O International DirectDistribution (IDD) tem de estar sediado no Canadá ou no México e tem de ser configurada uma ID de estação de entrega na conta indicada.

Documentação internacional

Os relatórios de expedição detalhados da CCI (Fatura comercial consolidada) representam um dos relatórios alfandegários obrigatórios para que a expedição consolidada atravesse com sucesso a fronteira internacional para o país de destino.

Os Detalhes da expedição da CCI (Fatura comercial consolidada) fornecem as seguintes informações:

  • O relatório de Detalhes da expedição da CCI (Fatura comercial consolidada) fornece informações para todos os volumes de entradas de despachante na consolidação e agrupa ou lista os mesmos por "Comprador" (ou seja, "Emissor da ordem").
    Nota: as expedições secundárias são listadas na CCI (Fatura comercial consolidada) tendo em conta uma das condições seguintes:
    • As expedições secundárias que não se qualificam para a Secção 321 são listadas na entrada da CCI (Fatura comercial consolidada) para alfândega pelo Alfandegário designado.
    • O expedidor especifica que todas as expedições secundárias na consolidação têm de ser enviadas para entrada pelo Alfandegário.

O relatório de Transporte entre terminais de IDD fornece as seguintes informações:

  • Quais os Compradores e as expedições associadas que se qualificam para a Secção 321 e a PAPS.
  • A estação de entrega e o endereço.
  • Informações sobre as instalações ou estação de entrega de terceiros.
  • Nota: este relatório também é conhecido como Relatório de Transporte entre terminais da alfândega consolidado e é gerado para expedições nacionais nos EUA do Canadá ou do México.

Serviços International DirectDistribution: a tabela de serviços FedEx Express e FedEx Ground indica os serviços da FedEx U.S. disponíveis em expedições do serviço International DirectDistribution após darem entrada nos EUA.

Serviços FedEx Express ‑ FedEx International Priority DirectDistribution (IPD)

Necessidade de expedição Serviço disponibilizado

Logo de manhã no Dia útil seguinte.

FedEx First Overnight®

Manhã do Dia útil seguinte.

FedEx Priority Overnight®

Tarde do Dia útil seguinte.

FedEx Standard Overnight®

Dois dias úteis.

FedEx 2Day®

Segundo dia útil às 10h30 na maioria das áreas comerciais. Em determinadas expedições para o Alasca e Havai, a entrega demora três dias úteis.

FedEx 2Day® A.M

Três dias úteis.

FedEx Express Saver®

Demora um, dois ou três dias úteis nos EUA para volumes com mais de 68 kg cada.

FedEx 1Day® Freight

FedEx 2Day® Freight

FedEx 3Day® Freight

 

Serviços FedEx Ground ‑ International DirectDistribution (IDD) Surface Solutions

Necessidade de expedição Serviço disponibilizado

Entrega por via terrestre económica para empresas.

FedEx Ground®

Entrega por via terrestre económica para residências nos EUA.

FedEx Home Delivery®

Seguem-se os serviços de expedições disponíveis para esta API de consolidação.

Serviços FedEx Express International DirectDistribution

  • Os serviços International Priority DirectDistribution (IPD) e International Economy DirectDistribution (IED) disponibilizam o desalfandegamento de expedições FedEx Express® consolidadas numa única entrada e a entrega a destinatários individuais no país de destino. São serviços disponibilizados apenas mediante contrato.
  • O serviço International DirectDistribution (IDD) permite expedições consolidadas transfronteiriças do Canadá e México para vários destinatários nos Estados Unidos.

Serviço FedEx Express International DirectDistribution Freight

  • Pode consolidar e enviar expedições de carga multi-peças (com mais de 68 kg/150 libras) através do FedEx International Priority DirectDistribution Freight (IDF). Todas as peças têm de ser colocadas em paletes de face única para serem enviadas através do IDF. O International Priority DirectDistribution Freight (IDF) permite utilizar uma Carta de porte internacional FedEx® para consolidar expedições de uma única localização de origem para vários destinatários num país de destino. Depois de a sua expedição entrar em território norte-americano, pode ser gerida pelos serviços FedEx U.S., como o FedEx Express, FedEx Ground e FedEx Home Delivery.

Processo da Expedição de consolidação

As Expedições de consolidação podem ser processadas de duas maneiras: de forma síncrona ou assíncrona, consoante o número de volumes por expedição ou as mercadorias ao nível de volume numa expedição.
Para um processamento de forma síncrona, uma transação só pode ter 40 volumes secundários por consolidação.
Se a transação for processada de forma síncrona, a resposta terá as etiquetas de volumes e os relatórios de expedições, como FC (Fatura comercial).
Se a transação for processada de forma assíncrona, a resposta a este pedido apenas confirma que o pedido foi colocado em fila com êxito para processamento assíncrono. A expedição pode não ser processada com êxito. Assim, terá de ser utilizado o método Resultados da Expedição de consolidação correspondente para verificar se as expedições foram processadas com êxito. Aguarde algum tempo para que a expedição seja processada com êxito antes de obter os resultados.

Pode seguir os passos seguintes para processar a expedição de forma assíncrona:

  1. Criar consolidação: utilize este ponto final para criar uma nova consolidação com um índice único. A resposta bem-sucedida irá gerar um número de rastreio de consolidação.
    Nota: se o índice não for fornecido no pedido, o número de rastreio será considerado como o índice.
  2. Criar expedição de consolidação: utilize este ponto final para criar uma expedição assíncrona para mais de 40 volumes. A resposta bem-sucedida irá gerar um jobID de expedição de consolidação.
  3. Resultados de expedição de consolidação: utilize este ponto final com o jobID gerado para obter o número de rastreio da expedição e as etiquetas.
  4. Confirmar consolidação: utilize este ponto final com o tipo de consolidação e o Índice gerado para confirmar a sua consolidação criada. A resposta bem-sucedida irá gerar um jobID
  5. Confirmar resultados de consolidação: utilize este ponto final com o jobID gerado a partir de Confirmar consolidação para obter os números de rastreio, as etiquetas e a documentação da sua consolidação.

Pode seguir estes passos para processar a expedição de forma síncrona –

  1. Criar consolidação: utilize este ponto final para criar uma nova consolidação com um índice único. A resposta bem-sucedida irá gerar um número de rastreio de consolidação.
    Nota: se o índice não for fornecido no pedido, o número de rastreio será considerado como o índice.
  2. Criar expedição de consolidação: utilize este ponto final para criar uma expedição síncrona inferior ou igual a 40 volumes. A resposta bem-sucedida irá gerar números de rastreio da expedição de consolidação e etiquetas.
  3. Confirmar consolidação: utilize este ponto final com o tipo de consolidação e o Índice gerado para confirmar a sua consolidação criada. A resposta bem-sucedida irá gerar um jobID
  4. Confirmar resultados de consolidação: utilize este ponto final com o jobID gerado a partir de Confirmar consolidação para obter os números de rastreio, as etiquetas e a documentação da sua consolidação.

Pode seguir estes passos para modificar ou eliminar quaisquer consolidações ou expedições de consolidação criadas –

  • Modificar consolidações: utilize este ponto final para modificar informações de um pedido de Consolidação existente antes de a consolidação ser confirmada.
  • Eliminar expedição de consolidação: utilize este ponto final para cancelar expedições FedEx Express, Express Freight e Ground que não tenham sido apresentadas à FedEx. A resposta bem-sucedida irá mostrar o estado Eliminado da expedição de consolidação e gerar o elemento "cancelledShipment": true.
  • Eliminar consolidação: utilize este ponto final para eliminar uma consolidação antes de ser confirmada.
    Nota: isto também irá eliminar todos os volumes de expedição que foram processados como parte da consolidação.
  • Obter consolidação: utilize este ponto final para obter os detalhes da sua consolidação.

Como funciona a API de consolidação

Seguem-se as funcionalidades principais associadas à API de consolidação:

Criar consolidações

Utilize este ponto final para criar uma consolidação com as informações de consolidação necessárias.
As informações de introdução principais associadas a este pedido são:

  • Número de conta – o número de conta da expedição FedEx
  • requestedConsolidation
    • Tipo de consolidação – especifique o tipo de consolidação.
    • Expedidor – forneça as informações do expedidor juntamente com o Número de identificação fiscal (TIN)
    • Especificação da etiqueta – indique todos os detalhes de tipo de imagem, formato de impressora e stock de etiquetas.
    • Detalhes de distribuição international
      • Moedas declaradas
      • Dimensões totais
      • ID de estação da instalação de desalfandegamento
    • Detalhes de desalfandegamento – indique o Importador registado.
    • Documentos de consolidação – especifique a documentação necessária quando a consolidação for confirmada.

A resposta bem-sucedida a este pedido irá criar a consolidação e gerar a Identificação de rastreio principal e a Chave de consolidação. Tenha em atenção que não serão geradas etiquetas na resposta.

Modificar consolidações

Utilize este ponto final para modificar informações de um pedido de Consolidação existente antes de a consolidação ser confirmada.
As informações de introdução principais associadas a este pedido são:

  • Chave de consolidação – especifique o Tipo de consolidação, Índice e data de consolidação a partir de Criar resposta de consolidação.
  • Número de conta – o número de conta da expedição FedEx.
  • requestedConsolidation
    • Tipo de consolidação – indique o tipo de consolidação.
    • Expedidor
    • Especificação da etiqueta – especifique detalhes sobre o tipo de imagem, formato de impressora e stock de etiquetas. Também pode especificar detalhes específicos do cliente, como conteúdo do separador de documentos, etiquetas regulamentares e dados dissimulados na etiqueta
    • Desalfandegamento – especifique os detalhes de desalfandegamento com o Importador registado.

O pedido bem-sucedido irá atualizar as informações pretendidas e devolver os detalhes de consolidação atualizados.

Obter consolidação

Utilize este ponto final para obter a consolidação da Chave de consolidação indicada. As informações de introdução principais associadas a este pedido são:

  • Número de conta – o número de conta da expedição FedEx.
  • Chave de consolidação – especifique o Tipo de consolidação, Índice e data de consolidação a partir de Criar consolidação.

O pedido bem-sucedido irá obter os detalhes de consolidação.

Eliminar consolidação

Utilize este ponto final para eliminar a consolidação aberta antes de a consolidação ser confirmada.
Nota: se necessário, este ponto final deve ser utilizado antes de Confirmar consolidação.

As informações de introdução principais associadas a este pedido são:

  • Número de conta – o número de conta da expedição FedEx.
  • Chave de consolidação – especifique o Tipo de consolidação, Índice e data de consolidação.
  • TrackingId – especifique a Identificação de rastreio principal gerada em Criar resposta de consolidação.

O pedido bem-sucedido irá eliminar a consolidação pretendida e devolver o transactionID e o estado do elemento cancelledShipment como true no resultado.

Criar uma Expedição de consolidação

Utilize este ponto final para adicionar os volumes de expedição sob uma chave de consolidação.
Nota: são necessárias um mínimo de 2 expedições para criar a expedição de consolidação.

As informações de introdução principais associadas a este pedido são:

  • Opções de resposta de etiqueta – deve ser URL_ONLY/LABEL
  • Ação de expedição aberta – CONFIRMAR
  • Número de conta – o número de conta da expedição FedEx.
  • Chave de consolidação – especifique o Tipo de consolidação, Índice e data de consolidação a partir de Criar consolidação.
  • requestedShipment
    • Tipo de consolidação – especifique o tipo de consolidação
    • Informações do expedidor
    • Informações dos destinatários
    • Tipo de Recolha
    • Tipo de serviço – forneça tipos de serviço Express/Ground
    • Tipo de Embalagem
    • Tipo de pagamento da expedição (SENDER/THIRD_PARTY e Payor ACCOUNT)
    • Detalhes de desalfandegamento
    • Itens de linha do volume
      • peso
      • mercadorias

A resposta bem-sucedida para 40 ou menos volumes secundários por consolidação numa expedição irá carregar os dados da expedição dos sistemas da FedEx e gerar números de rastreio e etiquetas de volume. A resposta de confirmação bem-sucedida para mais de 40 volumes secundários por consolidação numa expedição confirma que o pedido foi colocado em fila com sucesso e devolve o jobId para obter o resultado mais tarde ao utilizar Resultados da expedição de consolidação.

Confirmar consolidação

Utilize este ponto final para confirmar a consolidação.
As informações de introdução principais associadas a este pedido são:

  • Número da Conta
  • processingOptionType – ALLOW_ASYNCHRONOUS
  • Chave de consolidação
  • Especificação da etiqueta

A resposta bem-sucedida a este pedido irá disponibilizar resultados de processamento assíncrono, o jobID e os detalhes da consolidação concluída, que incluem detalhes dos elementos shipmentRoleType e requestedShipments, assim como outras informações da expedição.

Confirmar resultados de consolidação

Utilize este ponto final para concluir uma consolidação. Se a consolidação for concluída, a resposta devolve a memória intermédia da etiqueta e quaisquer documentos aplicáveis.

As informações de introdução principais associadas a este pedido são:

  • jobId
  • Número da Conta

A resposta bem-sucedida a este pedido irá devolver os resultados da Expedição de consolidação confirmada, que incluem informações específicas da etiqueta, documentos de expedição ou o número de rastreio.

Resultados da Expedição de consolidação

Utilize este ponto final para validar e carregar os dados da Expedição de consolidação para os Sistemas da FedEx assim que todos os volumes forem adicionados no pedido de Expedição. Este ponto final disponibiliza a opção de verificar se o processamento assíncrono de expedições em aberto foi concluído. Caso se verifique, as etiquetas e os documentos aplicáveis serão devolvidos na resposta. As empresas de operações deste pedido são a FedEx Express e a FedEx Ground.
As informações de introdução principais associadas a este pedido são:

  • jobId
  • Número da Conta

A resposta bem-sucedida a este pedido irá disponibilizar os detalhes de expedições, que inclui o número de rastreio da expedição e as Etiquetas.

Eliminar Expedições de consolidação

Utilize este ponto final para cancelar expedições FedEx Express, Express Freight e Ground não apresentadas à FedEx.
As informações de introdução principais associadas a este pedido são:

  • Número da Conta
  • Número de rastreio
  • deletionControl – DELETE_ALL_PACKAGES

A resposta bem-sucedida a este pedido irá mostrar o estado Eliminado da expedição de consolidação e gerar o elemento "cancelledShipment": true.

Regras Empresariais

  • É permitido um máximo de 300 volumes numa expedição única.
  • Atualmente, é permitido um total combinado de 400 volumes numa consolidação única para uma consolidação da FedEx.
  • É permitido um máximo de 999 mercadorias únicas (FedEx Express e FedEx Ground, conforme adequado) por consolidação. Normalmente, existem menos mercadorias numa consolidação.
  • Só são permitidas as taxas de transporte e direitos e taxas Cobrança ao remetente e Cobrança a terceiros.
  • Não pode enviar uma peça individual numa expedição International Priority DirectDistribution Freight com menos de 68 kg (ou 151 lb).
  • Introduza dados de tamanho e peso de pacote pequeno que não excedam as restrições atuais de peso e tamanho do FedEx Express, FedEx Ground e FedEx Home Delivery dentro dos EUA.
  • O Pagamento contra entrega não está disponível na API de consolidação da FedEx.
  • Pode selecionar uma única moeda para o Valor alfandegário de toda a transação. Após a Expedição de consolidação da FedEx ser aberta, a moeda selecionada para o primeiro volume na expedição permanece o mesmo para os restantes volumes na consolidação.
  • Se enviar volumes através do FedEx Ground ou FedEx Home Delivery, terá de introduzir as medidas em libras (LB) e polegadas (IN).
  • As Consolidações e as expedições de Consolidação serão eliminadas se não forem confirmadas até ao final do quinto dia a partir da criação das Consolidações.

Recolha da API JSON

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.

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

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

Response samples

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.

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

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

Response samples

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.

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

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

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

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

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

Response samples

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 .

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

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

Response samples

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.

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

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

Response samples

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.

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

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

Response samples

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.

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

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

Response samples

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.

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

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

Response samples

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

Response

Copy