Introdução
A API de Carga LTL permite criar expedições para LTL (less-than-truckload). A carga LTL é demasiado grande para ser expedida como pacote mas exige menos do que um camião completo.
Isto permite que obtenha estimativas de tarifas, crie etiquetas de expedição únicas para unidades de manuseamento individuais e Comprovativos de Carga (quando necessário), agende recolhas e rastreie os estados da expedição, verifique a disponibilidade e agende recolhas. Tal resulta numa maior eficiência para as suas expedições maiores e mais pesadas.
A expedição LTL na FedEx Freight oferece rastreamento e visibilidade a nível da unidade de manuseamento para as suas expedições de várias unidades de manuseamento, bem como expedição doméstica sem um Comprovativo de Carga (BOL) em papel na maioria das situações. Um Comprovativo de Carga pode ser criado quando necessário. Embora todas as unidades de manuseamento tenham um número de rastreio único, a expedição é transportada em referência a um Comprovativo de Carga, um Recibo de Entrega e uma Declaração de Fatura.
Detalhes da API de Carga LTL
A API de Carga LTL permite expedições LTL e cria os documentos necessários, tais como o Comprovativo de carga (quando solicitado), as etiquetas de expedição FedEx Freight e vários outros documentos de expedição. Na Expedição de carga LTL, a etiqueta principal vai na primeira unidade de manuseamento e a etiqueta secundária é aplicada à segunda e subsequentes unidades de manuseamento. As etiquetas secundárias têm o seu próprio número de rastreio, mas referem-se ao número de rastreio principal. Pode ser criado um único Comprovativo de carga por expedição que consiste em todas as unidades de manuseamento e volumes.
Cada unidade de manuseamento pode ser associada a um número de rastreio e a etiqueta é semelhante a uma etiqueta FedEx Ground ou Express Parcel com a exceção de um F, que representa uma Expedição de carga.
Máximos para unidades de manuseamento e volumes por unidade de manuseamento:
- O número máximo de volumes por unidade de manuseamento é 9999.
- Número máximo de unidades de manuseamento: 200 (quando é impressa apenas uma etiqueta de unidade de manuseamento de cada vez).
- Número máximo de unidades de manuseamento – 40 (quando as Etiquetas de unidades de manuseamento são impressas em simultâneo)
As expedições de Carga LTL da FedEx estão disponíveis para os 50 estados, bem como para Porto Rico, USVI, Canadá e México. Algumas expedições exigem um Comprovativo de Carga para além das etiquetas de expedição. Um exemplo destas expedições são as que contêm materiais perigosos.
A FedEx Freight® está a mudar a indústria LTL ao facilitar o envio de carga de forma rápida e económica dentro de uma rede LTL otimizada.
Seguem-se as funcionalidades disponíveis com esta API:
- Gerir Recolha de Carga LTL
Esta funcionalidade permite obter os locais de recolha da carga LTL, agendar uma Recolha de carga e cancelar qualquer Recolha já agendada.
- Obter Tarifas de Carga LTL
Esta funcionalidade permite obter as tarifas para uma expedição de carga LTL com base nas localizações e opções de serviço selecionados.
- Enviar Expedições de Carga LTL
Esta funcionalidade permite criar uma expedição de carga LTL.
Seguem-se as funcionalidades da API de Carga LTL:
- Envie uma expedição de volume único ou MPS para todos os tipos de serviço e crie etiqueta(s) de expedição ou um Comprovativo de Carga (se necessário).
- Crie uma expedição de múltiplas unidades de manuseamento e rastreie as unidades de manuseamento individualmente.
- Crie expedições LTL para utilizar os serviços FedEx Freight Priority e Freight Economy.
- Forneça as informações do destinatário, tais como o número de conta, o contacto e o endereço.
- Forneça um carimbo de data/hora, o tipo de volume, o peso total e vários outros detalhes necessários mencionados no esquema do ponto final.
- Forneça a Etiqueta FedEx com tamanhos padrão com especificação de marca e suporte para etiquetas térmicas.
- Receba notificações por e-mail ou SMS durante a transação da expedição, tais como:
- Notificação de expedição
- Entrega estimada
- Notificação de recolha
- Crie Documentos de Expedição, tais como:
- Etiquetas de Expedição de Unidades de Manuseamento Individuais
- Bill of Lading
- Fatura comercial
- Fatura Aduaneira do Canadá
- Crie expedições e imprima etiquetas para uma unidade de manuseamento de cada vez ou processe todas as unidades de manuseamento de uma só vez.
- Obtenha tarifas de expedição de um único volume ou MPS para todos os tipos de serviço.
- Verifique a disponibilidade para recolha, agende a recolha de uma carga e cancele a recolha.
- Crie e Agende a recolha com contas de terceiros para uma morada de faturação alternativa.
Serviços de Expedição de Carga LTL
Estão disponíveis os seguintes serviços de expedição de Carga LTL:
FedEx Freight® Priority
Com desempenho atempado líder na indústria e tempos de trânsito rápidos, a FedEx Freight® Priority entrega as suas expedições de forma rápida e fiável. Conte com o nosso serviço regional para entrega alargada no dia seguinte e no segundo dia para os nossos clientes, todos apoiados por uma garantia de devolução de dinheiro sem custos. *
Características do serviço FedEx Freight® Priority:
- Tempos de trânsito rápidos com serviço de entrega no dia seguinte até 960 km e serviço de entrega no segundo dia útil até 2500 km
- Entrega direta em quase todos os códigos postais nos EUA, Canadá e México.
- Fiabilidade atempada, consistente
- Uma garantia de devolução de dinheiro sem custos*
- Tecnologia de informação de última geração com visibilidade das expedições de ponta a ponta
- Uma equipa dedicada de profissionais para ajudar com todas as suas necessidades regionais de carga
*Todos os serviços estão sujeitos aos termos e condições da Tarifa de Normas de Série FXFR 100.
FedEx Freight Economy
A FedEx Freight® Economy fornece uma entrega LTL (less-than-truckload) económica e adequada às suas necessidades básicas de expedição de carga. Com os serviços de entregas FedEx LTL, irá obter fiabilidade atempada e serviço de apoio ao cliente cuidadoso.
A FedEx Freight® Economy permite:
- Soluções de carga económicas
- Maior poupança para expedições que são menos exigentes a nível de tempo, mas necessitam de uma entrega fiável
- Fiabilidade atempada, consistente
- Entrega direta em quase todos os códigos postais nos EUA, Canadá, México e Porto Rico.
- Tecnologia de informação de última geração com visibilidade das expedições de ponta a ponta
- Visibilidade melhorada com rastreio de expedições de ponta a ponta
Como funciona a API de Carga LTL
Esta secção descreve os pontos finais e elementos chave necessários para a API de Carga LTL da FedEx.
Nota: A sua conta FedEx Freight LTL tem de ser ativada para utilizar a API de Carga LTL da FedEx. As informações chave necessárias são o número de conta FedEx Freight e o endereço de correio correto da conta para processar as expedições LTL.
Seguem-se os pontos finais disponíveis com esta API:
Enviar Carga LTL
Utilize este ponto final para validar e criar a expedição de Carga LTL da FedEx.
As informações de introdução obrigatória associadas a este pedido são:
- Número de Conta Freight
- Endereço de correio da conta
- Expedição de Carga Solicitada
- Opções de Resposta de Etiqueta – Etiquetas a devolver como codificadas ou como URL.
- Detalhes de Rastreio Principal – Apenas no caso de a expedição MPS ter de ser processada e as etiquetas terem de ser impressas uma de cada vez e não todas ao mesmo tempo (se o elemento singleShotMPS não for fornecido ou adicionado com o valor falso).
A resposta bem-sucedida a este pedido cria a Expedição LTL, fornece detalhes de Rastreio e detalhes de alerta na resposta. Devolve também erros e as descrições em caso de falha.
Nota: O endereço de correio pode ser diferente do endereço de expedição real.
Verificar a Disponibilidade de Recolha de Carga LTL
Utilize este ponto final para pedir uma lista de todas as localizações de recolha de carga disponíveis com os detalhes de agendamento da recolha, como a transportadora, a última hora de recolha disponível, a última hora disponível predefinida, hora em que o volume está pronto para a recolha, indicação se o endereço é residencial, hora limite da recolha e acesso do motorista para recolher o volume.
As informações de introdução obrigatória associadas a este pedido são:
- Detalhes do endereço/código postal de recolha.
- Tipo de pedido de recolha (por ex.: próprio dia/dia posterior).
- Se a recolha é nacional/internacional ou não.
Nota: utilize o endereço de recolha correto e válido.
A resposta bem-sucedida a este pedido fornece uma lista de todas as localizações de recolha de carga disponíveis, dia da entrega, disponibilidade (indicador), data de recolha, hora limite, hora de acesso, disponibilidade residencial (indicador), hora de fecho (indicador), hora de fecho e hora local na resposta. Devolve também erros e as descrições em caso de falha.
Criar Recolha de Carga LTL
Utilize este ponto final para criar e agendar uma recolha de carga LTL.
As informações de introdução obrigatória associadas a este pedido são:
- Número de conta Freight, que será faturado para a recolha.
- Detalhes da origem (endereço, localização e tipo de endereço de recolha, como conta/expedidor/outro).
- Detalhes do endereço da conta associada.
O pedido de recolha bem-sucedido devolve um número de confirmação de recolha, uma notificação de recolha e um código de localização para a recolha a ser agendada. Devolve também erros e as descrições em caso de falha.
Nota: utilize a morada de recolha correta e válida e forneça a morada de registo da conta correta para agendar a recolha. Não deve ser introduzida uma hora ou data passada ou demasiado longínqua no futuro para agendar uma recolha. Não são permitidas recolhas anónimas. Pode agendar a recolha para contas de terceiros ao fornecer detalhes de morada válidos alternativos.
Cancelar Recolha de Carga LTL
Utilize este ponto final para cancelar um pedido de recolha já agendado para um volume LTL. O cancelamento da recolha bem-sucedido devolve um número de confirmação e uma mensagem de confirmação do cancelamento da recolha.
As informações de introdução obrigatória associadas a este pedido são:
- Código de Confirmação de Recolha (obtido durante o envio de um pedido de recolha)
- Data Agendada (data em que o despacho da recolha ocorre)
- Localização (localização da FedEx Express responsável pelo processamento do pedido de recolha)
O pedido bem-sucedido devolve um número de confirmação de recolha, uma notificação de recolha e um código de localização para a recolha a ser agendada. Devolve também erros e as descrições em caso de falha.
Nota: envie o número de confirmação de recolha e o código de localização correspondente (aplica-se apenas ao FDXE) para cancelar a recolha que foi agendada. As informações de número de confirmação de recolha e código de localização correspondente (aplica-se apenas ao FDXE) são obtidas ao enviar um pedido de recolha. Utilize também o endereço de registo da conta correto para cancelar a recolha. Uma notificação de falha será enviada se tentar cancelar uma recolha após o estafeta da FedEx ter efetuado o despacho para a localização de recolha
Atribuição de Tarifas de Carga LTL
Utilize este ponto final para pedir uma lista de todas as cotações de tarifas de carga possíveis e informações de trânsito opcionais com base em detalhes de entradas. As taxas obtidas têm por base a origem, o destino e várias outras entradas na expedição. Podem ser utilizadas informações adicionais, como o código da transportadora, o tipo de serviço ou a opção de serviço para obter resultados mais precisos.
As informações de introdução obrigatória associadas a este pedido são:
- Número de Conta Freight
- Expedição de Carga Solicitada.
A resposta bem-sucedida a este pedido devolve uma lista de todas as taxas possíveis e um código de localização para a recolha a ser agendada. Devolve também erros e as descrições em caso de falha.
Expedição de Carga LTL Multi-peças (MPS)
Uma expedição multi-peças (MPS) consiste em duas ou mais unidades de manuseamento enviadas para os mesmos endereços de destinatário. A primeira unidade de manuseamento no pedido de expedição é considerada a principal.
Para criar uma expedição multi-peças:
- Inclua informações ao nível da expedição, como os detalhes serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail e requestedPackageLineItems. [Nota: o detalhe sequenceNumber para o volume principal deve ser igual a 1.]
- Na impressão de etiquetas por unidade de manuseamento, inclua os detalhes de rastreio principais no elemento masterTrackingId em todas as unidades de manuseamento subsequentes.
Seguem-se as opções de Processamento de Expedições Multi-peças disponíveis com esta API:
Imprimir uma Etiqueta de Unidade de Manuseamento de Cada Vez
Esta API permite-lhe processar expedições MPS e obter uma etiqueta de cada vez.
Quando precisar desta funcionalidade para as suas expedições, bem como todos os elementos MPS necessários, forneça o elemento oneLabelAtATime como verdadeiro no pedido.
A saída do primeiro pedido deve gerar uma etiqueta e um número de rastreio que é o número de rastreio principal. Forneça este número de rastreio principal no elemento masterTrackingId para processar o pedido de expedição subsequente e gerar etiquetas com números de rastreio (números de rastreio secundários) para a contagem total de volumes definida (totalPackageCount).
Nota: o número máximo de unidades de manuseamento é 200.
Imprimir Todas as Etiquetas de Unidade de Manuseamento de Uma Vez
Esta API permite-lhe processar expedições MPS e obter as etiquetas de uma vez. Trata-se de um dos métodos ideais de processamento e é utilizado quando uma expedição tem 40 ou menos unidades de manuseamento (totalPackageCount<=40) destinados à mesma morada do destinatário na expedição.
Defina oneLabelAtATime como falso no pedido de expedição com 40 ou menos unidades de manuseamento e gere as etiquetadas automaticamente.
Nota: o limite máximo de unidades de manuseamento é 40 e é indicativo, não um limite fixo. O limite também depende da combinação do número de unidades de manuseamento e das mercadorias. Contacte o seu gerente FedEx para obter mais informações.
Exemplo: o seu pedido de expedição consiste em 10 unidades de manuseamento, quando for enviado irá gerar 10 etiquetas e fornecer URL de etiqueta ou etiquetas codificadas na resposta conforme pedido.
FedEx Freight Direct
Este serviço fornece uma experiência ao cliente superior para a devolução de mercadorias de grandes dimensões em paletes, incluindo expedições pesadas e volumosas destinadas às casas ou empresas dos clientes.
O serviço oferece opções como comunicações proativas, opções de entrega flexíveis e preços em pacote que incluem diversas sobretaxas.
Seguem-se algumas das funcionalidades incluídas neste serviço:
- Permite a criação de expedições de entrega FedEx Freight Direct basic, basic por marcação, standard e premium e expedições de devolução/recolhas basic no território continental dos Estados Unidos, Alasca e Havai.
- Inclui a possibilidade de obter uma estimativa de tarifa completa referente a uma expedição FedEx Freight Direct com um número de conta FedEx Freight Direct e a possibilidade de cancelar uma recolha FedEx Freight Direct.
- As tarifas estimadas para o Alasca e Havai não serão apresentadas. Os clientes deverão contactar o Serviço de apoio ao cliente FedEx para solicitar um orçamento para estes estados.
- Para canelar uma recolha agendada para o mesmo dia, o cliente tem de contactar o Serviço de apoio ao cliente da FedEx.
- Permite-lhe enviar notificações por e-mail ao expedidor/consignatário original para que o cliente possa:
- Agendar uma entrega
- Receber confirmação de entrega e/ou recolha
- Receber notificação para entrega e/ou recolha
- Receber notificações em percurso
- Inquérito ao cliente para expedições entregues
- As regras empresariais de validação do código postal, dimensões, peso da peça e peso da unidade de manuseamento serão aplicadas ao FedEx Freight Direct para determinar a combinação correta dos serviços de linha de transporte e de primeira/última etapa.
O FedEx Freight Direct oferece diferentes tipos de serviço para escolher.
Esta API oferece as seguintes funcionalidades com o serviço Freight Direct:
Obter Tarifas Freight Direct
Utilizar este ponto final para obter Tarifas Freight Direct e sobretaxas para as seguintes opções especiais do serviço Freight Direct: Serviço Basic, Serviço Basic por marcação, Serviço Standard, Serviço Premium.
Seguem-se os detalhes necessários a serem acompanhados com o pedido de Tarifa ao utilizar o ponto final Tarifa de carga LTL:
- Tipo de Freight Direct (BASIC, BASIC_POR_MARCAÇÃO, PREMIUM, STANDARD)
- Tipo de transporte Freight Direct (ENTREGA, RECOLHA)
- Tipo de Número de telefone, se o número de telefone for fornecido (CASA, TELEMÓVEL, TRABALHO)
- Peso
- Dimensões (Comprimento não negativo, Largura e Altura)
Criar Expedição Freight Direct
Utilize este ponto final para enviar uma peça única ou expedição MPS com as seguintes opções especiais do serviço Freight Direct: Serviço Basic, Serviço Basic por marcação, Serviço Standard, Serviço Premium e obtenha uma etiqueta de expedição ou BOL (Bill of Lading), incluindo a documentação necessária para o processamento de expedições Freight Priority.
Seguem-se os detalhes necessários a serem acompanhados com o pedido de expedição através do ponto final Enviar Carga LTL:
- Tipo de Freight Direct (BASIC, BASIC_POR_MARCAÇÃO, PREMIUM, STANDARD)
- Tipo de transporte Freight Direct (ENTREGA, RECOLHA)
- Endereço de e-mail, Número de telefone e Tipo de telefone
- Peso
- Dimensões (Comprimento não negativo, Largura e Altura)
O BOL (Bill of Lading) de saída terá os novos nomes do serviço Freight Direct impressos. Seguem-se os valores impressos no BOL (Bill of Lading) dependendo da seleção do serviço:
- ENTREGA DIRECT BASIC
- ENTREGA DIRECT BASIC POR MARCAÇÃO
- ENTREGA DIRECT PREMIUM
- ENTREGA DIRECT STANDARD
- RECOLHA DIRECT BASIC
- RECOLHA DIRECT BASIC POR MARCAÇÃO
- RECOLHA DIRECT PREMIUM
- RECOLHA DIRECT STANDARD
Freight Direct – Recolha
Utilize este ponto final para verificar a disponibilidade do serviço de recolha Freight Direct da carga LTL, criar um pedido de recolha para um volume ser recolhido ou cancelar uma recolha existente pedida.
Seguem-se os detalhes necessários a serem acompanhados com o pedido de Recolha ao utilizar o ponto final Verificar a disponibilidade de Recolha de carga LTL, Criar Recolha de carga LTL e Cancelar recolha de Carga LTL.
- Tipo de Freight Direct (BASIC, BASIC_POR_MARCAÇÃO, PREMIUM, STANDARD)
- Tipo de transporte Freight Direct (ENTREGA, RECOLHA)
- Endereço de e-mail (Criar Pedido de recolha)
- Número de telefone e Tipo de telefone (Criar Pedido de recolha)
- Peso
Regras Empresariais
- Um número (Pro) de rastreio principal é atribuído à primeira unidade de manuseamento da expedição de Carga LTL e os números de rastreio secundários são atribuídos a cada unidade de manuseamento subsequente.
- Cada unidade de manuseamento na expedição pode ser rastreada individualmente ou como parte de toda a expedição.
- Outros documentos podem aplicar-se a expedições específicas (por ex., expedições de Carga de materiais perigosos [HazMat] e internacionais).
- As contas apenas de LTL Freight e de Faturação para LTL Freight não podem ser adicionadas ao FedEx Developer Portal.
- O cliente pode utilizar o número de conta LTL de longo termo único ou o número de conta FedEx Freight Direct para utilizar os serviços Freight Direct.
- As funcionalidades de tarifa do FedEx Freight Direct só estão disponíveis na API LTL regular.
- Todos os novos erros/mensagens estarão apenas em inglês.
- O endereço de e-mail e o telefone são necessários como parte do pedido de opção do serviço FedEx Freight Direct durante a criação de expedições.
Recolha da API JSON
Response