ConnectCloud Developers

Correct an approved or billed entry (its owner, line manager or deputy, or hr:work:manage)

POST /api/hr/v1/work-entries/{id}/corrections

Module: HR · operationId: correctWorkEntry · Tag: Work entries · Auth: access token (Authorization: Bearer <accessToken>)

Books a new confirmed entry (source: correction, correctionOf) whose minutes are the difference to the effective values asked for, dated today. An entry that is not approved or billed is 409 work_state. A correction that brings the effective minutes to zero releases what the entry booked, like a delete: its origin (cleared on the entry and its corrections) and the activities combined into it can be booked again.

Parameters

Name In Type Required Description
id path string (uuid) yes

Request body

application/json (required)

  • billableMinutes (integer, required): Effective billable minutes
  • description (string, required): The reason (max. 2000 characters)
  • minutes (integer, nullable): Effective worked minutes (null keeps them)

Example:

{
  "billableMinutes": 10,
  "description": "Rückruf war Teil der Gewährleistung, 5 Minuten nicht aus dem Kontingent buchen.",
  "minutes": 15
}

Responses

  • 201 The correction (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)
  • 409 Error (application/json)

Fields of the 201 answer:

  • approvedAt (string (date-time), nullable): When the entry was approved
  • approvedBy (string): Who approved the entry (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)
  • article (WorkArticleRef | null): Masterdata article a flat-rate entry is billed as
  • batchId (string (uuid), nullable): Billing batch the entry is billed in
  • billableMinutes (integer): Minutes billed
  • billedRate (number, nullable): Hourly rate (or article price) the entry was billed at
  • billing (string): Key of a billing type
  • contract (WorkContractRef | null): Trade contract that decides billing
  • correctionOf (string (uuid), nullable): The approved or billed entry this one corrects; its minutes are the difference (may be negative)
  • createdAt (string (date-time)): When the work entry was created
  • createdBy (string): Who booked the entry (e-mail)
  • customer (WorkCustomerRef | null): Customer the work is billed to
  • description (string): What was done
  • durationSeconds (integer): The exact length in seconds (the stopwatch's seconds, else minutes × 60)
  • employeeId (string (uuid)): Id of the employee
  • employeeName (string): Display name of the employee – only in listApprovableWorkEntries
  • endedAt (string (date-time), nullable): null for the running stopwatch and for an entry without a span
  • id (string (uuid)): Id of the work entry
  • kind (string): Key of a work kind (getWorkEntrySettings)
  • km (number): Kilometres travelled (kinds that allow travel)
  • minutes (integer): The length in minutes that sums and billing use (a correction's difference, may be negative; 0 for a stopwatch run that rounded to nothing)
  • origin (string): The call or appointment the time comes from: comms:interaction:<id> or comms:calendar:<id>; omitted for other work. Booked at most once per tenant (409 already_booked)
  • project (WorkProjectRef | null): Project the work counts for
  • running (boolean): The running stopwatch entry (start, no end)
  • source (string): How the entry was booked (one of manual, stopwatch, interaction, calendar, correction)
  • startedAt (string (date-time), nullable): null for an entry booked as a length only
  • state (string): suggested → confirmed → approved → billed (one of suggested, confirmed, approved, billed)
  • subject (string): What was worked on: desk:item:<id>, forge:item:<id>, crm:activity:<id>, a project desk:project:<id> / forge:project:<id>; empty for work on the customer only or internal work
  • subjectLabel (string): The subject's name at booking time (the origin's without a subject)
  • travelMinutes (integer): Travel time in minutes (kinds that allow travel)
  • updatedAt (string (date-time)): When the work entry was last changed
  • version (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
  • workDate (string (date)): The day the work counts for (the person's choice; with a start its day in the tenant's time zone)

Example 201 answer:

{
  "approvedAt": "2026-11-17T08:05:00Z",
  "approvedBy": "martin.brandl@muster-it.example",
  "batchId": null,
  "billableMinutes": 15,
  "billedRate": null,
  "billing": "quota",
  "contract": {
    "id": "7a9c1e3a-5c7e-4a9c-8e3a-5c7e9a1c3e52",
    "number": "WV-2026-0007",
    "quota": true,
    "title": "Wartungsvertrag Netzwerk und WLAN"
  },
  "correctionOf": null,
  "createdAt": "2026-11-16T09:30:00Z",
  "createdBy": "sophie.huber@muster-it.example",
  "customer": {
    "id": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c1e",
    "name": "Alpenhotel Seeblick GmbH"
  },
  "description": "Access Point im Restaurant neu gestartet, Kanal gewechselt, Rückruf bei Frau Stadler.",
  "durationSeconds": 900,
  "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
  "endedAt": "2026-11-16T09:27:00Z",
  "id": "5e7a9c1e-3a5c-4e7a-9c1e-3a5c7e9a1c51",
  "kind": "remote",
  "km": 0,
  "minutes": 15,
  "origin": "comms:interaction:4f6a8c0e-2b4d-4f6a-8c0e-2b4d6f8a0c2e",
  "running": false,
  "source": "interaction",
  "startedAt": "2026-11-16T09:12:00Z",
  "state": "approved",
  "subject": "desk:item:6a8c0e2a-4b6d-4f8a-9c1e-3b5d7f9a1c3e",
  "subjectLabel": "#214 WLAN im Restaurant fällt aus",
  "travelMinutes": 0,
  "updatedAt": "2026-11-17T08:05:00Z",
  "version": 2,
  "workDate": "2026-11-16"
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/hr/v1/work-entries/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/corrections' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"billableMinutes":10,"description":"Rückruf war Teil der Gewährleistung, 5 Minuten nicht aus dem Kontingent buchen.","minutes":15}'

View as Markdown · Interactive reference · OpenAPI