Activate UltraTax CS (Virtual Office CS or SaaS) 2024 and Prior

Tax File Activation Web lets your firm integrate SurePrep with your tax software, giving SurePrep the ability to communicate information with your tax software.
Tax Software
Description
UltraTax CS (Virtual Office CS or SaaS)
Authenticating the tax software lets you integrate SurePrep services with your tax software. After the integration is complete, you will be able to create binders in FileRoom, Create Custom DRLs (Document Request List) in TaxCaddy, and fetch deliverables in Reviewer Dashboard (for example, tax returns, tax payments, and e-file authorizations).
UltraTax CS (Local)
You'll need to set up SurePrep integration using a different method (that is, Tax File Activation window).
After integrating UltraTax CS with SurePrep, set up a web authentication token to fetch deliverables like tax returns, tax payments, and e-file authorizations in the Reviewer Dashboard. Follow the instructions in this article to complete the setup.
note
Starting from the 2022 tax year, the integration process in this article is
mandatory
for all firms using UltraTax CS (Virtual Office or SaaS). If you plan to Create Custom DRL or binders for the 2021 tax year, then don’t remove the previous UltraTax CS Virtual Office integration method with SurePrep. There is no change for firms that are only using the SurePrep Outsource service. Firms can continue using the existing integration method.

Activate UltraTax CS

Follow these steps to complete a one-time setup of the UltraTax CS integration with SurePrep:
1. Get API credentials from UltraTax CS
2. Enter API credentials into SurePrep
note
For UltraTax CS (Virtual Office or SaaS), these steps are necessary to create binders, custom DRL, and fetch deliverables. However, for UltraTax CS local install, complete these steps if you need to fetch deliverables from the tax software.
Get API credentials from UltraTax CS (Virtual Office CS or SaaS)
  1. Log in to your UltraTax CS (Virtual Office CS).
  2. Go to
    Setup
    ,
    System Configuration
    , then
    CS Connect
    tab.
    Select the CS Connect tab.
  3. Select the
    Enable CS Connect Background Services
    checkbox if it is not already enabled. Next, select
    Any computer on this network
    .
    Select the "Enable CS Connect Background Services" checkbox.
  4. Select the
    SurePrep API
    tab, select the
    Enable SurePrep Integration
    checkbox if it is not already enabled, then select
    Generate API Key
    .
    Select SurePrep API, then Enabled SurePrep Integration, then Generate API Key.
  5. Select
    Add
    to create a new API key for your firm. Once the API key is created, select
    Copy
    to copy the API key to your clipboard. You will need to paste this API key into SurePrep's
    Account Admin
    .
    Select Add, then Copy.
2. Enter API credentials into SurePrep
  1. Log into SurePrep FileRoom, then go to
    Admin > ACCOUNT SETUP > Tax File Activation Web
    .
    Select Admin, ACCOUNT SETUP, then Tax File Activation Web.
  2. Select
    UltraTax CS
    , then select
    API Authentication
    to expand the section.
    Select UltraTax CS, then API Authentication.
  3. Enter your UltraTax Firm ID in the
    UltraTax CS Firm ID
     field.
    note
    Locate your UltraTax CS Firm ID in
    Help > About UltraTax CS
    . Your Firm ID is located on the upper left corner (without the parentheses).Firm ID.
  4. Enter the
    API Key
    you copied earlier from UltraTax CS (press
    Ctrl + V
    ), then select
    Generate
    .
    Provide Firm ID and Key, then select Generate.
  5. Scroll down and select
    Alias Configuration
    to expand the section if it is not already expanded. You will now see your <default>
    ALIAS
     path appear automatically.
    Select Alias Configuration to see your ALIAS.
  6. If your firm has multiple
    ALIAS
    paths in UltraTax CS (Virtual Office or SaaS) then you can add additional paths if needed. In UltraTax CS, go to
    Setup > System Configurations > Data Locations
    (tab), and note down all the aliases for different office locations.
    List of Aliases in Data Locations.
    Select
    Add New Path
    , then enter the
    ALIAS
    names for each
    Data Location
    paths associated with the Firm ID.
    Select Add New Path then enter the ALIAS.
    note
    Data Location aliases are in UltraTax Virtual Office CS (
    Setup
    ,
    System Configuration
    , then
    Data Locations
    tab). Note that the
    Alias
    for the paths that you want to use with SurePrep integration.
    note
    The
    ALIAS
    (for paths) is case-sensitive, make sure to match the letters as you see them in UltraTax CS.
  7. Your one-time setup is now complete. Use the
    SurePrep Integration
    feature in UltraTax CS (VO/SaaS) to select clients to create binders and add clients in TaxCaddy. UltraTax CS local and VO/SaaS users can fetch tax returns, tax payments, and e-file authorizations directly from the tax software.
note
Some new firm (first year) or firms switching over to UltraTax CS (Virtual Office CS or SaaS) for the first time may not see UltraTax CS (VO/SaaS) appears as an option when selecting their tax software in TaxCaddy or the
Create New Binder
window. If the previous scenario happens, go to
FileRoom
Admin
Account Setup
Tax File Activation
, then
UltraTax CS
(tab), then add a random placeholder path (for example, Z:/). After a placeholder path is saved, you will be able to see
UltraTax (Virtual Office or SaaS)
as an option. Note that the placeholder path won’t be used to import any clients.
Select Add New Path.

Create clients' tax files in tax software- only UltraTax (Virtual Office or SaaS)

Before you create binders or Custom DRLs, you must first create
SurePrep Integration
tax files for all clients in UltraTax CS (VO or SaaS). 
Your clients'
SurePrep Integration
tax files in UltraTax (VO or SaaS) let SurePrep use the data to create binders and Custom DRLs. Client's information is shared with SurePrep without requiring you to upload any tax files.
Diagram for exporting clients.
You will need to repeat this (SurePrep Integration) action every time:
Add a new client to UltraTax CS (Virtual Office CS or SaaS).
note
You only need to create
SurePrep Integration
tax files for new clients.
Before adding additional documents to binders created without
Leadsheets
.
You only need to redo SurePrep integration for clients (in UltraTax Virtual Office CS) if you want to add additional documents to the client's (without
Leadsheet
) binder in FileRoom. Repeating
SurePrep Integration
ensures that the most current information is used to process additional documents.
note
For without
Leadsheet
binders, you only need to do
SurePrep Integration
for clients whose binders you will be adding additional documents to.
Follow these steps to create clients' SurePrep Integration tax files in UltraTax CS (Virtual Office CS or SaaS):
  1. Open UltraTax CS (Virtual Office CS or SaaS).
  2. Go to
    Utilities
    , then
    SurePrep
    , then
    Integration
    .
    Select Utilities, SurePrep, then Integration.
  3. Select the clients on the left panel, then select
    Select
    to select the highlighted clients. You can also select
    Select All
    to bulk select all available clients. Select the checkbox for
    Send client data to SurePrep Binder and Document Request List
    . Next, select
    Continue
    to begin creating
    SurePrep Integration
    tax files.
    SurePrep Integration window.
    note
    You can also use
    SurePrep Integration
    to create TaxCaddy clients directly from UltraTax (Local and VO/SaaS).
    note
    Clients in Red
    : Clients that are missing the required information will be highlighted in red (for example, Name, SSN). To create tax files for these clients, open the client’s tax return and update any missing information.
    Clients in red.
    • Clients not appearing
      : Clients that are currently locked in UltraTax CS Virtual Office won’t appear in the
      SurePrep Integration
      window. To unlock your client go to
      Lock > Repair > File Locks
      (tab)
      .
Additional Notes
  • For binders without
    Leadsheets
    ,
    SurePrep Integration
    has to be repeated each time (in UltraTax VO/SaaS) before adding additional documents to SPbinder. On the
    SurePrep Integration
    window, you only need to select clients whose binder you want to add additional documents to. Repeating
    SurePrep Integration
    ensures that the most current information is used to process additional documents.
  • On the
    SurePrep Integration
    window, you only need to select new clients. 
  • The system generates a new token automatically before the current one expires.

What's next?

You can now:
  1. Create Binders (UltraTax CS Virtual Office or SaaS)
  2. Add a new client in TaxCaddy (UltraTax CS Virtual Office or SaaS)
  3. Create DRL in TaxCaddy (UltraTax CS Virtual Office or SaaS)
  4. Fetch deliverables in Reviewer Dashboard (UltraTax CS local and VO/SaaS)
Create Binders (UltraTax CS Virtual Office or SaaS)
After preparing your clients in UltraTax (via
SurePrep Integration
), you can create binders in FileRoom. On the
Create New Binder
window, enter the tax
Client ID
then select
Search
to import the client's tax return information into a binder.
UltraTax Virtual Office in FileRoom.
Provide a Client ID, then select Search.
Add a new client in TaxCaddy (UltraTax CS Virtual Office or SaaS)
After activating UltraTax CS (VO/SaaS), you can add a new client in TaxCaddy and select UltraTax CS (VO/SaaS) as the tax software.
Create DRL in TaxCaddy (UltraTax CS Virtual Office or SaaS)
After preparing your clients in UltraTax (via
SurePrep Integration
), you can create custom DRL.
Fetch deliverables in Reviewer Dashboard (UltraTax CS local and VO/SaaS)
After you've completed UltraTax CS integration with SurePrep, you can also follow the instructions in this article to set up web authentication token that will give you the ability to fetch deliverables in Reviewer Dashboard (for example, tax returns, tax payments, and e-file authorizations).

Video demo

Complete setting up UltraTax CS (Local and VO/SaaS) API with SurePrep before you can:
  • Create binders, DRL - UltraTax CS (Virtual Office or SaaS)
  • Fetch what you need from the tax software - UltraTax CS (Local and VO/SaaS)
Watch SurePrep and UltraTax CS integration setup
: https://youtu.be/kqH21LG2Slg
Use the
SurePrep Integration
feature to integrate UltraTax (VO/SaaS) clients with SurePrep:

Related Content

error-icon

Triva isn't available right now.

Check out the support page for our phone number and hours

error-close