create_ropis_order

Description

Creates a ROPIS (Reserve Online, Pay In Store) order. This tool is used when store reservation is the best fulfillment option after evaluating delivery promises. Requires a confirmed pickup endpoint and validated customer details.

When to Use

Shopper explicitly wants to reserve an item in-store.
Delivery promises are too slow, too expensive, or unavailable.
A pickup store has been selected and contact details have been confirmed.

Workflow

Understand the shopper’s need and timing requirements.
Call get_delivery_promises to compare shipping availability.
Present pickup store alternatives via get_pickup_stores_near_location.
Collect mandatory customer details (first name, last name, phone, email).
Confirm store hours + pickup rules.
Call create_ropis_order.
Confirm that an email/SMS will be sent when validated.

Arguments

Field	Type	Required	Notes

Field	Type	Required	Notes
endpoint_id	string	Yes	ID of selected pickup store
order_items	array	Yes	Requires `item_id` + `quantity`
first_name	string	Yes	Customer’s first name
last_name	string	Yes	Customer’s last name
phone_number	string	Yes	Must be valid
email	string	Yes	Must be valid
sales_channel	string/null	No	Only when known in the context

Input Schema (simplified)

{
  "endpoint_id": "string",
  "order_items": [{ "item_id": "SKU", "quantity": 1 }],
  "first_name": "string",
  "last_name": "string",
  "phone_number": "string",
  "email": "string",
  "sales_channel": "string | null"
}

Output

No structured output. Success or failure is returned through MCP response.

Sample Prompts

“Reserve SKU 12345 in-store at endpoint 678 for John Smith, john@example.com.”
“Create a ROPIS order for SKU SHIRT-M in the nearest store.”