get_delivery_promises

Description

Computes delivery options including ETA estimates, delivery methods, costs, and carrier routes for specific items shipped to a destination. This is the central tool for evaluating delivery feasibility.

When to Use

Shopper asks “When can I receive it?”
Need to compare shipping vs pickup.
Evaluating express vs standard shipping.
When delivery seems impossible and you may switch to ROPIS.

Workflow

Collect destination (address, endpoint, or delivery zone).
Build items list with item_id and qty.
Call tool.
Interpret each option: status, ETA, price, method.
Recommend best option (or fallback to ROPIS if none feasible).

Arguments

Field	Type	Required

Field	Type	Required
destination	object	Yes
items	array	Yes

Destination supports either:

endpoint_id
delivery_zone
location (country, state, zip_code)

Input Schema (simplified)

{
  "destination": {
    "endpoint_id": "string",
    "delivery_zone": "string",
    "location": {
      "country": "string",
      "zip_code": "string"
    }
  },
  "items": [
    { "item_id": "sku123", "qty": 1 }
  ]
}

Output

Array of delivery options:

[
  {
    "delivery_method": "express",
    "cost": 5.99,
    "eta_start": 1764666751,
    "eta_end": 1764668251,
    "status": "valid"
  }
]

Sample Prompts

“Get delivery promises for SKU 1122 to Paris 75010.”
“Compare standard vs express shipping for item sku123.”