Retrieve configured vendor record
get
/spms/v2/ships/{shipId}/configurations/vendor
This is to retrieve the configured vendor.
Request
Supported Media Types
- application/json
Path Parameters
-
shipId(required): number
Ship Id
Query Parameters
-
companyName: string
Vendor company name
-
firstName: string
firstName of vendor
-
id: number
Vendor ID
-
isActive: boolean
This is to indicate switch to active / In-active vendor * `true` - active vendor * `false` - Inactive vendor
-
lastName: string
lastname of vendor
-
limit: integer(int32)
Minimum Value:
1Paging limit -
offset: integer(int32)
Minimum Value:
0Paging offset -
orderBy: string
order by id, lastname, firstname, companyName, vendorType, isActive with format column1:asc/desc,column2:asc/desc column3:asc/desc
-
vendorType: string
Vendor Type (E - Vendors for OHC Excursions, C - Manning Agents for OHC Crew)
Response
Supported Media Types
- application/json
200 Response
Ok
Root Schema : Vendor success Oracle Responses list
Type:
objectTitle:
Vendor success Oracle Responses listThe wrapper object when returning successful values in Oracle standard
Show Source
-
count:
number
The total number of items in the list.Example:
2 -
hasMore:
boolean
Flag which indicates whether or not there are more items.Example:
false -
items:
array items
-
limit:
number
Paging limitExample:
5 -
offset:
number
Paging offsetExample:
10
Nested Schema : items
Type:
Show Source
array-
Array of:
object configurationVendor
configurationVendor
Example:
[
{
"id":"281",
"lastName":"watt",
"firstName":"Elma",
"salutation":"Miss",
"companyName":null,
"contactDetails":{
"address":"Firestone Boulevard, La Mirada",
"street":"Street number 13",
"zipCode":"123456",
"state":"Victoria",
"city":"Melbourne",
"country":{
"code":"AUS",
"description":"Australia"
},
"comment":"Shore Excursion sold on board.",
"vendorType":"E",
"currency":{
"code":"9503",
"description":"Australian DOLLAR",
"paymentType":"CF",
"exchangeRate":"1.24"
}
},
"isActive":true
},
{
"id":"308",
"lastName":null,
"firstName":"Carlos",
"salutation":null,
"companyName":"Blue Line Tours",
"contactDetails":{
"address":"Suite no 12, Knowledge city",
"street":"Street number 14",
"zipCode":"563124",
"state":"Berlin",
"city":"Berlin",
"country":{
"code":"DE",
"description":"Germany"
},
"comment":"Blue Line Tours does not have any branch",
"vendorType":"C",
"currency":{
"code":"9520",
"description":"EURO",
"paymentType":"CF",
"exchangeRate":"0.8302"
}
},
"isActive":true
}
]Nested Schema : configurationVendor
Type:
objectconfigurationVendor
Show Source
-
comment:
string
Minimum Length:
1Maximum Length:200Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$"Vendor comment" * `null` if emptyExample:Vendor comments 1 -
companyName:
string
Minimum Length:
1Maximum Length:30Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor company name" * `null` if emptyExample:Antigua Vacation -
contactDetails:
object contactDetails
Vendor contact details
-
currency:
object currency
vendor currency details
-
firstName:
string
Minimum Length:
1Maximum Length:40Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor firstName" * `null` if emptyExample:Elma -
Id:
number
Minimum Value:
1Pattern:^[0-9]*$"Vendor ID"Example:12345678 -
isActive:
boolean
Activation status of the sub department: * `true` - Sub Department is active * `false` - Sub Department is inactiveExample:
true -
lastName:
string
Minimum Length:
1Maximum Length:40Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor lastName" * `null` if emptyExample:Pigott -
salutation:
string
Minimum Length:
1Maximum Length:20Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor salutation" * `null` if emptyExample:Mr -
vendorType:
string
Minimum Length:
1Maximum Length:1Pattern:^[E|C|e|c]$"Vendor type" * `null` if emptyExample:E
Nested Schema : contactDetails
Type:
objectVendor contact details
Show Source
-
address:
string
Minimum Length:
1Maximum Length:30Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$"Vendor address" * `null` if emptyExample:Vendor address 2 -
city:
string
Minimum Length:
1Maximum Length:30Pattern:^[ A-Za-z0-9,'_@./#&+-]*$"Vendor city" * `null` if emptyExample:Melbourne -
country:
object country
Country
-
email:
string
Minimum Length:
1Maximum Length:49Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$"Vendor Email address" * `null` if emptyExample:abc@myemail.com -
faxNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[0-9+-]*$"Vendor Fax number" * `null` if emptyExample:4413563590 -
phoneNumber:
string
Minimum Length:
1Maximum Length:20Pattern:^[0-9+-]*$"Vendor Phone number" * `null` if emptyExample:4413563590 -
state:
string
Minimum Length:
1Maximum Length:10Pattern:^[ A-Za-z0-9,'_@./#&+-]*$"Vendor state" * `null` if emptyExample:Victoria -
street:
string
Minimum Length:
1Maximum Length:30Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$"Vendor street" * `null` if emptyExample:Vendor street -
zipCode:
string
Minimum Length:
1Maximum Length:10Pattern:^[ A-Za-z0-9,'_@./#&+-]*$"Vendor zip code" * `null` if emptyExample:Vendor zip code
Nested Schema : currency
Type:
objectvendor currency details
Show Source
-
exchangeRate:
number
Vendor currency exchangeRateExample:
1.2753 -
paymentType:
string
Minimum Length:
2Maximum Length:2Pattern:^[a-zA-Z]+$"Payment type" * `null` if emptyExample:CF -
subDepartmentCode:
string
Minimum Length:
1Maximum Length:10Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor currency department code" * `null` if emptyExample:9520 -
subDepartmentDescription:
string
Minimum Length:
1Maximum Length:50Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor currency department description" * `null` if emptyExample:AUSTRALIAN DOLLAR
Nested Schema : country
Type:
objectCountry
Show Source
-
code:
string
Minimum Length:
1Maximum Length:6Pattern:^[ A-Za-z0-9,'_@./#&+-]*$"Vendor country code"Example:MY -
description:
string
Pattern:
^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$"Vendor country description"Example:Malaysia
204 Response
No Content
400 Response
Bad Request
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Bad Request",
"detail":"The parameter 'shipId' has incorrect format"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
"title":"Unauthorized",
"detail":"Valid token is required to access this resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
"title":"Forbidden",
"detail":"You are forbidden to use this API"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
404 Response
Not found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"title":"Not Found",
"detail":"Ship Id could not be found"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
"title":"Method Not Supported",
"detail":"HTTP method not supported for this resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
406 Response
Not acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
"title":"Not Acceptable",
"detail":"Request a Mime type that is supported for this Resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
410 Response
Gone
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
"title":"Gone",
"detail":"Requested Resource no longer exists"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
415 Response
Unsupported Media Type
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
"title":"Invalid content",
"detail":"Content type not supported"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
"title":"Internal Server Error",
"detail":"Issue fulfilling request. Please retry or contact support"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
501 Response
Not Implemented
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
"title":"Not implemented",
"detail":"Resource is not implemented in this version of the API"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
"title":"Service Unavailable",
"detail":"Service not available"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source