Introduction
L’API Freight LTL vous permet de créer des envois pour les chargements partiels de camion (LTL). Les envois LTL sont trop volumineux pour être expédiés en tant que colis, mais ne remplissent pas la totalité du chargement d’un camion.
Cela vous permet d’obtenir des estimations de tarifs, de créer des étiquettes d’expédition uniques pour les unités de manutention individuelles et les connaissements (le cas échéant), de planifier les enlèvements, de suivre l’état de l’expédition et de vérifier la disponibilité. Vous gagnez ainsi en efficacité pour vos envois dont le poids et le volume sont plus élevés.
Le service d’expédition LTL de FedEx Freight offre un suivi et une visibilité de chaque unité de manutention pour vos envois d’unités de manutention multiples ainsi que pour les expéditions nationales sans connaissement papier (BOL) dans la plupart des cas. Un connaissement peut être créé si nécessaire. Même si toutes les unités de manutention ont un numéro de suivi unique, l’envoi passe d’un connaissement à un reçu de livraison, puis à un relevé de facture.
Détails de l’API Freight LTL
L’API Freight LTL permet de réaliser des envois en chargement partiel de camion et de créer les documents nécessaires tels que le connaissement (sur demande), les étiquettes d’expédition FedEx Freight et d’autres documents d’expédition divers. Avec les envois Freight LTL, l’étiquette principale est placée sur la première unité de manutention et une étiquette enfant est placée sur la deuxième unité et les suivantes. Si les étiquettes enfants ont leur propre numéro de suivi, elles font toujours référence au numéro de suivi principal. Un seul connaissement peut être créé par envoi et comprend tous les colis et unités de manutention.
Chaque unité de manutention peut être associée à un numéro de suivi et l’étiquette est similaire à une étiquette FedEx Ground ou Express Parcel, à l’exception de la lettre F (désignant un envoi Freight).
Voici le nombre maximal d’unités de manutention et de colis par unité de manutention :
- Nombre maximal de colis par unité de manutention : 9 999
- Nombre maximal d’unités de manutention : 200 (en cas d’impression individuelle des étiquettes d’unité de manutention).
- Nombre maximal d’unités de manutention : 40 (en cas d’impression groupée des étiquettes d’unité de manutention).
Les envois de colis FedEx LTL sont disponibles dans les 50 États ainsi qu’à Porto Rico, aux Îles Vierges américaines, au Canada et au Mexique. Certains envois nécessitent un connaissement en plus des étiquettes d’expédition, comme les envois contenant des matières dangereuses.
FedEx Freight® fait évoluer le secteur du chargement partiel de camion en facilitant l’envoi rapide et économique de colis au sein d’un même réseau LTL rationalisé.
Cette API contient les fonctionnalités suivantes :
- Gérer les enlèvements Freight LTL
Cette fonctionnalité permet d’obtenir les lieux d’enlèvement de colis Freight LTL, de planifier l’enlèvement d’un colis et d’annuler un enlèvement déjà planifié.
- Obtenir un devis Freight LTL
Cette fonctionnalité permet d’obtenir des devis pour un envoi Freight LTL en fonction des lieux et des options de service sélectionnés.
- Créer un envoi Freight LTL
Cette fonctionnalité permet de créer un envoi Freight LTL.
Voici les fonctionnalités de l’API Freight LTL :
- Expédiez une seule pièce ou faites un envoi MPS pour tous les types de services en générant des étiquettes d’expédition ou un connaissement (si nécessaire).
- Créez un envoi contenant plusieurs unités de manutention et suivez chacune d’entre elles.
- Créez des envois LTL à l’aide des services FedEx Freight Priority et Freight Economy.
- Indiquez les informations sur le destinataire telles que le numéro de compte, les coordonnées et l’adresse.
- Indiquez l’horodatage, le type de colis, le poids total et toute autre information nécessaire tel que mentionné dans le schéma du point de terminaison.
- Fournissez à FedEx Label les normes d’une marque et gérez les tailles spécifiées pour les étiquettes thermiques.
- Recevez des notifications par e-mail ou SMS lors de la transaction d’expédition, par exemple :
- Avis d’expédition
- Livraison estimée
- La notification d’enlèvement
- Générez les documents d’expédition, par exemple :
- Étiquettes d’expédition par unité de manutention
- Connaissement
- Facture commerciale
- La déclaration de douane canadienne
- Créez des envois et imprimez des étiquettes pour chaque unité de manutention ou pour toutes à la fois.
- Obtenez les tarifs pour un envoi en un seul colis ou MPS pour tous les types de services.
- Vérifiez la disponibilité de l’enlèvement, planifiez l’enlèvement d’un colis ou annulez un enlèvement.
- Créez et planifiez l’enlèvement avec des comptes tiers pour une autre adresse de facturation.
Services d’expédition Freight LTL
Les services d’expédition Freight LTL disponibles sont les suivants :
FedEx Freight® Priority
Avec des délais de livraison parmi les plus courts et une ponctualité inégalée, FedEx Freight® Priority livre vos colis rapidement et avec fiabilité. Vous pouvez compter sur notre service régional pour proposer une livraison le lendemain ou en deux jours à vos clients, le tout couvert par une garantie de remboursement sans frais. *
Le service FedEx Freight® Priority offre :
- des délais de livraison réduits avec une livraison le lendemain jusqu’à 965 km (600 miles) et une livraison en deux jours jusqu’à 2 570 km (1 600 miles) ;
- une livraison directe vers pratiquement tous les codes postaux aux États-Unis, au Canada et au Mexique ;
- fiabilité et ponctualité ;
- une garantie de remboursement sans frais ;
- une technologie d’information de pointe avec une visibilité sur les envois de bout en bout ;
- une équipe de professionnels dédiée afin de répondre à vos besoins en matière d’envoi de colis régionaux.
* Tous les services sont soumis aux conditions du tarif des règles FXFR 100 Series.
FedEx Freight Economy
FedEx Freight® Economy offre une livraison LTL (en chargement partiel de camion) économique et axée sur vos besoins standard en matière d’expédition de colis. Grâce aux services de livraison FedEx LTL, à notre ponctualité et au soin de notre manutention, le Service Clientèle est assuré.
FedEx Freight® Economy offre :
- des solutions économiques d’envoi de colis ;
- des économies supplémentaires sur les envois dont les délais sont moins stricts, mais devant tout de même bénéficier d’une livraison fiable ;
- fiabilité et ponctualité ;
- une livraison directe vers pratiquement tous les codes postaux aux États-Unis, au Canada, au Mexique et à Porto Rico ;
- une technologie d’information de pointe avec une visibilité sur les envois de bout en bout ;
- une meilleure visibilité avec un suivi de l’envoi de bout de bout.
Fonctionnement de l’API Freight LTL
Cette section décrit les points de terminaison et les éléments clés requis pour l’API FedEx Freight LTL.
Remarque : votre compte FedEx Freight LTL doit être activé pour utiliser l’API FedEx Freight LTL. Les principales informations requises sont le(s) numéro(s) de compte FedEx Freight et l’adresse de correspondance correcte pour que le compte puisse traiter les envois LTL.
Cette API contient les points de terminaisons suivants :
Envoi Freight LTL
Ce point de terminaison vous permet de valider et de créer l’envoi FedEx Freight LTL.
Voici les informations d’entrée requises pour cette requête :
- Numéro de compte Freight
- Adresse de correspondance du compte
- Envoi Freight concerné par la demande
- Options de réponse d’étiquette ; étiquettes à renvoyer telles qu’encodées ou sous forme d’URL
- Détails de suivi principaux : dans ce cas uniquement, l’envoi MPS doit être traité et les étiquettes doivent être imprimées individuellement plutôt qu’en une seule fois (lorsque l’élément singleShotMPS n’est pas fourni ou présent avec la valeur false).
Une réponse sans erreur à cette requête crée l’envoi LTL et obtient les détails du suivi et de l’alerte dans la réponse. Elle renvoie également des erreurs et leur description en cas d’échec.
Remarque : l’adresse de correspondance peut être différente de l’adresse d’expédition.
Vérifier la disponibilité pour l’enlèvement Freight LTL
Ce point de terminaison vous permet de demander une liste complète des points d’enlèvement de colis, avec les informations de planification de l’enlèvement telles que le transporteur, la dernière heure de disponibilité pour enlèvement, l’heure limite de disponibilité par défaut, la disponibilité pour enlèvement, l’heure à laquelle le colis est prêt à être enlevé, l’information indiquant si l’adresse est résidentielle, l’heure limite de l’enlèvement et l’accès du chauffeur pour enlever le colis.
Voici les informations d’entrée requises pour cette requête :
- Adresse d’enlèvement/coordonnées postales.
- Type de demande d’enlèvement (p. ex. : même jour/jour ultérieur).
- Enlèvement international/national.
Remarque : utilisez une adresse d’enlèvement correcte et valide.
Une demande sans erreur renvoie dans la réponse une liste de tous les lieux d’enlèvement disponibles, le jour de livraison, la disponibilité (indicateur), la date d’enlèvement, l’heure limite d’enlèvement, l’heure d’accès, la disponibilité en résidence (indicateur), l’heure de fermeture (indicateur) et l’heure locale. Elle renvoie également des erreurs et leur description en cas d’échec.
Créer un enlèvement Freight LTL
Utilisez ce point de terminaison pour créer et planifier un enlèvement Freight LTL.
Voici les informations d’entrée requises pour cette requête :
- Numéro de compte Freight, auquel l’enlèvement sera facturé.
- Détails de l’emplacement d’origine (adresse, emplacement et type d’adresse d’enlèvement tel que compte/expéditeur/autre).
- Détails de l’adresse pour le compte associé.
Une demande d’enlèvement sans erreur renvoie un numéro de confirmation d’enlèvement, une notification d’enlèvement et un code d’emplacement pour l’enlèvement planifié. Elle renvoie également des erreurs et leur description en cas d’échec.
Remarque : Utilisez une adresse correcte et valide pour l’enlèvement, et indiquez également une adresse de compte répertoriée correcte pour planifier l’enlèvement. Ne saisissez pas une heure de disponibilité passée, une date passée ou une date trop éloignée dans le futur pour planifier un enlèvement. Les enlèvements anonymes ne sont pas autorisés. Vous pouvez planifier l’enlèvement pour des comptes tiers en renseignant les informations relatives à une autre adresse valide.
Annuler un enlèvement Freight LTL
Ce point de terminaison vous permet d’annuler une demande d’enlèvement de colis LTL déjà planifiée. Une annulation d’enlèvement sans erreur renvoie un numéro de confirmation et un message de confirmation d’annulation de l’enlèvement.
Voici les informations d’entrée requises pour cette requête :
- Code de confirmation d’enlèvement (obtenu lors de l’envoi d’une demande d’enlèvement)
- Date prévue (date à laquelle l’enlèvement doit avoir lieu)
- Emplacement (emplacement FedEx Express responsable du traitement de la demande d’enlèvement)
Une requête sans erreur renvoie un numéro de confirmation d’enlèvement, une notification d’enlèvement et un code d’emplacement pour l’enlèvement planifié. Elle renvoie également des erreurs et leur description en cas d’échec.
Remarque : envoyez le code de confirmation d’enlèvement et le code d’emplacement correspondant (concerne uniquement FDXE) pour annuler l’enlèvement planifié. Le numéro de confirmation d’enlèvement et le code d’emplacement correspondant (concerne uniquement FDXE) s’obtiennent lors de l’envoi d’une demande d’enlèvement. Indiquez également une adresse répertoriée correcte pour annuler l’enlèvement. Vous recevrez une notification d’échec si vous tentez d’annuler un enlèvement après que le coursier FedEx a été dépêché au lieu d’enlèvement.
Tarifs Freight LTL
Ce point de terminaison vous permet de demander une liste de tous les devis et délais de livraison de fret possibles en fonction des informations saisies. Les tarifs obtenus dépendent de l’origine, de la destination et d’autres informations à propos de l’envoi. D’autres informations telles que le code de transporteur, le type de service ou les options de service peuvent être utilisées pour affiner les résultats.
Voici les informations d’entrée requises pour cette requête :
- Numéro de compte Freight
- Envoi Freight concerné par la demande
Une demande sans erreur renvoie une liste de tous les tarifs possibles et le code d’emplacement pour l’enlèvement planifié. Elle renvoie également des erreurs et leur description en cas d’échec.
Envoi multi-colis (MPS) Freight LTL
Un envoi multicolis (EMC) se compose d’au moins deux unités de manutention expédiées vers une adresse de destination identique. La première unité de manutention de la demande d’envoi est considérée comme étant l’élément principal.
Pour créer un envoi multi-colis :
- Incluez les informations sur le niveau de l’envoi telles que serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail et les informations requestedPackageLineItems. (Remarque : la valeur sequenceNumber du colis principal doit être égale à 1).
- Pour imprimer l’étiquette de chaque unité de manutention, incluez les informations du suivi principal dans l’élément masterTrackingId pour toutes les unités de manutention suivantes.
Cette API contient les options de traitement des envois multi-colis suivants :
Imprimer une étiquette de l’unité de manutention à la fois
Cette API vous permet de traiter les envois EMC et de générer chaque étiquette individuellement.
Si vous avez besoin de cette fonctionnalité pour vos envois ainsi que de tous les éléments MPS nécessaires, définissez l’élément oneLabelAtATime sur true dans la requête.
La première requête doit aboutir à la génération d’une étiquette et d’un numéro de suivi (le numéro de suivi principal). Indiquez ce numéro de suivi principal dans l’élément masterTrackingId pour traiter la requête d’envoi suivante et générer les étiquettes avec les numéros de suivi (appelés sous-numéros de suivi) pour le nombre total de colis définis (totalPackageCount).
Remarque : le nombre maximal d’unités de manutention est de 200.
Imprimer les étiquettes de toutes les unités de manutention simultanément
Cette API vous permet de traiter les envois EMC et de générer les étiquettes en une seule fois. Il s’agit d’une des méthodes de traitement les plus efficaces, qui est utilisée lorsqu’un envoi comprend 40 unités de manutention ou moins (totalPackageCount<=40) devant être livrées à la même adresse de destination.
Définissez oneLabelAtATime sur false dans la demande d’envoi de 40 unités de manutention ou moins et générez les étiquettes instantanément.
Remarque : la limite de 40 unités de manutention est donnée à titre indicatif et n’est pas une limite fixe. Elle dépend également de la combinaison entre le nombre d’unités de manutention et les articles. Pour plus d’informations à ce sujet, contactez votre responsable commercial FedEx.
Exemple : votre demande d’envoi comporte 10 unités de manutention, ce qui générera 10 étiquettes lors de sa soumission, et les URL d’étiquettes ou étiquettes encodées requises seront indiquées dans la réponse.
FedEx Freight Direct
Ce service fournit une expérience client de qualité pour la livraison de marchandises volumineuses et sur palettes, et comprend la livraison d’envois lourds et volumineux au domicile ou dans les entreprises des clients.
Le service offre des options comme la communication proactive, des options de livraison flexible et des prix groupés qui incluent plusieurs suppléments.
Les fonctionnalités suivantes sont incluses dans ce service :
- La possibilité de créer des envois FedEx Freight Direct basiques, basiques sur rendez-vous, avec livraison standard et premium ainsi que les retours/enlèvements des envois basiques aux États-Unis, en Alaska et à Hawaï.
- La possibilité d’obtenir un devis complet pour un envoi FedEx Freight Direct en utilisant un numéro de compte FedEx Freight Direct et la possibilité d’annuler un enlèvement FedEx Freight Direct.
- Les estimations de tarifs ne seront pas renvoyées pour l’Alaska et Hawaï. Les clients doivent appeler le Service Clientèle de FedEx et demander un devis pour ces États.
- Pour annuler un enlèvement planifié le même jour, le client doit appeler le service Clientèle FedEx.
- La possibilité d’envoyer des notifications par e-mail à l’expéditeur/au destinataire de base pour que le client puisse :
- Planifier une livraison ;
- Recevoir la confirmation de livraison et/ou d’enlèvement ;
- Recevoir des notifications lorsque le colis est en cours de livraison et/ou d’enlèvement ;
- Recevoir des notifications lorsque le colis est en transit ;
- Enquêter auprès des clients pour les envois livrés.
- Les règles commerciales concernant la validation du code postal, les dimensions, le poids du colis et le poids de l’unité de manutention s’appliqueront à FedEx Freight Direct pour déterminer la combinaison correcte des services de transport de ligne et de premiers/derniers kilomètres.
FedEx Freight Direct offre différents types de service au choix.
Cette API offre les fonctionnalités suivantes grâce au service Freight Direct :
Obtenir les tarifs Freight Direct
Utiliser ce point de terminaison pour obtenir les tarifs et suppléments Freight Direct des options de service Freight Direct spéciales suivantes : service basique, service basique sur rdv, service standard et service premium.
Les informations suivantes doivent être accompagnées de la demande de tarif en utilisant le point de terminaison Tarifs Freight LTL :
- Type de Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD) ;
- Type de transport Freight Direct (DELIVERY, PICKUP) ;
- Type de numéro de téléphone s’il est fourni (HOME, MOBILE, WORK) ;
- Poids
- Dimensions (longueur, largeur et hauteur non négatives).
Créer des envois Freight Direct
Utilisez ce point de terminaison pour expédier un envoi comprenant un ou plusieurs colis pour les options de service Freight Direct spéciales service basique, service basique sur rdv, service standard, service premium, et pour obtenir une étiquette d’expédition ou le connaissement, y compris la documentation nécessaire pour traiter les envois Freight Priority.
Les informations suivantes doivent être accompagnées de la demande d’envoi via le point de terminaison Envoi Freight LTL :
- Type de Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD) ;
- Type de transport Freight Direct (DELIVERY, PICKUP) ;
- Adresse e-mail, numéro de téléphone et type de téléphone ;
- Poids
- Dimensions (longueur, largeur et hauteur non négatives).
Les noms des nouveaux services de Freight Direct seront imprimés sur le connaissement de sortie. Les valeurs suivantes sont imprimées sur le connaissement en fonction de la sélection du service :
- DIRECT BASIC DELIVERY
- DIRECT BASIC BY APPOINTMENT DELIVERY
- DIRECT PREMIUM DELIVERY
- DIRECT STANDARD DELIVERY
- DIRECT BASIC PICKUP
- DIRECT BASIC BY APPOINTMENT PICKUP
- DIRECT PREMIUM PICKUP
- DIRECT STANDARD PICKUP
Enlèvement Freight Direct
Utilisez ce point de terminaison pour vérifier la disponibilité du service d’enlèvement de fret LTL Freight Direct, créer une demande d’enlèvement pour un colis ou annuler une demande d’enlèvement existante.
Les informations suivantes doivent être accompagnées de la demande d’enlèvement en utilisant le point de terminaison Vérifier la disponibilité d’enlèvement Freight LTL, créer un enlèvement Freight LTL et annuler un enlèvement Freight LTL.
- Type de Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD) ;
- Type de transport Freight Direct (DELIVERY, PICKUP) ;
- Adresse e-mail (créer une demande d’enlèvement) ;
- Numéro de téléphone et type de téléphone (créer une demande d’enlèvement) ;
- Poids
Règles commerciales
- Un numéro de suivi principal (Pro) est attribué à la première unité de manutention d’un envoi Freight LTL et des numéros secondaires sont attribués aux unités suivantes.
- Les unités de manutention de l’envoi peuvent être suivies individuellement ou d’un bloc.
- D’autres documents peuvent être requis pour certains envois (par exemple, les envois internationaux ou ceux contenant des matières dangereuses [HazMat]) ;
- Seuls les comptes Fret LTL et Facturation au fret LTL peuvent être ajoutés au FedEx Developer Portal.
- Le client peut utiliser soit le numéro de compte LTL à long terme, soit le numéro de compte FedEx Freight Direct pour utiliser les services Freight Direct ;
- Les fonctionnalités de tarification FedEx Freight Direct sont seulement disponibles dans les API LTL habituelles ;
- L’ensemble des nouvelles erreurs ou des nouveaux messages seront uniquement en anglais ;
- Adresse e-mail et numéro de téléphone requis dans le cadre de la demande d’option de service FedEx Freight Direct lors de la création d’envois.
Collection d’API JSON
Response