Skip to content
TrakIT documentation

ReopenWO

Re-opens the closed or cancelled work orders you list, as Re-open Work Order does on the work order page. Use it to undo a CloseWO or a CancelWO, or to reopen a work order that TrakIT closed by itself.

How to sign in and read the response: Authentication, Responses.

POST /api/v1/ReopenWO
Token: your-token
Content-Type: application/json
[48211, 48212, 48299]
Field Required Meaning
The body Yes A JSON list of work order IDs, whole numbers. Not an object: the list itself is the body.

TrakIT re-opens the work orders one at a time, in the order of the list. Each one is re-opened or refused on its own: a refusal does not stop the others, and does not undo those already re-opened. The other work orders of their jobs are not re-opened.

Rules

Section titled “Rules”

For the request:

Rule Info when it fails
The Token header holds a valid token. Token missing in header, Token invalid or expired, or another answer listed in Login token
The user is a system administrator with API access. API User must be SysAdmin with API Access
The body is a list of at least one ID. No WO IDs supplied

For each work order, in the Info of its entry in RetInfo:

Rule Info when it fails
A work order has that ID. No such work order
The work order is closed or cancelled. Work Order(s) already open
Your company’s validations for Save WO Header, Save Job Header and Re-Open WO pass. Their own messages

Response

Section titled “Response”

RetInfo has one entry for each ID, in the order you sent them. RowsAffected is the number of work orders re-opened. Code is 1 when at least one was re-opened, and 0 when none was; Info is empty either way. Always read the entries.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    { "WOID": 48211, "Success": true, "Info": "" },
    { "WOID": 48212, "Success": false, "Info": "Work Order(s) already open" },
    { "WOID": 48299, "Success": false, "Info": "No such work order" }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}
Field Meaning
WOID The work order ID, as you sent it.
Success true when the work order was re-opened, false when it was refused.
Info Why the work order was refused. Empty when it was re-opened.

Notes

Section titled “Notes”
  • A re-opened work order gets the status Active (0 in GetWO), and loses its closing date and the user who closed or cancelled it. Its audit log says Reopened via API.
  • TrakIT then runs your company’s actions for Re-Open WO. No notification is sent.
  • Re-opening a cancelled work order does not put it back into delay tracking or link its yard moves to it again.
  • If a request times out, you can send it again: work orders already re-opened are refused with Work Order(s) already open and stay open.