Logistics: Create freight order
logistics_create_freight_orderCreate a freight order (заявка) — a customer's request to move cargo. 'customer', 'plan_tons', 'load_point' and 'unload_point' are the minimum; 'rate_per_ton' is what we pay, 'customer_rate_per_ton' what we charge (the two sides of the margin). Resolve 'cargo_id' with logistics_list_references first when the cargo matters. The order number (RQ_…) is assigned by the server — never invent one. Starts in status New. Requires confirmation before it runs. CONFIRMATION: this tool is PROPOSED, never performed directly. You get status='confirmation_required' with an action_id and a plan_token, and the write happens only after confirm_action.
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": {
"customer": "<customer>",
"plan_tons": "<plan_tons>"
},
"name": "logistics_create_freight_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| cargo_id | No | ||
| customer | Yes | ||
| end_house | No | ||
| end_phone | No | ||
| end_place | No | ||
| load_date | No | ISO date (YYYY-MM-DD) or datetime. | |
| load_type | No | Vehicle body type. Prefer a code from the company's «Тип машини» book (Grain, Dump, Tent, Reefer, Flatbed, Container, Tanker) — loss-norm resolution matches this against the norm's transportType. | |
| plan_tons | Yes | ||
| end_region | No | ||
| end_street | No | ||
| load_point | No | ||
| order_date | No | ISO date (YYYY-MM-DD) or datetime. | |
| distance_km | No | ||
| end_contact | No | ||
| end_country | No | ||
| start_house | No | ||
| start_phone | No | ||
| start_place | No | ||
| unload_date | No | ISO date (YYYY-MM-DD) or datetime. | |
| end_district | No | ||
| end_latitude | No | ||
| end_locality | No | ||
| loss_percent | No | ||
| rate_per_ton | No | ||
| start_region | No | ||
| start_street | No | ||
| unload_point | No | ||
| end_longitude | No | ||
| start_contact | No | ||
| start_country | No | ||
| start_district | No | ||
| start_latitude | No | ||
| start_locality | No | ||
| vehicles_count | No | ||
| freight_rate_id | No | ||
| start_longitude | No | ||
| customer_rate_per_ton | No | ||
| estimated_cost_per_ton | No | ||
| customer_organization_id | No |