get_available_pickup_stores

Description

Returns a list of alternative pickup stores capable of fulfilling the current pickup order. It evaluates availability, store capabilities, and location constraints. Used when customers want to switch pickup location or when the initial store becomes unavailable.

When to Use

Customer wants to change to another pickup point.
A store is closed, out of stock, or cannot fulfill the order.
You need to present a list of pickup alternatives (with distance).

Workflow

Ask whether to search near shopper location or current pickup store.
If a location is provided, validate → convert to coordinates.
Call tool with latitude/longitude or None.
Present results including name, address, zip, country, coordinates.
Shopper picks one → proceed with edit_pickup_store if needed.

Arguments

Field	Type	Required	Notes

Field	Type	Required	Notes
order_id	string	Yes	Order needing alternative stores
latitude	number/null	No	Center of search
longitude	number/null	No	Center of search
radius	integer/null	No	Defaults to 100 km

Input Schema (simplified)

{
  "order_id": "string",
  "latitude": "number",
  "longitude": "number",
  "radius": "number"
}

Output

Object containing store IDs mapped to store info:

{
  "result": {
    "stores": {
      "store_123": {
        "name": "Toulouse - Blagnac",
        "address_lines": ["123 Avenue de l'Europe"],
        "city": "Blagnac",
        "zip_code": "31700",
        "country": "France",
        "coordinates": { "latitude": 43.62, "longitude": 1.38 }
      }
    }
  }
}

Sample Prompts

“Find available pickup stores for order 9001 near 75001 Paris.”
“List pickup alternatives for order 22011 within 50 km.”