Введение
API Freight LTL позволяет создавать сборные грузы (LTL). Сборные грузовые отправления слишком велики, чтобы оформлять их как посылку, но занимают не весь грузовик.
API позволяет рассчитывать тарифы, формировать уникальные транспортные этикетки для отдельных единиц обработки и коносаменты (при необходимости), планировать забор и отслеживать статус отправлений, проверять доступность пунктов забора и график их работы, что повышает эффективность работы с габаритными и тяжелыми грузами.
Отправка сборных грузов службой FedEx Freight позволяет отслеживать и просматривать составные отправления на уровне отдельных единиц обработки, а большинство внутренних посылок можно отправлять без распечатанных коносаментов. При необходимости коносамент можно составить. Несмотря на то, что все единицы обработки имеют уникальный номер для отслеживания, отправление перевозится по одному коносаменту, квитанции о доставке и счету-фактуре.
Сведения об API Freight LTL
API Freight LTL позволяет отправлять сборные грузы и формировать необходимые документы, такие как коносамент (по необходимости), транспортные этикетки FedEx Freight и другие транспортные документы. При отправке сборных грузов основная этикетка наклеивается на первую единицу обработки, а на все остальные — дополнительные этикетки. Каждая дополнительная этикетка имеет свой собственный уникальный номер отслеживания, но содержит также ссылку на номер отслеживания головного места. Для отправления, состоящего из нескольких единиц обработки и мест, можно сформировать один коносамент.
Каждая единица обработки привязывается к номеру отслеживания и снабжается такой же этикеткой, как посылки FedEx Ground или FedEx Express, кроме F, что означает грузовое отправление.
Максимальное количество единиц обработки и мест на единицу обработки:
- максимальное количество мест на единицу обработки — 9999;
- Максимальное количество обрабатываемых единиц: 200 (при печати транспортных этикеток по одной).
- Максимальное количество обрабатываемых единиц: 40 (при печати всех транспортных этикеток сразу).
Сборные грузы можно отправлять службами FedEx во все 50 штатов, а также в Пуэрто-Рико, на Американские Виргинские острова, в Канаду и Мексику. Для некоторых отправлений помимо транспортных этикеток требуется коносамент, например, для посылок с опасными материалами.
FedEx Freight® меняет сферу перевозок сборных грузов, позволяя легко, быстро и недорого отправлять сборные грузы через единую эффективную сеть.
Функции, доступные в этом API:
- Управление забором сборных грузов
Эта функция позволяет получить список мест, где принимают сборные грузы, запланировать забор груза и отменить уже запланированный забор.
- Получение тарифов на сборное грузовое отправление
Эта функция позволяет получить тарифы на сборные грузы в зависимости от местонахождения и выбранных услуг.
- Отправка сборного груза
Эта функция позволяет создать сборное грузовое отправление.
API Freight LTL предоставляет следующие возможности:
- Отправка одноместного или многоместного отправления с использованием любых типов услуг и, соответственно, создание транспортных этикеток и коносамента (при необходимости).
- Создание отправления с несколькими единицами обработки и отслеживание каждой единицы обработки отдельно.
- Создание сборных грузов для отправки службами FedEx Freight Priority и Freight Economy.
- Указание информации о получателе, такой как номер счета, контактные данные и адрес.
- Указание времени отправки, типа упаковки, общего веса и других необходимых данных, предусмотренных схемой конечной точки.
- Указание на этикете FedEx стандартной торговой марки и обеспечение указанных размеров термоэтикеток.
- Получение уведомлений по электронной почте или в виде SMS во время перевозки, таких как:
- уведомление об отправке;
- Дата ожид. достав.
- уведомление о заборе.
- Формирование транспортных документов, таких как:
- транспортные этикетки для отдельных единиц обработки;
- Коносамент
- Коммерческий счет-фактура
- канадский таможенный счет-фактура.
- Создание отправлений и распечатка этикеток для каждой единицы обработки или для всех единиц обработки одновременно.
- Получение тарифов на одноместный или многоместный груза для всех типов услуг.
- Проверка доступности для забора, планирование и отмена забора груза.
- Создание и планирование забора по счету третьей стороны с альтернативным адресом для выставления счета.
Услуги перевозки сборных грузов
Для отправки сборных грузов можно использовать следующие услуги:
FedEx Freight® Priority
Услуга FedEx Freight®Priority предлагает самую быструю, надежную доставку и кратчайшие сроки перевозки в отрасли. Наша региональная сеть позволяет доставлять грузы вашим клиентам на следующий или на второй день с гарантией возврата денег и без дополнительных сборов.*
Особенности услуги FedEx Freight® Priority:
- кратчайшие сроки перевозки с доставкой на следующий день в радиусе 600 миль и на второй день — в радиусе 1600 миль;
- Прямая доставка практически по любым почтовым индексам в США, Канаде и Мексике.
- гарантированная своевременная доставка;
- гарантия возврата денег без дополнительных сборов*;
- современные ИТ-решения и отслеживание отправлений на всем пути доставки;
- команда специалистов, которые помогут вам решить любые задачи в сфере региональных грузовых перевозок.
* На все услуги распространяются условия и положения тарифа FXF 100 Series Rules.
FedEx Freight Economy
Услуга FedEx Freight® Economy — это доступная доставка сборных грузов, решающая базовые задачи грузовых перевозок. Службы доставки сборных грузов FedEx гарантируют своевременную доставку и внимательное отношение к потребностям клиентов.
FedEx Freight® Economy предлагает следующее:
- Экономичные услуги доставки.
- сокращение затрат на перевозки, для которых не требуется особая срочность, не жертвуя надежностью доставки;
- гарантированная своевременная доставка;
- Прямая доставка практически по любым почтовым индексам в США, Канаде, Мексике и Пуэрто-Рико.
- современные ИТ-решения и отслеживание отправлений на всем пути доставки;
- улучшенное отслеживание отправлений на всем пути доставки.
Как работает API Freight LTL
В этом разделе описываются конечные точки и основные элементы, необходимые для API FedEx Freight LTL.
Примечание. Для использования API FedEx Freight LTL необходимо активировать счет FedEx LTL Freight. Требуются следующие основные данные: номер(а) счета FedEx Freight и правильный почтовый адрес для обработки сборных грузов.
В данном API доступны следующие конечные точки:
Отправка сборного груза
С помощью этой конечной точки можно проверять и создавать сборный груз FedEx Freight.
Для такого запроса необходимы следующие исходные данные:
- номер счета FedEx Freight;
- почтовый адрес для счета;
- запрос грузового отправления;
- способ получения этикеток — в закодированном виде или в виде URL-адреса;
- сведения о головном месте — только если нужно обработать многоместный груз и распечатать этикетки по одной, а не все вместе (когда элемент singleShotMPS не указан или имеет значение false).
В случае успешного выполнения запроса создается сборный груз и возвращаются сведения для отслеживания и подробности уведомления. В случае проблем также возвращаются ошибки и их описания.
Примечание. Почтовый адрес может отличаться от фактического адреса доставки.
Проверка доступности пункта забора сборного груза
С помощью этой конечной точки можно запросить список всех офисов, доступных для забора груза, с расписанием забора, включая такие данные, как перевозчик, самое позднее время забора, самое позднее доступное время по умолчанию, возможность забора, время готовности груза для забора, указание, является ли адрес жилым, срок забора, а также возможность забора посылки водителем.
Для такого запроса необходимы следующие исходные данные:
- сведения об адресе забора/почтовом адресе;
- тип запроса о заборе посылки (например, в тот же или на следующий день);
- является ли посылка для забора внутренней или международной.
Примечание. Используйте действительный адрес забора в правильном формате.
В случае успешного выполнения запроса выдается список всех доступных офисов для забора груза, день доставки, доступность (флажок), дата забора, срок забора, время доступа, доступность по месту проживания (флажок), время закрытия (флажок), время закрытия и местное время. В случае проблем также возвращаются ошибки и их описания.
Создание записи о заборе сборного груза
Эта конечная точка позволяет создать и запланировать забор сборного груза.
Для такого запроса необходимы следующие исходные данные:
- номер счета FedEx Freight, на который будет выставлен счет на оплату забора;
- данные пункта отправления (адрес, местонахождение и тип адреса забора, например «клиент/отправитель/другое»);
- данные адреса для связанного счета.
Запрос возвращает номер подтверждения забора, уведомление о заборе и код офиса для запланированного забора. В случае проблем также возвращаются ошибки и их описания.
Примечание. Указывайте верный, действительный адрес забора в правильном формате, а также правильный адрес клиента, чтобы запланировать забор. Не указывайте для забора груза прошедшее время или дату либо слишком отдаленную дату. Анонимный забор посылок запрещен. Можно планировать забор по счету третьей стороны, указав альтернативный действительный адрес.
Отмена забора сборного груза
Эта конечная точка позволяет отменить запланированный забор сборного груза. При отмене забора выдается номер подтверждения и сообщение с подтверждением отмены забора.
Для такого запроса необходимы следующие исходные данные:
- код подтверждения забора (предоставляется при отправке запроса о заборе);
- запланированная дата забора;
- офис (офис FedEx Express, ответственный за обработку запроса о заборе груза).
Запрос возвращает номер подтверждения забора, уведомление о заборе и код офиса для запланированного забора. В случае проблем также возвращаются ошибки и их описания.
Примечание. Чтобы отменить запланированный забор, укажите номер подтверждения забора и соответствующий код офиса (только для FDXE). Номер подтверждения забора и соответствующий код офиса (только для FDXE) предоставляются при отправке запроса о заборе. Чтобы отменить забор, укажите правильный адрес счета. Если вы попытаетесь отменить забор после того, как курьер FedEx отправится в офис забора, вам будет отправлено уведомление об ошибке.
Тарифы на доставку сборных грузов
С помощью этой конечной точки можно запросить список всех возможных тарифов на грузовые отправления с дополнительной информацией о сроках перевозки согласно введенным параметрам. Возвращаемые тарифы зависят от пункта отправления, пункта назначения и других указанных параметров. Чтобы получить более точные результаты, можно указать дополнительные сведения, такие как код перевозчика, тип или вариант услуги.
Для такого запроса необходимы следующие исходные данные:
- номер счета FedEx Freight;
- запрос грузового отправления;
Запрос возвращает список всех возможных тарифов и код офиса для запланированного забора посылки. В случае проблем также возвращаются ошибки и их описания.
Отправка многоместного сборного груза
Многоместное отправление состоит из двух и более единиц обработки, которые отправляются по одному адресу. Первая единица обработки в запросе об отправке считается главной.
Чтобы создать многоместный груз, выполните указанные ниже действия.
- Укажите данные отправления, такие как serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail и requestedPackageLineItems. [Примечание. Параметр sequenceNumber для головного места должен быть равен 1.]
- При печати этикеток для единиц обработки укажите данные отслеживания главного места в элементе masterTrackingId по всем последующим единицам обработки.
Ниже перечислены варианты обработки многоместных грузов, доступные в этом API.
Печать этикеток для каждой единицы обработки
Данный API позволяет обрабатывать многоместные отправления и получать по одной этикетке для каждого места.
Если вам нужна такая возможность для отправлений, вместе со всеми обязательными элементами для многоместного груза укажите в запросе элемент oneLabelAtATime со значением true.
Первый запрос возвращает этикетку и номер отслеживания главного места. Укажите этот номер в элементе masterTrackingId для обработки последующих запросов об отправке и формирования этикеток с номерами отслеживания (дочерними номерами отслеживания) для заданного количества мест (totalPackageCount).
Примечание. Максимальное количество единиц обработки — 200.
Печать этикеток для всех единиц обработки сразу
Данный API позволяет обрабатывать многоместные грузы и получать все этикетки сразу. Это оптимальное решение, если отправление содержит до 40 обрабатываемых единиц (totalPackageCount<=40), доставляемых по одному адресу.
В запросе об отправке с общим количеством мест не более 40 задайте для элемента oneLabelAtATime значение false, чтобы сформировать все этикетки сразу.
Примечание. Ограничение в 40 обрабатываемых единиц указано для примера и не является фиксированным. Ограничение также зависит от количества единиц обработки и самих товаров. За дополнительной информацией обращайтесь к сотруднику FedEx.
Пример. В запросе об отправке указано 10 обрабатываемых единиц. В ответе возвращаются 10 этикеток в виде URL-адресов или закодированных этикеток согласно запросу.
FedEx Freight Direct
Эта услуга обеспечивает высокое качество обслуживания клиентов при доставке крупногабаритных грузов и грузов на поддонах, включая доставку тяжелых и громоздких грузов на дом или на место работы.
При использовании этой услуги доступны такие опции, как активная связь, гибкие условия доставки и пакетное ценообразование за дополнительную плату.
Функции, доступные при использовании этой услуги:
- Возможность создавать отправления c базовой доставкой, базовой доставкой при встрече, стандартной доставкой и премиум-доставкой FedEx Freight Direct, а также возвращаемые отправления или заборы базового уровня в пределах континентальной части США, на Аляске и на Гавайи.
- Возможность получать полные версии тарифов для отправлений FedEx Freight Direct, используя учетную запись FedEx Freight Direct, а также отменять заборы FedEx Freight Direct.
- На Аляске и Гавайях не будут отображаться расчетные тарифы. Клиентам в этих штатах необходимо обращаться в службу по работе с клиентами FedEx, чтобы запросить предложение.
- Чтобы отменить забор, запланированный на тот же день, клиент должен позвонить в центр обслуживания клиентов FedEx.
- Возможность отправлять уведомления по электронной почте первоначальному отправителю/получателю, чтобы клиент мог:
- Запланировать доставку.
- Получать подтверждения доставки и/или забора.
- Получать уведомления о том, что отправление находится в процессе доставки и/или забора.
- Получать уведомления о пути следования.
- Опросить клиентов о качестве доставки отправлений.
- Для правильной организации магистральных перевозок и определения первого/последнего этапов доставки при использовании FedEx Freight Direct применяются рабочие правила проверки почтового индекса, габаритов, веса места и веса единицы обработки.
FedEx Freight Direct предлагает различные типы услуг на выбор.
С данным API доступны описанные ниже функции для услуги Freight Direct.
Получение тарифов Freight Direct
Эта конечная точка позволяет получить информацию о тарифах на услуги Freight Direct и размере доплат за следующие специальные опции Freight Direct: базовая услуга, базовая услуга при встрече, стандартная услуга, премиум-услуга.
Ниже приведены сведения, обязательные для предоставления с запросом тарифа при использовании конечной точки «Тарифы на доставку сборных грузов».
- Тип Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Тип транспортировки Freight Direct (DELIVERY, PICKUP)
- Тип номера телефона, если указан номер телефона (HOME, MOBILE, WORK)
- Вес
- Габариты (неотрицательные длина, ширина и высота)
Создание отправлений Freight Direct
Эта конечная точка позволяет отправить одноместный или многоместный груз используя следующие специальные опции Freight Direct: базовая услуга, базовая услуга при встрече, стандартная услуга, премиум-услуга и получить транспортную этикетку или коносамент, включая необходимую документацию для обработки отправлений Freight Priority.
Ниже приведены сведения, обязательные для предоставления с запросом на отправку при использовании конечной точки «Отправка сборного груза».
- Тип Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Тип транспортировки Freight Direct (DELIVERY, PICKUP)
- Адрес электронной почты, номер телефона и тип телефона
- Вес
- Габариты (неотрицательные длина, ширина и высота)
Выходной коносамент содержит названия услуг Freight Direct. Ниже приведены значения, указанные в коносаменте в зависимости от выбора услуги.
- 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
Забор Freight Direct
Эта конечная точка позволяет проверить доступность услуги забора сборного груза Freight Direct, создать запрос на забор груза или отменить запрос на забор.
Ниже приведены сведения, обязательные для предоставления с запросом на забор при использовании конечных точек «Проверка доступности пункта забора сборного груза», «Создание записи о заборе сборного груза» и «Отмена забора сборного груза».
- Тип Freight Direct (BASIC, BASIC_BY_APPOINTMENT, PREMIUM, STANDARD)
- Тип транспортировки Freight Direct (DELIVERY, PICKUP)
- Адрес электронной почты (создание запроса на забор)
- Номер телефона и тип телефона (создание запроса на забор)
- Вес
Правила работы
- Основной номер отслеживания (Pro) присваивается первой единице обработки в сборном грузовом отправлении, а каждой последующей единице обработки назначается дополнительный номер отслеживания.
- Это позволяет отслеживать как каждую отдельную единицу обработки в отправлении, так и все отправление в целом.
- Для определенных отправлений (например, для опасных материалов [HazMat] и международных отправлений) могут требоваться другие документы.
- Учетные записи LTL Freight и учетные записи, используемые для выставления счетов за LTL Freight, нельзя добавить на FedEx Developer Portal.
- Для использования услуг Freight Direct клиент может использовать долгосрочную единую учетную запись LTL или учетную запись FedEx Freight Direct.
- Тарифы FedEx Freight Direct доступны только для стандартной API LTL.
- Все новые тексты ошибок и сообщения будут отображаться только на английском языке.
- При создании отправлений следует указать адрес электронной почты и номер телефона в запросе на услугу FedEx Freight Direct.
Коллекция API JSON
Response