Fedex Logo
Developer Portal

FedEx Locations Search API

Introdução

As localidades da FedEx são pontos de coleta e entrega gerenciados pelos fornecedores de remessa da FedEx. Você pode enviar um pacote de um ponto de coleta para um ponto de entrega usando qualquer transportadora FedEx. Este API ajuda você a pesquisar as localizações de remessa suportadas e disponíveis, usando endereço, coordenadas geográficas ou número de telefone.

O API de busca de localidade FedEx procura e retorna os endereços dos pontos de entrega de pacotes FedEx mais próximos, incluindo FedEx Office® Print and Ship Centers e os pontos de entrega de pacotes FedEx Drop Box disponíveis para FedEx Express® e FedEx Ground®.

Detalhes da API de pesquisa de localidades FedEx

O API de busca de localidades FedEx permite pesquisar as localidades de entrega na FedEx por endereço, coordenadas geográficas, ou número de telefone.

O API de busca de localidades FedEx permite pesquisar localizações com base nas seguintes informações:

  • Centros de envio autorizados
  • Pontos de coleta autorizados
  • Reter na localidade
  • Localidades dos pontos de entrega
  • Localidades que aceitam remessas de carga perigosa

Entre as características do API de busca de localidades FedEx estão:

  • Encontre o ponto de coleta e entrega FedEx mais próximo
  • Obtenha o endereço detalhado do local, incluindo código postal, código do país etc.

Como a API de pesquisa de localidades FedEx funciona

O API de busca de localidade FedEx ajuda a solicitar as localidades FedEx disponíveis para a entrega de pacotes FedEx Express® e FedEx Ground®. Esta solicitação faz uma busca e retorna os endereços das localidades FedEx mais próximas. Você também pode usar este API para encontrar localidades FedEx que fornecem o serviço Reter na Localidade.

Encontrar localidades

Esta solicitação é usada para retornar uma lista de todas as localidades disponíveis com base nos dados de registro. As informações essenciais associadas a esta solicitação são as seguintes:

  • Endereço do local
  • Distância (valores e unidades do raio ao redor do endereço para pesquisar localidades FedEx)

Nota: O código postal é obrigatório para países que possuem serviços postais. Para países que não têm acesso aos serviços postais, é necessário uma combinação de cidade e país para obter as localidades FedEx válidas.

O resultado desta solicitação é uma lista detalhada de todos os pontos de coleta e entrega na FedEx disponíveis, juntamente com informações importantes como distância, horário de atendimento da loja, detalhes da transportadora, serviço de localização e opções disponíveis para os dias de semana, para coletar e entregar remessas, para reter remessas, etc.

Principais recursos da API de pesquisa de localidades FedEx

Faça uma busca mais detalhada por local

Você pode refinar sua busca por tipo de localização. Poderão ser especificados na solicitação de busca uma, várias, ou todos os tipos de localidades FedEx listadas:

  • Localidades do FedEx Authorized ShipCenter®: Acesse a rede de transporte da FedEx em mais de 5.800 pontos independentemente de embalo e envio (FASC) através das lojas estadunidenses que participam do programa FedEx Authorized ShipCenter® e que também fornecem outros serviços comerciais. As localidades FedEx Authorized ShipCenter podem aplicar encargos adicionais às tarifas publicadas pela FedEx.
  • FedEx ShipCenter®
  • Express Station
  • FedEx ShipSite
  • Localidade do FedEx Office®.
  • Localidade de autoatendimento da FedEx: Entregue encomendas FedEx Express e FedEx Ground (até 50 cm x 30 cm x 15 cm) em um FedEx Express® Drop Box.
  • Os seguintes tipos de localidades são suportados para o serviço Reter na localidade:
    • FedEx OnSite – Pacotes FedEx Express e FedEx Ground
    • FedEx Office – Pacotes FedEx Express e FedEx Ground
    • Express stations – Somente pacotes FedEx Express
    • FedEx Ship Centers– Pacotes FedEx Express e FedEx Ground e apenas carga perigosa aprovada

Recursos da de localidade

Além disso, a solicitação de pesquisa disponibiliza um atributo para especificar que as localidades suportam o recurso FedEx Express ou FedEx Ground Redirect to Hold e atributos para especificar recursos na localidade, como:

  • Serviços de devolução
  • Entrega em terra
  • Numerário
  • Embalar e enviar
  • Materiais de embalagem
  • Serviço de sinalização e banners
  • Sony PictureStation
  • Serviços de entrega postal direta
  • Serviços de cópia e impressão
  • Serviços de carga perigosa
  • Localização no aeroporto
  • Serviços de cartório
  • Verifica os horários de verão
  • Serviços de fotos para passaportes
  • Drop Box
  • Serviços de remessa doméstica
  • Serviços de remessa internacional

Classificação de resultados

O API de busca de localidade FedEx permite que você classifique os resultados por:

  • Último horário de entrega da FedEx Express
  • Último horário de entrega da FedEx Ground
  • Tipo de localidade
  • Por distância em ordem crescente
  • Por distância em ordem decrescente

Critérios de pesquisa adicionais

Você também pode refinar sua pesquisa por:

  • Serviço ao sábado disponível.
  • Serviço de embalagem disponível (a maioria dos FedEx Office): A FedEx embalará seu pacote para você (por um custo extra).
  • Materiais de embalagem disponíveis (em qualquer lugar onde os materiais de embalagem FedEx Express são fornecidos; não inclui os materiais FedEx Ground).
  • Últimas localidades de entrega FedEx Express: Retorna localidades com o mais recente tempo de entrega perto de você.
  • Entrega expressa após: Entregue uma encomenda após um horário específico, como às 17h. Use este recurso para procurar por pontos de entrega abertos após as 17h.

Nota: O API de busca de localidade FedEx retorna até 75 localidades dentro de um raio de 50 milhas de seu endereço

Localidades FedEx

Localidades FedEx Ship Center® :Entregue os pacotes e obtenha informações de envio

Os técnicos de envio nas localidades FedEx Ship Center podem ajudá-lo a escolher um serviço de entrega, completar uma documentação e processar seus pacotes. Muitas localidades ficam abertas até tarde e aos sábados para acomodar em sua programação.

  • Entregue suas remessas ou a FedEx vai processá-las para você no balcão.
  • Comprar caixas e outros materiais de embalagem.
  • Verifique no FedEx Dropoff Locator a lista de serviços, tais como o serviço aos sábados, oferecidos em cada localidade.
  • Carregue suas remessas em sua conta FedEx ou use cheques, cartões de crédito ou dinheiro, que são aceitos na maioria das localidades.

Nota: Você deve ter um número de conta FedEx para enviar encomendas FedEx International Ground®® em um FedEx Ship Center e em nossas outras localidades de envio.

Localidades FedEx Authorized ShipCenter®: Localizações de embalagem e envio de propriedade independente

Passe por esses localidades de propriedade independente para serviços de embalagem e remessa. A maioria também oferece fax, cópia e outros serviços comerciais.

  • Procure varejistas de embalagem e envio, como AIM Mail Center®, PakMail®, PostalAnnex+® e PostNet®, bem como locais afiliados à Associação de Carteiros e Centros de Negócios e Associados de Transporte Varejista.
  • Você pode enviar encomendas FedEx Express e FedEx Ground na maioria dessas localidades. Para obter mais informações, consulte o FedEx Dropoff Locator

Nota: As tarifas para o processamento de encomendas refletem as próprias políticas de preços de cada localidade. Esses locais podem aplicar encargos adicionais às tarifas FedEx.

FedEx ShipSite nos locais Office Depot® e OfficeMax®: Acesso conveniente aos serviços de remessa

Os serviços FedEx® estão disponíveis em todas as localidades Office Depot e OfficeMax. Essas localidades oferecem serviços de remessa FedEx Express e FedEx Ground U.S. e serviços internacionais. Você pode levar seus pacotes ou fazer o processo de envio no balcão, além de comprar materiais de embalagem entre outras necessidades de negócios. Tudo em um único local.

Localidades FedEx Drop Box: Mais de 35.000 localidades

Existem mais de 35.000 pontos de coleta em prédios de escritórios, shopping centers, aeroportos, localidades FedEx Office, supermercados e outros locais convenientes.

  • Entregue suas remessas da FedEx Express, FedEx Ground e FedEx Ground® Economy (anteriormente conhecida como FedEx SmartPost®). As remessas FedEx Ground® podem precisar de um dia a mais para a entrega.
  • Todos os pontos de coleta aceitam pacotes de até 50 cm \ x 30 cm \ x 15 cm (muitos aceitam pacotes de até 50 cm \ x 30 cm \ x 22 cm \).
  • A maioria tem uma quantidade limitada de recibos FedEx Express e materiais de embalagem.
  • Todas realizam coleta de segunda a sexta-feira, e algumas também realizam coleta aos sábados.
  • Não coloque pacotes FedEx SameDay® em caixas coletoras.
  • Baterias de lítio e substâncias biológicas da Seção II da IATA, Categoria B (UN 3373) são as únicas cargas perigosas que podem ser colocadas em caixas coletoras.
  • Não são aceitos pagamentos em dinheiro, cheque ou cartão de crédito.

Localidades FedEx OnSite: Pegar e entregar onde você faz compras

Com as localidades FedEx OnSite, você pode pegar e entregar suas encomendas FedEx onde for mais conveniente para você. Elas estão perto de onde você trabalha, vive e se diverte, e algumas estão até mesmo abertas por horários estendidos. A FedEx tem quase 9.000 localidades Walgreens e seleciona as localidades do Dollar General, Albertsons e Kroger nos Estados Unidos e Porto Rico onde você pode:

  • Ter as encomendas guardadas em um local seguro para que você possa pegá-las quando lhe for conveniente.
  • Entregar as remessas pré-embaladas, pré-etiquetadas FedEx Express e FedEx Ground U.S. e remessas internacionais. Os pacotes individuais podem pesar até 55 libras. e medirem até 48 "de comprimento por 25" de largura por 25 "de altura.

Regras do negócio

  • As localidades FedEx Office, FedEx OnSite e algumas FedEx Authorized ShipCenter não aceitam cargas perigosas, animais vivos, tabaco ou outros materiais regulamentados e carregamentos de risco.
  • Restrições de peso por localidade
    • As localidades FedEx Office e FedEx Ship Center podem aceitar encomendas maiores e mais pesadas no Reter na localidade que a FedEx Authorized ShipCenter e FedEx OnSite.
    • As localidades FedEx Ship Center aceitam pacotes que excedam 68 Kg, 300 cm de comprimento, e/ou 420 cm de comprimento e perímetro (L+2P+2A) que não possam ser entregues em outros localidades.
    • As localidades FedEx Office aceitam pacotes com um peso máximo de 68 Kg, comprimento máximo de 300 cm e/ou 420 cm comprimento e perímetro (L+2P+2A).
    • As localidades FASCs e FedEx OnSite (por exemplo, Walgreens) aceitam encomendas com peso máximo de 25 Kg e tamanho máximo de 122 cm x 63 cm x 63 cm.

Coleção JSON API

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