OptimoRoute

These are the OptimoRoute actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create or Update Orders

  Tool to bulk create, update, or replace multiple orders at once without geocoding. Use when you need to add new orders or modify existing ones efficiently. Supports up to 500 orders per request.

• Create Order

  Tool to create a new order or update an existing order in OptimoRoute. Use when you need to add delivery, pickup, or task orders to the system with location, time windows, and other constraints.

• Delete Order

  Tool to remove a single order from the OptimoRoute system. Use when you need to delete a specific order by its orderNo.

• Delete Orders

  Tool to delete one or more orders from the system in bulk (max 500 per request). Use when you need to remove orders, either individually or in batch operations.

• Get Drivers

  Tool to retrieve all drivers in the system. Use when you need up-to-date driver data including status and contact information.

• Get Mobile Events

  Tool to retrieve mobile events from drivers' field operations. Use when you need to track order completions, status changes (success, failed, on_duty, off_duty), and other field events for the currently active plan.

• Get Order Completion Details

  Tool to retrieve completion details for one or more orders including proof of delivery data. Use when you need to check order completion status, timing details, and form data.

• Get Order Scheduling Info

  Tool to retrieve scheduling information for a specific order. Use when you need to check if an order is scheduled and get details like driver assignment, timing, and position.

• Get Orders

  Tool to retrieve one or more orders from OptimoRoute. Use when you need detailed order information including location, time windows, and assignment details.

• Get Planned Routes

  Tool to retrieve all planned routes for a given date. Use when you need a detailed view of routes including optional stops, route parameters, and unassigned orders.

• Get Planning Status

  Tool to retrieve the status of an active planning/optimization process. Use when you need to check the progress of a planning job by providing its ID.

• Search Orders

  Tool to search for orders in OptimoRoute based on criteria. Use when you need to find orders by date range, order identifiers, or order status. At least one of 'orders' or 'date_range' must be provided.

• Start Planning

  Tool to start the planning/optimization process for a specified date or date range. Use when you need to generate optimized routes for orders and drivers. Requires orders to be created before planning can begin.

• Stop Planning

  Tool to stop an active planning/optimization process. Use when you need to halt a running planning job by providing its ID.

• Update Driver Parameters

  Tool to update driver parameters for a specific date including work times, vehicle assignment, and start/end locations. Use when you need to modify driver availability or routing constraints. Note that this unschedules existing routes for the driver on the specified date.

• Update Drivers Parameters

  Tool to update parameters of multiple drivers for specified dates in bulk (max 500 per request). Use when you need to modify driver configuration including work hours, vehicle assignments, and location settings. Note: Existing routes for the specified drivers and dates will be unscheduled.

• Delete All Orders

  Tool to remove all orders and planned routes for a specified date. Use when you need to clear orders for a specific date or delete all orders system-wide if no date is provided.