Tax Filing Service
| Required role: | AllowAnyUser | Required permission: | CanAccess |
| GET | /async/orders/search |
|---|
"use strict";
export class PaginationBase {
/** @param {{skip?:number,take?:number}} [init] */
constructor(init) { Object.assign(this, init) }
/**
* @type {?number}
* @description The number of query results to skip. */
skip;
/**
* @type {?number}
* @description The number of query results to include. */
take;
}
/** @typedef {'Today'|'Yesterday'|'LastWeek'|'Last30Days'|'Last90Days'|'Last180Days'} */
export var PeriodMode;
(function (PeriodMode) {
PeriodMode["Today"] = "Today"
PeriodMode["Yesterday"] = "Yesterday"
PeriodMode["LastWeek"] = "LastWeek"
PeriodMode["Last30Days"] = "Last30Days"
PeriodMode["Last90Days"] = "Last90Days"
PeriodMode["Last180Days"] = "Last180Days"
})(PeriodMode || (PeriodMode = {}));
export class SearchOrdersBase extends PaginationBase {
/** @param {{userName?:string,name?:string,nameStartsWith?:string,nameEndsWith?:string,nameContains?:string,serviceName?:string,serviceNameStartsWith?:string,serviceNameEndsWith?:string,serviceNameContains?:string,before?:string,after?:string,periodStartDate?:string,periodEndDate?:string,periodMode?:PeriodMode,orderRequestSucceeded?:boolean,unitOfMeasurement?:string,unitOfMeasurementStartsWith?:string,unitOfMeasurementEndsWith?:string,unitOfMeasurementContains?:string,processType?:string,processTypeStartsWith?:string,processTypeEndsWith?:string,processTypeContains?:string,dataType?:string,dataTypeStartsWith?:string,dataTypeEndsWith?:string,dataTypeContains?:string,dataName?:string,dataNameStartsWith?:string,dataNameEndsWith?:string,dataNameContains?:string,skip?:number,take?:number,skip?:number,take?:number}} [init] */
constructor(init) { super(init); Object.assign(this, init) }
/**
* @type {?string}
* @description The user name of the account. */
userName;
/**
* @type {?string}
* @description The name of the order. */
name;
/**
* @type {?string}
* @description Search by using the name of the order that starts with the specified value. */
nameStartsWith;
/**
* @type {?string}
* @description Search by using the name of the order that ends with the specified value. */
nameEndsWith;
/**
* @type {?string}
* @description Search by using the name of the order that contains the specified value. */
nameContains;
/**
* @type {?string}
* @description Search by using the name of the order that contains the specified value. */
serviceName;
/**
* @type {?string}
* @description Search by using the service name of the order that starts with the specified value. */
serviceNameStartsWith;
/**
* @type {?string}
* @description Search by using the service name of the order that ends with the specified value. */
serviceNameEndsWith;
/**
* @type {?string}
* @description Search by using the service name of the order that contains the specified value. */
serviceNameContains;
/**
* @type {?string}
* @description Search for orders placed before a certain date and time. The specified date is included in the search. */
before;
/**
* @type {?string}
* @description Search for orders placed after a certain date and time. The specified date is included in the search. */
after;
/**
* @type {?string}
* @description Search for orders placed within a date and time period. The specified date is the start of the period and it is included in the search. */
periodStartDate;
/**
* @type {?string}
* @description Search for orders placed within a date and time period. The specified date is the start of the period and it is included in the search. */
periodEndDate;
/**
* @type {?PeriodMode}
* @description Search for orders placed within the last 180 days. Today is included in the search. */
periodMode;
/**
* @type {?boolean}
* @description Was the order request successful? */
orderRequestSucceeded;
/**
* @type {?string}
* @description The unit of measurement for the order. */
unitOfMeasurement;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that starts with the specified value. */
unitOfMeasurementStartsWith;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that ends with the specified value. */
unitOfMeasurementEndsWith;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that contains the specified value. */
unitOfMeasurementContains;
/**
* @type {?string}
* @description The type of process, for which the order is charged. */
processType;
/**
* @type {?string}
* @description Search by using the process type of the order that starts with the specified value. */
processTypeStartsWith;
/**
* @type {?string}
* @description Search by using the process type of the order that ends with the specified value. */
processTypeEndsWith;
/**
* @type {?string}
* @description Search by using the process type of the order that contains the specified value. */
processTypeContains;
/**
* @type {?string}
* @description The type of data, for which the order is charged. */
dataType;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that starts with the specified value. */
dataTypeStartsWith;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that ends with the specified value. */
dataTypeEndsWith;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that contains the specified value. */
dataTypeContains;
/**
* @type {?string}
* @description The name of the data, for which the order is charged. */
dataName;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that starts with the specified value. */
dataNameStartsWith;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that ends with the specified value. */
dataNameEndsWith;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that contains the specified value. */
dataNameContains;
/**
* @type {?number}
* @description The number of query results to skip. */
skip;
/**
* @type {?number}
* @description The number of query results to include. */
take;
}
export class Order {
/** @param {{id?:number,productId?:number,accountId?:number,name?:string,serviceName?:string,requestTimestamp?:string,responseTimestamp?:string,requestUri?:string,requestHttpMethod?:string,requestDuration?:string,responseStatusCode?:HttpStatusCode,clientIPAddress?:string,unitOfMeasurement?:string,processType?:string,dataType?:string,dataName?:string,creationDate?:string,expiryDate?:string,isTest?:boolean}} [init] */
constructor(init) { Object.assign(this, init) }
/**
* @type {number}
* @description The unique identifier of the order. */
id;
/**
* @type {number}
* @description The unique identifier of the product, for which the order is made. */
productId;
/**
* @type {number}
* @description The unique identifier of the user account, who placed the order. */
accountId;
/**
* @type {string}
* @description A name to identify the order. */
name;
/**
* @type {?string}
* @description The name of the service, for which the order was made. */
serviceName;
/**
* @type {?string}
* @description The time stamp at which the order was initiated. */
requestTimestamp;
/**
* @type {?string}
* @description The time stamp at which the order was completed. */
responseTimestamp;
/**
* @type {?string}
* @description The URI from which the order was initiated. */
requestUri;
/**
* @type {?string}
* @description The HTTP method of the order request. */
requestHttpMethod;
/**
* @type {?string}
* @description The duration of the order request. */
requestDuration;
/**
* @type {HttpStatusCode}
* @description The HTTP status code of the order request. */
responseStatusCode;
/**
* @type {?string}
* @description The IP address of client, who placed the order. */
clientIPAddress;
/**
* @type {?string}
* @description The unit of measurement for the order. */
unitOfMeasurement;
/**
* @type {?string}
* @description The type of process, for which the order is charged. */
processType;
/**
* @type {?string}
* @description The type of data, for which the order is charged. */
dataType;
/**
* @type {?string}
* @description The name of the data, for which the order is charged. */
dataName;
/**
* @type {string}
* @description The date of creation of the order. */
creationDate;
/**
* @type {?string}
* @description The final date to retain the order in the records. After this date, the order is expunged from the records. */
expiryDate;
/**
* @type {boolean}
* @description Indicates 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. */
isTest;
}
export class OrderQueryResponse extends QueryResponse {
/** @param {{offset?:number,total?:number,results?:Order[],meta?:{ [index: string]: string; },responseStatus?:ResponseStatus,offset?:number,total?:number,results?:T[],meta?:{ [index: string]: string; },responseStatus?:ResponseStatus}} [init] */
constructor(init) { super(init); Object.assign(this, init) }
/** @type {number} */
offset;
/** @type {number} */
total;
/** @type {Order[]} */
results;
/** @type {{ [index: string]: string; }} */
meta;
/** @type {ResponseStatus} */
responseStatus;
}
export class SearchOrdersAsync extends SearchOrdersBase {
/** @param {{userName?:string,name?:string,nameStartsWith?:string,nameEndsWith?:string,nameContains?:string,serviceName?:string,serviceNameStartsWith?:string,serviceNameEndsWith?:string,serviceNameContains?:string,before?:string,after?:string,periodStartDate?:string,periodEndDate?:string,periodMode?:PeriodMode,orderRequestSucceeded?:boolean,unitOfMeasurement?:string,unitOfMeasurementStartsWith?:string,unitOfMeasurementEndsWith?:string,unitOfMeasurementContains?:string,processType?:string,processTypeStartsWith?:string,processTypeEndsWith?:string,processTypeContains?:string,dataType?:string,dataTypeStartsWith?:string,dataTypeEndsWith?:string,dataTypeContains?:string,dataName?:string,dataNameStartsWith?:string,dataNameEndsWith?:string,dataNameContains?:string,skip?:number,take?:number,userName?:string,name?:string,nameStartsWith?:string,nameEndsWith?:string,nameContains?:string,serviceName?:string,serviceNameStartsWith?:string,serviceNameEndsWith?:string,serviceNameContains?:string,before?:string,after?:string,periodStartDate?:string,periodEndDate?:string,periodMode?:PeriodMode,orderRequestSucceeded?:boolean,unitOfMeasurement?:string,unitOfMeasurementStartsWith?:string,unitOfMeasurementEndsWith?:string,unitOfMeasurementContains?:string,processType?:string,processTypeStartsWith?:string,processTypeEndsWith?:string,processTypeContains?:string,dataType?:string,dataTypeStartsWith?:string,dataTypeEndsWith?:string,dataTypeContains?:string,dataName?:string,dataNameStartsWith?:string,dataNameEndsWith?:string,dataNameContains?:string,skip?:number,take?:number,skip?:number,take?:number}} [init] */
constructor(init) { super(init); Object.assign(this, init) }
/**
* @type {?string}
* @description The user name of the account. */
userName;
/**
* @type {?string}
* @description The name of the order. */
name;
/**
* @type {?string}
* @description Search by using the name of the order that starts with the specified value. */
nameStartsWith;
/**
* @type {?string}
* @description Search by using the name of the order that ends with the specified value. */
nameEndsWith;
/**
* @type {?string}
* @description Search by using the name of the order that contains the specified value. */
nameContains;
/**
* @type {?string}
* @description Search by using the name of the order that contains the specified value. */
serviceName;
/**
* @type {?string}
* @description Search by using the service name of the order that starts with the specified value. */
serviceNameStartsWith;
/**
* @type {?string}
* @description Search by using the service name of the order that ends with the specified value. */
serviceNameEndsWith;
/**
* @type {?string}
* @description Search by using the service name of the order that contains the specified value. */
serviceNameContains;
/**
* @type {?string}
* @description Search for orders placed before a certain date and time. The specified date is included in the search. */
before;
/**
* @type {?string}
* @description Search for orders placed after a certain date and time. The specified date is included in the search. */
after;
/**
* @type {?string}
* @description Search for orders placed within a date and time period. The specified date is the start of the period and it is included in the search. */
periodStartDate;
/**
* @type {?string}
* @description Search for orders placed within a date and time period. The specified date is the start of the period and it is included in the search. */
periodEndDate;
/**
* @type {?PeriodMode}
* @description Search for orders placed within the last 180 days. Today is included in the search. */
periodMode;
/**
* @type {?boolean}
* @description Was the order request successful? */
orderRequestSucceeded;
/**
* @type {?string}
* @description The unit of measurement for the order. */
unitOfMeasurement;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that starts with the specified value. */
unitOfMeasurementStartsWith;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that ends with the specified value. */
unitOfMeasurementEndsWith;
/**
* @type {?string}
* @description Search by using the unit of measurement of the order that contains the specified value. */
unitOfMeasurementContains;
/**
* @type {?string}
* @description The type of process, for which the order is charged. */
processType;
/**
* @type {?string}
* @description Search by using the process type of the order that starts with the specified value. */
processTypeStartsWith;
/**
* @type {?string}
* @description Search by using the process type of the order that ends with the specified value. */
processTypeEndsWith;
/**
* @type {?string}
* @description Search by using the process type of the order that contains the specified value. */
processTypeContains;
/**
* @type {?string}
* @description The type of data, for which the order is charged. */
dataType;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that starts with the specified value. */
dataTypeStartsWith;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that ends with the specified value. */
dataTypeEndsWith;
/**
* @type {?string}
* @description Search by using the type of data, for which the order is charged that contains the specified value. */
dataTypeContains;
/**
* @type {?string}
* @description The name of the data, for which the order is charged. */
dataName;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that starts with the specified value. */
dataNameStartsWith;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that ends with the specified value. */
dataNameEndsWith;
/**
* @type {?string}
* @description Search by using the name of data, for which the order is charged that contains the specified value. */
dataNameContains;
/**
* @type {?number}
* @description The number of query results to skip. */
skip;
/**
* @type {?number}
* @description The number of query results to include. */
take;
}
/** @typedef T {any} */
export class QueryResponse {
/** @param {{offset?:number,total?:number,results?:T[],meta?:{ [index: string]: string; },responseStatus?:ResponseStatus}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {number} */
offset;
/** @type {number} */
total;
/** @type {T[]} */
results;
/** @type {{ [index: string]: string; }} */
meta;
/** @type {ResponseStatus} */
responseStatus;
}
JavaScript SearchOrdersAsync DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /async/orders/search HTTP/1.1 Host: taxfiling.pwc.de Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length
{"offset":0,"total":0,"results":[{"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}],"meta":{"String":"String"},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}