Webhook — функция обратного вызова через протокол HTTPS, которая обеспечивает простой обмен данными о событиях между приложениями отправителя и получателя. В данном случае это обмен данными между FedEx и вашим приложением. Webhook позволяет получать обновления о важных событиях практически в реальном времени. Подробные сведения см. в разделе Что такое Webhook?

Webhook Advanced Integrated Visibility пересылает уведомления о событиях отслеживания отправлений от создания этикетки до подтверждения доставки, включая подтверждение доставки с помощью фото.

Клиенты могут настраивать Webhook и выбирать необходимые им категории событий отслеживания. Например, если вы используете событие Delivered (Доставлено), чтобы отправлять клиентам уведомления об успешной доставке, можно выбрать только категорию «Уведомления о доставке». Нажмите здесь, чтобы просмотреть полный список событий.

1.  Создать учетные данные пользователя для входа на портале FedEx Developer Portal.
2.  Создать профиль организации на портале FedEx Developer Portal.
3.  Добавьте применимые счета клиентов, расположенных в США, для выставления счетов и доставки.
4.  Настроить прослушиватель Webhook (целевой URL-адрес/URL обратного вызова и маркер безопасности), который принимает уведомления о полезной нагрузке JSON.

Мы предлагаем два уровня поддержки: консультации и общее устранение неполадок. За дополнительными сведениями обращайтесь в отдел по работе с клиентами.

в службу технической поддержки.

ЗВОНИТЕ ПО НОМЕРУ: 1 877 339 2774

Время работы службы поддержки: с понедельника по пятницу с 7:00 до 21:00 и в субботу с 7:00 до 15:00 (стандартное центральное время).

Выберите вариант 4 для API и веб-сервисов.

Чтобы использовать Webhook FedEx, вы должны прочитать и принять Лицензионное соглашение с разработчиком FedEx при создании Webhook. В дополнение к FDPLA ваша компания должна соблюдать Лицензионное соглашение конечного пользователя для каждой учетной записи отправителя в организации, а также использовать Форму заказа.

Пока Webhook доступен только для учетных записей выставления счетов и отправки из США.

Webhook FedEx будет отправлять сигнатуру fdx в кодировке Base64 на основе HMAC в заголовке с каждым уведомлением о полезной нагрузке. Вы можете выполнить аутентификацию полученной полезной нагрузки, создав сигнатуру HMAC на основе полезной нагрузки и токена безопасности и сравнив ее с сигнатурой fdx.

Чтобы проверить тип данных отслеживания, возвращаемых на URL-адрес назначения (обратного вызова), используйте функцию ПОПРОБОВАТЬ ЭТОТ WEBHOOK для отправки тестового запроса. Это поможет проверить ваш URL-адрес и обработать уведомление о полезной нагрузке имитатора Webhook перед созданием Webhook Advanced Integrated Visibility .

См. Руководство по началу работы.

Webhook принимает только действительные соединения HTTPS TLS 1.2 или более поздней версии, настроенные с использованием сертификата известного удостоверяющего центра. При настройке целевого URL-адреса (обратного вызова) не следует использовать имена доменов и IP-адреса FedEx. Дополнительные сведения см. в разделе рекомендаций.

При использовании Webhook по номеру отслеживания добавляйте номера отслеживания тех отправлений, которые уже поступили или в ближайшие 24 часа поступят в распоряжение FedEx.

Повтор Webhook — это попытка отправить сообщение Webhook, которое ранее уже не удалось отправить. FedEx сохраняет эти данные и пытается отправить их снова 3 раза с интервалом в 5 минут.

Если FedEx не получит ответ об успешной доставке в установленный срок, повторная доставка данных об этом событии прекращается. Однако клиент может запросить данные пропущенных событий за последние 7 дней с помощью кнопки «ПОВТОРИТЬ» на странице с информацией о проекте Webhook. Дополнительные сведения см. в разделе о повторных попытках.

Пользователи могут настроить Webhook таким образом, чтобы получать определенные категории данных о событиях отслеживания (таких как «отправка», «в пути», «исключения» или «доставка»). При этом можно выбрать получение полной истории с каждым событием или получение конкретных данных о самом последнем событии. Дополнительные сведения см. в разделе параметров настройки.

Клиенты могут добавить в белый список адрес: nat.fxconnect.eastus2.heap-prod.fedex.io

 Использование бесклассовой маршрутизации между доменами (CIDR): 20.65.16.22/31

См. руководство по статусам и кодам отслеживания Webhook Advanced Integrated Visibility .

ПРИМЕЧАНИЕ. FedEx не гарантирует доставку событий в порядке их создания.

• Клиенты могут создавать новые Webhook и хранить введенные данные до 90 дней.
• Если не завершить создание сохраненного Webhook за 90 дней, он будет удален, а метаданные станут недоступны на портале.
• Если процесс создания Webhook запущен, но не выполнен, Webhook будет иметь статус «сбой» (клиенты могут попробовать создать его снова). Webhook с таким статусом удаляется через 30 дней, если за этот период не предпринять никаких действий.
• Если процесс создания Webhook успешно завершен:
  • Webhook будет иметь статус «активно» (в этом случае происходит сопоставление сведений об отправлениях, и данные отправляются клиенту).
  • Метаданные отмененных Webhook будут доступны на портале FDP еще 90 дней без возможности повторной активации.
  • Через 90 дней после отмены Webhook удаляется автоматически.

Чтобы отменить Webhook, перейдите в раздел Мои проекты > Webhooks, выберите Webhook и затем выберите ОТМЕНА в меню или на экране редактирования. После отмены Webhook не может быть восстановлен и останется видимым в течение 90 дней, а затем он будет удален автоматически. Щелкните здесь, чтобы ознакомиться с условиями вашего проекта Webhook. 

• В профиле одной организации можно создать не более 100 Webhook.
• В один Webhook по клиентскому номеру можно добавить до 1000 клиентских номеров.
• При использовании Webhook по номеру отслеживания в запросе можно указать до 1000 номеров отслеживания.

Вы получите личную информацию, такую как имя отправителя, адрес отправителя, контактная информация отправителя, имя получателя, адрес получателя, контактная информация получателя, изображение подписи (SPOD), координаты GPS и удобные условия доставки (CDO).

Обратитесь к нашему руководству по началу работы, чтобы создать проект Webhook, для которого можно создать подписку по номеру отслеживания. После создания проекта подписка по номеру отслеживания Advanced Integrated Visibility добавляется в проект автоматически. У этого API есть 3 конечные точки:

1. Привязка номеров отслеживания — эта конечная точка используется для того, чтобы запустить асинхронную задачу по привязке одного или нескольких номеров отслеживания к определенному проекту Webhook.
2. Состояние задачи для номера отслеживания — используйте эту конечную точку, чтобы получить статус асинхронной задачи или статус всех отправленных задач.
3. Сведения о задаче для номера отслеживания — используйте эту конечную точку для загрузки отчета в формате JSON для асинхронной задачи, находящейся в состоянии «ВЫПОЛНЕНО».

Дополнительную информацию см. в документации.

Отлично! Вы узнали о принципах работы Webhook и готовы приступить к их использованию. Для этого зарегистрируйтесь на нашем портале (т. е. создайте профиль организации) и следуйте рекомендациям, приведенным в этом руководстве.

Нет, Webhook FedEx представляет собой набор технических схем с сопроводительной документацией и примерами, с помощью которого ваши ИТ-специалисты смогут встраивать различные функции FedEx в ваши внутренние системы. Готовые решения можно найти в программе FedEx Compatible solutions.

Создать подписку на Webhook Advanced Integrated Visibility можно двумя способами:

1. Пользователи могут подписаться на события отслеживания по 9-значным клиентским номерам FedEx. Таким образом можно отслеживать все входящие и исходящие отправления, а также отправления третьих сторон, счет за которые выставляется на соответствующий клиентский номер.
2. Webhook на основе номера отслеживания, в этом случае пользователи могут создать подписку, указав номер(а) отслеживания FedEx, и получать ту же информацию, которая доступна на сайте FedEx.com. Личные данные не передаются через Webhook на основе номера отслеживания.

Webhook FedEx Advanced Integrated Visibility поддерживает обновление сведений об отправлениях FedEx Ground, FedEx Ground Economy, FedEx Express и FedEx Freight (только для 9-значного номера счета клиента).

ПРИМЕЧАНИЕ.

• Webhook FedEx Advanced Integrated Visibility поддерживает только 9-значные грузовые счета предприятий.
• Webhook поддерживает только 9-значные счета предприятий и пакетов. Клиентские счета предприятий позволяют создавать отправления, связанные со всеми компаниями, принадлежащими бренду FedEx, включая FedEx Express и FedEx Ground.
• 9-значные счета, созданные только для перевозки грузов, объем которых меньше грузовместимости транспортного средства, не поддерживаются. Чтобы преобразовать счет сборных грузов в счет предприятия, обратитесь в Центр поддержки клиентов FedEx.