Migration methods
Use one of the following migration methods based on whether you access FileCabinet CS locally, via Virtual Office CS, or Software as a Service (SaaS).
Migration from a local installation of FileCabinet CS
Migration from FileCabinet CS in Virtual Office CS or Software as a Service (SaaS)
Note: Issues with the migration may occur during file extraction from FileCabinet CS to the local machine, and/or after the file extraction, when the files are uploaded into Onvio.
We strongly recommend that you begin the migration using a small batch of drawers so that you can experience the migration on a smaller scale and easily identify where potential issues may appear.
Identifying and preventing potential issues before the migration into Onvio
Before migrating documents from UltraTax CS to Onvio, verify that there are no duplicate contacts created in Onvio. In the CS Professional Suite desktop application, clients are identified by the Client ID. There are also Client ID’s in Onvio, but it’s the Contact (or person) that is the most important identifier. Most upload errors are encountered because you can create multiple contacts with the same ID and SSN in Onvio.
Perform the following actions after you’ve completed the migration into Onvio.
- Verify that there are no duplicate contacts. If there are any present, remove those that were not generated in the migration from UltraTax CS.
- Remove contacts that aren’t tied to the contact's records in Onvio (i.e., standalone contacts, manually created outside of the migration process).
Issues during upload
Most upload issues are related to the file size of specific documents. Some documents may be too large to upload, which causes the web service to timeout during the upload process. Documents that are too large can be dragged and dropped or manually printed into Onvio. Files that time out during the upload are listed in the Document Exception Report.
After the initial migration, if multiple documents fail to migrate within a specific drawer, re-run the migration to process the drawer again to determine whether the issue was due to connectivity problems during the first attempt.
Notes
- The migration runs in the background and shouldn’t cause issues when users continue to work in FileCabinet CS or Onvio.
- Drawers are locked in FileCabinet CS during file extraction and the lock is removed when files begin uploading to Onvio.
Example
Rodney Miller is created as the contact with different Client IDs for a 1040 return, two 1065 returns, a single 1120 return, and a 1041 return in UltraTax CS. To successfully migrate these contact records into Onvio, multiple contacts must be removed, and the contact Rodney Miller (Entity Type- Individual and Type- Client) set up in Onvio as follows.
- Primary relationship to the 1040 client.
- The partner relationship to the 1065-1 and 1065-2 clients.
- The Shareholder relationship to the 1120s client.
- The Trustee of relationship to the 1041 client.
Note: The contact Rodney Miller (Entity Type- Individual and Type-Staff) can exist as long as he is not marked as the primary contact for any other Client ID in Onvio.
Error: fcodm-occ-2a
Scenario
You may see this error when there are multiple contacts with the same SSN, or have been set up as the primary of more than one Onvio Client ID.
Solution
Remove duplicate contacts in Onvio and use the remaining contact to link as a relationship with multiple client IDs. You can leave the Staff contact if they are not identified as the primary contact of a Client ID drawer in Onvio. Rerun the migration from FileCabinet CS into Onvio.
Error: fcodm-occ-2b
Scenario
You may see this error when multiple drawers—as listed in this example—have been created with the same SSN.
Solution
Instead of combining the two drawers, change the entity’s drawer to reflect the correct EIN.
After the corrections are made in FileCabinet CS, the extraction and migration can be rerun for those clients.
Was this article helpful?
Thank you for the feedback!