12 de agosto de 2025
Melhorias na visibilidade integrada avançada da FedEx em julho de 2025 e próximas versões
Como parte dos nossos esforços contínuos para melhorar o produto de webhook, a visibilidade do cliente e as experiências de integração, implementamos diversas atualizações importantes, como listadas abaixo.
Data da versão: 31 de julho de 2025
- Capacidade de adicionar o mesmo número da conta de envio a várias assinaturas de webhook em uma organização.
- Reformulação das páginas de documentação do webhook para facilitar sua compreensão.
- Correção de defeitos: URLs de sandbox removidos da Account Number Subscription API e das Track Number Subscription APIs. Os URLs de produção são exibidos como padrão.
- Correção de defeitos: os problemas da interface no painel do webhook foram corrigidos para permitir que os usuários visualizem e pesquisem uma grande quantidade de números de contas de envio.
Próximas melhorias – Setembro de 2025
- Padronização das descrições de eventos (remoção dos pontos finais).
- Remoção de campos obsoletos no esquema de rastreamento.
- Adição de detalhes de endereço e do tipo de estabelecimento em nós de Reter na localidade e Coleta.
Detalhes adicionais:
Leia os detalhes da versão abaixo para ter certeza de que as alterações futuras não afetarão negativamente sua integração de webhook.
31 de julho de 2025 - Notas detalhadas da versão
1. Duplicação da conta de envio em várias assinaturas de webhook
Os clientes adicionam o mesmo número da conta de envio em várias IDs de assinatura durante a criação ou atualização do webhook na mesma organização (sem restrições de país).
Exemplo:
- Número da conta de envio: ABC123456
- IDs de assinatura: SubscriptionID-001, SubscriptionID-002, SubscriptionID-003
Agora você pode adicionar ABC123456 às três assinaturas durante a criação ou atualização do webhook, permitindo a consistência do rastreamento e do processamento de eventos nos sistemas da sua organização.
Atualização da documentação do webhook
A página de documentação do webhook agora apresenta descrições mais claras e detalhadas, com formatação aprimorada e recursos visuais para auxiliar os desenvolvedores.
Correções de defeitos
- Como parte desta versão, compartilhamos apenas os URLs do servidor de produção na documentação dos endpoints da API para a Account Number Subscription API e a Tracking Number Subscription API. Realizamos isso para garantir clareza, reduzir a possibilidade de confusão e oferecer suporte a implementações prontas para produção.
- Resolvemos um problema que gerava um erro quando o tentava criar um webhook no FedEx Developer Portal (FDP) usando contas de envio em lote. Esse erro era causado porque não era possível carregar nem exibir a lista completa de contas durante o processo de configuração do webhook. Agora, o usuário pode visualizar e selecionar todas as contas ao configurar webhooks com várias contas de envio.
Detalhes da próxima versão - Setembro de 2025
Leia abaixo os detalhes das próximas versões. Assim que o trabalho de desenvolvimento for concluído, enviaremos o cronograma detalhado de lançamento da versão.
1. Padronização das descrições de eventos nos dados do webhook
Para garantir a consistência entre sistemas e integrações, removemos os pontos finais das descrições dos eventos. Essa alteração se aplica a todos os tipos de eventos e ajuda a manter a formatação uniforme entre as plataformas.
O que isso significa para sua integração de webhook?
Se seus sistemas dependerem de formatos exatos de descrição de eventos (por exemplo, para análise ou correspondência), essa isso pode ser uma alteração interruptiva (breaking change).
Veja abaixo a lista completa das descrições de eventos afetadas.
| Descrição atual do evento (antes) | Nova descrição do evento (depois) |
|---|---|
| Dados do manifesto no aeroporto. | Dados do manifesto no aeroporto |
| Liberação na alfândega pelo despachante aduaneiro. | Liberação na alfândega pelo despachante aduaneiro |
| Chegou ao despachante aduaneiro. | Chegou ao despachante aduaneiro |
| Atraso de liberação no despachante aduaneiro. | Atraso de liberação no despachante aduaneiro |
| Chegou ao estabelecimento FedEx de destino. | Chegou ao estabelecimento FedEx de destino |
| No estabelecimento FedEx de destino. | No estabelecimento FedEx de destino |
| Chegará ao estabelecimento FedEx de destino dentro do prazo. | Chegará ao estabelecimento FedEx de destino dentro do prazo |
| Chegará ao estabelecimento FedEx de destino antes do prazo. | Chegará ao estabelecimento FedEx de destino antes do prazo |
| Pronto para coleta no estabelecimento FedEx de destino. | Pronto para coleta no estabelecimento FedEx de destino |
| Exceção de entrega no estabelecimento FedEx de destino. | Exceção de entrega no estabelecimento FedEx de destino |
| Atraso no estabelecimento FedEx de destino. | Atraso no estabelecimento FedEx de destino |
| Reter no estabelecimento FedEx de destino. | Reter no estabelecimento FedEx de destino |
| Chegou ao local de entrega. | Chegou ao local de entrega |
| Exceção de entrega no local de entrega. | Exceção de entrega no local de entrega |
| Chegará ao local de entrega dentro do prazo. | Chegará ao local de entrega dentro do prazo |
| Chegará ao local de entrega antes do prazo. | Chegará ao local de entrega antes do prazo |
| Atraso na entrega no local de entrega. | Atraso na entrega no local de entrega |
| Solicitação de opção de entrega cancelada durante o trajeto. | Solicitação de opção de entrega cancelada durante o trajeto |
| Chegará à rota antes do prazo. | Chegará à rota antes do prazo |
| Chegará à rota dentro do prazo. | Chegará à rota dentro do prazo |
| Atraso na coleta durante o trajeto. | Atraso na coleta durante o trajeto |
| Liberação alfandegária durante o trajeto. | Liberação alfandegária durante o trajeto |
| Atraso na entrega durante o trajeto. | Atraso na entrega durante o trajeto |
| Liberação alfandegária no estabelecimento FedEx. | Liberação alfandegária no estabelecimento FedEx |
| Atraso de liberação no estabelecimento FedEx. | Atraso de liberação no estabelecimento FedEx |
| No estabelecimento FedEx. | Em instalação FedEx |
| Saiu do estabelecimento FedEx. | Saiu do estabelecimento FedEx |
| Chegou ao estabelecimento FedEx. | Chegou ao estabelecimento FedEx |
| Liberação em andamento no estabelecimento FedEx. | Liberação em andamento no estabelecimento FedEx |
| Chegará ao estabelecimento FedEx dentro do prazo. | Chegará ao estabelecimento FedEx dentro do prazo |
| Chegará ao estabelecimento FedEx antes do prazo. | Chegará ao estabelecimento FedEx antes do prazo |
| Chegou ao estabelecimento FedEx de origem. | Chegou ao estabelecimento FedEx de origem |
| Atraso no estabelecimento FedEx. | Atraso no estabelecimento FedEx |
| Saiu do estabelecimento FedEx de origem. | Saiu do estabelecimento FedEx de origem |
| Em posse da FedEx no estabelecimento FedEx. | Em posse da FedEx no estabelecimento FedEx |
| Transferência no estabelecimento FedEx. | Transferência no estabelecimento FedEx |
| Atendimento sob demanda no estabelecimento FedEx. | Atendimento sob demanda no estabelecimento FedEx |
| Chegará ao estabelecimento FedEx de origem dentro do prazo. | Chegará ao estabelecimento FedEx de origem dentro do prazo |
| Chegará ao estabelecimento FedEx de origem antes do prazo. | Chegará ao estabelecimento FedEx de origem antes do prazo |
| Atraso de liberação no estabelecimento FedEx de origem. | Atraso de liberação no estabelecimento FedEx de origem |
| Mudança de local no estabelecimento FedEx de origem. | Mudança de local no estabelecimento FedEx de origem |
| Liberação alfandegária no estabelecimento FedEx de origem. | Liberação alfandegária no estabelecimento FedEx de origem |
| Transferência no estabelecimento FedEx de origem. | Transferência no estabelecimento FedEx de origem |
| Chegará ao local de coleta dentro do prazo. | Chegará ao local de coleta dentro do prazo |
| Chegará ao local de coleta antes do prazo. | Chegará ao local de coleta antes do prazo |
| Em posse da FedEx no local de coleta. | Em posse da FedEx no local de coleta |
| Chegará ao veículo antes do prazo. | Chegará ao veículo antes do prazo |
| Chegará ao veículo dentro do prazo. | Chegará ao veículo dentro do prazo |
| Saiu do destino. | Saiu do destino |
| Chegou ao destino. | Chegou ao destino |
| Chegará ao destino antes do prazo. | Chegará ao destino antes do prazo |
| Chegará ao destino dentro do prazo. | Chegará ao destino dentro do prazo |
| Chegou ao local de coleta. | Chegou ao local de coleta |
| Atraso na coleta no local de coleta. | Atraso na coleta no local de coleta |
2. Limpeza do esquema e remoção de campos
Para diminuir a redundância e simplificar as cargas úteis, estes campos serão removidos do esquema de resposta de rastreamento:
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
Esses campos não são mais necessários e serão descontinuados nas próximas versões.
3. Melhoria nos eventos Reter na localidade e Pronto para coleta
Adicionamos detalhes sobre o local para esses eventos. Anteriormente, os eventos de retenção eram exibidos dessa forma:
Reter em <Estabelecimento>
Este é o novo formato:
Reter em <Endereço> (<Tipo de estabelecimento>)
Essa mudança permite que o cliente tenha uma visão mais clara do local exato onde o pacote está sendo mantido para coleta, melhorando a experiência geral de entrega.
Evento "Pronto para coleta" ao desmascarar e adicionar a linha de endereço diretamente na descrição do evento. Essa melhoria permite que o cliente veja imediatamente onde pode coletar o pacote sem precisar procurar em outros campos.
Exemplo:
Antes:
Coleta no FedEx Office
Depois:
Pronto para coleta pelo destinatário
(Pacote disponível para coleta no FedEx Office – 610.9TH ST), DURHAM, NC
Isso ajudará o cliente a saber exatamente onde retirar os pacotes, principalmente se houver várias localidades FedEx nas proximidades.
