getVmrsCodes

Overview

Get a list of VMRS codes.

This method requires the VmrsCodes:Get permission to be associated with your role.

It performs the same function as the corresponding action in the Approvals screen.

Permissions

The permission for this API is stored in [gb_api_permissions]permission as 'VmrsCodes:Get'.

Only roles with a stored link to this permission in [gb_role_api_permissions] can run this api.

HTTP Method

Use the HTTP Method 'GET' for consuming this web service.

URL Examples

https://api.demo.catch-e.com/fm/vmrs-codes

https://api.{{environment}}.catch-e.com/fm/vmrs-codes

https://api.test.catch-e.com/fm/vmrs-codes

Input Fields (Query)

Key	Format	Notes	Mandatory	Default
posting_map_id	string	Posting Map Id	No
posting_class_id	string	Posting Class Id	No
work_code_id	string	Work Code Id	No
cause_code_id	string	Work Code Id	No
vmrs_code	string	Optional VMRS Code	No
page	integer	Optional page number	No	1
page_size	integer	Optional page size	No	25

Response Details

Success

200 - Success

{  "_links": {  "self": {  "href": "https://api.catch-e.loc/fm/vmrs-codes"  }  },  "_embedded": {  "fm_vmrs_codes": [  {  "vmrs_code_id": "string",  "vmrs_code": "string",  "posting_class_id": "string",  "work_code_id": "string",  "cause_code_id": "string",  "approval_job_type_id": "string",  "approval_item_job_type_id": "string",  "type": "P",  "pricing_type": "retail-labour",  "compliant_code_flag": "yes",  "scheduled_service_flag": "yes",  "external_role_access_flag": "yes",  "description": "string",  "invoice_type": "maintenance",  "quantity": 0,  "unit_cost": 0,  "odometer": 0,  "capped_price_service_flag": "yes",  "action_code": "tyre_count",  "external_code": "string"  }  ]  },  "page_count": 1,  "page_size": 25,  "total_items": 1,  "page": 1 }

Error Response Details

Validation Message	Comments
401 Unauthorized	1. You have not authenticated before running this API or 2. The token_timeout of the current session has passed. You need to authenticate again.

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Unauthorized",  "status": 401,  "detail": "Unauthorized" }

Validation Message	Comments
403 Forbidden	- You do not have permissions for this request. - Go to System Roles and enter 'web_services' - Navigate to the Roles / APIs tab to make sure the permission you need to run this API is checked.

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Forbidden",  "status": 403,  "detail": "Forbidden" }

Validation Message	Validation Comments
404 - Not Found

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Not Found",  "status": 404,  "detail": "Not Found" }

Validation Message	Comments
406 - Not Acceptable

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Not Acceptable",  "status": 406,  "detail": "Not Acceptable" }

Validation Message	Comments
409 - Conflict

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Conflict",  "status": 409,  "detail": "Conflict" }

Validation Message	Comments
422 - Unprocessible Entity	- Data being passed in the described field is invalid, the format is invalid or it is missing

{  "warning_messages": {  "fieldName": {  "warningExceptionCode": "A textual description of the warning exception"  }  },  "validation_messages": {  "fieldName": {  "validationExceptionCode": "A textual description of the validation exception"  }  },  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Unprocessable Entity",  "status": 422,  "detail": "Failed Validation" }

Validation Message	Comments
500 - Internal Error

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "string",  "status": 599,  "detail": "string" }

Validation Message	Comments
default - Unexpected Error

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "string",  "status": 599,  "detail": "string" }