How do I use the Tambla integration to account for US pay rules?

Charlotte Boatner-Doane - Forum Moderator
Charlotte Boatner-Doane - Forum Moderator
  • Updated

The Tambla integration with AlayaCare can be used by U.S. agencies that need to calculate overtime for payroll and billing purposes. 

warning_icon.jpg Please note that your agency needs to go through a configuration and requirement validation process to use the Tambla integration. The following documentation can only be used once this process has been defined with AlayaCare. To learn more, reach out to your Client Success Manager. 

Enabling the Tambla Feature Flag 

To use the Tambla integration, the Tambla Integration Feature Flag must be turned on. If your agency is multi-office, this feature flag should be enabled at the branch level. 

Tambla_integration_feature_flag.png

Preparing your Payroll Information with the Tambla Integration

Depending on your specific Payroll rules and configurations defined with your Client Success team, some information needs to be set prior to your Payroll Run.

The following set-up is standard for organizations using multiple Service units and/or applying state-specific Payroll rules:

  • Only Visits paid by the hour (Units=Hours on the Pay Code) can be handled by this process.
    • Services paid by Visit (Units=Visits) will be "OT exempt" tagged in the Service which will exclude all Visits for this Service from the Tambla calculation.

Screen_Shot_2019-09-30_at_4.33.01_PM.png

Running Payroll with the Tambla Integration

Once your agency has finished setting up the Tambla integration, you can run payroll and generate exports that return the calculated overtime according to the rules followed by your organization. 

To begin, go to Accounting>Payroll. The Status column will display the current status of any Tambla exports included in Payroll Runs. The possible Statuses are Pending, In Progress, Processing, Success, Export Failed, Failed, and Locked

payroll_tab_tambla.png

Important note: when using the Tambla integration, you cannot use the Adjustment & Carry Over Date. To run payroll for visits which have been added to a period late, you must run payroll for the previous period again.

Select View/Prepare for the period for which you wish to complete a payroll run and calculate overtime (or create a new period and then select View/Prepare). 

If you are ready to run Payroll, select 3) Run Payroll & Export and click Run Payroll

run_payroll_tambla.png

This action will change the status of the run to Pending and trigger the Tambla export generation process. The status will change to In Progress once the Payroll export file has been received by Tambla and your payroll results are being calculated.

In_progress_status_tambl.png

Once Tambla has sent back the resulting file and the file is being processed by AlayaCare, the status will change to Processing.

If the export generation process fails, the status will be Export Failed. In this case, you can select the Re-Run Export button to redo only the export generation portion of the process. 

If errors are returned to AlayaCare, the status will be Failed. If you receive this status, please contact the AlayaCare Support Team. 

mceclip0.png

If the file is successfully processed by AlayaCare, the status will change to Success. To export the results, click Export.

success_payroll_tambla_export.png

In the dialogue box, click +New Export

new_export_payroll_exports_dialogue.png

Select the File Type and Format and then click Run. When the background job is finished, click Download to open and save the file. Currently, the only Export Types that will return the calculation done by Tambla are Quickbooks and Paychex payroll exports. For any additional requests, please contact your Client Success Manager. 

download_tambla_payroll.png

If you need to make changes to Visits in the Payroll and re-run Payroll, you can do so by clicking Run Payroll again. This will trigger a rollback of all changes made during the previous run before starting the process again.

run_payroll_again_tambla.png

To delete the Payroll run and roll back changes without redoing the process, click Delete.

delete_tambla_payroll.png

Creating Visit Premiums for Billing Overtime 

If you wish to bill for the overtime calculated by Tambla during Payroll runs, you must create billable Visit Premiums using the Tambla Rule for Premiums.

Once at least one Tambla Premium has been created, your agency will need to select in System Settings which Tambla Premium you would like to use when determining overtime for billing with Tambla. 

Tambla_premium_system_settings.png

To add a new Premium, go to Accounting>Accounting Settings>Premiums and click +New Premium.

add_new_premium.png

Enter a Code for the Premium and choose the Bill Codes that will be used for billing the Premium. Next, select Tambla as the Rule. When you have finished, click Save

New_premium_tambla_rule.png

In order to identify which Services need to be billed for overtime calculated by Tambla, you must also indicate which Services should be billed for overtime by checking the Bill OT checkbox in the Service profile.  You can check this setting when creating a Service or editing an existing one. 

bill_OT_create_service.png

This is a Form Context field should be enabled for your agency prior to the Tambla configuration process. 

Bill_OT_field.png

When running Payroll with the Tambla integration, Visits for Services with Bill OT checked will be identified. The designated Tambla Premium (the Premium set in System Settings>Accounting>Tambla Premium) will then be created on Visits for these Services based on the amount of overtime calculated by Tambla. 

Billing Tambla Visit Premiums

When the Tambla Visit Premium is invoiced, the related Payroll Run will be Locked

Screen_Shot_2019-09-30_at_2.44.30_PM.pngTo unlock the Payroll, all invoiced Tambla Premiums linked to the payroll will need to be voided or deleted.

Once Unlocked, the Payroll Period can be re-run, triggering a rollback of the changes and re-starting the process.

Was this article helpful?

2 out of 2 found this helpful

Comments

0 comments

Article is closed for comments.