Tax Filing Service

<back to all web services

RetrieveProductAsync

RetrieveProductsAsync

Represents a service request to retrieve a product in an asynchronous operation.

Requires Authentication
Required role:AdminRequired permission:CanAccess
The following routes are available for this service:
GET/async/products/{Id}
RetrieveProductAsync Parameters:
NameParameterData TypeRequiredDescription
IdpathintNoThe unique identifier of the product.
IncludeOrdersquerybool?NoShould the related orders of the account be included in the retrieved product?
SkipOrdersqueryint?NoSpecifies the number of orders to skip. Applicable only when 'IncludeOrders' is true.
TakeOrdersqueryint?NoSpecifies the number of orders to include. Applicable only when 'IncludeOrders' is true.
RetrieveProductBase Parameters:
NameParameterData TypeRequiredDescription
IdformintNoThe unique identifier of the product.
IncludeOrdersformbool?NoShould the related orders of the account be included in the retrieved product?
SkipOrdersformint?NoSpecifies the number of orders to skip. Applicable only when 'IncludeOrders' is true.
TakeOrdersformint?NoSpecifies the number of orders to include. Applicable only when 'IncludeOrders' is true.
ProductResponse Parameters:
NameParameterData TypeRequiredDescription
ProductformProductNoThe product data of the response.
OrdersformList<Order>YesThe list of orders associated with the encapsulated product.
ResponseStatusformResponseStatusNoData structure that holds error information from a service operation.
ServiceResponseBase Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNoData structure that holds error information from a service operation.
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.
Order Parameters:
NameParameterData TypeRequiredDescription
IdformintYesThe unique identifier of the order.
ProductIdformintYesThe unique identifier of the product, for which the order is made.
AccountIdformintYesThe unique identifier of the user account, who placed the order.
NameformstringYesA name to identify the order.
ServiceNameformstringNoThe name of the service, for which the order was made.
RequestTimestampformDateTime?NoThe time stamp at which the order was initiated.
ResponseTimestampformDateTime?NoThe time stamp at which the order was completed.
RequestUriformstringNoThe URI from which the order was initiated.
RequestHttpMethodformstringNoThe HTTP method of the order request.
RequestDurationformTimeSpan?NoThe duration of the order request.
ResponseStatusCodeformHttpStatusCodeNoThe HTTP status code of the order request.
ClientIPAddressformstringNoThe IP address of client, who placed the order.
UnitOfMeasurementformstringNoThe unit of measurement for the order.
ProcessTypeformstringNoThe type of process, for which the order is charged.
DataTypeformstringNoThe type of data, for which the order is charged.
DataNameformstringNoThe name of the data, for which the order is charged.
CreationDateformDateTimeNoThe date of creation of the order.
ExpiryDateformDateTime?NoThe final date to retain the order in the records. After this date, the order is expunged from the records.
IsTestformboolNoIndicates whether the order is simulated for test purposes. True if the order is simulated for test purposes; otherwise it is a false order for production purposes.

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

GET /async/products/{Id} HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"product":{"id":0,"index":0,"name":"String","version":"String","description":"String","tags":["String"]},"orders":[{"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}],"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}