⚠️ Orders: select courier slot
orders_set_courier_delivery_rangeBooks a courier pickup time slot for an order using seller's address and contact details. Updates the slot if courier hasn't picked up yet.
Instructions
⚠️ Selects (books) a specific time slot for a courier to pick up the item (set_courier_delivery_range), for seller-courier delivery. A write operation, unlike the read method orders_get_courier_delivery_range, which only shows the available slots — call it first and take the interval and intervalType from the response. Can be called again to change the time while the courier has not yet picked up the parcel. The response contains a success flag.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orderId | Yes | Avito order ID. | |
| address | Yes | Seller's address where the courier picks up the item. | |
| addressDetails | No | Seller address details (entrance, floor, apartment, etc.). | |
| name | Yes | Full name of the seller's contact person. | |
| phone | Yes | Phone of the seller's contact person. | |
| startDate | Yes | Start date/time of the courier arrival in date-time format (ISO 8601); taken from the get method response. | |
| endDate | Yes | End date/time of the courier arrival in date-time format (ISO 8601); taken from the get method response. | |
| intervalType | Yes | Interval type: fixed (fixed slot) or asap (as soon as possible). Taken from the orders_get_courier_delivery_range response. | |
| dryRun | No | v0.7.0: if true — returns a preview of the HTTP request without calling the Avito API. Safe for inspecting exactly what would be done. Default: the value of AVITO_MCP_DRY_RUN_DEFAULT (usually false). | |
| idempotencyKey | No | v0.7.0: optional key for duplicate protection. A repeat call with the same key within AVITO_MCP_IDEMPOTENCY_TTL_SEC returns the cached result. The same key with different args returns a conflict error — this is safe by design. |