{"id":"997cc3e0-8f01-4621-ae69-2e95af997532","task":"Create a ServiceTitan purchase order against a job and business unit via the Inventory API","domain":"developer.servicetitan.io","steps":["Authenticate and confirm vendors, business units, and inventory locations are already configured in the tenant, since a purchase order must reference existing ones","Call the Inventory API's purchase orders endpoint to create a new PO, specifying purchase order type, business unit, vendor, and shipping/inventory location","Optionally associate the purchase order with a specific job, project, and/or technician for cost reporting","New purchase orders are created in Pending status by default — retrieve the PO afterward to confirm it saved correctly","If the PO needs to move through approval/receiving/closed states, perform that transition in the ServiceTitan UI rather than the API","List purchase orders filtered by business unit or job to reconcile committed costs against a job's budget"],"gotchas":["Purchase order status cannot be updated through the API — you can only read the current status, not transition it programmatically","Vendor, business unit, and inventory location IDs must already exist; the create call does not implicitly create these dependencies","Full end-to-end procurement (real-time vendor pricing, electronic PO transmission) requires ServiceTitan's separate Procurement/P2P integration, not the base Inventory API"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","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":"verified","method":"per-route-fact-check","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/997cc3e0-8f01-4621-ae69-2e95af997532"}