Tax Filing Service

<back to all web services

SearchProductsAsync

SearchProductsAsync

Represents a service to search for product data in an asynchronous operation.

Requires Authentication
Required role:AdminRequired permission:CanAccess
The following routes are available for this service:
GET/async/products/search
SearchProductsAsync Parameters:
NameParameterData TypeRequiredDescription
ProductIdqueryint?NoThe unique identifier of the account associated with the product.
AccountIdqueryint?NoThe unique identifier of the account associated with the product.
NamequerystringNoThe name of the product.
NameStartsWithquerystringNoSearch by using the name of the product that starts with the specified value.
NameEndsWithquerystringNoSearch by using the name of the product that ends with the specified value.
NameContainsquerystringNoSearch by using the name of the product that contains the specified value.
VersionquerystringNoThe version of the product.
VersionStartsWithquerystringNoSearch by using the version of the product that starts with the specified value.
VersionEndsWithquerystringNoSearch by using the version of the product that ends with the specified value.
VersionContainsquerystringNoSearch by using the version of the product that contains the specified value.
DescriptionquerystringNoThe description of the product.
DescriptionStartsWithquerystringNoSearch by using the description of the product that starts with the specified value.
DescriptionEndsWithquerystringNoSearch by using the description of the product that ends with the specified value.
DescriptionContainsquerystringNoSearch by using the description of the product that contains the specified value.
IncludeOrdersquerybool?NoShould the related orders of the account be included in the retrieved products?
SkipOrdersqueryint?NoSpecifies the number of orders to skip per product. Applicable only when 'IncludeOrders' is true.
TakeOrdersqueryint?NoSpecifies the number of orders to include per product. Applicable only when 'IncludeOrders' is true.
Skipqueryint?NoThe number of query results to skip.
Takequeryint?NoThe number of query results to include.
SearchProductsBase Parameters:
NameParameterData TypeRequiredDescription
ProductIdformint?NoThe unique identifier of the account associated with the product.
AccountIdformint?NoThe unique identifier of the account associated with the product.
NameformstringNoThe name of the product.
NameStartsWithformstringNoSearch by using the name of the product that starts with the specified value.
NameEndsWithformstringNoSearch by using the name of the product that ends with the specified value.
NameContainsformstringNoSearch by using the name of the product that contains the specified value.
VersionformstringNoThe version of the product.
VersionStartsWithformstringNoSearch by using the version of the product that starts with the specified value.
VersionEndsWithformstringNoSearch by using the version of the product that ends with the specified value.
VersionContainsformstringNoSearch by using the version of the product that contains the specified value.
DescriptionformstringNoThe description of the product.
DescriptionStartsWithformstringNoSearch by using the description of the product that starts with the specified value.
DescriptionEndsWithformstringNoSearch by using the description of the product that ends with the specified value.
DescriptionContainsformstringNoSearch by using the description of the product that contains the specified value.
IncludeOrdersformbool?NoShould the related orders of the account be included in the retrieved products?
SkipOrdersformint?NoSpecifies the number of orders to skip per product. Applicable only when 'IncludeOrders' is true.
TakeOrdersformint?NoSpecifies the number of orders to include per product. Applicable only when 'IncludeOrders' is true.
Skipformint?NoThe number of query results to skip.
Takeformint?NoThe number of query results to include.
PaginationBase Parameters:
NameParameterData TypeRequiredDescription
Skipformint?NoThe number of query results to skip.
Takeformint?NoThe number of query results to include.
ProductQueryResponse Parameters:
NameParameterData TypeRequiredDescription
OrdersMapformDictionary<int, List<Order>>YesThe dictionary of orders associated with each found product.
OffsetformintNo
TotalformintNo
ResultsformList<Product>No
MetaformDictionary<string, string>No
ResponseStatusformResponseStatusNo
QueryResponse<T> Parameters:
NameParameterData TypeRequiredDescription
OffsetformintNo
TotalformintNo
ResultsformList<T>No
MetaformDictionary<string, string>No
ResponseStatusformResponseStatusNo
Product Parameters:
NameParameterData TypeRequiredDescription
IdformintYesThe unique identifier of the product.
IndexformintYesThe position of this instance in a collection of 'Product' instances
NameformstringYesThe name of the product.
VersionformstringYesThe version of the product.
DescriptionformstringNoThe version of the product.
TagsformList<string>YesTags associated with the product.

To override the Content-type in your clients, use the HTTP Accept Header, append the .x-msgpack suffix or ?format=x-msgpack

HTTP + X-MSGPACK

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /async/products/search HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/x-msgpack
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
Content-Length: length

{"ordersMap":{"0":[{"id":0,"productId":0,"accountId":0,"name":"String","serviceName":"String","requestTimestamp":"\/Date(-62135596800000-0000)\/","responseTimestamp":"\/Date(-62135596800000-0000)\/","requestUri":"String","requestHttpMethod":"String","requestDuration":"PT0S","responseStatusCode":"Continue","clientIPAddress":"String","unitOfMeasurement":"String","processType":"String","dataType":"String","dataName":"String","creationDate":"\/Date(-62135596800000-0000)\/","expiryDate":"\/Date(-62135596800000-0000)\/","isTest":false}]},"offset":0,"total":0,"results":[{"id":0,"index":0,"name":"String","version":"String","description":"String","tags":["String"]}],"meta":{"String":"String"},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}