Skip to main content

Legal

Tax & Accounting

Trade & Supply

Risk & Fraud

News & Media

Books

Developers

SurePrep API - Binder use cases

Automatically link new binders with client profiles in TaxCaddy

Your firm can use the SurePrep API to create binders in FileRoom and automatically link the new binders to client profiles in TaxCaddy. Creating a new binder (via API) and auto-linking it to a TaxCaddy client profile is the same as creating a new binder in TaxCaddy.
Based on your firm level settings, the API can also automatically upload TaxCaddy documents to the newly created/linked binder from the linked client. By using the API, your firm saves time by:
  • Automating the process of creating a binder
  • Automatically linking binders to client profiles
  • Automatically uploading TaxCaddy documents to the binder

Before you begin

Contact SurePrep Support to enable the following features for your firm:
Firm-level Options
Description
Auto-link (API) binder with TaxCaddy client profile
Automatically links the binder with a TaxCaddy client profile with a matching
Tax Client ID
 (for example, Locator No.).
Auto-upload TaxCaddy documents to (API) binder
Automatically uploads TaxCaddy documents to the binder if marked with the
Include in binder
 document flag.

Create a binder with uploaded TaxCaddy documents

Follow these steps to create and link a binder with a client profile and automatically upload all TaxCaddy documents:
  1. (Optional) Go to the client's profile and flag the uploaded documents you want to include or exclude from the binder. By default, all documents uploaded to TaxCaddy are flagged for inclusion in the binder. Skip to the next step if you don't want to exclude any uploaded documents.
    Documents you flag to
    Exclude from binder
     aren't included in the binder.
    Documents you flag as
    Include in binder
     are automatically uploaded to the binder once the binder is submitted.
  2. Next, create a binder using the CreateBinder API method.
    If your firm enabled the option to auto-link binder at the firm level, then the
    LinkBinder
     input parameter is set as
    1
     or
    True
    (for yes) by default, even if you don't add the
    LinkBinder
     input parameter to the
    CreateBinder
     call.
    However, if you want to prevent a binder from being linked to a client profile manually, set the
    LinkBinder
     option as
    0
     or
    False
    .
  3. (Optional) You can use the
    UploadBinderDocuments
         API method to upload non-TaxCaddy documents. This step won't impact on TaxCaddy documents uploaded automatically.
  4. Call the
    SubmitBinder
         method to submit the binder. If the SubmitBinder was successful, you will see the binder ID as a response (for example, 987654)
    You will see the following error if there are no uploaded documents available in the client's profile: 
    {
    ErrorCode
    : 1060,
    ErrorDesc
    : "Please upload at least one source document to submit this binder"}
    Solution: Go to the client's profile and make sure there is at least one uploaded document marked to include in the binder. Alternatively, use the
    UploadBinderDocuments
         method to upload a document to the document.
  5. In the client's profile, documents flagged to include in the binder will now show a new
    Added to binder
     icon.

FAQ

Add additional documents to the binder
You can use the same workflow steps as previously described:
  1. CreateBinder  > SubmitBinder
  2. Make sure to pass the
    LinkBinder
     input parameter (for the
    CreateBinder
     method).
  3. Make sure there's at least 1 uploaded document in the client profile, and it's flagged for inclusion in the binder.
Enable the option to auto-link the binder to (TaxCaddy) client profile without auto-uploading documents
When you contact SurePrep Support, specify that you only want to enable the option to auto-link new binders. However, since TaxCaddy documents are not auto-uploaded, the
UploadBinderDocuments
 method is mandatory before submitting the binder.

Requirements

To create a binder (and automatically link it to a client profile) with uploaded TaxCaddy documents, make sure to meet the following criteria: 
Item
Details
Firm Setting
Contact SurePrep Support to enable the following features for your firm:
  • Auto-link (API) binder with TaxCaddy client profile
  • Auto-upload TaxCaddy documents to (API) binder
TaxCaddy
  • Enable TaxCaddy for your firm
  • Client's Profile has least 1 uploaded document;
  • Mark the document to include in the binder (included by default).
Services
1040SCANverify (Offshore/Onshore)
Leadsheet
None (Without Leadsheets)
Classic
Simplified Leadsheets binders
Binder Type
1040 binder type
Tax Software
CCH Axcess Tax
  • When creating a binder (via API
    CreateBinder
     method    ), an additional
    LinkBinder
     input parameter must be set as
    1
     (for yes).
  • There must be only 1 TaxCaddy client profile with the same Tax Client ID (that is,
    Locator_no
    ).

This article applies to:

  • Product: SurePrep

Related content

Chat now

error-icon

Triva isn't available right now.

Check out the support page for our phone number and hours

error-close