Box (Package & Parcel Delivery)
Box tools handle parcel and package delivery services. All tools are prefixed box_. Only delivery (business_type=send) is enabled for now — buy (Box Purchase) is a documented value but not yet live.
| Tool | Purpose | Key parameters |
|---|---|---|
box_get_vehicle_types | Available vehicle types for delivery (returns cct_id per type) | pickup_latitude, pickup_longitude, dropoff_latitude, dropoff_longitude, business_type (send) |
box_pre_checkout | Pre-checkout validation, pricing, and available payment methods | pickup_latitude, pickup_longitude, dropoff_latitude, dropoff_longitude, cct_id (from box_get_vehicle_types), optional pickup_location_id?, dropoff_location_id?, pickup_name?, dropoff_name?, instructions?, package_category_id? |
box_get_config | Service configuration and settings | latitude, longitude, business_type (send) |
box_get_categories | Available parcel categories (returns id per category to use as package_category_id) | latitude, longitude, business_type (send) |
box_create_order ⚠️ | Create a parcel delivery order | pickup_latitude, pickup_longitude, pickup_location_id, dropoff_location_id, cct_id, payment_type (cash | card | wallet), optional instructions?, package_category_id?, payment_id? (required when payment_type is card) |
Flow
box_get_config— confirmservice_statusisAVAILABLEfor the pickup area (business_type=send) before going further.box_get_vehicle_types— list vehicle types for thepickup_latitude/pickup_longitude+dropoff_latitude/dropoff_longitudepair; get each option'scct_id.box_get_categories(optional) — list parcel categories; get the chosen category'sidto use aspackage_category_id.box_pre_checkout— pass the chosencct_id(+package_category_idif set) to get pricing anduser_available_payment_methods; let the user pick a payment method, never auto-select.box_create_order⚠️ — place the order with the samecct_id,pickup_location_id/dropoff_location_id, and the chosenpayment_type(+payment_idifcard).