Tax Filing Service

<back to all web services

BatchRegisterAccountsAsync

RegisterAccountsBatchAsync

Represents a service request to register one or more accounts in a batch operation.

Requires Authentication
Required role:AdminRequired permissions:CanAccess, CanAdd
The following routes are available for this service:
POST/async/accounts/batch
BatchRegisterAccountsAsync Parameters:
NameParameterData TypeRequiredDescription
AccountsbodyList<Account>YesThe accounts to register and corresponding product subscriptions.
BatchRegisterAccountsBase Parameters:
NameParameterData TypeRequiredDescription
AccountsformList<Account>YesThe accounts to register and corresponding product subscriptions.
Account Parameters:
NameParameterData TypeRequiredDescription
IdformintYesThe unique identifier of the user account.
IndexformintYesThe position of this instance in a collection of 'Account' instances
RefIdformint?YesThe unique identifier of the customer associated with this account.
RefIdStrformstringNoThe string representation of the unique identifier of a reference that associates with this user account. This should have the same value as 'RefId'.
UserNameformstringYesThe unique user name of the user account.
EmailformstringNoThe electronic mail address of the user account.
DisplayNameformstringNoThe friendly name of the user account.
FirstNameformstringNoThe first name of the owner (natural person) of the user account.
LastNameformstringNoThe last name of the owner (natural person) of the user account.
FullNameformstringNoThe unique identifier of the customer associated with this account.
GenderformstringNoThe gender of the owner (natural person) of the user account.
LanguageformstringNoThe language of the owner of teh user account.
CompanyformstringNoThe company, where the user is an employee.
ProfileUrlformstringYesThe profile URL of the user account.
RolesformList<string>YesThe roles assigned to the user account.
PermissionsformList<string>YesThe permissions assigned to the user account.
PrimaryEmailformstringNoThe primary e-mail address of the user.
SaltformstringNoRandom data to enhance the security of the user password.
PasswordHashformstringNoThe hash value of the user password that the PBKDF2 algorithm produces.
DigestHa1HashformstringNoThe hash value of the user password that the DigestHa1 algorithm produces.
InvalidLoginAttemptsformintNoThe number of times the user account tried to sign in but failed.
LastLoginAttemptformDateTime?NoThe last time the user account attempted a sign in.
LockedDateformDateTime?NoThe date and time when the user acount was denied access.
CreatedDateformDateTimeNoThe date and time when the user account was created.
ModifiedDateformDateTimeNoThe date and time when the user account was last modified.
PhoneNumberformstringNoThe telephone number of the owner of the user account.
BirthDateformDateTime?NoThe birth date of the owner of the user account
BirthDateRawformstringNoThe string representation of the birth date of the user account.
AddressformstringNoThe mail address of the user account.
Address2formstringNoAdditional information for the specified 'Address' of the user.
CityformstringNoThe city of the owner of the user account.
StateformstringNoThe state of the owner of the user account.
CountryformstringNoThe country of the owner of the user account. It is recommended to use the name of the associated 'Customer'.
CultureformstringNoThe locale of the user account.
MailAddressformstringNoThe mail address of the user account.
NicknameformstringNoThe nickname of the user of the user account.
PostalCodeformstringNoThe postal code of the user account.
TimeZoneformstringNoThe time zone of the user of the user account.
MetaformDictionary<string, string>NoAdditional information to attach to the user account.

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.

POST /async/accounts/batch HTTP/1.1 
Host: taxfiling.pwc.de 
Accept: application/x-msgpack
Content-Type: application/x-msgpack
Content-Length: length

{"accounts":[{"id":0,"index":0,"refId":0,"refIdStr":"String","userName":"String","email":"String","displayName":"String","firstName":"String","lastName":"String","fullName":"String","gender":"String","language":"String","company":"String","profileUrl":"String","roles":["String"],"permissions":["String"],"primaryEmail":"String","salt":"String","passwordHash":"String","digestHa1Hash":"String","invalidLoginAttempts":0,"lastLoginAttempt":"\/Date(-62135596800000-0000)\/","lockedDate":"\/Date(-62135596800000-0000)\/","createdDate":"\/Date(-62135596800000-0000)\/","modifiedDate":"\/Date(-62135596800000-0000)\/","phoneNumber":"String","birthDate":"\/Date(-62135596800000-0000)\/","birthDateRaw":"String","address":"String","address2":"String","city":"String","state":"String","country":"String","culture":"String","mailAddress":"String","nickname":"String","postalCode":"String","timeZone":"String","meta":{"String":"String"}}]}
HTTP/1.1 200 OK
Content-Type: application/x-msgpack
Content-Length: length

[{"account":{"id":0,"index":0,"refId":0,"refIdStr":"String","userName":"String","email":"String","displayName":"String","firstName":"String","lastName":"String","fullName":"String","gender":"String","language":"String","company":"String","profileUrl":"String","roles":["String"],"permissions":["String"],"primaryEmail":"String","salt":"String","passwordHash":"String","digestHa1Hash":"String","invalidLoginAttempts":0,"lastLoginAttempt":"\/Date(-62135596800000-0000)\/","lockedDate":"\/Date(-62135596800000-0000)\/","createdDate":"\/Date(-62135596800000-0000)\/","modifiedDate":"\/Date(-62135596800000-0000)\/","phoneNumber":"String","birthDate":"\/Date(-62135596800000-0000)\/","birthDateRaw":"String","address":"String","address2":"String","city":"String","state":"String","country":"String","culture":"String","mailAddress":"String","nickname":"String","postalCode":"String","timeZone":"String","meta":{"String":"String"}},"index":0,"products":[{"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"}}}]