Fedex Logo
Developer Portal

FedEx Locations Search API

Introducción

Las oficinas de FedEx son puntos de recolección y entrega administrados por los proveedores de envíos de FedEx. Puede enviar un paquete desde una oficina de recolección a una de entrega utilizando cualquier transportista de FedEx. Esta API le ayuda a buscar oficinas de envío compatibles y disponibles por medio de la dirección, las coordenadas geográficas o el número de teléfono.

La API de búsqueda de oficina de FedEx busca y arroja las direcciones de los puntos de entrega de FedEx más cercanos, incluidas las ubicaciones de los Centro de impresión y envío de FedEx Office® y las ubicaciones de FedEx Drop Box disponibles como puntos de entrega de paquetes de FedEx Express® y FedEx Ground®.

Detalles de la API de búsqueda de oficinas de FedEx

La API de búsqueda de oficinas de FedEx le permite buscar ubicaciones de puntos de entrega de FedEx por dirección, coordenadas geográficas o número de teléfono.

La API de búsqueda de oficinas de FedEx le permite buscar ubicaciones según lo siguiente:

  • Centros de envío autorizados
  • Centros de entrega autorizados
  • Retener en oficina
  • Ubicación de buzones
  • Oficinas que aceptan envíos de mercancías peligrosas

Las funciones de la API de búsqueda de oficina de FedEx son:

  • Búsqueda de la oficina de recolección y entrega de FedEx más cercana
  • Recuperar la dirección detallada de la oficina, incluido el código postal, el código del país, etc.

Cómo funciona la API de búsqueda de oficinas de FedEx

La API de búsqueda de oficina le ayuda a solicitar las oficinas de FedEx disponibles como punto de entrega de paquetes FedEx Express® y FedEx Ground®. Esta transacción busca y arroja las direcciones de la oficina de FedEx más cercana. También puede usar esta API para encontrar oficinas de FedEx que proporcionen el servicio de retener en oficina.

Localizar oficinas

Esta solicitud se utiliza para arrojar una lista de todas las oficinas disponibles basada en los detalles ingresados. La información clave de ingreso asociada a esta solicitud es la siguiente:

  • Dirección de la oficina
  • Distancia (valor y las unidades del radio alrededor de la dirección para buscar oficinas de FedEx)

Nota: El código postal es obligatorio para los países en los que se utiliza. Para los países en los que no se utiliza el código postal, una combinación de ciudad y país buscará las oficinas de FedEx válidas.

El resultado de esta solicitud es una lista detallada de oficinas de recolección y entrega disponibles, junto con la información clave como distancia, horario de atención, detalles del transportista, servicios y capacidades disponibles de la oficina en los días de la semana, si funciona como punto de entrega y recolección de envíos, si puede retener envíos para recolectar, etc.

Características clave de la API de búsqueda de oficinas de FedEx

Limite su búsqueda por oficina

Usted puede limitar su búsqueda por tipo de oficina. En la solicitud de búsqueda se pueden especificar uno, varios o todos los tipos de oficinas de FedEx que se encuentran enumeradas:

  • Ubicaciones de FedEx Authorized ShipCenter®: acceda a la red de transporte de FedEx en más de 5800 establecimientos de propietarios independientes (FASC) que hacen empaques y envíos en las tiendas de los Estados Unidos que participan del programa FedEx Authorized ShipCenter y que también proporcionan otros servicios comerciales. Los FedEx Authorized ShipCenter pueden aplicar cargos adicionales a las tarifas publicadas por FedEx.
  • FedEx ShipCenter®
  • Estación Express
  • FedEx ShipSite
  • Ubicación de FedEx Office®
  • Ubicación de autoservicio de FedEx: Deje paquetes de FedEx Express (hasta 20” x 12” x 6” [50 cm x 30 cm x 15 cm]) en un punto de entrega de FedEx Express ®.
  • Los siguientes tipos de oficina admiten el servicio de retener en oficina:
    • Paquetes de FedEx OnSite: FedEx Express y FedEx Ground
    • Paquetes de Oficina de FedEx: FedEx Express y FedEx Ground
    • Estaciones Express: solo paquetes de FedEx Express
    • Centros de envíos FedEx: paquetes de FedEx Express y FedEx Ground y mercancías peligrosas aprobadas

Capacidades de la oficina

Además, la solicitud de búsqueda admite un atributo para especificar que las oficinas admiten el servicio de redireccionar para retener de FedEx Express o FedEx Ground y atributos para especificar capacidades de la ubicación, como:

  • Servicios de devolución
  • Punto de entrega de Ground
  • Efectivo
  • Empacar y enviar
  • Suministros de embalaje
  • Servicio de carteles y anuncios
  • Sony PictureStation
  • Servicios de correo directo
  • Servicios de copia e impresión
  • Servicio de mercancías peligrosas
  • La oficina está en el aeropuerto
  • Servicios notariales
  • Respeta el horario de verano
  • Servicios fotográficos para pasaportes
  • Buzón
  • Servicios de envío nacional
  • Servicios de envío internacional

Ordenar resultados

La API de búsqueda de oficina de FedEx permite que ordene los resultados por:

  • Último horario del punto de entrega de FedEx Express
  • Último horario del punto de entrega de FedEx Ground
  • Tipo de oficina
  • Por distancia en orden ascendente
  • Por distancia en orden descendente

Criterios de búsqueda adicionales

También puede limitar su búsqueda según el siguiente criterio:

  • Servicio disponible los sábados.
  • Servicio de empaque disponible (la mayoría de las ubicaciones de FedEx Office): FedEx empaquetará su envío por usted (con un cargo adicional).
  • Suministros de empaque disponibles (donde se suministren los materiales de empaque de FedEx Express, no incluye los materiales de FedEx Ground).
  • Ubicaciones de punto de entrega de FedEx Express que cierran más tarde: arroja las oficinas con puntos de entrega que cierran más tarde.
  • Entrega Express fuera de horario: entregue un paquete después de un horario específico, como por ejemplo las 17:00 h. Utilice este elemento para buscar los puntos de entrega abiertos después de las 17:00 h.

Nota: la API de búsqueda de oficina de FedEx arroja hasta 75 ubicaciones en un radio de 50 millas (80 km) de su dirección

Oficinas de FedEx

Oficinas de FedEx Ship Center®: deje paquetes y obtenga información de envío

Los especialistas en envíos de las oficinas de FedEx Ship Center pueden ayudarle a elegir un servicio de entrega, completar la documentación y procesar sus paquetes. Muchas oficinas están abiertas hasta más tarde y los sábados para adaptarse a su horario.

  • Deje sus envíos o entréguelos en el mostrador para que FedEx los procese.
  • Compre cajas y otros suministros de embalaje.
  • Revise el Localizador de puntos de entrega de FedEx para ver la lista de servicios, como el servicio los sábados que se ofrece en cada ubicación.
  • Cargue sus envíos a su cuenta FedEx o use cheques, tarjetas de crédito y efectivo, los cuales son aceptados en la mayoría de las oficinas.

Nota: debe tener un número de cuenta FedEx para enviar paquetes con FedEx International Ground® en un FedEx Ship Center y nuestras otras oficinas de envíos.

Oficinas autorizadas de FedEx ShipCenterCenter®: oficinas de propietarios independientes para empacar y enviar

Acuda a estas oficinas de propietarios independientes para servicios de envío y embalaje. La mayoría también ofrecen servicio de fax, copias y otros servicios de negocios.

  • Busque tiendas minoristas para empacar y enviar como AIM Mail Center®, PakMail®, PostalAnnex+® y PostNet® y otras oficinas afiliadas a la Asociación de Centros de Envío y Negocios y Asociados de tiendas minoristas de envíos.
  • Usted puede enviar paquetes de FedEx Express y FedEx Ground en la mayoría de estas oficinas. Para obtener más información, revise el Localizador de puntos de entrega de FedEx.

Nota: las tarifas por procesar paquetes reflejan las propias políticas de precios de cada oficina. Estas oficinas podrían aplicar cargos adicionales a las tarifas de FedEx.

Las oficinas de FedEx ShipSite en Office Depot® y OfficeMax®: acceso conveniente a servicios de envío

Los servicios de FedEx® están disponibles en todas las tiendas Office Depot y OfficeMax. Estas ubicaciones ofrecen servicios de envío internacional de FedEx Express y FedEx Ground, para que puedas dejar paquetes o procesarlos en el mostrador, comprar suministros de embalaje y te encargues de otras necesidades de negocios, todo en un solo lugar.

Ubicaciones FedEx Drop Box: más de 35 000 ubicaciones de buzones

Existen más de 35 000 buzones en edificios de oficinas, centros comerciales, aeropuertos, oficinas de FedEx, tiendas de comestibles y otras convenientes ubicaciones.

  • Deja tus envíos de FedEx Express, FedEx Ground y FedEx Ground® Economy (antes conocido como FedEx SmartPost®). Es posible que los envíos de FedEx Ground requieran un día adicional para la entrega.
  • Todos los buzones aceptan paquetes de hasta 20" x 12" x 6" (50 cm x 30 cm x 15 cm) (muchos aceptan paquetes de hasta 20" x 12" x 6" [50 cm x 30 cm x 22 cm]).
  • Muchos tienen una cantidad limitada de guías aéreas y suministros de embalaje de FedEx Express.
  • Todos ofrecen la recolección de lunes a viernes y algunos también ofrecen recolección los sábados.
  • No deposites paquetes de Fedex SameDay®  en los buzones.
  • Las únicas mercancías peligrosas que se pueden poner en los buzones son baterías de litio de IATA Sección II y sustancias biológicas, Categoría B (ONU 3373).
  • No se aceptan pagos en efectivo, con cheques ni con tarjeta de crédito.

Oficinas de FedEx OnSite: recolecte y deje sus paquetes donde compra

Con las nuevas sucursales de FedEx OnSite puede retirar y dejar sus paquetes de FedEx donde le quede más cómodo. Están cerca de donde trabaja, vive y se divierte e incluso algunas cuentan con horario extendido. FedEx tiene cerca de 9 000 oficinas en Walgreens y en algunas ubicaciones de Dollar General, Albertsons y Kroger en los EE. UU. y Puerto Rico, donde usted puede:

  • Pedir que le retengan su paquete en un lugar seguro para buscarlo cuando le quede cómodo.
  • Dejar envíos nacionales e internacionales de FedEx Express y FedEx Ground ya embalados y etiquetados. Los paquetes individuales pueden pesar hasta 55 lb (25 kg). y medir hasta 48″ (1,21 m) de largo por 25″ (63 cm) de ancho por 25″ (63 cm) de alto.

Normas comerciales

  • Las oficinas de FedEx, las oficinas de FedEx OnSite y los FedEx Authorized ShipCenter no aceptan mercancías peligrosas, tabaco ni envíos de otros materiales regulados o peligrosos.
  • Restricciones de peso por tipo de oficina
    • Es posible que las oficinas de FedEx y los FedEx Ship Center acepten paquetes más grandes y más pesados para retener en oficina que los FedEx Authorized ShipCenter y las oficinas de FedEx OnSite.
    • Las oficinas de los FedEx Ship Center aceptan paquetes que exceden las 150 lb (68 kg), 119″ (3,02 m) de largo y/o 165″ (4,2 m) de largo y contorno (largo + 2ancho + 2altura) que no es posible entregar en otras oficinas.
    • Las oficinas de FedEx aceptan paquetes con un peso máximo de 150 lb (68 kg), máximo de 119″ (3,02 m) de largo y/o 165″ (4,2 m) de largo y contorno (largo + 2ancho + 2altura).
    • Las oficinas de FASC y FedEx OnSite (p.ej. Walgreens) aceptan paquetes con un peso máximo de 55 lb (25 kg). y tamaño máximo de 48" x 25" x 25" (1,21 m x 63 cm x 63 cm).

Colección de JSON de la 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