Get job codes
post
/bi/v1/{orgIdentifier}/getJobCodeDimensions
Gets the job codes for a specified location.
Request
Path Parameters
-
orgIdentifier: string
Unique identifier of the organization name
The request body defines the details of the API request.
Root Schema : locRequestPayload
Type:
objectRequest payload with location reference
Show Source
-
applicationName(optional):
string
Title:
Application NameMaximum Length:128The name of the application which is accessing the API.First Available Version: 20.1.10
-
include(optional):
string
Title:
IncludeList of objects to include in response -
locRef:
string
Title:
Location ReferenceThe location reference, this may be a store number or name depending on the organization -
searchCriteria(optional):
string
Title:
Search CriteriaSearch criteria to filter results based on field value
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : jobCodeDimensions
Type:
objectThe response body contains information about the job code dimensions for the specified locatio
Show Source
-
jobCodes:
array Job Codes
Title:
Job CodesAn array of job code dimensions -
locRef:
string
Title:
Location ReferenceMaximum Length:99The location reference, this may be a store number or name depending on the organization
Nested Schema : Job Codes
Type:
arrayTitle:
Job CodesAn array of job code dimensions
Show Source
-
Array of:
object jobCode
The response body contains information about the job code for the specified location.
Nested Schema : jobCode
Type:
objectThe response body contains information about the job code for the specified location.
Show Source
-
lbrCatMstrName(optional):
string
Title:
Labor Category Master NameMaximum Length:99The master labor category name -
lbrCatMstrNum(optional):
integer
Title:
Labor Category Master NumberMaximum Length:16The master labor category number -
lbrCatName:
string
Title:
Labor Category NameMaximum Length:99Labor category name. This attribute will not be returned in the response if value is null -
lbrCatNum:
integer
Title:
Labor Category NumberMaximum Length:16Labor category number. This attribute will not be returned in the response if value is null -
mstrName(optional):
string
Title:
Master NameMaximum Length:99The master job code name -
mstrNum(optional):
integer
Title:
Master NumberMaximum Length:16The master job code number -
name:
string
Title:
NameMaximum Length:99Job code Name -
num:
integer
Title:
NumberMaximum Length:16Job code number
400 Response
Bad Request
Root Schema : exceptionDetailType
Type:
objectError details
Show Source
-
detail(optional):
string
Title:
Error descriptionThe description of the error -
o:errorCode:
integer
Title:
Oracle error codeOracle error code -
status(optional):
integer
Title:
StatusHTTP response code -
title:
string
Title:
TitleHigh level description of the error -
type:
string
Title:
TypeThe description of the type of HTTP error
401 Response
Unauthorized
Root Schema : exceptionDetailType
Type:
objectError details
Show Source
-
detail(optional):
string
Title:
Error descriptionThe description of the error -
o:errorCode:
integer
Title:
Oracle error codeOracle error code -
status(optional):
integer
Title:
StatusHTTP response code -
title:
string
Title:
TitleHigh level description of the error -
type:
string
Title:
TypeThe description of the type of HTTP error
403 Response
Service Unavailable
Root Schema : exceptionDetailType
Type:
objectError details
Show Source
-
detail(optional):
string
Title:
Error descriptionThe description of the error -
o:errorCode:
integer
Title:
Oracle error codeOracle error code -
status(optional):
integer
Title:
StatusHTTP response code -
title:
string
Title:
TitleHigh level description of the error -
type:
string
Title:
TypeThe description of the type of HTTP error
404 Response
Resource Not Found
Root Schema : exceptionDetailType
Type:
objectError details
Show Source
-
detail(optional):
string
Title:
Error descriptionThe description of the error -
o:errorCode:
integer
Title:
Oracle error codeOracle error code -
status(optional):
integer
Title:
StatusHTTP response code -
title:
string
Title:
TitleHigh level description of the error -
type:
string
Title:
TypeThe description of the type of HTTP error
Default Response
Unexpected Error
Root Schema : exceptionDetailType
Type:
objectError details
Show Source
-
detail(optional):
string
Title:
Error descriptionThe description of the error -
o:errorCode:
integer
Title:
Oracle error codeOracle error code -
status(optional):
integer
Title:
StatusHTTP response code -
title:
string
Title:
TitleHigh level description of the error -
type:
string
Title:
TypeThe description of the type of HTTP error
Examples
The following example shows how to get the job code dimensions for a specified location by submitting a POST request on the REST resource using cURL. For more information, see Use cURL
curl -i -X POST -H "Authorization: Bearer" -H "Content-Type:application/json" -d {"locRef":"1234"} https://baseurl/bi/v1/orgidentifier/getJobCodeDimensions
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Date: Tue, 20 Oct 2020 21:24:33 GMT Transfer-Encoding: chunked Content-Type: application/json
Example of Response Body
The following example shows the contents of the response body in JSON format:
{
"locRef": "1234",
"jobCodes":[{
"num": 101,
"name": "Cashier",
"mstrNum": 101,
"mstrName": "Cashier",
"lbrCatNum": 101,
"lbrCatName": "Staff",
"lbrCatMstrNum": 101,
"lbrCatMstrName": "Staff"
}]
}