Introdução
Este guia detalhado mostrará tudo o que você precisa saber sobre as tarifas e os tempos de trânsito. A FedEx fornece uma data/hora estimada da entrega e cotações de tarifa para cada serviço oferecido.
Ao solicitar cotações de tarifa, é importante especificar os detalhes da remessa. Esses detalhes são a data, os endereços de origem e destino completos, e dimensões e peso do pacote. Fornecer detalhes precisos garante que você receba uma cotação correta para a remessa. Qualquer requisito especial, como carga perigosa, precisa ser especificado nos detalhes da remessa.
Observação: a API de tarifa não fornece as cotações de tarifa para os serviços de carga da FedEx. Para saber mais sobre as cotações de tarifa para os serviços de carga da FedEx, visite a página de documentação da API de carga parcial (LTL).
Detalhes da API de tarifas e tempos de trânsito da FedEx
Essa API ajuda você a saber o custo estimado da remessa e planejar seu orçamento. A FedEx oferece várias tarifas de acordo com a sua necessidade. Você pode solicitar tarifas para suas remessas FedEx. Outros fatores que podem afetar a tarifa são listados na tabela de preços, que inclui descontos, cobranças adicionais, taxas etc.
Os seguintes recursos estão associados a essa API:
- Obter cotação de tarifa rápida
Obtenha cotações de tarifa e tempos de trânsito rapidamente, sem inserir descrições detalhadas do pacote.
- Tempo de trânsito
Obtenha o tempo de trânsito para serviços entre a origem e o destino.
- Cotação de tarifa detalhada
Obtenha cotações de tarifa e tempo de trânsito, incluindo estimativas de taxas e impostos aduaneiros, para remessas nacionais e internacionais. Os clientes devem fornecer informações detalhadas da remessa, incluindo as dimensões do pacote, valor declarado e opções adicionais de serviço. Estimativas de taxas e impostos aduaneiros estão disponíveis apenas para clientes FedEx enviando produtos/mercadorias, não documentos.
Benefícios da API de tarifas e tempos de trânsito da FedEx
- Simplifica o planejamento de remessas ao determinar os custos e tempos de trânsito de qualquer origem para qualquer destino no mundo.
- Fornece tanto cotações da tabela padrão como de tarifas específicas da conta para vários serviços FedEx.
- Economiza tempo com acesso rápido a tarifas específicas da conta
- Economiza tempo ao comparar as tarifas por serviço e ajudar o cliente a escolher a melhor opção para suas necessidades de envio.
- Economiza tempo com respostas rápidas a perguntas sobre custo de remessa e data de entrega
A API traz a cotação da tarifa da remessa para uma combinação específica de serviço de acordo com as informações de origem e destino fornecidas na solicitação. Os detalhes a seguir são aplicáveis:
- Há tarifas de desconto disponíveis para todos os serviços e pares de origem/destino.
- A API retorna a tarifa para a origem, o destino e o serviço solicitado, e não validará se o serviço está realmente disponível para a data do envio ou para a origem/destino.
- Também é possível verificar tarifas para remessas FedEx Express dentro do México.
- As tarifas também estão disponíveis para envios via FedEx Ground® Economy (antigo FedEx SmartPost®).
- Informações de compromisso e de tarifa específicos para o serviço também podem ser especificadas.
Para obter informações mais detalhadas sobre os serviços oferecidos pela FedEx, consulte o Guia de Serviços FedEx eletrônico.
Como a API de tarifas e tempos de trânsito da FedEx funciona
Tarifa e tempos de trânsito
Solicita uma lista de todas as cotações de tarifa possíveis e informações opcionais de trânsito com base nos detalhes inseridos. As informações de entrada necessárias associadas a essa solicitação são:
- Número da conta
- Detalhes da remessa
Ao solicitar tarifas e tempos de trânsito:
- Inclua o máximo possível de detalhes sobre sua remessa. Essas informações são importantes para calcular os custos de remessa corretos, incluindo cobranças adicionais.
- Use o elemento RateRequestTypes para solicitar tarifas específicas, seja usando LIST ou as tarifas específicas da conta. Se escolher LIST como o valor do elemento, você receberá tanto os preços da tabela como os específicos da conta.
- Para solicitar cotações para um único serviço, especifique o serviço para receber só os dados de tarifa específicos desse serviço. Se você não incluir o valor ServiceType, receberá as tarifas de vários serviços.
- Para obter tarifas detalhadas específicas da transportadora, especifique a transportadora usando CarrierCode na solicitação e você receberá os dados de tarifa para todos os serviços da transportadora selecionada. Se você não especificar o CarrierCode, serão retornados todos os serviços disponíveis de todas as transportadoras.
- Use o elemento returnTransitTimes para incluir informações de tempo de trânsito na resposta. FedEx Express, FedEx Ground e FedEx Home Delivery incluem a estimativa de dias, além da data de entrega do pacote, com base na data de envio especificada.
- A resposta para a solicitação de tempos de trânsito do FedEx Ground® Economy (anteriormente chamado de FedEx SmartPost®) incluirá a data de entrega e o dia da semana específicos com base nos valores especificados na solicitação.
- Informações como o código da transportadora, tipo de serviço ou opção de serviço podem ser usadas para filtrar os resultados.
- Os resultados podem ser ordenados (Elemento: rateSortOrder) para dispor os dados da cotação de tarifa no formato desejado.
Resposta de tarifas e tempos de trânsito
O resultado dessa solicitação fornecerá uma lista de todas as cotações de tarifa possíveis e informações de trânsito opcionais com código de serviço, tipos de serviço, tipos de embalagem e detalhes de compromisso, como os dias/horas em trânsito e qualquer dia específico de entrega (entrega aos sábados).
As tarifas e cobranças informadas na resposta são:
- Tabela de preços – informa a tabela de preços publicada, além de tarifas específicas da conta (se aplicável)
- Tarifas preferenciais – informa as tarifas na moeda preferencial fornecida na solicitação
- Tarifas de incentivo – preços promocionais
- Tarifas da conta – tarifas atribuídas à conta
- Cobranças adicionais
- Descontos
- Taxas e impostos
Observação: uma solicitação de tarifa não informa a rota. Todas as cotações de tarifa são apenas estimativas e diferir do valor real cobrado na fatura.
Para obter mais informações sobre programas de desconto, consulte Descontos.
Tarifas especiais FedEx
Tarifas de remessa com vários volumes
Esta opção está disponível para remessas de vários volumes (MPS) usando os serviços FedEx Domestic, FedEx International, assim como os serviços Domestic e International Ground®, FedEx Express C.O.D. (internacional) e FedEx Ground C.O.D (internacional).
Tarifas de pacote nos EUA: FedEx Express Multiweight®
Remessas de vários pacotes da FedEx Express poderão receber uma tarifa com base no peso total se pesarem 45 kg ou mais (90 kg ou mais para remessas FedEx Express Saver®). Um peso mínimo médio de 6,8 kg é aplicável para a remessa. Multiplique a tarifa por kg pelo peso total da remessa. A menor tarifa de remessa FedEx Express Multiweight ou a soma do preço individual por pacote será selecionada e aplicada automaticamente no faturamento.
FedEx One Rate
O FedEx One Rate é uma remessa de preço fixo que não exige dados de peso ou medida para remessas com menos de 22,7 kg. Você pode escolher a caixa ou tubo que melhor se adequar ao tamanho do conteúdo que precisa enviar e encher o pacote até o máximo, desde que a remessa não ultrapasse 22,7 kg. Isso oferece a você uma opção de remessa com tarifa fixa simples e previsível para seus pacotes FedEx Express. O FedEx One Rate é um portfólio de envio baseado em seis opções de serviço FedEx Express, combinado com sete tipos de embalagens proprietários (brancos) da FedEx.
Embalagem FedEx One Rate
Os tipos de embalagem FedEx disponíveis e válidos com a opção de preço One Rate são:
- FEDEX_ENVELOPE
- FEDEX_SMALL_BOX
- FEDEX_MEDIUM_BOX
- FEDEX_LARGE_BOX
- FEDEX_EXTRA_LARGE_BOX
- FEDEX_PAK
- FEDEX_TUBE
Você não pode usar a própria embalagem com a opção de preço One Rate.
Para obter mais informações sobre serviços de embalagens, consulte Tipos de embalagem.
Como especificar o preço One Rate
Para especificar a opção de preço FedEx One Rate, realize as etapas a seguir:
- Especifique o serviço de remessa especial \"FEDEX_ONE_RATE\".
- Especifique um dos tipos de embalagem disponíveis.
- Especifique uma origem e um destino nos EUA.
- Escolha um dos seguintes tipos de serviço FedEx Express:
- FIRST_OVERNIGHT
- PRIORITY_OVERNIGHT
- STANDARD_OVERNIGHT
- FEDEX_2_DAY
- FEDEX_2_DAY_AM
- EXPRESS_SAVER
Observação: remessas no Havaí não podem usar o preço One Rate.
Observação: clientes FedEx podem solicitar tanto a tarifa One Rate quanto a tarifa baseada em peso (não One Rate) em uma única solicitação de tarifa ao especificar \"FEDEX_ONE_RATE\" como o tipo de opção de serviço na solicitação.
Taxas e cobranças variáveis de manuseio
Taxa de manuseio variável
Quaisquer taxas de manuseio adicionais cobradas além das taxas de envio da operação de remessa serão adicionadas à cobrança total. Essas cobranças são informadas na resposta da tarifa e podem ser configuradas para serem impressas na guia de documentos. Para mais informações, consulte Taxas de manuseio variáveis
Informação de cobrança adicional na tarifa
Caso algum manuseio ou serviço especial seja solicitado, serão adicionadas sobretaxas às cobranças da remessa. Essas cobranças são informadas na resposta da tarifa.
A cotação de tarifa informa as sobretaxas disponíveis juntamente com os detalhes da tarifa.
As sobretaxas informadas na resposta da tarifa são:
- Cobrança adicional total
- Total de impostos (para remessas originárias do Canadá)
- Cobrança adicional detalhada
Para obter mais informações, consulte Cobranças adicionais.
Taxas e outras informações de remessa
Sua remessa pode incorrer em taxas adicionais à tarifa básica.
- No caso de remessas de importação FedEx Express nos EUA, as taxas variam de acordo com o país de origem, mas cada taxa funciona da mesma maneira como na exportação dos EUA.
- Os serviços Express Package dos EUA incluem FedEx First Overnight®, FedEx Priority Overnight®, FedEx Standard Overnight®, FedEx 2Day® A.M., FedEx 2Day® e FedEx Express Saver®.
- Os serviços por terra nos EUA incluem FedEx Ground® e FedEx Home Delivery®.
- Os serviços International Express Package incluem FedEx International First®, FedEx International Priority® e FedEx International Economy®.
- O serviço International Ground inclui o FedEx International Ground®. [Service ENUM : FEDEX_GROUND]
Regras do negócio
- Não pressuponha que um serviço em particular estará disponível em todas as situações. Por exemplo, STANDARD_OVERNIGHT (entre outros) não está disponível em todos os códigos postais.
- Se um tipo de serviço específico estiver sendo solicitado para a definição da tarifa, inclua o tipo de serviço na solicitação. Isso reduzirá o tamanho da resposta e o tempo de resposta da transação.
- Para incluir um serviço especial em uma remessa, informe o tipo e os detalhes do serviço desejado. Caso os detalhes do serviço especial não sejam informados, o serviço não será incluído na remessa, mas nem sempre haverá um aviso de não inclusão.
- O carimbo de data/hora de uma tarifa ou remessa deve ser a hora esperada de recebimento do pacote na FedEx ou por um agente da FedEx, que não é necessariamente a hora na qual a transação da remessa ou tarifa é realizada. Por exemplo, uma remessa gerada na noite de sexta-feira para um pacote que não será coletado pela FedEx até a segunda-feira deve ter um carimbo de data/hora de segunda-feira. Use o carimbo de data/hora correto se conhecido, ou as estimativas de entrega e de tarifa poderão não ser calculadas corretamente.
- A aplicação de tarifa e tempos de trânsito só usa o nome da cidade ou código postal para definir o tempo de trânsito. A FedEx só mostra as cidades ou códigos postais atendidos pela FedEx nos países de destino e origem selecionados por você.
- A FedEx não entrega em endereços de caixa postal nos EUA. Insira um código postal para encontrar o tempo de trânsito da remessa ou clique em Localizar CEP/código postal.
- Pacotes coletados de uma residência podem ter um dia de trânsito adicional. Para retornos mais rápidos, entregue o pacote em uma localidade FedEx com funcionários.
- Entregas de farmácias não são válidas com a opção Reter na localidade.
Coleção JSON API
Response