create_parcel
Book and dispatch a physical parcel consignment across Bangladesh through Steadfast, Pathao, RedX, Paperfly, or AI smart cascading routing, with built-in per-tenant invoice idempotency and optional dry-run validation. STATE-MUTATING ACTION (unless dry_run=true): Creates a real, billable shipment record in the carrier's production database, assigns an official tracking code, and deducts courier fees upon pickup. Set dry_run=true to validate recipient phone/address and preview the target courier and estimated BDT cost without booking upstream. Once booked, cancellations require direct courier portal operations ('cancellable_via_api: false').
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"invoice": "<invoice>",
"recipient_name": "<recipient_name>",
"recipient_phone": "<recipient_phone>",
"recipient_address": "<recipient_address>",
"cod_amount": "<cod_amount>"
},
"name": "create_parcel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Special instructions for delivery rider | |
| value | No | Declared parcel value in BDT (used by RedX; defaults to the COD amount) | |
| courier | No | Target courier or 'auto' for AI smart routing (default: auto) | |
| dry_run | No | If true, validates phone/address and returns would_book_with and estimated_cost_bdt without creating a real upstream shipment. | |
| invoice | Yes | Unique order invoice number (e.g. INV-1002) used as idempotency key | |
| item_type | No | What's inside the parcel (used by RedX) | |
| cod_amount | Yes | Cash on delivery amount in BDT (0 if prepaid) | |
| item_weight | No | Parcel weight in KG (default: 0.5) | |
| recipient_name | Yes | Customer full name | |
| pickup_store_id | No | RedX only: your pickup store id (optional) | |
| recipient_phone | Yes | 11-digit Bangladeshi mobile number (e.g. 017XXXXXXXX) | |
| delivery_area_id | No | RedX only: numeric delivery-area id (auto-resolved from the address if omitted) | |
| recipient_address | Yes | Delivery address (Thana, District, Street) |