All Docs
Getting StartedBlockManOSUpdated March 15, 2026

v1.0.45: Formal Works Order Documents Are Now Generated In-Platform

v1.0.45: Formal Works Order Documents Are Now Generated In-Platform

Release: v1.0.45
Category: Core Functionality

The Problem This Solves

Property managers using the platform to raise maintenance requests have always received an auto-generated Works Order reference — for example, WO-2025-0042. However, until now, there was no way to produce the actual Works Order document from within the platform. Managers had to create the formal written instruction to contractors separately, outside the system.

This created a gap between the platform's internal records and the documents being issued to contractors — undermining traceability and adding manual overhead to a core part of the maintenance workflow.

What Has Changed

v1.0.45 introduces a new PDF generation route:

GET /api/reports/works-order/[requestId]

Calling this endpoint returns a fully formatted Works Order PDF, ready to issue to a contractor. The document is built from data already held in the maintenance request and includes:

  • The worksOrderRef number
  • Scope of works
  • Agreed contractor rates
  • Insurance requirements
  • Authorised spend cap

How to Issue a Works Order

  1. Raise or locate the maintenance request for the works you want to instruct.

  2. Note the worksOrderRef assigned to the request (e.g. WO-2025-0042).

  3. Call the PDF endpoint with the maintenance request ID:

    GET /api/reports/works-order/[requestId]

  4. Download the PDF and issue it directly to the appointed contractor.

No additional data entry is required — the document is generated from information already recorded on the request.

Why Written Contractor Instructions Matter in Irish Block Management

For property managers acting on behalf of an OMC (Owners' Management Company), issuing a formal written instruction before works commence is a standard procurement and risk management control. It establishes:

  • What the contractor is authorised to do
  • How much they are authorised to spend
  • What insurance they must hold

Having this document generated in-platform means it is always consistent with the platform's records, reducing the risk of disputes and providing a clear audit trail for OMC directors and auditors.

Further Reading