Introducción
La API de tarifa integral y tiempo en tránsito proporciona todas las posibles cotizaciones de tarifas y tiempos en tránsito para los servicios que correspondan a tu tipo de embalaje, con cotizaciones de tarifas para el servicio de FedEx Tarifa Única en una sola solicitud de tarifas. Esto te permite escoger la mejor opción posible según las necesidades de tu envío. Para los servicios de FedEx Express, la API compara las tarifas estándar específicas de la cuenta, incluida FedEx Tarifa Única, y arroja la cotización de tarifa más baja.
Nota:
- Tu cuenta debe estar habilitada para los servicios de FedEx Tarifa Única y FedEx Ground Economy para obtener cotizaciones de tarifas para los servicios respectivos.
- El servicio de FedEx Tarifa Única tiene algunas restricciones de dimensión y peso para los envíos. Solo los envíos que califican según las condiciones de dimensión y peso son elegibles para FedEx Tarifa Única.
- La Rate and Transit Times API no proporciona las cotizaciones de las tarifas para los servicios de FedEx Freight. Para conocer las tarifas de los servicios de FedEx Freight, visita el sitio web de FedEx Freight.
Esta API te proporciona la flexibilidad de recibir cotizaciones de tarifas de servicios de FedEx Tarifa Única junto con las tarifas de descuento específicas de cuenta. Las cotizaciones se pueden hacer para embalaje de FedEx o para tu embalaje.
Para obtener más información consulta Tipos de paquetes.
Nota: Esta API no acepta como tipo de embalaje el FedEx Tube.
A continuación encontrará las funciones asociadas con esta API:
- Obtén todas las cotizaciones de tarifas en una Sola transacción
Obtén todas las tarifas (FedEx Ground Economy saliente, FedEx Express, FedEx Tarifa Única, tarifas específicas de cuenta) en una sola transacción. - Tiempo en tránsito
Obtén tiempos en tránsito para los servicios entre el origen y el destino. - Cálculo del tipo de embalaje
El cálculo de volumen proporciona el tipo de embalaje preciso para el envío con base en las dimensiones que especificaste.
Nota:
- Para recibir en la respuesta la FedEx Tarifa Única, debes especificar un Tipo de embalaje FedEx válido (Sobre, pak, caja pequeña, caja mediana, caja grande o caja extragrande) o seleccionar Your_Packaging y proporcionar las dimensiones admisibles, de lo contrario la API solo arrojará las cotizaciones de tarifas de descuento específicas de cuenta.
- Para recibir la FedEx Tarifa Única para un Sobre o Pak, debes especificar el tipo de embalaje como Sobre o Pak, respectivamente.
Cómo funciona la API de tarifa integral y tiempo en tránsito
La API de tarifa integral y tiempo en tránsito lleva a cabo un cálculo de volumen con base en las dimensiones del paquete que proporcionaste para tu embalaje para los tipos de paquetes estándar correspondientes de FedEx (caja mediana, caja grande, etc.,), para determinar si tu paquete es elegible para los servicios de Tarifa Única y proporciona el precio de Tarifa Única junto con las cotizaciones de tarifas de todos los otros servicios aplicables.
Descargo de responsabilidad para remitentes compatibles o cualquier remitente que desea utilizar la Ship API para crear etiquetas de FedEx Tarifa Única: los usuarios deben pasar un tipo de embalaje FedEx FEDEX_ENVELOPE, FEDEX_PAK, FEDEX_EXTRA_SMALL_BOX, FEDEX_SMALL_BOX, FEDEX_MEDIUM_BOX, FEDEX_LARGE_BOX o FEDEX_EXTRA_LARGE_BOX junto con un Indicador de Servicios especiales de FEDEX_ONE_RATE para recibir los precios de Tarifa Única. Ten en cuenta que si la Ship API pasa un tipo de embalaje YOUR_PACKAGING, NO se aplicará la FedEx Tarifa Única. Sin embargo, el cliente recibirá las tarifas específicas de la cuenta. Para obtener más información sobre cómo enviar con FedEx Tarifa Única con la Ship API, consulta la documentación de Ship API o ponte en contacto con tu representante FedEx.
Nota:
- Comportamiento predeterminado: cuando seleccionas el tipo Your_Packaging e ingresas las dimensiones y el peso, la API devuelve la cotización con la tarifa más baja para cada servicio aplicable (por ejemplo, los servicios de FedEx Tarifa Única, FedEx Express, FedEx Ground y Ground Economy).
- Reglas predeterminadas: si se omite el campo rateDisplayOption o se deja en blanco, vacío o nulo, se establece el valor predeterminado LOWER_RATE.
Si deseas obtener todas las cotizaciones posibles (y no solo la tarifa más baja), establece de manera explícita alguno de los siguientes valores para rateDisplayOption en tu solicitud:
- SELECTED_RATES_INCLUDING_F1R: se muestran todas las tarifas aplicables, incluida la de FedEx Tarifa Única (F1R).
- SELECTED_RATES_EXCLUDING_F1R: se muestran todas las tarifas aplicables, excepto la de FedEx Tarifa Única (F1R).
Las condiciones de volumen y peso que se encuentran a continuación se revisan para determinar la elegibilidad de un paquete para FedEx Tarifa Única.
| Tipo de embalaje | Medidas especificadas del paquete |
Cálculo del tipo de embalaje de FedEx que corresponde |
Cotizaciones de tarifas para servicios que se arrojan en respuesta |
|||
Volumen (longitud X ancho X altura) |
Espesor |
Peso |
||||
Su embalaje |
No especificado |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para Caja pequeña y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para Caja mediana y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para Caja grande y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para Caja extragrande y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Envelope |
No especificado |
No especificado |
< 4,53 kg |
FedEx Envelope |
Tarifa Única para FedEx Envelope y otros servicios aplicables |
|
<= 4 916,12 cm cúbicos |
<= 7,62 cm |
<= 4,53 kg |
FedEx Envelope |
Tarifa Única para FedEx Envelope y otros servicios aplicables |
||
<= 4 916,12 cm cúbicos |
> 7,62 y <= 12,7 cm |
<= 4,53 kg |
FedEx Pak |
Tarifa Única para FedEx Pak y otros servicios aplicables |
||
<= 4 916,12 cm cúbicos |
<= 12,7 cm |
> 4,53 y <= 22,6 kg |
FedEx Pak |
Tarifa Única para FedEx Pak y otros servicios aplicables |
||
> 4 916,12 y <= 10 651,6 cm cúbicos |
<= 12,7 cm |
<= 22,6 kg |
FedEx Pak |
Tarifa Única para FedEx Pak y otros servicios aplicables |
||
> 16 y <= 2753 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No especificado |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Pak |
<= 10 651,6 cm cúbicos |
<= 12,7 cm |
<= 22,6 kg |
FedEx Pak |
Tarifa Única para FedEx Pak y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
> 12,7 cm |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No especificado |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Extra Small Box |
No especificado |
No disponible |
< 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Small Box |
No especificado |
No disponible |
< 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Medium Box |
No especificado |
No disponible |
< 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Large Box |
No especificado |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
FedEx Extra Large Box |
No especificado |
No disponible |
< 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
|
> 16 y <= 2753 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Small Box |
Tarifa Única para FedEx Extra Small Box y otros servicios aplicables |
||
> 2753 y <= 6882 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Small Box |
Tarifa Única para FedEx Small Box y otros servicios aplicables |
||
> 6 882.57 y <= 10 651,6 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Medium Box |
Tarifa Única para FedEx Medium Box y otros servicios aplicables |
||
> 10 651,6 <= 18 025,77 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Large Box |
Tarifa Única para FedEx Large Box y otros servicios aplicables |
||
> 18 025,77 y <= 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
FedEx Extra Large Box |
Tarifa Única para FedEx Extra Large Box y otros servicios aplicables |
||
> 36 051,54 cm cúbicos |
No disponible |
<= 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
No especificado |
No disponible |
> 22,6 kg |
Su embalaje |
Todos los servicios aplicables excepto FedEx Tarifa Única |
||
Nota: el grosor se define como la menor medida de longitud, ancho y altura. |
||||||
Comprehensive Rate Quote
Utiliza este extremo para solicitar una lista de todas las posibles cotizaciones de tarifas e información de tránsito opcional con base en los detalles ingresados.
La información que debe ingresarse en relación con esta solicitud es:
- accountNumber: especifica tu información de cuenta.
- returnTransitTimes: especifica si la respuesta debe tener el tiempo en tránsito y la información registrada
- shipper: especifica los datos del remitente, como el código del país, el código postal, etc.
- recipient: especifica los datos del destinatario, como el código del país, el código postal, etc.
- pickupType: especifica el método por el cual el paquete se entrega a FedEx.
Ejemplo CONTACT_FEDEX_TO_SCHEDULE, USE_SCHEDULED_PICKUP. - rateDisplayOption (opcional): controla qué tarifas se devuelven en la respuesta de la API.
- LOWER_RATE: devuelve la tarifa más baja después de comparar la tarifa única (F1R) y las tarifas estándar. Si no se proporcionan dimensiones, solo se devuelve la tarifa de embalaje que suministra el cliente.
- SELECTED_RATES_INCLUDING_F1R: devuelve todas las tarifas aplicables y no se realiza ninguna comparación. Se incluyen la tarifa única y las tarifas estándar.
- SELECTED_RATES_EXCLUDING_F1R: devuelve todas las tarifas aplicables, excepto la tarifa única.
Predeterminado: si se omite el campo o se proporciona un valor no válido, se usa LOWER_RATE.
- peso: especifica el peso del paquete.
- Dimensiones (opcional): especifica la longitud, el ancho la altura y la unidad de medida del paquete.
Nota:
- Para obtener cotizaciones de FedEx Tarifa Única, debes especificar las dimensiones del paquete. Sin las dimensiones, la API devuelve tarifas con descuento o específicas de cuenta solo para otros servicios aplicables.
- Los elementos packagingType y rateDisplayOption son opcionales. Los predeterminados son YOUR_PACKAGING y LOWER_RATE. Puedes cambiarlos a cualquier tipo de opción estándar que se ajuste a tus necesidades de envío.
- Usa el elemento processingOptions para incluir las tarifas de recolección a petición en la respuesta. Selecciona el valor INCLUDE_PICKUPRATES para esta solicitud.
- Usa el campo requestType para obtener cotizaciones de tarifas de recolección para una fecha futura. Selecciona el valor FUTURE_DAY, que completará requestedShipment.pickupDetail.readyDateTime y requestedShipment.pickupDetail.latestPickupDateTime en los detalles de la solicitud.
- La respuesta incluye todas las cotizaciones de tarifas posibles e información de tránsito opcional para servicios aplicables, con códigos de servicio, tipos de servicio, tipos de embalaje y detalles de compromiso (por ejemplo, días y horas en tránsito, entrega los sábados).
- Para valores decimales de longitud, ancho o altura en los servicios web, solo se usa el número entero para calcular las tarifas. Por ejemplo, si se ingresa 9.4, se calculará como 9.
Normas comerciales
- Los envíos de varios paquetes (MPS) no son elegibles para FedEx Tarifa Única.
- Los paquetes que pesan más de 22.6 kg o que tienen un volumen mayor que 36 051.54 cm cúbicos no son elegibles para FedEx Tarifa Única.
- Para obtener una cotización de FedEx Tarifa Única para un Sobre o Pak, especifica el tipo de paquete como Sobre o Pak.
- Cuando utilizas tu propio embalaje, se requieren las dimensiones del paquete para obtener las cotizaciones de FedEx Tarifa Única. Sin las dimensiones, solo se devolverán las tarifas para otros servicios aplicables (excepto la Tarifa Única).
- Si especificas carrierCodes en la solicitud de tarifas, solo se devolverán las tarifas para esos transportistas.
- El límite de tiempo de espera para cualquier solicitud de tarifas es de 6 segundos.
- Las cotizaciones de FedEx Tarifa Única se devuelven incluso si no seleccionas FEDEX_ONE_RATE como specialServiceTypes en la solicitud de tarifas.
- Usa el indicador opcional rateDisplayOption para incluir o excluir las cotizaciones de FedEx Tarifa Única:
- SELECTED_RATES_INCLUDING_F1R
- SELECTED_RATES_EXCLUDING_F1R
- Si falta rateDisplayOption o no es válido, se establece el valor predeterminado LOWER_RATE.
