OfficeGest
Workshop/Reports/Service order times

Service order times report

Returns, per calendar month, the hours clocked on service orders (time_spent) and the invoiced labour hours prorated over those same mechanic tasks (time_invoiced). When no window is supplied the current month and the three previous ones are returned. start_date/end_date are expanded to the whole calendar months they belong to, and every month in the window is returned, including months with no clocked hours (zeros) — the response is never empty.

GET
/workshop/reports/service-order-times
AuthorizationBearer <token>

In: header

Query Parameters

start_date?string

First day of the window (inclusive). Defaults to the first day of the month 4 months back (current month included). The report buckets whole calendar months, so a mid-month date is expanded to the whole month it belongs to.

Formatdate
end_date?string

Last day of the window (inclusive). Defaults to today. Expanded to the whole calendar month it belongs to.

Formatdate

Response Body

curl -X GET "https://og-tenant1.test:8003/api/v2/workshop/reports/service-order-times?start_date=2019-08-24&end_date=2019-08-24"
{
  "data": [
    {
      "month": "string",
      "time_spent": 0,
      "time_invoiced": 0
    }
  ]
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}