Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 6 Next »

5.0.0

Work Item objects are used to represent the details of a Work Item (i.e. a unit of activity, job, task, break, etc.), either to indicate the current state of the Work Item, what the state of a Work Item was at a given point in time, or to indicate what the Work Item state should be updated to be - depending on the context in which the Work Item object is used.

Do not confuse the Work Item object (which represents the details of a Work Item) with the WorkItem object, for representing how the ServiceBroker WorkItem module is configured for the relevant tenant.

Work Item Object Format

JSON Format
{
  "Assets": [
    {
      "AssetNum": "",
      "Cost": "",
      "Desc": "",
      "FlexForms": [
        "${FlexFormID}"
      ],
      "FlexView": [
        {
          "Title": "GroupName1",
          "Items": [
            {
              "Label": "labeltext",
              "Value": "valuetext"
            }
          ]
        }
      ],
      "InServiceDate": "",
      "IsComponent": false,
      "LastServiceDate": "",
      "Location": "",
      "Mfg": "",
      "MfgCode": "",
      "Model": "",
      "ProdCode": "",
      "ProdNum": "",
      "ProdLine": "",
      "RetailerID": "",
      "RetailerName": "",
      "SerialNum": "",
      "ServiceCodes": [],
      "Status": "",
      "Type": "",
      "WhereAbouts": ""
    }
  ],
  "AtRisk": {
    "Type": "",
    "Offset": 0
  },
  "Booking": {
    "OrderDate": "",
    "SchdArr": "",
    "SchdStart": "",
    "SchdEnd": "",
    "ServiceDesc": "",
    "ServiceOrg": "",
    "Tech": "",
    "Offer": {
      "OfferId": "",
      "GroupId": "",
      "SchdStart": "",
      "SchedEnd": "",
      "Source": ""
    },
    "TechInfo": {
        "Name": "",
        "Phone": "",
        "ImageUrl": ""
    },
    "ServiceOrgInfo": {
      "Name": "",
      "ServiceOrg": "",
      "ExtSysId": "",
      "NetworkProviderType": "",
      "Address": {
        "AddrLine1": "",
        "AddrLine2": "",
        "City": "",
        "Region": "",
        "PostalCode": "",
        "Country": ""
      },
      "Phone": "",
      "Email": "",
      "ImageUrl": ""
    }
  },
  "Claims": [
    {
      "ClaimNum": "",
      "BatchNum": "",
      "SeqNum": "",
      "Status": "",
      "StatusDesc": "",
      "Amount": ""
    }
  ],
  "Desc": "",
  "FlexView": [
    {
      "Title": "GroupName1",
      "Items": [
        {
          "Label": "labeltext",
          "Value": "valuetext"
        }
      ]
    }
  ],
  "Flags": {
    "AllowRebook": false,
    "AllowReject": false,
    "AllowReschedule": false,
    "Billable": false,
    "CallConfirmed": false,
    "ClerkReview": false,
    "Deleted": false,
    "Fixed": false,
    "HardStop": false,
    "IsDelivered": false,
    "IsRead": false,
    "IsRedacted": false,
    "Paused": false,
    "RepeatCall": false,
    "IsAllDayJob": false
  },
  "Id": "",
  "JobSourceInfo": {
    "SourceId": "SS,SD,SM"
  },
  "Location": {
    "Address": {
      "AddrLine1": "",
      "AddrLine2": "",
      "AddrLine3": "",
      "AddrLine4": "",
      "AddrType": "",
      "City": "",
      "Country": "",
      "Intersection": "",
      "Lat": "",
      "Lon": "",
      "PostalCode": "",
      "Region": ""
    },
    "Contacts": [
      {
        "ContactPoint": [
          {
            "Mode": "Email,Phone,Mobile,FaceTime",
            "Value": ""
          }
        ],
        "ContactType": "",
        "FirstName": "",
        "LastName": "",
        "PreferredName": ""
      }
    ],
    "LanguageId": "",
    "LocationNum": "",
    "Name": "",
    "POReq": false,
    "SigReq": true,
    "StorageLocationId": "",
    "Type": "",
    "WorkCenter": ""
  },
  "Notes": "",
  "Payment": [
    {
      "AssetNum": "",
      "AuthorityNum": "",
      "AuthorizationLimit": 100.0,
      "ContractNum": "",
      "PONum": "",
      "POAmount": "",
      "CoPayAmount": "",
      "ServiceContractId": "",
      "ServiceContractEndDate": "",
      "ServiceContractProvider": ""
    }
  ],
  "Photos": [
    {
      "Date": "",
      "Id": "",
      "Note": "",
      "URL": ""
    }
  ],
  "Priority": "",
  "RejectReasonCode": "",
  "RejectReasons": [{
      "code": "",
      "desc": ""
  }],
  "ServiceProvider": {
      "NetworkProviderType": ""
  },
  "Stage": 0,
  "TimeConstraints": [
    {
      "Range": {
        "Days": "0000000",
        "RangeStartDt": "",
        "RangeEndDt": "",
        "DayStartTm": "",
        "DayEndTm": "",
        "TZ": ""
      },
      "Period": {
        "Start": "",
        "End": ""
      },
      "Desc": "",
      "Type": 1001
    }
  ],
  "Type": "",
  "WorkStatus": 0,
  "WorkSubStatus": 0,
  "WorkType": {
    "Desc": "",
    "Dur": 0,
    "Name": "",
    "ReqSkills": ["",""]
    "ReqSkillSetId": "",
    "Skills": [
      {
        "Comp": "",
        "Id": ""
      }
    ]
  }
}

Work Item Object Properties


PropertyTypeRequired?DescriptionField Mappings
ServiceDispatchServiceMobilityServiceScheduling
AssetsarrayNoAn array of Asset objects, representing properties related to items of physical equipment (i.e. assets) that are associated with the Work Item (e.g. normally, assets located at the location of the Work Item).


AtRiskobjectNoAn At Risk object, representing the "at risk" status of the Work Item.


BookingobjectNoA Booking object, representing details of the Work Item related to when the Work Item was created, when it is scheduled to be carried out, who will be performing the work, etc.


DescstringNo

A short description of the Work Item.

ProbDesc/DescriptionactNotes
FlexViewarrayNoAn array of FlexView objects, representing associated flexible "extra" items of information associated with the Work Item.


FlagsobjectNoA Flags object, representing various boolean flag values of the Work Item.


IdstringNo

The ID of the Work Item.


(mfgId:CallNo -> OrderNum)/OrderNumJobId
LocationobjectNoA Location object, representing the location of the Work Item.


NotesstringNo

Any notes associated with the Work Item.



/Notes[]

moreNotes

(info) The ServiceBroker Work Item Object Notes field is only mapped to the ServiceScheduling moreNotes field when the moreNotes content is plain text. See the FlexView field for when the moreNotes field contains XML.

PaymentarrayNoAn array of Payment objects, representing payment information associated with the Work Item.


PrioritystringNo

A representation of the priority (importance) of the Work Item.

(info) See table below for a definition of possible Priority property values.


/Prioritypriority(0-99)
TimeConstraintsarrayNoAn array of TimeConstraint objects, representing any constraints relating to when the Work Item can be performed.


TypestringNoThe Work Item's type of work (i.e. Job, Break or Activity).


WorkStatusintegerNo

A code representing the status of the Work Item.

(info) See table below for a definition of possible WorkStatus property values.

CallStatus/OrderStatusdisStatus
WorkSubStatusintegerNo

An optional, unchecked sub-status code from the relevant sub-system.

CallSubStatus

WorkTypeobjectNoA WorkType object, representing the type of work that the Work Item relates to in more detail than the Type field.


Priority Property Values

ValueDescriptionServiceMobilityServiceScheduling
0Low10010-9
1Low100110-19
2Low100120-29
3Medium100230-39
4Medium100240-49
5Medium100250-59
6Medium100260-69
7High100370-79
8High100380-89
9High100390-99

WorkStatus Property Values

ValueDescriptionServiceDispatchServiceMobilityServiceSchedulingNotes
0Eamarked/PendingOPEN1EarmarkedThe Work Item is in a pending status awaiting the Worker to either accept or reject it.
10Contacted/Acknowledged/AcceptedACCEPTED
ContactedThe Work Item has been accepted by the Worker.
20En Route
6TravellingThe Worker is en route (traveling) to the customer location.
30Travel Complete
8
The Worker has completed travel to the location although they may not yet be onsite. This can happen when the Worker has to park some distance away from the actual service location.
40Onsite
7LoggedOnThe Worker has arrived onsite at the customer location.
50Offsite


The Worker has left the site of the customer location.
60Closed CompleteCOMPLETED4096ClearedThe Worker has completed the Work Item and marked it as completed.
70Closed Incomplete
4097LoggedOffThe Worker has marked the Work Item as closed but incomplete.
80RejectedREJECTED1001
The Worker has rejected the Work Item.
100ClaimedCLAIMED

The Work Item is in claimed status.
-1CancelledCANCELLED


-9Tentative

Tentative (0)(warning) Tentative/Fixed are not mapped.
  • No labels