Managing companies

In the Codat Portal, click Companies in the navigation bar to view a list of your created companies. If you have signed up using the free trial, you will see a company has already been created for you using sandbox data.

From here you can:

View existing companies

In the companies view, you can see the following information for every company:

  • Company name
  • Company ID
  • Name of the Portal user that created the company
  • Date and time of the company creation
  • Date and time of the last pull of data
  • Data connections and their statuses

Data connection statuses

  • Green indicates the connection is linked, and data can be refreshed from the connection
  • Red indicates the connection has an error, or has become de-authorized (your customer will need to re-authorize the connection)
  • Purple indicates the connection has been created but has not yet been authorized
  • Grey indicates the connection has been un-linked (your customer will need to re-authorize the connection)

Clicking on a data connection allows you to manage the connection and see any linking errors.

Add a new company

To create a new company, use the New Company button in the top right corner of the Companies view. In the Add new company dialog box, enter your customer's company name, and select Add.

You can rename a company at any time. This doesn't affect the connection. Next to the company name, click on the "pencil" icon and update the name in the text field that appears. Save the changes.

Link a company

To link a company via Portal, follow the instructions here.

You can also learn more about Link.

Queue data sync

You can trigger data synchronization to request data outside of the pre-configured sync setup frequency.

  1. Navigate to Companies and click the company you want to sync.
  2. Click Datasets in the side navigation menu.
  3. Click the Refresh data icon.
  4. To see the synchronization progress, click View datasets. The Data history view displays.
  5. From the Data history view, you can toggle the Poll for updates checkbox to view the progress of the refresh in real time.
  6. Once the refresh has been completed, you can view the latest data.

The configured sync frequency re-commences from the time of the last successful sync.

The Data type settings page in the Codat portal allows users to set a default synchronization frequency for each data type to ensure your customers' data is kept up-to-date. The available options are hourly, daily, weekly, and monthly.

If you require a more specific schedule, you queue data sync using Codat's API.

For more information on configuring your sync settings, please see Data type settings.

๐Ÿ“˜

Token expiry and connection de-authorization

For some accounting platforms, if you donโ€™t synchronize the data of a company for a significant time period (between 60 and 100 days) authorization is revoked. In this case, provide your customer with a new link URL so that they can renew your access to their data.

View company data

Click on a company to access information pertaining to it:

Delete a company

Next to the Link URL button, in the Portal, select the delete icon. Confirm the deletion on the pop-up screen.


Did this page help you?