Learn about the different statuses and definitions of Truv Tasks.
When a user first connects their payroll account through Bridge, a persistent Link to a payroll provider is created. This link can be identified by
link ID or
The access_token is used to do important manipulations with the Link including pulling data (e.g Income and Employment report) and initiating Data Refresh.
Every time a new data pull/push is initiated for a particular
Link, the platform creates a Task to perform the requested action on the payroll provider side.
Each Task has a specific set of possible statuses during processing, which usually appear sequentially:
new -> login -> mfa -> base_parse -> full_parse -> done. A full description of each status is below.
|new||The Task has just been created.|
|login||Attempting to log into the payroll provider.|
|mfa||Attempting to complete multi-factor authentication.|
|parse||Attempting to parse payroll data.|
|full_parse||Initial parse is done. Parsing of slow objects is in progress.|
|switch_deposit||Direct deposit switching started.|
|done||Task is complete.|
Task Error Statuses
In some cases, the Task cannot be completed successfully and will fall into one of the following terminal error states.
|login_error||There was an error logging in.|
|mfa_error||There was an error completing the authentication.|
|config_error||A configuration issue needs to be resolved by the user or developer before we can complete the payroll connection.|
|account_locked||The payroll account is locked.|
|unable_to_reset||There was an error completing credentials reset.|
|no_data||No data available from the payroll provider.|
|unavailable||The payroll provider is unavailable.|
|error||Generic error during connection.|