Fedex Logo
Developer Portal

Rates and Transit Times API

Introdução

Este guia detalhado permitir-lhe-á saber tudo o que precisa sobre tarifas e tempos de trânsito. A FedEx fornece-lhe a data/hora de entrega estimada e as tarifas de cada serviço oferecido.

Ao pedir cotações, é importante especificar os detalhes da expedição. Isto inclui a data, o endereço de origem detalhado, o endereço de destino, bem como as dimensões e o peso do volume. Ao fornecer estes detalhes de forma exata, certifica-se de que recebe o orçamento correto para a sua expedição. Se tiver requisitos especiais (por exemplo, se estiver a enviar mercadorias perigosas), tem de especificá-los nos detalhes da expedição.

Nota: a API de Tarifa não indica as tarifas dos serviços de carga da FedEx. Para saber mais sobre as tarifas do serviço de carga da FedEx, aceda à página de documentos da API de Carga LTL.

Detalhes da API de Tarifas e Tempos de Trânsito FedEx

Ao planear o seu orçamento, é útil saber o custo estimado da expedição. A FedEx oferece uma variedade de tarifas, consoante as suas necessidades. Pode pedir tarifas para as suas expedições FedEx. Além disso, existem tarifas de lista, descontos, sobretaxas, taxas e outros fatores que podem afetar as suas tarifas de expedição.

Seguem-se as funcionalidades associadas a esta API:

  • Obter Tarifa Rápida

    Obtenha tarifas rápidas e tempos de trânsito sem introduzir descrições detalhadas do volume.

  • Tempo de trânsito

    Obtenha os tempos de trânsito dos serviços entre a origem e o destino.

  • Tarifa Detalhada

    Obtenha cotações, tempos de trânsito, incluindo estimativas de direitos e taxas para expedições nacionais e internacionais. Os clientes têm de incluir informações detalhadas sobre a expedição, incluindo as dimensões do volume, o valor declarado (DV) e opções de serviço adicionais. As estimativas de direitos e taxas estão disponíveis apenas para clientes FedEx que estejam a enviar produtos/mercadorias e não documentos.

Vantagens da API de Tarifas e Tempos de Trânsito FedEx:

  • Simplifica o planeamento da expedição ao determinar os custos e os tempos de trânsito a partir de qualquer origem para qualquer destino em todo o mundo.
  • Fornece uma lista padrão e tarifas específicas da conta para vários serviços FedEx.
  • Poupa tempo com o acesso rápido a tarifas específicas de contas.
  • Poupa dinheiro ao comparar tarifas por serviço e ao permitir que tome decisões com base nas suas necessidades de expedição.
  • Poupa tempo com respostas rápidas a perguntas sobre os custos de expedição e a data de entrega.

Esta API fornece uma cotação de tarifa de expedição para uma combinação de serviços específica, consoante as informações de origem e destino fornecidas no pedido. Os seguintes detalhes são aplicáveis:

  • Estão disponíveis tarifas de desconto para todos os serviços e pares de origem/destino.
  • Esta API devolve as tarifas de origem e destino pelo serviço pedido e não indica se o serviço está disponível para a sua data de envio, bem como para a origem e o destino indicados.
  • Também pode consultar as tarifas de expedições FedEx Express dentro do México.
  • As tarifas também estão disponíveis para expedições FedEx Ground® Economy (anteriormente denominado FedEx SmartPost®).
  • Também pode especificar informações sobre tarifas e compromissos específicos do serviço.

Para obter informações detalhadas sobre os serviços oferecidos pela FedEx, consulte o Guia de Serviços FedEx eletrónico.

Como Funciona a API de Tarifas e Tempos de Trânsito FedEx

Tarifas e Tempos de Trânsito

Peça uma lista de todas as tarifas possíveis e informações de trânsito opcionais com base em detalhes introduzidos. As informações de introdução obrigatória associadas a este pedido são:

  • Número da Conta
  • Detalhes da expedição.

Ao pedir tarifas e tempos de trânsito:

  • Inclua o máximo de detalhes possível sobre a sua expedição. Estas informações são importantes para calcular os custos de expedição corretos com as sobretaxas incluídas.
  • Utilize o elemento RateRequestTypes para pedir tarifas específicas, quer se tratem de tarifas de LISTA ou específicas da conta. Se escolher LISTA como o valor do elemento, recebe tarifas de lista e tarifas específicas da conta.
  • Para pedir cotações para um único serviço, especifique o serviço para garantir a devolução dos dados das tarifas do serviço. Se não incluir o valor ServiceType, serão devolvidas tarifas de vários serviços.
  • Para obter tarifas detalhadas de uma transportadora específica, indique a transportadora ao utilizar CarrierCode no seu pedido e os dados das tarifas de todos os serviços da transportadora serão devolvidos. Se não especificar um CarrierCode, verá os serviços disponíveis de todas as transportadoras.
  • Utilize o elemento returnTransitTimes para incluir informações sobre o tempo de trânsito na resposta. O FedEx Express, FedEx Ground e FedEx Home Delivery incluem os dias e a data de entrega estimada do volume com base na data de expedição especificada.
  • A resposta para o pedido de tempos de trânsito para o FedEx Ground® Economy (anteriormente denominado FedEx SmartPost®) irá incluir a data de entrega específica e o dia da semana, com base nos valores especificados no pedido.
  • Informações como o código da transportadora, o tipo de serviço ou a opção de serviço podem ser utilizadas para filtrar os resultados.
  • Os resultados podem ser ordenados (Elemento: rateSortOrder), de modo a obter os dados das tarifas no formato desejado.

Resposta às Tarifas e Tempos de Trânsito

O resultado deste pedido irá fornecer uma lista de todas as tarifas e informações de trânsito opcionais possíveis com código de serviço, tipos de serviços, tipos de embalagens e detalhes de compromisso, como os dias/horas de trânsito e qualquer entrega num dia específico (entrega ao sábado).

Seguem-se as tarifas e taxas devolvidas:

  • Tarifas de LISTA – devolve tarifas de lista publicadas e baseadas na conta (se aplicável).
  • Tarifas PREFERENCIAIS – devolve as tarifas na Moeda Preferencial indicada no pedido.
  • Tarifas de INCENTIVO – preços promocionais.
  • Tarifas de CONTA – tarifas atribuídas à conta.
  • Sobretaxas
  • Descontos
  • Taxas e Impostos

Nota: um pedido de tarifas não devolve percursos. Todas as tarifas são apenas estimativas e podem diferir do montante apresentado na fatura.

Para obter mais informações sobre programas de descontos, consulte a secção Descontos.

Tarifas Especiais FedEx

Tarifas de Expedição Multi-peças

Esta opção está disponível para o FedEx Domestic, expedições multi-peças (MPS) FedEx International, bem como para expedições multi-peças International Ground®, FedEx Express e expedições multi-peças internacionais COD, bem como FedEx Ground e expedições multi-peças internacionais COD.

Tarifas de Volumes dos EUA: FedEx Express Multiweight®

As expedições multi-peças FedEx Express podem receber uma tarifa com base no peso total da expedição, caso as mesmas tenham um peso igual ou superior a 100 lb (200 lb ou mais para expedições FedEx Express Saver®). O peso mínimo médio de expedição é 15 lb. Multiplique a tarifa por libra pelo peso total da expedição. Será selecionada e aplicada automaticamente na faturação a tarifa mais baixa da tarifa de expedição FedEx Express Multiweight ou a soma dos preços individuais por volume.

FedEx One Rate

O FedEx One Rate tem uma taxa de expedição fixa e não requer que pese ou meça expedições com menos de 50 lb. Pode optar pela caixa ou tubo que melhor se adeque ao tamanho do que precisa de expedir e encher o volume até à sua capacidade máxima, desde que a expedição não exceda os 50 lb. Proporciona-lhe uma opção de expedição simples, previsível e de taxa fixa para os seus volumes FedEx Express. O FedEx One Rate consiste num portefólio de expedição com base em seis opções do Serviço FedEx Express com sete tipos de embalagens (brancas) exclusivas FedEx.

Embalagens FedEx One Rate

Os tipos de embalagens FedEx válidos/disponíveis com a opção de preço One Rate são os seguintes:

  • FEDEX_ENVELOPE
  • FEDEX_SMALL_BOX
  • FEDEX_MEDIUM_BOX
  • FEDEX_LARGE_BOX
  • FEDEX_EXTRA_LARGE_BOX
  • FEDEX_PAK
  • FEDEX_TUBE

As suas embalagens não estão disponíveis para a opção de preço One Rate.

Para obter mais informações sobre os serviços de embalagem, consulte Tipos de Embalagens

Como Especificar o Preço One Rate

Para especificar a Opção de Preço FedEx One Rate, siga os passos seguintes:

  • Especifique o Serviço de Expedição Especial \"FEDEX_ONE_RATE\".
  • Especifique um dos Tipos de Embalagens.
  • Especifique uma origem e um destino nos EUA.

    • Nota: os preços One Rate não são permitidos para expedições dentro do Havai.

  • Especifique um dos seguintes tipos de serviço FedEx Express:
    • FIRST_OVERNIGHT
    • PRIORITY_OVERNIGHT
    • STANDARD_OVERNIGHT
    • FEDEX_2_DAY
    • FEDEX_2_DAY_AM
    • EXPRESS_SAVER

Nota: os clientes FedEx podem pedir tarifas One Rate e tarifas baseadas no peso (não One Rate) num Pedido de Tarifa único ao especificar \"FEDEX_ONE_RATE\" como o Tipo de Opção de Serviço.

Taxas e Despesas de Manuseamento Variáveis

Taxa de manuseamento variável

Quaisquer taxas de manuseamento adicionais, além dos custos de expedição da operação de expedição, são adicionadas aos custos totais da mesma. Estes custos são devolvidos na resposta à Tarifa e podem ser configurados para impressão no separador Documento. Para obter mais informações, consulte a secção Taxas de manuseamento variáveis

Reembolso da Sobretaxa de Tarifa

Para quaisquer manuseamentos especiais ou serviços adicionais, as sobretaxas são cobradas juntamente com os custos de envio da sua expedição. Estes custos são devolvidos na resposta à Tarifa.

A tarifa devolve as sobretaxas disponíveis com os detalhes da tarifa.

As sobretaxas devolvidas na resposta à Tarifa são as seguintes:

  • Sobretaxas totais
  • Total de impostos (para expedições provenientes do Canadá)
  • Sobretaxa de artigos

Para obter mais informações, consulte a secção Sobretaxas

Taxas e Outras Informações de Expedição

A sua expedição pode incorrer em taxas, além da respetiva tarifa base.

  • Para expedições de importação FedEx Express U.S., as taxas variam consoante o país de origem. No entanto, cada taxa funciona de forma semelhante às taxas de exportação dos EUA.
  • Os U.S. Express Package Services incluem o FedEx First Overnight®, FedEx Priority Overnight®, FedEx Standard Overnight®, FedEx 2Day® A.M., FedEx 2Day® e FedEx Express Saver®.
  • Os U.S. Ground Services incluem o FedEx Ground® e o FedEx Home Delivery®.
  • Os International Express Package Services incluem o FedEx International First®, o FedEx International Priority®, o FedEx International Economy® e o Fedex Deferred Freight.
  • O International Ground Service inclui o FedEx International Ground® .[Service ENUM : FEDEX_GROUND]

Regras Empresariais

  • Não assuma que um serviço específico estará disponível em todos os cenários. Por exemplo, STANDARD_OVERNIGHT (entre outros) não está disponível entre todos os códigos postais.
  • Se for pedida a tarifa de um serviço específico, inclua o Tipo de Serviço no pedido. Isto irá diminuir o tamanho da resposta e reduzir o tempo de resposta da transação.
  • As Expedições com múltiplos volumes (MPS) não são elegíveis para o FedEx One Rate.
  • Para que um serviço especial seja incluído numa expedição, o tipo de serviço especial e os respetivos detalhes têm de ser incluídos. Se os detalhes do serviço especial não forem incluídos, é possível que não existam indicações de que o mesmo está incluído.
  • O carimbo de data/hora de uma tarifa ou expedição deve ser a hora esperada de apresentação do volume à FedEx ou a um agente FedEx. Não se trata necessariamente da hora da realização da transação da expedição ou das tarifas. Por exemplo, uma expedição gerada durante a noite da última sexta-feira com um volume que não será recolhido pela FedEx até segunda-feira deve apresentar "Segunda-feira" no carimbo de data /hora. Utilize o carimbo de data/hora correto se o mesmo for conhecido. Caso contrário, a estimativa de entrega e as tarifas poderão não estar corretas.
  • O requerimento de tarifas e tempo de trânsito utiliza apenas o nome da cidade ou o código postal para definir o tempo de trânsito. A FedEx apresenta apenas a cidade ou o código postal nos países de origem e destino que selecionou.
  • A FedEx não faz entrega a endereços de Caixas Postais nos EUA. Introduza um Código Postal para saber o tempo de trânsito da sua expedição ou clique em Encontrar Código Postal.
  • Os volumes recolhidos numa residência podem ter um dia de trânsito adicional. Para obter devoluções mais rápidas, entregue as expedições em estações FedEx com funcionários disponíveis.
  • A entrega de produtos farmacêuticos não está disponível para o serviço Reter na estação.

Recolha da API JSON

Documentation Powered by ReDoc

Rates and Transit Times API (1.0.0)

Rate and Transit times

This endpoint provides the ability to retrieve rate quotes and optionalll transit information. The rate is calculated based on the origin and destination of the shipment. Additional information such as carrier code, service type, or service option can be used to filter the results. If carrier code is provided, the response includes the rate quotes for the specific transportation carrier. This endpoint provides the rates for FedEx Ground and FedEx Express and does not offer rates for FedEx Freight.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.

header Parameters
x-customer-transaction-id
string
Example: 624deea6-b709-470c-8c39-4b5511281492

This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply.

content-type
required
string
Example: application/json

This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file.

x-locale
string
Example: en_US

This indicates the combination of language code and country code. Click here to see Locales

authorization
required
string
Example: Bearer XXX

This indicates the authorization token for the input request.

Request Body schema: application/json
One of
  • Full_Schema_Quote_Rate
  • MinimumSamplePayload_1
  • FreightSamplePayload-RateResourceDetails_1
  • US_Domestic_Rate_shop
  • FDGSamplePayload-RateResourceDetails-IntraEurope
  • Alternate_Currency_Rate_Quote
  • Express_Freight_Rate_Quote
  • International_Hold_At_Location_with_Adult_Signature_Option
  • International_Multi_Piece_Rate_Quote
  • International_Return_Rate_Quote
  • Intra_Canada_Rate_Quote
  • Intra_Europe_Rate_Quote
  • Intra_India_Cash_On_Delivery_Rate_Quote
  • Intra_Mexico_Express_Saver_Rate_Quote
  • Priority_Alert_Rate_Quote
  • Express_Freight_Saturday_Pickup_Rate_Quote
  • SmartPost_Rate_Quote
  • International_Dry_Ice_Rate_Quote
  • US_Domestic_Multi_Piece_Rate_Quote
  • US_Domestic_Priority_Overnight_Rate_Quote
  • Ground_Home_Delivery_Appointment_Delivery_Rate_Quote
  • International_Ground_Rate_Quote
  • International_Priority_Rate_Quote
accountNumber
required
object (AccountNumber)

This is the Account number details.
Note:

  • If the paymentType is Sender, then the account number is optional in shippingChargesPayment.

rateRequestControlParameters
object (RateRequestControlParameters)

Specify the return transit times, services needed on rate failure, choice of variable option and order to sort rate options to filter and sort the expected response.

requestedShipment
required
object (RequestedShipment)

This is shipment data for which a rate quote (or rate-shipping comparison) is requested.

carrierCodes
Array of strings

Specify the four letter code of a FedEx operating company that meets your requirements.
Example: FDXE

  • FDXE - FedEx Express
  • FDXG - FedEx Ground
  • FXSP - FedEx SmartPost
  • FXCC - FedEx Custom Critical.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /rate/v1/rates/quotes

Sandbox Server

https://apis-sandbox.fedex.com/rate/v1/rates/quotes

Production Server

https://apis.fedex.com/rate/v1/rates/quotes

Request samples

Content type
application/json
Example
Full_Schema_Quote_Rate
Copy
 Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "rateRequestControlParameters":
    {
    },
  • "requestedShipment":
    {
    },
  • "carrierCodes":
    [
    ]
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}
CLOSE

Response

Copy