Fedex Logo

CRIAR UM
WEBHOOK GERIR WEBHOOKS

Regras empresariais e Processo de validação


  • Um número de conta de expedição não pode ser utilizado em várias Visibilidades integradas avançadas.
  • O URL de destino/ponto final criado pelo cliente tem de:
    • Ser um anfitrião HTTPS.
    • Responder a pedidos POST e analisar cargas JSON.
    • Limite de 200 carateres
    • O seu URL será bloqueado se incluir o seguinte:
      • Espaço de IP RFC1918
      • fedex.com ou qualquer um dos seus subdomínios
      • Endereços IP no URL (incluindo localhost, 127.0.0.1)

 

  • Segurança da Visibilidade integrada avançada: apenas são suportadas as ligações HTTPS que utilizam a versão de protocolo TLS (SSL) 1.2 ou posterior, que sejam configuradas com um certificado de uma autoridade de certificação (CA) válida. Autorize os endereços IP abaixo para receber atualizações de servidores FedEx sem interrupções:
    Prod

         Os clientes podem autorizar: "nat.fxconnect.eastus2.heap-prod.fedex.io"

         Utilizar CIDR "20.65.16.22/31"
  • Por vezes, os clientes podem receber as atualizações de eventos de rastreio fora de ordem e têm de consultar o registo de data/hora dos eventos de análise para obter a ordem correta.
  • Eliminar conta(s) no FedEx Developer Portal:
    • O utilizador/cliente não pode eliminar a conta:
      1. Se estiver associada a alguma Visibilidade integrada avançada ativa.
      2. Se a conta estiver disponível ou associada a um projeto.
      3. Se for a única conta num projeto/numa Visibilidade integrada avançada.
        Nota: o utilizador/cliente tem de remover a conta do projeto/da Visibilidade integrada avançada e, em seguida, eliminá-la da organização.
    • O utilizador/cliente pode eliminar a conta:
      1. A conta tem de pertencer à mesma organização.
      2. O utilizador/cliente tem de ser um administrador para eliminar contas da organização.

Restrições comuns

  • Todas as expedições de clientes associadas aos Números de conta FedEx de 9 dígitos das empresas operacionais – FedEx Express®, FedEx Ground® e FedEx Ground® Economy (anteriormente denominada FedEx SmartPost®) – estão abrangidas, independentemente do destino ou da origem (nacional, de exportação, internacional, etc.).
  • O webhook de Visibilidade integrada avançada só suporta contas empresariais/ativadas para pacotes de 9 dígitos. As contas empresariais permitem a criação de expedições associadas a todas as companhias operativas FedEx, incluindo a FedEx Express e a FedEx Ground.

    • Nota: as contas de expedição de carga LTL de 9 dígitos não são suportadas. Se quiser adicionar uma conta de expedição de carga LTL, tem de entrar em contacto com o apoio ao cliente para transferir uma conta LTL para uma conta empresarial.
  • Os clientes têm de gerir a ordem dos eventos de rastreio de expedições recebidos.
  • As notificações por e-mail automatizadas são enviadas sempre que existir atividade (Guardado/Falhou/Criar/Atualizar/Cancelar/Eliminar) no webhook de Visibilidade integrada avançada subscrito.
  • Traduções:
    • As traduções de cargas de rastreio são suportadas em 41 idiomas (regiões).(Em breve)
      Clique aqui para ver a lista de idiomas suportados.
    • Atualmente, a tradução de cargas de rastreio é suportada em inglês (Estados Unidos).
    • As traduções de notificações por e-mail estão disponíveis apenas para os idiomas suportados pelas regiões dos EUA. (Idioma: en-US, es-US)

 


Funções de utilizador do FedEx Developer Portal:


No FedEx Developer Portal, pode executar funções específicas com base na função configurada.
Para saber mais sobre o FedEx Developer Portal, consulte o Guia de administração da organização.

Processo de validação da Visibilidade integrada avançada

O que é o MAC/HMAC e como é utilizado no processo de validação?

Um código de autenticação de mensagem (MAC) indica uma forma de verificar a integridade das informações transmitidas ou armazenadas num meio inseguro, com base numa chave secreta. Por norma, os MAC são utilizados entre duas partes que partilham uma chave secreta para validar as informações transmitidas entre as duas partes.

Um mecanismo MAC que se baseia em funções de hash criptográficas é denominado de HMAC. O HMAC pode ser utilizado com qualquer função de hash criptográfica, por exemplo, SHA256, em combinação com uma chave secreta partilhada. O HMAC é especificado no RFC 2104. O webhook de Visibilidade integrada avançada da FedEx irá utilizar HMAC SHA256.

SHA256 (token de segurança + carga) = cabeçalho fdx-signature com codificação Base 64 como parte da carga

Exemplo (de um fragmento de pseudocódigo para ilustrar um hashing HMAC SHA256):

  • Comece por inicializar o MAC com o algoritmo HmacSHA256 e o token de segurança como chave secreta.
  • Em seguida, finalize a operação MAC ao utilizar codificação hexadecimal na carga do pedido enviado pela FedEx.
  • Este hash final deve corresponder ao valor do cabeçalho fdx-signature no PUSH enviado pela FedEx.

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

Nota: a chave secreta utilizada é o token seguro que irá fornecer ao configurar a Visibilidade integrada avançada ou ao testar o URL da Visibilidade integrada avançada.

 

Cálculo da latência

 

A Hora de criação do evento representa o momento em que um evento efetivamente ocorreu na rede.
Até o evento ser registado no sistema (indicado pelo Registo de data/hora da criação da mensagem), os webhooks ou quaisquer outros sistemas não podem processá-lo ou entregá-lo.

Recomendação

Os clientes devem utilizar o Registo de data/hora da criação da mensagem para medir a latência, uma vez que representa melhor o momento em que um evento se tornou disponível para os sistemas digitais. Este registo de data/hora alinha-se mais com o momento das atualizações digitais da FedEx e, normalmente, é mais rápido do que (ou alinha-se mais com) as atualizações visíveis em fedex.com.

 

Regras de validação: 

  • O nome do webhook de Visibilidade integrada avançada deve ser único.
  • O URL de destino do webhook de Visibilidade integrada avançada tem de estar no formato sintático padrão.
  • Todos os campos necessários para criar um webhook de Visibilidade integrada avançada não podem estar vazios.
  • Deve ser associado pelo menos um número de conta de expedição FedEx disponível para criar um  webhook de Visibilidade integrada avançada.
  • Para uma validação com sucesso:
    • Quando um webhook de Visibilidade integrada avançada for criado com sucesso, o cliente irá receber uma mensagem de confirmação.

      Mensagem de confirmação de exemplo: <<nome do webhook  de Visibilidade integrada avançada>> criado com sucesso. As alterações podem demorar até 10 minutos para entrarem em vigor.

  • Para uma validação sem sucesso/com falhas:
    • Se a FedEx receber qualquer resposta além de 200 (OK) ou 202 (Aceite), a validação do URL de destino do webhook  de Visibilidade integrada avançada será considerada sem sucesso.

Exemplo de Regras empresariais e Processo de validação


  • Um número de conta de expedição não pode ser utilizado em várias Visibilidades integradas avançadas.
  • O URL de destino/ponto final criado pelo cliente tem de:
    • Ser um anfitrião HTTPS.
    • Responder a pedidos POST e analisar cargas JSON.
    • Limite de 200 carateres
    • O seu URL será bloqueado se incluir o seguinte:
      • Espaço de IP RFC1918
      • fedex.com ou qualquer um dos seus subdomínios
      • Endereços IP no URL (incluindo localhost, 127.0.0.1)

 

  • Segurança da Visibilidade integrada avançada: apenas são suportadas as ligações HTTPS que utilizam a versão de protocolo TLS (SSL) 1.2 ou posterior, que sejam configuradas com um certificado de uma autoridade de certificação (CA) válida. Autorize os endereços IP abaixo para receber atualizações de servidores FedEx sem interrupções:
    Prod

         Os clientes podem autorizar: "nat.fxconnect.eastus2.heap-prod.fedex.io"

         Utilizar CIDR "20.65.16.22/31"
  • Por vezes, os clientes podem receber as atualizações de eventos de rastreio fora de ordem e têm de consultar o registo de data/hora dos eventos de análise para obter a ordem correta.
  • Eliminar conta(s) no FedEx Developer Portal:
    • O utilizador/cliente não pode eliminar a conta:
      1. Se estiver associada a alguma Visibilidade integrada avançada ativa.
      2. Se a conta estiver disponível ou associada a um projeto.
      3. Se for a única conta num projeto/numa Visibilidade integrada avançada.
        Nota: o utilizador/cliente tem de remover a conta do projeto/da Visibilidade integrada avançada e, em seguida, eliminá-la da organização.
    • O utilizador/cliente pode eliminar a conta:
      1. A conta tem de pertencer à mesma organização.
      2. O utilizador/cliente tem de ser um administrador para eliminar contas da organização.
CLOSE

Response

Copy