capabilities.work

Raise, quote, approve and complete a PropertyMe maintenance job

A 9-step recipe with PropertyMe. We can help you get access.

Recipe · 9 steps

Raise, quote, approve and complete a PropertyMe maintenance job

with PropertyMe · Property Maintenance & Work Order Management

Create a maintenance job against a property, attach a supplier quote, approve, assign and complete it.

  1. Resolve the supplier contact. Pages with Offset and Limit; there is no total count.
  2. Create the work order. NO Idempotency-Key exists on this operation — on a timeout, do not blind-retry; re-read with SearchJobTaskV2Requestjobtaskssearch_Get filtered on DateCreatedMin/DateCreatedMax and confirm before trying again.
  3. Read the job back to confirm its current state before transitioning.
  4. Record the supplier's quote against the job.
  5. Attach the supplier's quote document to the quotation.
  6. Approve the job. A 400 here means the transition is not valid from the job's current state, not a transient failure — do not retry it.
  7. Assign the approved job to the supplier or agency member.
  8. Attach completion photos before closing the job out.
  9. complete-job
What you'll need to have ready
  • lotId: GUID of the lot (property) the work is against.
  • jobId: GUID of an existing job task, when driving an already-created job.
  • quoteId: GUID of a quotation on the job.
For your developer

Arazzo workflow propertyme:raise-quote-and-complete-job, 9 operations: QuerySuppliersRequestcontactssuppliers_Get → AddJobV2Requestjobtasks_Post → JobTaskV2RequestjobtasksId_Get → AddJobTasksQuotationRequestjobtasksIdquotation_Post → AddJobTasksQuotationDocumentRequestjobtasksIdquotationQuoteIddocuments_Post → ApproveJobTaskRequestjobtasksIdapprove_Post → AssignTaskRequestjobtasksIdassign_Post → AddJobImagesRequestjobtasksIdimages_Post → CompleteJobTaskRequestjobtasksIdcomplete_Post. Specs on APIs.io.