Client Administration*

Workflows > Endpoints > Client Settings > Client Administration

Purpose: Create new clients and manage users on clients.

* The client administration service, is a collection of endpoints dedicated to accounting offices, and require both an access privelige and a partner client to be used. The endpoints reflects the functionality in the client administration user interface on a partner client, allowing for some operations to be done on clients with relation to the partner client (i.e. clients with the partner code).

These client administration endpoints differ in functionality when compared with other open api endpoints. The partner client api credentials is used in all operations with these endpoints.

Note that several new endpoints are being worked on to supplement the functionality.

Description

Create new client:

Endpoint for creating a new Go client, with the option of inheriting settings from a template client. The endpoint is used with the partner client's credentials, and the new client is created with the partner code of the accounting office.


Synchronize to Go:

  1. Create new client

    • Based on a template client (optional)

    • User admin must be a user on the partner client

  2. When the process is finished, a new client is created with the partner code and partner user as admininistrater, and the client identifier is returned.

  3. Combine with other client administration endpoints or other open endpoints as needed, to finalize the client setup.

Users:

Synchronize from Go

  1. Get the users from the partner client or from a client related to the partner

Access Roles: User Access Roles:

Synchronize from Go

  1. From the partner client, list all the clients a given partner client user have access to, along with the access roles this user have on the clients.

Access Roles: Access Roles

Synchronize from Go

  1. List the access roles defined on the partner client or from a client related to the partner

Prerequisites

  • Access to the ClientAdmin access privelige

  • Can only be used by partner clients and with the partner client credentials.

Related workflows:

Dictionary/Terminology:

  • Partner client: The Go client of an accounting office. Only partner clients have access to client administration

  • Partner code: The code of the partner client. The client administration tool list all the clients that have the partner code set.