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:
1
Paging limit -
offset: integer(int32)
Minimum Value:
0
Paging 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:
object
Title:
Vendor success Oracle Responses list
The 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:
object
configurationVendor
Show Source
-
comment:
string
Minimum Length:
1
Maximum Length:200
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
"Vendor comment" * `null` if emptyExample:Vendor comments 1
-
companyName:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[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:
1
Maximum Length:40
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
"Vendor firstName" * `null` if emptyExample:Elma
-
Id:
number
Minimum Value:
1
Pattern:^[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:
1
Maximum Length:40
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
"Vendor lastName" * `null` if emptyExample:Pigott
-
salutation:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
"Vendor salutation" * `null` if emptyExample:Mr
-
vendorType:
string
Minimum Length:
1
Maximum Length:1
Pattern:^[E|C|e|c]$
"Vendor type" * `null` if emptyExample:E
Nested Schema : contactDetails
Type:
object
Vendor contact details
Show Source
-
address:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
"Vendor address" * `null` if emptyExample:Vendor address 2
-
city:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
"Vendor city" * `null` if emptyExample:Melbourne
-
country:
object country
Country
-
email:
string
Minimum Length:
1
Maximum Length:49
Pattern:^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*(\.\w{2,3})+$
"Vendor Email address" * `null` if emptyExample:abc@myemail.com
-
faxNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[0-9+-]*$
"Vendor Fax number" * `null` if emptyExample:4413563590
-
phoneNumber:
string
Minimum Length:
1
Maximum Length:20
Pattern:^[0-9+-]*$
"Vendor Phone number" * `null` if emptyExample:4413563590
-
state:
string
Minimum Length:
1
Maximum Length:10
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
"Vendor state" * `null` if emptyExample:Victoria
-
street:
string
Minimum Length:
1
Maximum Length:30
Pattern:^[a-zA-ZÀ-ÖØ-öø-ÿ0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
"Vendor street" * `null` if emptyExample:Vendor street
-
zipCode:
string
Minimum Length:
1
Maximum Length:10
Pattern:^[ A-Za-z0-9,'_@./#&+-]*$
"Vendor zip code" * `null` if emptyExample:Vendor zip code
Nested Schema : currency
Type:
object
vendor currency details
Show Source
-
exchangeRate:
number
Vendor currency exchangeRateExample:
1.2753
-
paymentType:
string
Minimum Length:
2
Maximum Length:2
Pattern:^[a-zA-Z]+$
"Payment type" * `null` if emptyExample:CF
-
subDepartmentCode:
string
Minimum Length:
1
Maximum Length:10
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
"Vendor currency department code" * `null` if emptyExample:9520
-
subDepartmentDescription:
string
Minimum Length:
1
Maximum Length:50
Pattern:^[a-zA-Z0-9 _,\\?/\\.\\-\\\\+\\*\n~!@#$%&{}\\[\\]()=<>\\|\\^\\'\\\":;@`]*$
"Vendor currency department description" * `null` if emptyExample:AUSTRALIAN DOLLAR
Nested Schema : country
Type:
object
Country
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:6
Pattern:^[ 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 Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
404 Response
Not found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
406 Response
Not acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
410 Response
Gone
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
415 Response
Unsupported Media Type
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
501 Response
Not Implemented
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error Response
Error 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:
object
Title:
Error Response
Error Response returned when encountered error
Show Source