Skip to content

Get all product service orders

POST
/api/connector/v1/productServiceOrders/getAll

Returns all product service orders orders associated with the given enterprise. This operation uses Pagination and supports Portfolio Access Tokens..

ProductServiceOrderFilterParameters
object
ClientToken
required

Token identifying the client application.

string
>= 1 characters
AccessToken
required

Access token of the client application.

string
>= 1 characters
Client
required

Name and version of the client application.

string
>= 1 characters
Limitation
required

Limitation on the quantity of data returned and optional Cursor for the starting point of data.

object
Count
required
integer format: int32
Cursor
string format: uuid
nullable
EnterpriseIds

Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token.

Array<string>
nullable >= 1 items <= 1000 items
ProductServiceOrderIds

Unique identifiers of the Product service order.

Array<string>
nullable >= 1 items <= 1000 items
ServiceIds
required

Unique identifiers of the Services.

Array<string>
>= 1 items <= 1000 items
AccountIds
Array<string>
nullable >= 1 items <= 1000 items
LinkedReservationIds
Array<string>
nullable >= 1 items <= 1000 items
UpdatedUtc
TimeFilterInterval
object
StartUtc
string format: date-time
nullable
EndUtc
string format: date-time
nullable
States

A list of product service order states to filter by.

Array<string>
nullable
Allowed values: Inquired Confirmed Started Processed Canceled Optional Requested
Example
{
"ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
"AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
"Client": "Sample Client 1.0.0",
"ProductServiceOrderIds": [
"9b59b50d-bd32-4ce5-add8-09ea0e1300e7"
],
"ServiceIds": [
"ae8da28c-e8a4-4141-9df0-8c998976c691",
"6b02d015-47ac-4c41-8e9f-5b4db61d4284"
],
"UpdatedUtc": {
"StartUtc": "2023-04-01T00:00:00Z",
"EndUtc": "2023-05-05T00:00:00Z"
},
"Limitation": {
"Cursor": "819e3435-7d5e-441f-bc68-76d89c69b8f5",
"Count": 10
}
}

OK

ProductServiceOrderResult
object
ProductServiceOrders
required

The product service order of the enterprise.

Array<object>
ServiceOrder
object
Id
required
string format: uuid
ServiceId
required

Unique identifier of the Service that service order is made against.

string format: uuid
AccountId
required
string format: uuid
AccountType
Any of:
Account type
string
Allowed values: Company Customer
CreatorProfileId
required
string format: uuid
UpdaterProfileId
required
string format: uuid
BookerId
string format: uuid
nullable
Number
string
nullable
State
required
Service order state
string
Allowed values: Inquired Confirmed Started Processed Canceled Optional Requested
Origin
required
Service order origin
string
Allowed values: Distributor ChannelManager Commander Import Connector Navigator
CommanderOrigin
Any of:
Commander origin
string
Allowed values: InPerson Channel Phone Email Website Message CallCenter
OriginDetails
string
nullable
CreatedUtc
required
string format: date-time
>= 1 characters
UpdatedUtc
required
string format: date-time
>= 1 characters
CancelledUtc
string format: date-time
nullable
VoucherId
string format: uuid
nullable
BusinessSegmentId
string format: uuid
nullable
LinkedReservationId
string format: uuid
nullable
Options
required
Service Order Options
object
OwnerCheckedIn
required

Owner of the reservation checked in.

boolean
AllCompanionsCheckedIn
required

All companions of the reservation checked in.

boolean
AnyCompanionCheckedIn
required

Any of the companions of the reservation checked in.

boolean
ConnectorCheckIn
required

Check in was done via Connector API.

boolean
Cursor

Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.

string format: uuid
nullable
Example
{
"ProductServiceOrders": [
{
"Id": "9b59b50d-bd32-4ce5-add8-09ea0e1300e7",
"ServiceId": "ae8da28c-e8a4-4141-9df0-8c998976c691",
"AccountId": "94843f6f-3be3-481b-a1c7-06458774c3df",
"AccountType": "Customer",
"CreatorProfileId": "3cd637ef-4728-47f9-8fb1-afb900c9cdcf",
"UpdaterProfileId": "3cd637ef-4728-47f9-8fb1-afb900c9cdcf",
"BookerId": "ebd507c5-6bfd-4ca9-96aa-ffed6fa94f72",
"Number": "52",
"State": "Confirmed",
"Origin": "Connector",
"CommanderOrigin": null,
"OriginDetails": null,
"CreatedUtc": "2023-04-23T14:58:02Z",
"UpdatedUtc": "2023-04-23T14:58:02Z",
"CancelledUtc": null,
"VoucherId": null,
"BusinessSegmentId": null,
"Options": {
"OwnerCheckedIn": true,
"AllCompanionsCheckedIn": true,
"AnyCompanionCheckedIn": true,
"ConnectorCheckIn": true
}
}
],
"Cursor": "9b59b50d-bd32-4ce5-add8-09ea0e1300e7"
}

Server has successfully fulfilled the request and there is no additional information to send back.

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see Request timeouts

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Error caused by too many requests sent in a given amount of time. Response contains Retry-After header indicating how long the user agent should wait before making a follow-up request. For more information, see Request limits.

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable

Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our documentation repository.

ConnectorApiExceptionResult
object
Message
string
nullable
RequestId
string
nullable
Details
nullable