Fornecedor integrador FedEx | FedEx Developer Portal

1 Criar ou juntar-se a uma organização

Junte-se à organização da sua empresa para colaborar com a sua equipa. Se a sua empresa não tiver uma organização, pode criar uma.

Juntar-se a uma organização existente

1. Peça um convite

Peça ao administrador da sua organização que lhe envie um convite. Tem 24 horas para o aceitar. Se o convite expirar, peça ao administrador para o reenviar.

2. Aceite o convite

Inicie sessão com a ID de utilizador e a palavra-passe existentes. Se a sua ID de utilizador estiver associada a outra organização, crie uma nova.

Criar uma nova organização

Quando cria uma organização, obtém o cargo de administrador. Com o cargo de administrador, pode convidar utilizadores a juntarem-se à organização, atribuir-lhes funções de utilizador e projetos e gerir contas de faturação.

Para saber mais sobre as funções de utilizador, veja as Orientações de administração da organização.

1. Selecione Criar ou aderir a uma organização na barra de navegação.

2. Introduza os seguintes detalhes:

Para Trabalho para uma empresa que, selecione Vende ou fornece uma solução de software que utiliza a tecnologia FedEx e gostaria de se registar como um Fornecedor integrador FedEx validado
Introduza o nome da sua empresa, o site da empresa e um nome de organização que a sua equipa reconheça, como o nome da empresa, departamento, divisão ou região.
Introduza um e-mail oficial que inclua o domínio da sua empresa, o país ou território onde a sua empresa está incorporada, bem como os países e territórios onde vende ou distribui a sua solução de software.

3. Selecione Seguinte.

Pode atualizar ou adicionar detalhes posteriormente em Gerir organização no menu.

Adicionar uma conta de faturação

1. Selecione o separador Contas de faturação. Se não tiver uma conta de faturação FedEx, selecione Abrir conta de faturação para abrir uma nova ou contacte o Apoio ao cliente FedEx.

Nota: utilize o seu número de conta; não pode ser o número de conta FedEx de um cliente.

2. Selecione Adicionar conta de faturação.

3. Introduza o seu número de conta FedEx, uma alcunha da conta e o endereço de faturação dos Estados Unidos que utilizou durante a configuração da conta.

Nota: o endereço de faturação tem de corresponder ao endereço que utilizou durante a configuração da conta. Esta conta tornar-se-á a conta de faturação padrão da sua organização.

4. Selecione uma opção de autenticação.

A chamada telefónica está disponível para Integradores apenas nos Estados Unidos e Canadá.

5. Introduza o código de autenticação que receber e selecione Enviar.

6. Leia e aceite o Contrato do integrador FedEx.

Convidar utilizadores como administrador

1. Navegue até Gerir organização e selecione o separador Utilizadores.

2. Selecione + Adicionar utilizadores.

3. Introduza os seguintes detalhes:

O país ou território
O idioma preferido

4. Selecione uma função de utilizador (Visualizador, Contribuidor ou Administrador).

5. (Opcional) Atribua o utilizador a um projeto.

Pode atribuir um utilizador em qualquer altura a partir da página Descrição geral do projeto.

6. Introduza os endereços de e-mail dos utilizadores e clique em Convidar.

Pode convidar até 20 utilizadores de uma só vez, com cada e-mail separado por uma vírgula. O convite é válido durante 24 horas.

Criar uma Organização

2 Criar um projeto

Criar um projeto

1. Navegue até Os meus projetos no menu e selecione + Criar um projeto.

2. Introduza um Nome de projeto.

O formato de nome recomendado Projectname_applicationname. Selecione Seguinte quando terminar.

3. Selecione as API e os produtos de Visibilidade integrada avançada para incluir no seu projeto.

Os produtos de Visibilidade integrada avançada estão apenas disponíveis para Fornecedores integradores FedEx dos EUA.
Se selecionar quaisquer produtos pagos, ser-lhe-á pedido para atribuir uma conta de faturação ao projeto e aceitar os termos obrigatórios.

Atribuição de uma conta de faturação

Nota: isto é obrigatório apenas se selecionar um produto pago.

1. Atribua uma conta de faturação a partir da lista de contas adicionadas à organização. As contas de faturação têm de estar localizadas nos Estados Unidos.

2. Aceite o Contrato de Licença e o Formulário de pedidos do FedEx Developer Portal e selecione Criar.

Configurar a Visibilidade integrada avançada num projeto

Pré-requisitos

Análise de preços: é cobrada uma taxa mensal aos subscritores com base na contagem de números de rastreio. Consulte o Formulário de pedidos para saber mais sobre os preços.
Configurar contas: o webhook de visibilidade da expedição requer uma conta de faturação localizada nos EUA e, pelo menos, uma conta de expedição. Estes dois tipos de conta são mutuamente exclusivos. Apenas os administradores podem adicionar contas de faturação e expedição na página Gerir organização.

1. Crie um URL de destino na sua aplicação ou plataforma para receber redirecionamentos. O URL tem de:

Utilizar HTTPS
Excluir o espaço de IP RFC1918, fedex.com e respetivos subdomínios, e endereços IP como localhost ou 127.0.0.1.

2. Gere um token de segurança para autenticação. O token tem de:

Conter entre 26 e 100 carateres, pelo menos uma letra maiúscula, uma letra minúscula e um número

3. No menu, Os meus projetos, selecione o separador Visibilidade integrada avançada.

4. Selecione Criar um projeto de Visibilidade integrada avançada.

5. Selecione o tipo de utilizador:

Expedidor FedEx: envia com a FedEx e tem de integrar as API FedEx nas suas próprias aplicações
Fornecedor compatível FedEx: é um Fornecedor compatível FedEx certificado
Fornecedor integrador FedEx: vende ou fornece uma solução de software que utiliza a tecnologia FedEx e é um Fornecedor integrador FedEx validado

6. Selecione o tipo de subscrição. Pode subscrever eventos através de números de conta ou números de rastreio.

7. Confirme a conta de faturação e selecione as funcionalidades que pretende, como a prova de entrega, entrega estimada, eventos de rastreio ou filtragem baseada em eventos.

8. Introduza os detalhes do projeto.

Introduza um nome único e reconhecível para o projeto.
Introduza o URL de destino e o token de segurança que criou.
Introduza um endereço de e-mail e o idioma preferencial para receber notificações sobre atualizações e interrupções da Visibilidade integrada avançada.

9. Aceite o Contrato de licença e o Formulário de pedido do FedEx Developer Portal e selecione Criar.

Nota: consoante o tipo de subscrição escolhido, poderão existir passos adicionais. Para obter mais detalhes, consulte a nossa documentação sobre webhooks.

IR PARA OS MEUS PROJETOS

3 Testar a sua integração

Siga estes passos para verificar a integração da API e confirmar se a aplicação pode enviar e receber dados de teste.

1. No menu, selecione Os meus projetos e, em seguida, selecione o Nome do projeto.

2. No separador Chaves de API , em Chave de teste, encontre as suas credenciais de teste.

3. Inicie sessão e transfira a coleção da JSON API ao utilizar o botão Transferir JSON no topo da página de documentação. Reveja os pedidos de exemplo para os pontos finais que a sua integração utiliza.

4. Solicite um token de acesso OAuth para utilizar com todas as transações da API. O token é válido por uma hora e pode configurar a sua aplicação para atualizá-lo antes que expire. Para obter detalhes, consulte a documentação da API Authorization.

5. No menu, selecione Catálogo de API, escolha a API com a qual pretende trabalhar e selecione Documentação.

6. No menu, selecione o ponto final.

7. Envie pedidos de exemplo com as suas credenciais de teste e o URL de teste da FedEx. Em seguida, confirme se as respostas correspondem aos exemplos da documentação. Para obter detalhes, consulte o Guia de virtualização da sandbox.

8. Execute testes com a Visibilidade integrada avançada para gerar dados de amostra e confirmar que a aplicação processa as informações de rastreio corretamente.

Nota: os testes não autenticam o seu URL de redirecionamento. Para obter detalhes, consulte a documentação da Visibilidade integrada avançada.

4 Validar a sua API

Para mover as suas API para a produção, estas têm de ser validadas. O nível de validação varia por API. Reveja os Requisitos de validação da API antes de começar.

1. No menu, selecione Os meus projetos e, em seguida, selecione o Nome do projeto.

2. No separador Chaves de API , em Chave de teste, encontre as suas credenciais de teste.

3. Identifique casos de teste para as regiões ou os territórios onde planeia implementar a sua solução. Para obter detalhes, consulte as Normas dos casos de teste do integrador.

4. Conclua as transações de registo com os números de conta de teste fornecidos antes de executar os casos de teste.

5. Conclua todos os casos de teste necessários.

6. Preencha a Ficha de informações do produto (PIW) com os seus detalhes de contacto e a sua escolha de serviços FedEx.

7. Preencha a Folha de rosto de validação do integrador.

Enviar documentos

Envie todos os materiais necessários para validationmtp@fedex.com.

1. Prepare os seguintes documentos:

PIW preenchida (PDF)
Folha de rosto de validação preenchida (PDF)
Transações de registo de cliente final com autenticação multifator (JSON)
Etiquetas de expedição lidas para todos os casos de teste aplicáveis (PDF ou PNG)
Transações de expedição para três formatos de etiqueta (PDF, PNG e ZPL [JSON]), para as API Shipping e Rating aplicáveis
Capturas de ecrã (PDF) que mostrem:
- A solução orientada para o cliente que apresenta os serviços e o manuseamento especial da FedEx
- A declaração de isenção de responsabilidade
- O EULA (Contrato de Licença de Utilizador Final)
- O fluxo de registo de cliente final

2. Comprima todos os ficheiros num único ficheiro .zip para evitar restrições do fornecedor de e-mail.

3. Envie um e-mail com o ficheiro .zip à equipa de validação.

Boas práticas para evitar atrasos

Siga estas orientações para reduzir o tempo de revisão:

Imprima e leia etiquetas com um mínimo de 600 DPI. Não envie ficheiros gerados diretamente a partir das API.
Para impressoras térmicas, peça o tipo de imagem que corresponde à sua impressora, por exemplo, ZPLII para impressoras Zebra.
Para FedEx International Express®, inclua a Carta de porte (AWB) auxiliar (secundária).
Inclua uma etiqueta para cada volume nas expedições multipeças (MPS).

Avaliação das etiquetas

A equipa de validação revê o envio.

Se for rejeitado, responda ao feedback e envie novamente os documentos.
Se for aprovado, receberá um e-mail com a confirmação. Após a aprovação, as suas credenciais de produção são autorizadas para transações de etiquetas de expedição.

5 Passagem para a fase de produção

1. No menu, selecione Os meus projetos e, em seguida, selecione o Nome do projeto.

2. Na secção API, copie e guarde em segurança a sua chave de API de produção e a chave secreta.

Nota: guarde a sua chave secreta numa localização segura, pois só aparece uma vez. Se a perder, pode gerar uma nova mais tarde.