Fedex Logo
Developer Portal

FedEx Locations Search API

Introdução

As estações FedEx são pontos de recolha e de entrega geridos pelos fornecedores de expedições FedEx. Pode expedir um volume a partir de uma estação de recolha para uma estação de entrega com qualquer transportadora FedEx. Esta API ajuda-o a procurar estações de expedição suportadas e disponíveis, utilizando para tal um endereço, coordenadas geográficas ou um número de telefone.

A API de Pesquisa de Estações FedEx procura e devolve os endereços das estações FedEx de entrega de volumes mais próximas, incluindo Centros de Expedição e Impressão FedEx Office® e estações FedEx Drop Box disponíveis para entrega de volumes FedEx Express® e FedEx Ground®.

Detalhes da API de Pesquisa de Estações FedEx

A API de Pesquisa de Estações FedEx permite-lhe procurar estações de entrega da FedEx através de um endereço, coordenadas geográficas ou um número de telefone.

A API de Pesquisa de Estações FedEx permite-lhe procurar estações com base no seguinte:

  • Centros de expedição autorizados
  • Centros de entrega autorizados
  • Serviço Reter na Estação
  • Estações Drop Box
  • Estações que aceitam expedições de mercadorias perigosas

As funcionalidades da API de Pesquisa de Estações FedEx incluem:

  • Pesquisa da estação de entrega e recolha FedEx mais próxima
  • Recuperação do endereço detalhado da estação, incluindo código postal, código do país, etc.

Como Funciona a API de Pesquisa de Estações FedEx

A API de Pesquisa de Estações FedEx ajuda a solicitar as estações FedEx disponíveis para entrega de volumes FedEx Express® e FedEx Ground®. Esta transação procura e devolve o endereço da estação FedEx mais próxima. Também pode utilizar esta API para encontrar estações FedEx que fornecem o serviço Reter na Estação.

Encontrar Estações

Este pedido é utilizado para devolver uma lista de todas as estações disponíveis, com base em detalhes introduzidos. A informação-chave introduzida e associada a este pedido é:

  • Endereço da estação
  • Distância (valor e unidades do raio junto ao endereço para procurar estações FedEx)

Nota: o código postal é obrigatório para países com código postal. Para países sem código postal, uma combinação da cidade e do país será suficiente para obter estações FedEx válidas.

O resultado deste pedido corresponde a uma lista detalhada das estações FedEx de recolha e entrega disponíveis, para além de informação-chave como a distância, horários da loja, URL de mapas, detalhes da transportadora, serviço de localização e funcionalidades disponíveis em dias de semana, capacidade de entregar ou recolher expedições, capacidade de reter as expedições para recolha, etc.

Funcionalidades Principais da API de Pesquisa de Estações FedEx

Limitar a sua pesquisa por estação

Pode limitar a sua pesquisa por tipo de estação. Um, vários ou até todos os tipos de estações FedEx listados podem ser especificados no pedido de pesquisa:

  • Estações do Centro de Expedição Autorizado FedEx®: aceda à rede de transporte FedEx em mais de 5800 estações de embalagem e expedição operadas e de propriedade independente (FASC) em lojas dos EUA que participam no programa do Centro de Expedição Autorizado FedEx, e que, além disso, fornecem outros serviços comerciais. As estações do Centro de Expedição Autorizado FedEx podem aplicar taxas adicionais às tarifas FedEx anunciadas.
  • Centro de Expedição FedEx®
  • Estação Express
  • Local de expedição FedEx
  • Estação FedEx Office®
  • Estação FedEx self-service: entrega de volumes FedEx Express e FedEx Ground (com até 20" x 12" x 6") na FedEx Express® Drop Box.
  • Os seguintes tipos de estação são suportados para o serviço Reter na Estação:
    • FedEx OnSite – volumes FedEx Express e FedEx Ground
    • FedEx Office– volumes FedEx Express e FedEx Ground
    • Estações Express – apenas volumes FedEx Express
    • Centros de Expedição FedEx – volumes FedEx Express e FedEx Ground e mercadorias perigosas aprovadas

Funcionalidades das Estações

Além disso, o pedido de pesquisa suporta um atributo para especificar que as estações suportam a funcionalidade Redirecionar para Reter do FedEx Ground ou FedEx Express e atributos para especificar funcionalidades na estação, tais como:

  • Serviços de devolução
  • Entregas Ground
  • Numerário
  • Embalagem e expedição
  • Materiais de embalagem
  • Serviço de sinais e faixas
  • Sony PictureStation
  • Serviços de correspondência publicitária
  • Serviços de cópia e impressão
  • Serviços de mercadorias perigosas
  • Estação num aeroporto
  • Serviços de notário
  • Horário de verão
  • Serviços de fotografia do passaporte
  • Caixa para receção de envios
  • Serviços de expedição nacional
  • Serviços de expedição internacional

Ordenar resultados

A API de Pesquisa de Estações FedEx permite-te ordenar os resultados por:

  • Hora de entrega FedEx Express mais recente
  • Hora de entrega FedEx Ground mais recente
  • Tipo de estação
  • Distância em ordem crescente
  • Distância em ordem decrescente

Critérios de Pesquisa Adicionais

Também pode limitar a sua pesquisa de acordo com o seguinte:

  • Serviço ao sábado disponível.
  • Serviço de embalagem disponível (maioria das estações FedEx Office): a FedEx irá embalar a sua expedição (com um custo adicional).
  • Materiais de embalagem disponíveis (em qualquer lugar em que sejam fornecidos materiais de embalagem FedEx Express, não inclui materiais FedEx Ground).
  • Estações FedEx Express de entrega mais recentes: devolve estações perto de si com a hora de entrega mais recente.
  • Entrega Express tardia: entrega um volume depois de uma determinada hora, como 17h00. Utilize este elemento para pesquisar estações de entrega abertas depois das 17h00.

Nota: a API de Pesquisa de Estações FedEx devolve até 75 estações num raio de 80 km do seu endereço

Estações FedEx

Estações do Centro de Expedição FedEx®: entregue volumes e receba informação de expedição

Os especialistas de envio das estações do Centro de Expedição FedEx podem ajudá-lo a escolher um serviço de entrega, a preencher documentação e a processar os seus volumes. Muitas estações estão abertas até tarde e ao sábado para se ajustarem ao seu horário.

  • Entregue as suas expedições ou deixe que a FedEx as processe por si ao balcão.
  • Compre caixas e outros materiais de embalagem.
  • Consulte o Localizador de Estações FedEx para ver a lista de serviços, como o serviço ao sábado oferecido em cada estação.
  • Pague as suas expedições através da sua conta FedEx ou utilize cheques, cartões de crédito ou dinheiro, que são aceites na maioria das estações.

Nota: tem de ter um número de conta FedEx para expedir volumes FedEx International Ground® num Centro de Expedição FedEx e noutras estações de expedição.

Estações do Centro de Expedição Autorizado FedEx®: estações de embalagem e expedição de propriedade independente

Dirija-se a estas estações de propriedade independente para serviços de embalagem e expedição. A maioria também oferece serviços de fax, cópias e outros serviços comerciais.

  • Procure retalhistas de embalagem e expedição como AIM Mail Center®, PakMail® PostalAnnex+® e PostNet®, bem como estações afiliadas à Association of Mail and Business Centers e Retail Shipping Associates.
  • Pode expedir volumes FedEx Express e FedEx Ground na maioria destas estações. Para obter mais informações, consulte o Localizador de Estações FedEx.

Nota: as tarifas de processamento de volumes refletem as políticas de preços de cada estação. Estas estações podem aplicar taxas adicionais às tarifas FedEx anunciadas.

O Local de Expedição FedEx nas estações Office Depot® e OfficeMax®: acesso fácil a serviços de expedição

Os serviços FedEx® estão disponíveis em todas as estações Office Depot e OfficeMax. Estas estações oferecem serviços FedEx Express e FedEx Ground U.S. e ainda serviços de expedição internacional, para que possa entregar volumes ou processá-los ao balcão, comprar materiais de embalagem e lidar com outras necessidades comerciais, tudo num único local.

Estações FedEx Drop Box: mais de 35 000 estações

Há mais de 35 000 caixas para receção de envios em edifícios de escritórios, centros comerciais, aeroportos, estações FedEx Office, mercearias e outras estações convenientes.

  • Entregue as suas expedições FedEx Express, FedEx Ground e FedEx Ground® Economy (anteriormente denominada FedEx SmartPost®). As expedições FedEx Ground poderão necessitar de um dia adicional para a entrega.
  • Todas as caixas para receção de envios aceitam volumes com até 20" x 12" x 6" (e muitas aceitam volumes com até 20" x 12" x 9").
  • A maioria tem uma quantidade limitada de materiais de embalagem e de carta de porte FedEx Express.
  • Todas oferecem recolha de segunda a sexta-feira e algumas aos sábados.
  • Não coloque volumes FedEx SameDay® em caixas para receção de envios.
  • As baterias de lítio e Substâncias Biológicas (Categoria B) da Secção II da IATA (UN 3373) são as únicas mercadorias perigosas que se podem colocar em caixas para receção de envios.
  • Não é aceite o pagamento com dinheiro, cheques ou cartões de crédito.

Estações FedEx OnSite: recolha e entregue onde compra

Com as estações FedEx Onsite, pode recolher e entregar os seus volumes FedEx onde mais lhe convém. Estão perto de onde trabalha, vive e convive e, além disso, algumas até têm um horário de funcionamento alargado. A FedEx tem quase 9000 estações Walgreens e também estações específicas Dollar General, Albertsons e Kroger nos EUA e em Porto Rico, onde pode:

  • Reter volumes numa estação segura e recolhê-los de acordo com a sua disponibilidade.
  • Entregar expedições internacionais e expedições FedEx Express e FedEx Ground U.S. pré-embaladas e pré-etiquetadas. Os volumes individuais podem pesar até 55 lb e medir até 48" de comprimento por 25" de largura e 25" de altura.

Regras Empresariais

  • As estações FedEx Office, FedEx OnSite e a estação específica do Centro de Expedição Autorizado FedEx não aceitam mercadorias perigosas, animais vivos, tabaco ou outros materiais regulados e expedições perigosas.
  • Restrições de Peso por Tipo de Estação
    • As estações FedEx Office e do Centro de Expedição FedEx podem aceitar volumes a Reter na Estação maiores e mais pesados do que a estação específica do Centro de Expedição Autorizado FedEx e as estações FedEx OnSite.
    • As estações do Centro de Expedição FedEx aceitam volumes com mais de 150 lb e 119" de comprimento e/ou 165" de comprimento e circunferência (C+2L+2A), que não possam ser entregues noutras estações.
    • As estações FedEx Office aceitam volumes com um máximo de 150 lb e 119" de comprimento e/ou 165" de comprimento e circunferência (C+2L+2A).
    • As estações FASC e FedEx OnSite (por exemplo, Walgreens) aceitam volumes com um peso máximo de 55 lb e um tamanho máximo de 48" x 25" x 25".

Recolha da API JSON

Documentation Powered by ReDoc

FedEx Location Search API (1.0.0)

Find Locations

Use this endpoint to search for nearest FedEx locations by address, geographicccc coordinates, or phone numberrrr. You can also narrow your search by type of location and services offered. It returns up to 75 locations within a 50-mile radius for the address used in the search criteria. Results are based on current date and time. Supports all FedEx operating companies and countries, dependent upon being able to get a valid geolocation for a given set of criteria.
Note: You must specify landline numbers only, when searching for the nearest FedEx locations using phone number.
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_Find_Location
  • Search_Location_for_Postal_Aware_Country
  • Search_Location_for_Non_Postal_Aware_Country
  • Search_Location_by_US_domestic_Postal_Address
  • Search_Location_by_International_Postal_Address
  • Search_Location_by_Geographic_Coordinates
  • Search_Location_by_Phone_Number
  • Search_Location_HOLD_AT_LOCATION
  • Search_Location_OFFICE_AND_ONSITE
  • Search_Location_by_RETURNS_SERVICES
locationsSummaryRequestControlParameters
object

Use this object to specify all the inputs to get the locations details.

constraints
object

Specify the constraints to be applied to the location attributes.

locationSearchCriterion
string
Enum: "ADDRESS" "GEOGRAPHIC_COORDINATES" "PHONE_NUMBER"

Specify the criteria to be used to search for FedEx locations. Default value is ADDRESS if no value is passed.

Valid values:

  • ADDRESS – Search by address. Location detail data is required.
  • GEOGRAPHIC_COORDINATES – Search by geocodes. Location geocodes are required.
  • PHONE_NUMBER – Search by phone number. Location Phone number is required.

Note: Country code is REQUIRED when searching by any of the LocationsSearchCriterion, even PhoneNumber and GeorgraphicCoordinates.

location
required
object

Based on the locationSearchCriterion value specified, the location element specifies the minimum requirement for address search like postalCode, countryCode, GeoCodes or city.Location phone number is required. Only landline number is allowed.

Note: Country code is REQUIRED for the search.

phoneNumber
string

Specify the phone number(Only LandLine allowed) if the locationSearchCriterion is set to 'PHONE_NUMBER'.Given that is the case, the location search will be made based on the phone number value and the location object(postalCode&countryCode) will be completely ignored.
Example: 9015551234

multipleMatchesAction
string
Enum: "RETURN_ALL" "RETURN_ERROR" "RETURN_FIRST"

Specify the criterion to be used to return location results when there are multiple matches.
Valid values: RETURN_ALL,RETURN_ERROR, RETURN_FIRST.

Note: The 'maxResults' value takes precedence over RETURN_ALL value.

sort
object (Sort)

Specifies how the location search results will be sorted in the reply.

trackingInfo
object (TrackingInfo)

Information uniquely identifying a shipment such as Tracking number, ShipDate, and Tracking number uniqueId. This tracking information helps to return the correct list of locations when REDIRECT_TO_HOLD_AT_LOCATION is requested

sameState
boolean

Filter to display locations within the same state as the search criteria.
Valid values: True, False.

sameCountry
boolean

Filter to display locations within the same country as the search criteria.
Valid values: True, False.

redirectToHoldType
string
Enum: "FEDEX_EXPRESS" "FEDEX_GROUND" "FEDEX_GROUND_HOME_DELIVERY"

Specify the type of service supported by a FedEx location for redirect to hold.

locationAttrTypes
Array of strings
Items Enum: "ACCEPTS_CASH" "FEDEX_RETURNS_TECHNOLOGY" "ALREADY_OPEN" "COPY_AND_PRINT_SERVICES" "DANGEROUS_GOODS_SERVICES" "DIRECT_MAIL_SERVICES" "LOCATION_IS_IN_AIRPORT" "NOTARY_SERVICES" "OPEN_TWENTY_FOUR_HOURS" "PACK_AND_SHIP" "PACKAGING_SUPPLIES" "PASSPORT_PHOTO_SERVICES" "RETURNS_SERVICES" "SIGNS_AND_BANNERS_SERVICE" "SONY_PICTURE_STATION" "DROP_BOX" "DOMESTIC_SHIPPING_SERVICES" "INTERNATIONAL_SHIPPING_SERVICES" "CLEARANCE_SERVICES"

Specify attributes to filter location types. If more than one value is specified, only those locations that have all the specified attributes will be returned.
Note: In order to filter for DROP_BOX location, need to add locationTypes as FEDEX_SELF_SERVICE_LOCATION

locationCapabilities
Array of objects (LocationCapabilities)

Specify to filter the locations based on their capabilities.

packageAttributes
Array of objects (PackageAttribute)

Specify location supported package constraints to narrow the search.

For example, a package weighing more than 151 pounds may not be supported at all location types. Drop box location would be excluded.

Note: The package attributes inputs are only recognized/supported for FedEx OnSite Locations.

locationTypes
Array of strings
Items Enum: "FEDEX_AUTHORIZED_SHIP_CENTER" "FEDEX_OFFICE" "FEDEX_SELF_SERVICE_LOCATION" "FEDEX_ONSITE" "FEDEX_EXPRESS_STATION" "FEDEX_SHIPSITE" "FEDEX_SHIP_AND_GET"

Results filter which narrows the search to specific types of FedEx Locations.

includeHoliday
boolean

Indicates true if the location holiday list is desired in the results; otherwise false
Valid values: True, False.

dropoffTime
string

Specifies the latest time by which you can drop-off a package at a location to process the shipment the same day. This limits the results to locations that support a specific drop-off time. The format is an ISO 8601 string in which only the time portion is used.
Example: 16:00:00

dropOffServiceType
string

The drop-off service types supported by the specified location. If sort criteria is given as LATEST_EXPRESS_DROPOFF_TIME and dropoffservicetype is GROUND then backend will take the SORT_BY_LATEST_GROUND_TIME as sort criteria.
Example: FedEx Ground.

carrierCodes
Array of strings
Items Enum: "FDXE" "FDXG"

Unique code to identify the transporter.

getCall
boolean

Get a call.
Valid values: True, False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /location/v1/locations

Sandbox Server

https://apis-sandbox.fedex.com/location/v1/locations

Production Server

https://apis.fedex.com/location/v1/locations

Request samples

Content type
application/json
Example
Full_Schema_Find_Location
Copy
 Expand all Collapse all
{
  • "locationsSummaryRequestControlParameters":
    {
    },
  • "constraints":
    {
    },
  • "locationSearchCriterion": "ADDRESS",
  • "location":
    {
    },
  • "phoneNumber": "9015551234",
  • "multipleMatchesAction": "RETURN_ALL",
  • "sort":
    {
    },
  • "trackingInfo":
    {
    },
  • "sameState": true,
  • "sameCountry": true,
  • "redirectToHoldType": "FEDEX_GROUND",
  • "locationAttrTypes":
    [
    ],
  • "locationCapabilities":
    [
    ],
  • "packageAttributes":
    [
    ],
  • "locationTypes":
    [
    ],
  • "includeHoliday": true,
  • "dropoffTime": "09:30:00",
  • "dropOffServiceType": "GROUND",
  • "carrierCodes":
    [
    ],
  • "getCall": false
}

Response samples

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

Response

Copy