Fedex Logo
Developer Portal

ShipConsolidation

Introducción

La API de Consolidación te permite consolidar un grupo de envíos individuales para la liberación aduanal en una sola entrada y, después de la liberación aduanal, cada envío se separa en pequeños envíos dentro del país de destino para distribuirlos a los destinatarios individuales. Esta API beneficia a los remitentes que desean consolidar sus envíos internacionales de FedEx Express® y Ground®.
La Consolidación de envíos Ground es específica de los envíos canadienses y permite que los remitentes cualificados de EE. UU. consoliden los envíos de FedEx Ground para distribuirlos en Canadá a través de FedEx Logistics® o del agente aduanal de tu preferencia. Una vez que el envío pasa la liberación aduanal canadiense como un solo envío, se divide en pequeños envíos individuales en Canadá. Tendrás acceso a una variedad de servicios de FedEx después de que tu envío haya pasado la liberación aduanal.

Nota:

  • El número de cuenta debe habilitarse para los servicios de la API de Consolidación para realizar cualquier transacción de la API.
  • Las consolidaciones y los envíos de consolidación se eliminarán si no se confirman al finalizar el quinto día a partir de la creación de la consolidación.

Detalles de la API de consolidación

La API de consolidación ofrece hacer la liberación aduanal en el destino como un solo envío. El envío entero se consigna (se hace una entrada) en nombre de un solo importador registrado (IOR). El envío debe proceder de un solo registro de exportador. Las piezas individuales dentro del envío se entregan al destinatario indicado en cada etiqueta de envío de FedEx Express o del manifiesto Express.
El envío de consolidación también ofrece el Único Punto de Liberación Aduanera (SPOC), que te permite hacer un envío consolidado que incluye paquetes para múltiples países de la Unión Europea.
Los estándares y las restricciones de International Priority Freight (IPF) para el tamaño, peso y tipos de mercancía aplican a los paquetes individuales dentro de una carga de consolidación.
Nota: Debes tener un contrato de servicios en los registros de FedEx antes de poder procesar tus envíos de consolidación. Para obtener más información, comunícate con tus ejecutivos de cuenta FedEx.

Servicio International DirectDistribution

La API de consolidación permite a los clientes usar Direct Distribution al enviar más de un paquete internacionalmente, con la condición de que el país de destino para todos esos paquetes sea el mismo.
El servicio Direct Distribution mejorará los tiempos de entrega, reducirá las tarifas de liberación aduanal y bajará los costos de depósito para los remitentes. FedEx consolidará los envíos que se dirijan a la misma ubicación (país extranjero) para la liberación aduanal, después los dividirá para entrega directa a tus clientes.
Los clientes también pueden hacer envíos desde Canadá hacia EE. UU. a través de International DirectDistribution (IDD) (antes servicio de Distribución Transfronteriza). FedEx International DirectDistribution Surface Solutions (IDD Surface) ofrece a los clientes de Canadá y México una opción de entrega transfronteriza consolidada para enviar a varios destinatarios en EE. UU., pero International DirectDistribution (IDD) debe tener sede en Canadá o México y la ID de la ubicación del punto de entrega debe estar configurada para la cuenta especificada.

Documentación de envío internacional

Los reportes de detalles de envío de la factura comercial unificada (CCI) representan uno de los reportes mínimos requeridos por aduana, necesarios para que el envío consolidado cruce la frontera internacional del país de destino.

Los detalles de envío de la CCI proporcionan la siguiente información:

  • Proporcionan al destinatario información sobre el nivel de envío para todos los agentes aduanales de entrada sobre los paquetes que están en la consolidación, y los agrupa o los enumera por «Comprador» (es decir, («Vendido a»).
    Nota: Los envíos secundarios se enumeran en la CCI si cumplen con una de las siguientes condiciones:
    • El agente aduanal designado enumera en la CCI para el ingreso por aduana los envíos secundarios que no califican para la Sección 321.
    • El remitente especifica que todos los envíos secundarios que estén en la consolidación deben ser presentados por el agente aduanal para su ingreso.

El reporte de transporte directo de origen a destino proporciona la siguiente información:

  • Cuáles compradores y los envíos asociados califican para la Sección 321 y cuáles califican para PAPS.
  • La ubicación del punto de entrega y la dirección.
  • La ubicación del punto de entrega del tercero o información del establecimiento.
  • Nota: Este reporte también se conoce como el Reporte aduanal consolidado de transporte directo de origen a destino y se genera para los envíos entrantes a EE. UU. provenientes de Canadá o de México.

La tabla de International DirectDistribution Services – FedEx Express y FedEx Ground Services enumera los servicios de FedEx de EE. UU. disponibles para los envíos de International DirectDistribution Service después de su entrada en EE. UU.

FedEx Express Services - International Priority DirectDistribution (IPD)

Necesidad de envío Servicio proporcionado

A primera hora de la mañana del día hábil siguiente.

FedEx First Overnight®

En la mañana del siguiente día hábil.

FedEx Priority Overnight®

En la tarde del siguiente día hábil.

FedEx Standard Overnight®

2 días hábiles.

FedEx 2Day®

Segundo día hábil antes de las 10:30 a.m. para la mayoría de las áreas de negocio. En el caso de ciertos envíos a Alaska y Hawaii, la entrega es en 3 días hábiles.

FedEx 2Day® A.M

3 días hábiles.

FedEx Express Saver®

En 1, 2 o 3 días hábiles en los EE. UU. para paquetes de más de 68 kilogramos cada uno.

FedEx 1Day® Freight,

FedEx 2Day® Freight,

FedEx 3Day® Freight

 

FedEx Ground Services - International DirectDistribution (IDD) Surface Solutions

Necesidad de envío Servicio proporcionado

Entrega económica por tierra a negocios.

FedEx Ground®

Entrega económica por tierra a residencias en EE. UU.

FedEx Home Delivery®

Los siguientes son los servicios de envío disponibles con la API de Consolidación.

FedEx Express International DirectDistribution Services

  • International Priority DirectDistribution (IPD) y International Economy DirectDistribution Service (IED) proporcionan la liberación aduanal en una sola entrada para los envíos de FedEx Express®, y luego los entregan a los destinatarios individuales en su país de destino. Estos son servicios solo por contrato.
  • El servicio de International DirectDistribution (IDD) permite envíos consolidados transfronterizos desde Canadá y México a diversos destinatarios en Estados Unidos.

FedEx Express International DirectDistribution Freight Service

  • Puedes consolidar y enviar envíos de carga de piezas múltiples (que excedan de 150 libras/68 kilogramos) usando FedEx International Priority DirectDistribution Freight (IDF). Todas las piezas deben ser puestas en plataformas para enviar IDF. International Priority DirectDistribution Freight (IDF) permite usar una Guía aérea internacional de FedEx® para consolidar envíos de una sola ubicación de origen a varios destinatarios en un país de destino. Después de que tu envío ingresa a EE. UU., el envío puede ser gestionado por los servicios de FedEx de EE. UU., que incluyen a FedEx Express, FedEx Ground y FedEx Home Delivery.

Proceso de envío de consolidación

Los envíos de consolidación pueden procesarse de dos maneras – sincrónica o asincrónica, dependiendo del número de paquetes por envío o de las mercancías a nivel de paquete en un envío.
Para el procesamiento sincrónico, una transacción solo debe tener menos de 40 paquetes secundarios por consolidación.
Si la transacción se procesa de manera sincrónica, la respuesta generará las etiquetas de los paquetes y los reportes de envío, como el recibo comercial.
Cuando la transacción se procesa de manera asincrónica, la respuesta solo confirma que la solicitud se puso en espera con éxito para el procesamiento asincrónico. Es posible que el envío no se procese de manera exitosa, por lo que beberá usarse el método correspondiente de Resultados de consolidación del envío para revisar si los envíos se procesaron con éxito. Dale algo de tiempo a los envíos para que se procesen con éxito antes de que obtengas los resultados.

Puedes seguir los siguientes pasos para procesar el envío de manera asincrónica –

  1. Crear consolidación: Utiliza este extremo para crear una nueva consolidación con un índice único. Una respuesta exitosa generará un número de rastreo de consolidación.
    Nota: Si no se proporciona el índice en la solicitud, entonces se considerará al número de rastreo como el índice.
  2. Crear envío de consolidación: Utiliza este extremo para crear un envío asincrónico para más de 40 paquetes. La respuesta exitosa generará una jobID del envío de consolidación.
  3. Resultados del envío de consolidación: Utiliza este extremo con la jobID generada para obtener el número de rastreo y las etiquetas del envío.
  4. Confirmar consolidación: Utiliza este extremo con el tipo de consolidación y el índice generado para confirmar la creación de tu consolidación. Una respuesta exitosa generará una jobID
  5. Confirmar resultados de la consolidación: Utiliza este extremo con la jobID generada en Confirmar consolidación para obtener los números de rastreo, las etiquetas y la documentación para tu consolidación.

Puedes seguir los siguientes pasos para procesar el envío de manera sincrónica:

  1. Crear consolidación: Utiliza este extremo para crear una nueva consolidación con un índice único. Una respuesta exitosa generará un número de rastreo de consolidación.
    Nota: Si no se proporciona el índice en la solicitud, entonces se considerará al número de rastreo como el índice.
  2. Crear envío de consolidación: Utiliza este extremo para crear un envío sincrónico con 40 o menos paquetes. Una respuesta exitosa generará los números de rastreo y las etiquetas del envío de consolidación.
  3. Confirmar consolidación: Utiliza este extremo con el tipo de consolidación y el índice generado para confirmar la creación de tu consolidación. Una respuesta exitosa generará una jobID
  4. Confirmar resultados de la consolidación: Utiliza este extremo con la jobID generada en Confirmar consolidación para obtener los números de rastreo, las etiquetas y la documentación para tu consolidación.

Puedes seguir los siguientes pasos para modificar o eliminar cualquier envío o paquete de consolidación creado:

  • Modificar consolidaciones: Utiliza este extremo para modificar información de una solicitud de consolidación existente antes de confirmar la consolidación.
  • Eliminar envío de consolidación: Utiliza este extremo para cancelar los envíos de FedEx Express, Express Freight y Ground que no hayas enviado a FedEx. Una respuesta exitosa mostrará el estado de envío de consolidación eliminado y generará «cancelledShipment"»: verdadero.
  • Eliminar consolidación: Utiliza este extremo para eliminar un envío de consolidación antes de su confirmación.
    Nota: Esto también eliminará todos los paquetes de envío que se procesaron como parte del envío de consolidación.
  • Recuperar consolidación: Utiliza este extremo para obtener los detalles de tu consolidación.

Cómo funciona la API de consolidación

Las siguientes son las características principales de la API de consolidación:

Crear consolidaciones

Utiliza este extremo para crear una consolidación con la información de consolidación requerida.
La información clave de ingreso asociada a esta solicitud es:

  • Número de cuenta: el número de cuenta de envío de FedEx.
  • requestedConsolidation
    • Tipo de consolidación: especifica el tipo de consolidación.
    • Remitente: proporciona la información del remitente junto con el número de identificación fiscal (TIN)
    • Especificación de etiqueta: especifica los detalles sobre el tipo de imagen, formato de impresión e inventario de etiquetas.
    • Detalles de distribución internacional
      • Monedas declaradas
      • Dimensiones totales
      • Id de la oficina del establecimiento de liberación aduanal
    • Detalles de liberación aduanal: especifica el importador registrado.
    • Documentos de consolidación: especifica la documentación necesaria cuando se confirma la consolidación.

Una respuesta exitosa a esta solicitud creará la consolidación y generará la ID de rastreo principal y la clave de consolidación. Ten en cuenta que en la respuesta no se generarán etiquetas.

Modificar consolidaciones

Utiliza este extremo para modificar la información de una solicitud de consolidación existente antes de confirmar la consolidación.
La información clave de ingreso asociada a esta solicitud es:

  • Clave de consolidación: especifica el tipo de consolidación, el índice y la fecha de consolidación de Crear respuesta de consolidación.
  • Número de cuenta: el número de cuenta de envío de FedEx.
  • requestedConsolidation
    • Tipo de consolidación: especifica el tipo de consolidación.
    • Remitente
    • Especificación de etiqueta: especifica los detalles sobre el tipo de imagen, formato de impresión e inventario de etiquetas. También puedes especificar los detalles concretos del cliente como contenido de la pestaña del documento, etiquetas regulatorias y datos ocultos en la etiqueta.
    • Liberación aduanal: especifica los detalles de la liberación aduanal con el importador registrado.

Una solicitud exitosa actualizará la información deseada y arrojará los detalles de consolidación actualizados.

Recuperar consolidación

Usa este extremo para recuperar consolidaciones para la clave de consolidación específica. La información clave de ingreso asociada a esta solicitud es:

  • Número de cuenta: el número de cuenta de envío de FedEx.
  • Clave de consolidación: especifica el tipo de consolidación, el índice y la fecha de consolidación de Crear consolidación.

Una solicitud exitosa recuperará los detalles de la consolidación.

Eliminar consolidación

Utiliza este extremo para eliminar una consolidación abierta antes de confirmar la consolidación.
Nota: Si se requiere, este extremo debe utilizarse antes de Confirmar consolidación.

La información clave de ingreso asociada a esta solicitud es:

  • Número de cuenta: el número de cuenta de envío de FedEx.
  • Clave de consolidación: especifica el tipo de consolidación, el índice y la fecha de consolidación.
  • TrackingId: especifica la ID de rastreo principal que se generó en Crear respuesta de consolidación.

Una solicitud exitosa eliminará la consolidación deseada y arrojará la transactionID y el estado del elemento cancelledShipment como verdadero en la salida.

Crear envío de consolidación

Utiliza este extremo para agregar los paquetes del envío bajo una clave de consolidación.
Nota: Se requieren mínimo dos envíos para crear un envío de consolidación.

La información clave de ingreso asociada a esta solicitud es:

  • Opciones de respuesta de la etiqueta: debería ser URL_ONLY/LABEL.
  • Acción de envío abierto: CONFIRMADA
  • Número de cuenta: el número de cuenta de envío de FedEx.
  • Clave de consolidación: especifica el tipo de consolidación, el índice y la fecha de consolidación de Crear consolidación.
  • requestedShipment
    • Tipo de consolidación: especifica el tipo de consolidación.
    • Información del remitente
    • Información de los destinatarios
    • Tipo de recolección
    • Tipo de servicio: proporciona los tipos de servicio Express/Ground.
    • Tipo de embalaje
    • Tipo de pago del envío (SENDER/THIRD_PARTY y Payor ACCOUNT)
    • Detalles de liberación aduanal
    • Artículos de línea del paquete
      • Peso
      • mercancías

Una respuesta exitosa para 40 o menos paquetes secundarios por consolidación en un envío cargará la información del envío en los sistemas de FedEx y generará los números de rastreo y las etiquetas de los paquetes. Una respuesta de confirmación exitosa para más de 40 paquetes secundarios por consolidación en un envío confirma que la solicitud está en espera con éxito y arroja una jobId para recuperar el resultado más tarde en los resultados del envío de consolidación.

Confirmar consolidaciones

Utiliza este extremo para confirmar una consolidación.
La información clave de ingreso asociada a esta solicitud es:

  • Número de cuenta
  • processingOptionType: ALLOW_ASYNCHRONOUS
  • Clave de consolidación
  • Especificación de la etiqueta

La respuesta exitosa a esta solicitud proporcionará los resultados del procesamiento asincrónico, la ID del trabajo y los detalles completos de la consolidación, que incluyen los detalles de shipmentRoleType, requestedShipments y otra información de envío.

Confirmar los resultados de las consolidaciones

Utiliza este extremo para completar una consolidación. Si se completó la consolidación, la respuesta arroja el búfer de la etiqueta y cualquier documento aplicable.

La información clave de ingreso asociada a esta solicitud es:

  • ID del trabajo
  • Número de cuenta

La respuesta exitosa a esta solicitud arrojará los resultados confirmados del envío de consolidación, que incluyen el número de rastreo, los documentos de envío o la información específica de la etiqueta.

Resultados del envío de consolidación

Use este extremo para validar y cargar la información del envío de consolidación en los sistemas de FedEx una vez haya agregado todos los paquetes en la solicitud de envío. El extremo proporciona la opción de revisar si el procesamiento asincrónico de envíos abiertos está completo. En caso afirmativo, en respuesta se arrojan las etiquetas y los documentos aplicables. Las compañías operativas para esta solicitud son FedEx Express y FedEx Ground.
La información clave de ingreso asociada a esta solicitud es:

  • ID del trabajo
  • Número de cuenta

Una respuesta exitosa a esta solicitud proporcionará los detalles de los envíos que incluyen el número de rastreo y las etiquetas de los envíos.

Eliminar envíos de consolidación

Utiliza este extremo para cancelar envíos de FedEx Express, Express Freight y Ground que no hayas enviado a FedEx.
La información clave de ingreso asociada a esta solicitud es:

  • Número de cuenta
  • Número de rastreo
  • deletionControl: DELETE_ALL_PACKAGES

Una respuesta exitosa a esta solicitud mostrará el estado de envío de consolidación eliminado y generará "cancelledShipment" como verdadero.

Normas comerciales

  • Se permite un máximo de 300 paquetes en un solo envío.
  • Actualmente se permite un total combinado de 400 paquetes en una sola consolidación para una Consolidación de FedEx.
  • Un máximo de 999 mercancías únicas (de FedEx Express o de FedEx Ground, según corresponda) por consolidación. Normalmente hay mucho menos mercancías en una consolidación.
  • Solo se permite facturar al remitente o facturar a un tercero los cargos de transporte y los impuestos y aranceles.
  • No puedes enviar una pieza individual en un envío de International Priority DirectDistribution Freight que tenga menos de 68 Kg o 151 lb.
  • Datos sobre el tamaño y el peso de los paquetes pequeños que no exceden las restricciones actuales de tamaño y peso en el interior de EE. UU. de FedEx Express, FedEx Ground y FedEx Home Delivery.
  • Cobro contra entrega no está disponible con la API de consolidación de FedEx.
  • Puedes seleccionar una sola moneda para el valor de aduana de toda la transacción. Después de abrir el envío de consolidación de FedEx, la moneda que seleccionaste para el primer paquete del envío será la misma para los otros paquetes que se encuentran en la consolidación.
  • Si envías paquetes usando FedEx Ground o FedEx Home Delivery, entonces debes codificar las medidas en libras (LB) y pulgadas (IN).
  • Las consolidaciones y los envíos de consolidación se eliminarán si no se confirman al finalizar el quinto día a partir de la creación de la consolidación.

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