{"id":"b5c666dc-a5d7-4181-baf9-41ded85d3249","task":"Optimize delivery routes for a fleet using the Routific Engine API","domain":"docs.routific.com","steps":["Obtain a Routific API key and include it in every request as the Authorization: Bearer YOUR_API_KEY header with Content-Type: application/json.","For jobs with 60 or fewer stops, POST your fleet and visit data to https://api.routific.com/v1/vrp; for larger jobs use https://api.routific.com/v1/vrp-long to avoid timeouts.","Structure the request body with a visits object (keyed by stop ID, each with location lat/lng and optional time_window start/end, duration, and load) and a fleet object (keyed by vehicle ID, each with start/end location and optional shift times and capacity).","For vrp-long, the response returns a job_id; poll GET https://api.routific.com/v1/jobs/{job_id} at intervals (default 1000 ms) until status is finished.","Parse the solution object: each vehicle key maps to an ordered array of stops with arrival_time, finish_time, and any unserved visits; surface unserved stops for manual reassignment.","Push the optimized stop sequence back to your dispatch system or delivery app for driver navigation; re-submit to /vrp-long with updated inputs if real-time changes occur during the day."],"gotchas":["Time windows must be specified in HH:MM format relative to the fleet shift start — mixing absolute timestamps with relative windows produces silently incorrect routes.","Routific bills per optimization request; avoid tight polling loops or unnecessary re-optimizations during a single shift to control costs.","Unserved visits in the solution are not errors — they indicate stops that cannot fit within vehicle capacity or time constraints; always check and handle this array before dispatching."],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:26.626Z"},"url":"https://mcp.waymark.network/r/b5c666dc-a5d7-4181-baf9-41ded85d3249"}