Authorising TaxCalc to Connect to SmartVault

What are APIs?

A method of obtaining information called Application Program Interfaces or “API”. This will allow you to obtain client information from Document Manager providers and use it within TaxCalc.

Prerequisites for using the API

How to Authorise

  1. Go to Admin Centre > Users.
  2. Select Edit User for the user that is going to authorise.
  3. Go to the Document Manager Details page.
  4. Enter the email address for the SmartVault account of the selected user.
  5. Select Authorise.
  6. The Authorise TaxCalc to Connect to SmartVault dialog is displayed.
  7. Select Authorise.

  1. In the new authorisation window, enter your SmartVault credentials.

  1. You will then be prompted for a verification code, this code will be sent to the email address provided.
  2. Retrieve the verification code from your email and enter the code in the authorisation window.
  3. If successful, you will be taken to the SmartVault web portal.
  4. Select Allow.

  1. Close the Authorisation window.

You have now successfully authorised the use of the SmartVault API within TaxCalc and can now utilise the integrated Document Manager functionality.

Other areas of the application you will be prompted to authorise

Work Modules

When selecting the Send to Document Manager option within any TaxCalc work module, if the current client has not already been enabled for Document Manager then you will be presented with the option to enable the current client.

Selecting Yes will then check to see if you are authorised, if you are not authorised then the following message will be displayed:

Selecting Authorise will take you to the user record where you can authorise the use of the API.

If the only option is “I Understand” then the current user does not have the correct permissions to edit user records within TaxCalc and an Admin user will need to authorise.

Client Record

  1. Launch Practice Manager.
  2. Select a client in the table.
  3. Select Edit Client.
  4. Go to Document Manager from the left-hand menu.
  5. Select Enable client for document manager.
  6. If you are not already authorised, you will receive the following message.
  7. Select Authorise to be taken to the Document Manager Details page in the user record.

  1. If the only option is I Understand then the current user does not have the correct permissions to edit user records within TaxCalc and an Admin user will need to authorise.


Article ID: 3107
Last updated: 04 Apr, 2023
Revision: 3
Document Manager -> Authorising TaxCalc to Connect to SmartVault
https://kb.taxcalc.com/index.php?View=entry&EntryID=3107