Introducción
La API para Freight LTL le permite crear envíos inferiores a una camionada (LTL). La carga LTL es demasiado grande para ser enviada como un paquete, pero ocupa menos que un camión entero.
Esto le permite obtener tarifas estimadas, crear etiquetas únicas de envío para las unidades de manipulación individuales y conocimientos de embarque (BOL) (si se requiere), programar recolecciones y rastrear los estados del envío, verificar la disponibilidad de y programar recolecciones. Esto resulta en una mayor eficiencia para sus envíos más grandes y pesados.
El envío LTL en FedEx Freight ofrece rastreo a nivel de unidades de manejo y visibilidad para sus envíos unitarios de manipulación múltiple, así como envíos nacionales sin conocimiento de embarque (BOL) en la mayoría de los casos. Se puede crear un conocimiento de embarque cuando se requiera. Aunque todas las unidades de manejo tienen un número de rastreo único, el envío se mueve en un conocimiento de embarque, un recibo de entrega y una declaración de factura.
Detalles de la API para Freight LTL
La API para Freight LTL permite realizar los envíos LTL y crea los documentos necesarios, como el conocimiento de embarque (cuando se requiere), las etiquetas de envío de FedEx Freight y varios otros documentos de envío. En la etiqueta principal del envío Freight LTL va la primera unidad de manejo y la etiqueta secundaria que se aplica a la segunda y subsecuentes unidades de manejo. Las etiquetas secundarias tienen su propio número de rastreo único, pero se refieren al número de rastreo principal. Se puede crear un solo conocimiento de embarque por envío que consta de todas las unidades y piezas de manejo.
Cada unidad de manejo se puede asociar a un número de rastreo y la etiqueta es similar a una etiqueta de FedEx Ground o paquete Express, a excepción de una F, que representa un envío de carga.
Cantidades máximas para las unidades y piezas de manejo por unidades de manejo:
- El número máximo de piezas por límite de unidad de manejo: 9 999
- Unidades máximas de manipulación: 200 (al imprimir las etiquetas de las unidades de manipulación de una en una)
- Unidades máximas de manejo: 40 (al imprimir las etiquetas de las unidades de manejo a la vez)
Los envíos Freight LTL de FedEx están disponibles en los 50 estados, así como en Puerto Rico, las Islas Vírgenes de los Estados Unidos, Canadá y México. Algunos envíos requieren un conocimiento de embarque además de las etiquetas de envío. Un ejemplo de estos envíos son los que contienen materiales peligrosos.
FedEx Freight® está cambiando la industria de LTL al facilitar el envío de mercancías de forma rápida y económica dentro de una red LTL estandarizada.
Las siguientes son las funciones disponibles con esta API:
- Gestione recolecciones de Freight LTL
Esta característica permite obtener las ubicaciones de recolección de carga LTL, programar una recolección de carga y cancelar cualquier recolección ya programada.
- Obtenga cotizaciones de tarifas de Freight LTL
Esta característica permite obtener las tarifas estimadas para un envío de carga LTL según las ubicaciones y las opciones de servicio seleccionadas.
- Envíe un envío Freight LTL
Esta característica permite crear un envío de carga LTL.
Las siguientes son las características de la API Freight LTL:
- Haga un envío de una sola pieza o de varios paquetes (MPS) para todos los tipos de servicio, generando así etiqueta(s) de envío o un conocimiento de embarque (si se requiere).
- Cree un envío de varias unidades de manejo y rastree cada unidad de manejo de manera individual.
- Cree envíos LTL para utilizar los servicios de FedEx Freight Priority y Freight Economy.
- Proporcione la información del destinatario, como el número de cuenta, el contacto y la dirección.
- Proporcione el sello de hora, el tipo de embalaje, el peso total y varios otros detalles requeridos como se menciona en el esquema del extremo.
- Proporcione una marca estándar a la etiqueta de FedEx y establezca tamaños especificados para las etiquetas térmicas.
- Reciba notificaciones por correo electrónico o texto SMS durante la transacción de envío como:
- Notificación de envío
- Fecha de entrega estimada
- Notificaciones de recolección
- Genere documentos de envío como:
- Etiquetas de envío de unidades de manejo individual
- Conocimiento de embarque
- Factura comercial
- Factura de aduana canadiense
- Cree envíos e imprima etiquetas para una unidad de manejo a la vez o procese todas las unidades de manejo de una sola vez.
- Recupere las tarifas de una sola pieza o de un envío MPS para todos los tipos de servicio.
- Compruebe la disponibilidad para la recolección, programe una recolección de carga y cancele una recolección.
- Crea y programa una recolección con cuentas de terceros para una dirección de facturación alternativa.
Servicios de envío de Freight LTL
Los siguientes servicios de envío de Freight LTL están disponibles:
FedEx Freight® Priority
Con un rendimiento líder de la industria en cuanto a puntualidad de entrega y tiempos de tránsito rápidos, FedEx Freight® Priority entrega sus envíos de manera rápida y confiable. Cuente con nuestro servicio regional para una amplia entrega al día siguiente y al segundo día a sus clientes, todo ello respaldado por una garantía de devolución de dinero que no tiene costo. *
Características del servicio de FedEx Freight® Priority:
- Tiempos en tránsito rápidos con servicio al día siguiente hasta 965,6 km y servicio al segundo día hasta 2 575 km.
- Entrega directa a prácticamente todos los códigos postales en EE. UU., Canadá y México.
- Confiabilidad consistente y puntual
- Garantía de devolución de dinero sin costo*
- Tecnología informática de vanguardia con visibilidad del envío de extremo a extremo
- Un equipo exclusivo de profesionales para ayudarle con todas sus necesidades de carga regional
*Todos los servicios están sujetos a los términos y condiciones de la Tarifa para las normas de la Serie FXFR 100.
FedEx Freight Economy
FedEx Freight® Economy ofrece una entrega LTL (inferior a una camionada) económica y centrada en sus necesidades básicas de envío de carga. Gracias a los servicios de entrega de FedEx LTL, con la confiabilidad puntual y la manipulación cuidadosa, el servicio al cliente se logra de manera adecuada.
FedEx Freight® Economy brinda:
- Soluciones de flete económicas
- Mayor ahorro en los envíos que son menos urgentes, pero que necesitan una entrega confiable
- Confiabilidad consistente y puntual
- Entrega directa a prácticamente todos los códigos postales en EE. UU., Canadá, México y Puerto Rico.
- Tecnología informática de vanguardia con visibilidad del envío de extremo a extremo
- Visibilidad mejorada con el rastreo de envíos de extremo a extremo
Cómo funciona la API para Freight LTL
Esta sección describe los extremos y los elementos clave necesarios para la API para Freight LTL de FedEx .
Nota: su cuenta Freight LTL de FedEx debe estar habilitada para usar la API FedEx Freight LTL. La información clave requerida es el número (o los números) de cuenta de FedEx Freight y la dirección postal correcta de la cuenta para procesar los envíos LTL.
Los siguientes son los extremos disponibles con esta API:
Envío Freight LTL
Utilice este punto extremo para validar y crear el envío de carga LTL de FedEx.
La información que debe ingresarse en relación con esta solicitud es:
- Número de cuenta Freight
- Dirección postal de la cuenta
- Envío solicitado de carga
- Opciones de respuesta de la etiqueta: etiquetas que se devolverán codificadas o como URL.
- Detalles del rastreo principal: sólo en caso de que el envío MPS se deba procesar y las etiquetas se deban imprimir una a la vez y no todas a la vez (cuando no se proporciona el elemento singleShotMPS o se agrega con el valor falso).
Una respuesta satisfactoria a esta solicitud crea un envío LTL, proporciona detalles de rastreo y detalles de alerta en la respuesta. También arroja errores y las descripciones en caso de cualquier falla.
Nota: La dirección postal puede ser diferente a la dirección real de envío.
Verificar la disponibilidad de recolección de Freight LTL
Utilice este extremo para solicitar una lista de todas las ubicaciones de recolección disponibles con los detalles de programación de recolección, como el transportista, último horario de recolección disponible, último horario disponible predeterminado, disponibilidad para recolección, hora en que el paquete estará listo para su recolección, indicación si la dirección es residencial, hora de cierre de la recolección, y acceso al conductor para recolectar el paquete.
La información que debe ingresarse en relación con esta solicitud es:
- Detalles de dirección y código postal de la recolección.
- Tipo de solicitud de recolección (ejemplo: mismo día u otro día).
- Si sea una recolección nacional o internacional o no.
Nota: Utilice una dirección de recolección correcta y válida.
Una respuesta exitosa a esta solicitud proporcionará una lista de todos las ubicaciones de recolección de carga disponibles, día de entrega, disponibilidad (indicador), fecha de recolección, hora de corte, hora de acceso, disponibilidad residencial (indicador), hora de cierre (indicador), hora de cierre y hora local en la respuesta. También arroja errores y las descripciones en caso de cualquier falla.
Crear una recolección de Freight LTL
Utilice este extremo para crear y programar una recolección de Freight LTL.
La información que debe ingresarse en relación con esta solicitud es:
- Número de cuenta Freight, que se facturará para la recolección.
- Detalles de origen (dirección, ubicación y tipo de dirección de recolección como cuenta, remitente, u otro).
- Detalles de la dirección de la cuenta asociada.
La solicitud de recolección exitosa arrojará un número de confirmación de recolección, notificación de recolección y código de ubicación para la recolección programada. También arroja errores y las descripciones en caso de cualquier falla.
Nota: usa una dirección correcta y válida para la recolección y también proporciona la dirección correcta de la cuenta del registro a fin de programar la recolección. No debes ingresar una hora en la que estará listo el paquete que ya haya pasado, una fecha pasada ni una fecha que esté demasiado lejos en el futuro para programar una recolección. No se permiten las recolecciones anónimas. Puedes programar una recolección para cuentas de terceros al proporcionar detalles válidos de dirección.
Cancelar la recolección de Freight LTL
Utilice este extremo para cancelar una solicitud de recolección ya programada para un paquete LTL. La cancelación de recolección exitosa arrojará un número de confirmación y un mensaje de confirmación de la cancelación de recolección.
La información que debe ingresarse en relación con esta solicitud es:
- Código de confirmación de recolección (se obtiene al enviar una solicitud de recolección)
- Fecha programada (fecha en que se produce el envío)
- Ubicación (Ubicación de FedEx Express responsable de procesar la solicitud de recolección)
La solicitud de recolección exitosa arrojará un número de confirmación de recolección, notificación de recolección y código de ubicación para la recolección programada. También arroja errores y las descripciones en caso de cualquier falla.
Nota: ingrese el número de confirmación de recolección y el código de ubicación correspondiente (solo aplica a FDXE) para cancelar la recolección programada. El número de confirmación de recolección y la información de su código de ubicación correspondiente (solo aplica a FDXE) se obtienen cuando se envía una solicitud de recolección. También use la dirección correcta de la cuenta del registro para cancelar la recolección. Se enviará una notificación de error si intenta cancelar una recolección después de que el transportista haya sido despachado a la ubicación de la recolección.
Tarifa de Freight LTL
Utilice este extremo para solicitar una lista de todas las posibles cotizaciones de tarifas Freight e información de tránsito opcional basada en los detalles ingresados. Las tarifas recuperadas se basan en el origen, el destino y otras entradas en el envío. Se puede utilizar información adicional, como el código del transportista, el tipo de servicio o la opción de servicio, para obtener resultados más precisos.
La información que debe ingresarse en relación con esta solicitud es:
- Número de cuenta Freight
- Envío solicitado de carga.
La respuesta exitosa a esta solicitud devolverá la lista de todas las tarifas posibles y el código de ubicación para la recolección que se está programando. También arroja errores y las descripciones en caso de cualquier falla.
Envío de varias piezas (MPS) de Freight LTL
Un envío de varias piezas (MPS) consiste en dos o más unidades de manipulación enviadas a la misma dirección de destino. La primera unidad de manipulación en la solicitud de envío se considera la principal.
Para crear un envío de varias piezas:
- Incluya la información de nivel de envío, como serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail y detalles requestedPackageLineItems. [Nota: El sequenceNumber para el paquete principal debe ser igual a 1].
- Para imprimir una etiqueta por unidad de manejo, incluye los detalles de rastreo principales en el elemento masterTrackingId para todas las unidades de manejo subsecuentes.
Las siguientes son las opciones de procesamiento de envíos de varias piezas disponibles con esta API:
Imprimir la etiqueta de la unidad de manipulación una a la vez
Esta API te permite procesar los envíos MPS y obtener las etiquetas una a la vez.
Cuando necesite esta capacidad para sus envíos, junto con todos los elementos MPS necesarios, proporcione el elemento oneLabelAtATime como verdadero en la solicitud.
La salida de la primera solicitud debe generar la etiqueta y el número de rastreo que es el número de rastreo principal. Proporcione este número de rastreo principal en el elemento masterTrackingId para procesar la solicitud de envío subsiguiente y generar etiquetas con números de rastreo (números de rastreo secundarios) para el conteo total de paquetes definido (totalPackageCount).
Nota: El máximo de unidades de manejo que se permite es de 200.
Imprimir todas las etiquetas de las unidades de manipulación a la vez
Esta API te permite procesar los envíos de MPS y obtener etiquetas de una sola vez. Este es uno de los métodos de procesamiento ideales, que se utiliza cuando un envío tiene 40 o menos unidades de manejo (totalPackageCount<= 40) con destino a la misma dirección de destinatario en el envío.
Establece oneLabelAtATime as falso en la solicitud de envío con 40 o menos unidades de manejo y genera las etiquetas en el mismo instante.
Nota: el límite máximo de 40 unidades de manejo es indicativo y no es un límite fijo. El límite también depende de la combinación del número de unidades de manejo y de las mercancías. Comunícate con tu ejecutivo de FedEx para obtener más información al respecto.
Ejemplo: Tu solicitud de envío consta de 10 unidades de manejo, cuando se envíe generará 10 etiquetas y en la respuesta se proporcionarán las URL de las etiquetas o las etiquetas codificadas que se hayan solicitado.
FedEx Freight Direct
Este servicio proporciona una experiencia superior al cliente para la entrega de mercancías grandes y en paletas, incluida la entrega de envíos pesados y voluminosos en el interior de hogares o negocios.
Este servicio ofrece opciones como comunicaciones proactivas, opciones flexibles de entrega y precios agrupados que incluyen algunos recargos.
A continuación se encuentran algunas de las funciones incluidas en este servicio:
- Permite la creación de envíos básicos, básicos mediante cita, entrega estándar y premium de FedEx Freight Direct y devolución de envíos básicos y recolecciones dentro de Estados Unidos continental, Alaska y Hawái.
- Incluye la posibilidad de obtener una tarifa estimada completa para un envío de FedEx Freight Direct usando el número de cuenta de FedEx Freight Direct y la posibilidad de cancelar una recolección de FedEx Freight Direct.
- No se devolverán estimados de tarifas para Alaska y Hawái. Los clientes deben llamar al servicio al cliente de FedEx para solicitar una cotización para estos estados.
- Para cancelar una recolección para el mismo día, el cliente debe llamar a servicio al cliente de FedEx.
- Te permite enviar notificaciones por correo electrónico al remitente o destinatario original, así que el cliente podrá:
- Programar una entrega
- Recibir la confirmación de una entrega o una recolección
- Recibir la notificación de listo para la entrega o de recolección
- Recibir notificaciones de en la ruta
- Encuesta al cliente sobre envíos entregados
- Las reglas comerciales de validación de código postal, dimensiones, peso de la pieza y peso de la unidad de manejo se aplicarán a FedEx Freight Direct para determinar la combinación correcta de líneas de transporte y los servicios de primera y última milla.
FedEx Freight Direct ofrece diferentes tipos de servicio entre los que se puede escoger.
Esta API ofrece las siguientes funciones con el servicio de Freight Direct:
Obtener las tarifas de Freight Direct
Utiliza este extremo para obtener las tarifas de Freight Direct y los recargos por las siguientes opciones de servicio de Freight Direct: Servicio básico, servicio básico por cita, servicio estándar y servicio premium.
A continuación encontrarás los detalles que es obligatorio acompañar a la solicitud de tarifas usando el extremo Tarifas de Freight LTL:
- Tipo de Freight Direct (BÁSICO, BASIC_BY_APPOINTMENT, PREMIUM, ESTÁNDAR)
- Tipo de transporte Freight Direct (ENTREGA, RECOLECCIÓN)
- Tipo de número de teléfono si se proporciona un número de teléfono (HOGAR, MÓVIL, TRABAJO)
- Peso
- Dimensiones (Longitud, ancho y altura no negativos)
Crear un envío Freight Direct
Utiliza este extremo para enviar una sola pieza o un envío de varias piezas con las siguientes opciones especiales de servicio Freight Direct: Servicio básico, servicio básico por cita, servicio estándar y servicio premium, y obtén una etiqueta de envío o conocimiento de embarque, junto con la documentación requerida para procesar envíos de Freight Priority.
A continuación encontrarás los detalles que es obligatorio acompañar a la solicitud de envío mediante el extremo Enviar Freight LTL:
- Tipo de Freight Direct (BÁSICO, BASIC_BY_APPOINTMENT, PREMIUM, ESTÁNDAR)
- Tipo de transporte Freight Direct (ENTREGA, RECOLECCIÓN)
- Dirección de correo electrónico, número de teléfono y tipo de teléfono
- Peso
- Dimensiones (Longitud, ancho y altura no negativos)
El conocimiento de embarque que se genera tendrá impresos los nombres del nuevo servicio de Freight Direct. A continuación encontrarás los datos que se imprimen en el conocimiento de embarque dependiendo de la selección del servicio:
- ENTREGA BÁSICA DIRECT
- ENTREGA BÁSICA POR CITA DIRECT
- ENTREGA PREMIUM DIRECT
- ENTREGA ESTÁNDAR DIRECT
- RECOLECCIÓN BÁSICA DIRECT
- RECOLECCIÓN BÁSICA POR CITA DIRECT
- RECOLECCIÓN PREMIUM DIRECT
- RECOLECCIÓN ESTÁNDAR DIRECT
Recolección de Freight Direct
Usa este extremo para revisar la disponibilidad de los servicios de recolección, creación de una solicitud de recolección de un paquete o cancelación de una solicitud de recolección existente de Freight LTL Freight Direct.
A continuación encontrarás los detalles que es obligatorio acompañar a la solicitud de recolección usando el extremo Revisar la disponibilidad de recolección de Freight LTL, crear recolección de Freight LTL y cancelar recolección de Freight LTL.
- Tipo de Freight Direct (BÁSICO, BASIC_BY_APPOINTMENT, PREMIUM, ESTÁNDAR)
- Tipo de transporte Freight Direct (ENTREGA, RECOLECCIÓN)
- Dirección de correo electrónico (Crear solicitud de recolección)
- Número de teléfono y tipo de teléfono (Crear solicitud de recolección)
- Peso
Normas comerciales
- Se asigna un número de rastreo principal (Pro) a la primera unidad de manejo del envío de Freight LTL y se asignan números secundarios de rastreo a cada unidad de manejo subsecuente.
- Cada unidad de manejo en el envío se puede rastrear de manera individual o como parte de un envío completo.
- Se pueden aplicar otros documentos a envíos específicos (por ejemplo, materiales peligrosos de carga [HazMat] y envíos internacionales).
- Las cuentas de solo Carga inferior a una camionada (LTL) y Facturar por carga LTL no se pueden agregar al FedEx Developer Portal.
- El cliente puede usar el número de cuenta único a largo plazo de LTL o el número de cuenta de FedEx Freight Direct para usar los servicios de Freight Direct.
- La capacidad de ofrecer tarifas de FedEx Freight Direct solo está disponible en la API regular de LTL.
- Todos los errores o mensajes estarán en idioma inglés únicamente.
- La dirección de correo electrónico y el teléfono son obligatorios como parte de la opción de solicitud de servicio de FedEx Freight Direct al crear envíos.
Colección de JSON de la API
Response