Fedex Logo

Introdução

A API de carga parcial (LTL) permite que você crie remessas para carga parcial (LTL). A carga parcial (LTL) é muito grande para ser enviada como um pacote, mas ocupa menos do que um caminhão inteiro.

Isto permite obter estimativas de taxas, criar etiquetas de envio exclusivas para unidades de manuseio individuais e conhecimentos aéreos (quando necessário), programar coletas e acompanhar o status da remessa, verificar a disponibilidade e programar coletas. Isso resulta em maior eficiência para remessas maiores e mais pesadas.

O transporte LTL na FedEx Freight oferece rastreamento e visibilidade em nível de unidade de manuseio para suas remessas de unidades de manuseio múltiplas, bem como envio doméstico sem um conhecimento aéreo (BOL) em papel na maioria dos casos. Um conhecimento aéreo pode ser criado quando necessário. Mesmo que todas as unidades de manuseio tenham um número de rastreamento único, a remessa é transportada com um conhecimento aéreo, um recibo de entrega e uma declaração de fatura.

Detalhes sobre a API de carga parcial (LTL)

A API de carga parcial (LTL) permite remessas LTL e cria os documentos necessários, como conhecimento de embarque (quando solicitado), etiquetas de envio FedEx Freight e vários outros documentos da remessa. Nas remessas LTL, a etiqueta principal é aplicada na primeira unidade de manuseio, e a etiqueta secundária é aplicada na segunda unidade de manuseio e nas unidades de manuseio subsequentes. As etiquetas secundárias têm seu próprio número de rastreamento, mas se referem ao número principal de rastreamento. Um único conhecimento de embarque por remessa pode ser criado, abrangendo todas as unidades de manuseio e todos os volumes.

Cada unidade de manuseio pode ser associada a um número de rastreamento e a etiqueta é semelhante a uma etiqueta FedEx Ground ou Express Parcel, com exceção de um F, que representa uma remessa de carga.

Limites máximos de unidades de manuseio e volumes por unidade de manuseio:

  • Limite máximo de volumes por unidade de manuseio – 9.999
  • Limite máximo de unidades de manuseio – 200 (ao imprimir um rótulo de unidade de manuseio por vez).
  • Limite máximo de unidades de manuseio – 40 (ao imprimir várias etiquetas de unidade de manuseio ao mesmo tempo) 

As remessas de carga parcial (LTL) da FedEx estão disponíveis em todos os 50 estados dos EUA, bem como Porto Rico, Ilhas Virgens (EUA), Canadá e México. Algumas remessas exigem um conhecimento aéreo, além das etiquetas de envio. Um exemplo dessas remessas são as que contêm material perigoso.

O FedEx Freight® está transformando o setor de LTL, facilitando o envio de mercadorias de forma rápida e econômica em uma rede LTL simplificada.

Os seguintes recursos estão disponíveis com essa API:

  • Gerenciar coleta de carga parcial (LTL)

    Esse recurso permite obter os locais de coleta de carga parcial (LTL), agendar uma coleta de carga e cancelar qualquer coleta já agendada.

  • Obter uma cotação de tarifa de carga parcial (LTL)

    Esse recurso permite obter as cotações de tarifa para uma remessa de carga parcial (LTL) com base nos locais e nas opções de serviço selecionados.

  • Enviar remessa de carga parcial (LTL)

    Esse recurso permite criar uma remessa de carga parcial (LTL).

Estes são os recursos da API de carga parcial (LTL):

  • Enviar um único volume ou remessa MPS para todos os tipos de serviço, gerando, assim, etiqueta(s) de envio ou um formulário de conhecimento aéreo (se necessário).
  • Criar uma remessa de várias unidades de manuseio e rastrear cada unidade de manuseio individualmente.
  • Criar remessas de carga parcial (LTL) usando os serviços FedEx Freight Priority e Freight Economy.
    • Fornecer as informações do destinatário, como número da conta, contato e endereço.
    • Fornecer o carimbo de hora, tipo de embalagem, peso total e vários outros detalhes obrigatórios, conforme mencionado no esquema do endpoint.
  • Fornecer a etiqueta FedEx com marca padrão e permitir tamanhos específicos de etiquetas térmicas.
  • Receber notificações por e-mail ou texto SMS durante a transação de envio, como:
    • Notificação de envio
    • Entrega estimada
    • Notificação de coleta
  • Gerar documentos de envio, como:
    • Etiquetas de envio de unidades de manuseio individuais
    • Conhecimento Aéreo
    • Fatura comercial
    • Fatura da alfândega canadense
  • Criar remessas e imprimir etiquetas em um ritmo de uma unidade de manuseio por vez ou processar todas as unidades de manuseio de uma vez.
  • Obter as tarifas de uma única peça ou remessa MPS para todos os tipos de serviço.
  • Verificar a disponibilidade de coleta, agendar a coleta da carga e cancelar uma coleta.
  • Crie e agende coletas com contas de terceiros para um endereço de cobrança alternativo.

Serviços de envio de carga parcial (LTL)

Os seguintes serviços de envio de carga parcial (LTL) estão disponíveis:

FedEx Freight® Priority

Com desempenho de prazo líder do setor e curto tempo de trânsito, o FedEx Freight® Priority entrega suas remessas com rapidez e confiança. Conte com nosso serviço regional para ampla entrega no dia seguinte e no segundo dia aos seus clientes, tudo com a garantia de reembolso do valor do frete. *

Recursos do serviço FedEx Freight® Priority:

  • Tempos de trânsito curtos com serviço do dia seguinte até 600 milhas (966 km) e entrega no segundo dia até 1.600 (2.575 km)
  • Entrega direta para praticamente todos os códigos postais nos EUA, Canadá e México
  • Confiabilidade de prazo consistente
  • Garantia de reembolso do valor do frete sem taxa*
  • Tecnologia da informação de última geração com visibilidade de remessa do início ao fim
  • Uma equipe de profissionais exclusiva para atender a todas as suas necessidades de cargas regionais

*Todos os serviços estão sujeitos aos termos e condições das tarifas das regras da série FXFR 100.

FedEx Freight Economy

O FedEx Freight® Economy oferece entrega econômica de carga parcial (LTL), com foco em suas necessidades básicas de transporte de carga. Com os serviços de entrega de carga parcial (LTL) da FedEx, proporcionamos excelente serviço de atendimento ao cliente com confiabilidade no prazo e manuseio cuidadoso.

O FedEx Freight® Economy oferece:

  • Soluções econômicas de carga
  • Maior economia para remessas que são menos urgentes, mas que precisam de entrega confiável
  • Confiabilidade de prazo consistente
  • Entrega direta para praticamente todos os códigos postais nos EUA, Canadá, México e Porto Rico
  • Tecnologia da informação de última geração com visibilidade de remessa do início ao fim
  • Visibilidade aprimorada com rastreamento de remessa de ponta a ponta

Como a API de carga parcial (LTL) funciona

Esta seção descreve os endpoints e os principais elementos necessários para a API de carga parcial (LTL) da FedEx.

Observação: a sua conta de carga parcial (LTL) da FedEx deve estar habilitada para usar a API de carga parcial (LTL) da FedEx. As principais informações necessárias são o número da conta do FedEx Freight e o endereço de correspondência correto da conta para processar as remessas LTL.

Os seguintes endpoints estão disponíveis com essa API:

Enviar carga parcial (LTL)

Use esse endpoint para validar e criar a remessa de carga parcial (LTL) da FedEx.

As informações obrigatórias associadas a essa solicitação são:

  • Número de conta de carga
  • Endereço postal da conta
  • Remessa de carga solicitada
  • Opções de resposta de etiqueta: etiquetas a serem retornadas como codificadas ou como URL
  • Detalhes do rastreamento principal: apenas no processamento de uma remessa MPS com impressão individual de etiquetas e não de uma só vez (quando o elemento singleShotMPS não é fornecido ou adicionado com valor falso)

A resposta bem-sucedida a esta solicitação cria a remessa LTL, fornece detalhes de rastreamento e detalhes de alerta. Ela também retorna erros e descrições em caso de falhas.

Observação: o endereço de correspondência pode ser diferente do endereço de entrega real.

Verificar a disponibilidade de coleta de carga parcial (LTL)

Use esse endpoint para solicitar uma lista de todos os locais de coleta de carga disponíveis com os detalhes do agendamento da coleta, como transportadora, último horário disponível de coleta, último horário disponível padrão, disponibilidade para coleta, horário em que o pacote está pronto para ser coletado, indicação de endereço residencial, horário limite da coleta e acesso do motorista para retirar o pacote.

As informações obrigatórias associadas a essa solicitação são:

  • Detalhes do endereço de coleta
  • Tipo de solicitação de coleta (por exemplo: mesmo dia/dia futuro)
  • Se é uma coleta doméstica/internacional

Observação: use um endereço de coleta correto e válido. 

A resposta bem-sucedida a esta solicitação fornecerá uma lista de todos os locais de coleta de carga disponíveis, dia de entrega, disponibilidade (indicador), data de coleta, horário limite, tempo de acesso, disponibilidade residencial (indicador), hora de fechamento (indicador), hora de fechamento e hora local. Ela também retorna erros e descrições em caso de falhas.

Criar coleta de carga parcial (LTL)

Use esse endpoint para criar e agendar uma coleta de carga parcial (LTL).

As informações obrigatórias associadas a essa solicitação são:

  • O número da conta de carga que será faturada para a coleta
  • Dados da origem (endereço, localidade e tipo de endereço de coleta, como conta/remetente/outro)
  • Detalhes do endereço da conta associada

A solicitação de coleta bem-sucedida retornará um número de confirmação de coleta, notificação de coleta e código de local para a coleta sendo agendada. Ela também retorna erros e descrições em caso de falhas.

Observação: use um endereço válido e correto para coleta e forneça também o endereço correto registrado na conta para o agendamento. Ao agendar uma coleta, não insira um horário ou data indicados para coleta no passado, ou uma data muito distante no futuro. Coletas anônimas não são permitidas. Você pode agendar coletas para contas de terceiros fornecendo detalhes válidos de endereço alternativos.

Cancelar coleta de carga parcial (LTL)

Use esse endpoint para cancelar uma solicitação de coleta já agendada para um pacote LTL. O cancelamento de coleta bem-sucedido retornará um número de confirmação e uma mensagem de confirmação de cancelamento da coleta.

As informações obrigatórias associadas a essa solicitação são:

  • Código de confirmação da coleta (obtido ao enviar uma solicitação de coleta)
  • Data agendada (data em que o despacho de coleta ocorre)
  • Localidade (a localidade FedEx Express responsável por processar a solicitação de coleta)

A solicitação bem-sucedida retornará um número de confirmação de coleta, notificação de coleta e código de local para a coleta sendo agendada. Ela também retorna erros e descrições em caso de falhas.

Observação: envie o número de confirmação de coleta e o código de localidade correspondente (aplicável apenas ao FDXE) para cancelar a coleta agendada. As informações do número de confirmação da coleta e o código de localidade correspondente (aplicável apenas ao FDXE) são obtidos ao enviar uma solicitação de coleta. Use também o endereço correto registrado na conta para cancelar a coleta. Uma notificação de falha será enviada se você tentar cancelar uma coleta depois que o mensageiro da FedEx tiver sido enviado para o local de coleta.

Cotar carga parcial (LTL)

Use esse endpoint para solicitar uma lista de todas as cotações de tarifa de carga possíveis e as informações opcionais de trânsito com base nos detalhes inseridos. As tarifas recuperadas são baseadas na origem, destino e outros dados da remessa. Informações adicionais, como código da transportadora, tipo de serviço ou opção de serviço, podem ser usadas para obter resultados mais precisos.

As informações obrigatórias associadas a essa solicitação são:

  • Número de conta de carga
  • Remessa que solicita frete

A resposta bem-sucedida a esta solicitação retornará uma lista de todas as tarifas possíveis e o código de localidade da coleta sendo agendada. Ela também retorna erros e descrições em caso de falhas.

Remessa de vários volumes (MPS) de carga parcial (LTL)

Uma remessa de vários volumes (MPS) consiste em duas ou mais unidades de manuseio enviadas para o mesmo endereço de destinatário. A primeira unidade de manuseio na solicitação de remessa é considerada a principal.

Para criar uma remessa de vários volumes:

  • Inclua as informações de envio, como serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail e requestedPackageLineItems. (Observação: o sequenceNumber do pacote principal deve ser igual a 1.)
  • Para imprimir etiquetas por unidade de manuseio, inclua os detalhes do rastreamento principal no elemento masterTrackingId para todos as unidades de manuseio subsequentes.

Estas são as opções de processamento de envio de vários volumes disponíveis com esta API:

Imprimir uma etiqueta de unidade de manuseio de cada vez

Essa API permite que você processe remessas MPS e obtenha uma etiqueta de cada vez.

Quando você precisar desse recurso para suas remessas, forneça o elemento oneLabelAtATime como verdadeiro na solicitação, juntamente com todos os elementos MPS necessários.

O resultado da primeira solicitação deve gerar a etiqueta e o número de rastreamento, que é o número de rastreamento principal. Forneça esse número de rastreamento principal no elemento masterTrackingId para processar a solicitação de envio subsequente e gerar etiquetas com números de rastreamento (números de rastreamento secundários) para a contagem total de pacotes definida (totalPackageCount).

Observação: o limite máximo de unidades de manuseio é 200.

Imprimir todas as etiquetas da unidade de manuseio de uma só vez

Esta API permite que você processe remessas de vários volumes (MPS) e obtenha todas as etiquetas ao mesmo tempo. Esse é o método de processamento ideal usado quando uma remessa tem 40 unidades ou menos de manuseio (totalPackageCount<=40) enviadas para o mesmo endereço do destinatário.

Defina oneLabelAtATime como falso na solicitação de remessa com 40 unidades ou menos de manuseio e gere as etiquetas instantaneamente.

Observação: o limite máximo de 40 unidades de manuseio é representativo, não é fixo. O limite também depende da combinação de número de unidades de manuseio e mercadorias. Entre em contato com um executivo da FedEx para saber mais.

Exemplo: a solicitação de remessa abrange 10 unidades de manuseio. Ao ser enviada, ela gerará 10 etiquetas, URLs ou etiquetas codificadas, como solicitado, que serão fornecidas na resposta.

FedEx Freight Direct

Este serviço oferece uma excelente experiência do cliente na entrega de mercadorias grandes e paletizadas, incluindo na entrega de remessas pesadas e volumosas dentro da casa ou da empresa do cliente.

O serviço oferece a possibilidade de comunicação proativa, opções flexíveis de entrega e precificação em lote que inclui várias sobretaxas.

Veja alguns dos recursos disponíveis neste serviço:

  • Possibilita a criação do FedEx Freight Direct básico, básico por agendamento, remessas de entrega padrão e premium e remessas/coletas de devolução básicas dentro da área continental dos Estados Unidos, Alasca e Havaí.
  • Inclui a capacidade de obter uma estimativa completa de tarifa para uma remessa do FedEx Freight Direct usando um número de conta do FedEx Freight Direct e a capacidade de cancelar uma coleta do FedEx Freight Direct.
    • Não haverá estimativas de tarifas para o Alaska e o Havaí. Os clientes devem ligar para o Serviço de Atendimento ao Cliente FedEx para solicitar uma cotação para esses estados.
    • Para cancelar uma coleta agendada para o mesmo dia, o cliente precisa entrar em contato com o Serviço de Atendimento ao Cliente FedEx.
  • Permite que você envie notificações por e-mail ao remetente/consignatário original para que o cliente possa:
    • Agendar uma entrega
    • Receber confirmação de entrega e/ou coleta
    • Receber notificação de saída para entrega e/ou coleta
    • Receber notificações de remessa em trânsito
    • Consultar remessas entregues
  • As regras comerciais para verificação do CEP, dimensões e peso da peça e da unidade de manuseio serão aplicáveis ao FedEx Freight Direct para determinar a combinação correta dos serviços de transferência e de trecho inicial/final.

O FedEx Freight Direct oferece vários tipos de serviço.

Esta API oferece os seguintes recursos com o serviço Freight Direct:

Consultar tarifas do Freight Direct

Use este endpoint para consultar tarifas e sobretaxas do Freight Direct para as seguintes opções especiais do serviço Freight Direct: serviço básico, serviço básico por agendamento, serviço padrão, serviço premium.

Estes são os detalhes obrigatórios que precisam constar na solicitação de tarifa usando o endpoint Cotar carga parcial (LTL):

  • Tipo de Freight Direct (BÁSICO, BÁSICO_POR_AGENDAMENTO, PREMIUM, PADRÃO)
  • O tipo de transporte do Freight Direct (ENTREGA, COLETA)
  • O tipo do número de telefone, se fornecido (RESIDÊNCIA, CELULAR, TRABALHO)
  • dimensional
  • Dimensões (Comprimento, Largura e Altura em número positivo)

Criar remessa do Freight Direct

Use este endpoint para enviar uma peça única ou uma remessa de vários volumes para as seguintes opções especiais do serviço Freight Direct: serviço básico, serviço básico por agendamento, serviço padrão, serviço premium e para obter uma etiqueta de envio ou BOL, incluindo a documentação necessária para processar remessas de carga Priority.

Estes são os detalhes obrigatórios que precisam constar na solicitação de remessa por meio do endpoint Enviar carga parcial (LTL):

  • Tipo de Freight Direct (BÁSICO, BÁSICO_POR_AGENDAMENTO, PREMIUM, PADRÃO)
  • O tipo de transporte do Freight Direct (ENTREGA, COLETA)
  • Endereço de e-mail, número de telefone e tipo de número de telefone
  • dimensional
  • Dimensões (Comprimento, Largura e Altura em número positivo)

O BOL de saída terá os novos nomes do serviço Freight Direct impressos. Os seguintes valores estarão impressos no BOL dependendo do serviço selecionado:

  • ENTREGA BÁSICA DO DIRECT
  • ENTREGA BÁSICA POR AGENDAMENTO DO DIRECT
  • ENTREGA PREMIUM DO DIRECT
  • ENTREGA PADRÃO DO DIRECT
  • COLETA BÁSICA DO DIRECT
  • COLETA BÁSICA POR AGENDAMENTO DO DIRECT
  • COLETA PREMIUM DO DIRECT
  • COLETA PADRÃO DO DIRECT

Coleta do Freight Direct

Use este endpoint para verificar a disponibilidade do serviço de coleta de frete de carga parcial do Freight Direct, criar uma solicitação de coleta para um pacote a ser coletado ou cancelar uma coleta existente solicitada.

Estes são os detalhes obrigatórios que precisam constar na solicitação de coleta usando o endpoint Verificar a disponibilidade de coleta de carga parcial (LTL), Criar coleta de carga parcial (LTL) e Cancelar coleta de carga parcial (LTL):

  • Tipo de Freight Direct (BÁSICO, BÁSICO_POR_AGENDAMENTO, PREMIUM, PADRÃO)
  • O tipo de transporte do Freight Direct (ENTREGA, COLETA)
  • Endereço de e-mail (criação de solicitação de coleta)
  • Número de telefone e tipo de número de telefone (criação de solicitação de coleta)
  • dimensional

Regras do negócio

  • Um número de rastreamento principal (Pro) é atribuído à primeira unidade de manuseio de uma remessa de carga parcial (LTL) e os números de rastreamento secundários são atribuídos a cada unidade de manuseio subsequente.
  • Cada unidade de manuseio na remessa pode ser rastreada individualmente ou como parte da remessa inteira.
  • Outros documentos podem se aplicar a remessas específicas (por exemplo, carga de material perigoso [MatPerig] e remessas internacionais).
  • Somente carga LTL e fatura para contas de carga LTL não podem ser adicionadas ao FedEx Developer Portal.
  • Os clientes podem usar o número da conta do LTL de longo prazo ou o número da conta do FedEx Freight Direct para utilizar os serviços Freight Direct.
  • Os recursos de cálculo de tarifa do FedEx Freight Direct estão disponíveis apenas na API de LTL comum.
  • Todas as novas mensagens e erros serão em inglês.
  • O endereço de e-mail e o telefone são necessários para solicitar o serviço FedEx Freight Direct durante a criação das remessas.

Coleção JSON API

CLOSE

Response

Copy