Benefits in a Card: Back Office Setup and Use

This article provides guidance on setting up and integrating Benefits in a Card (BIC) within Avionté Back Office, covering the initial integration setup and payroll processing behavior.

Related Resources:

Setup

Deduction Category and Transaction Types

Refer to the setup resources above to create a Deduction Category called Benefits in a Card in your Back Office instance. Then create Transaction Types relevant to your BIC enrollment plans, selecting Benefits in a Card as the Deduction Category for each one.

When creating BIC Transaction Types, enter the system name exactly as it appears in BIC — no spaces. Work with your BIC representative to confirm the exact plan names before setup.

Important: When creating transaction types, always check the Is Permanent checkbox. This setting is required for transaction types to function as deductions on talent records. If left unchecked, the integration will encounter errors when attempting to automatically create talent deductions.

For example:

Example of BIC transaction type setup with Is Permanent checked
Note: Creating the correct Deduction Category and assigning Transaction Types to it is essential for the integration to work seamlessly.

Transaction Type Group

Create a new Transaction Type Group by navigating to Actions > Admin Tools > Transaction Type > Groups. Name the group exactly BIC Talent Benefits.

Search for the BIC Transaction Types created in the previous step and add them to the group using the Assign icon. Make sure all plans are included in the group before continuing.

Note: Creating the correct Transaction Type Group and assigning all BIC Transaction Types to it is crucial for the integration to work seamlessly.
Transaction Type Group showing BIC Talent Benefits with assigned plans

Supplier Grid and Deduction Authority

Once your plans are assigned to the group, a Supplier grid becomes available within the Transaction Type Group. Use this grid to assign a Deduction Authority agency to each supplier. The Agency column displays Deduction Authority agency types only.

Once configured, new benefit deductions created through the partner integration will automatically include the selected agency — no manual entry required. This applies to new deductions only; existing deductions are not updated automatically. If existing deductions need correction, contact Avionté Support.

Note: If you manually adjust the agency on an individual deduction, that override is preserved and will not be overwritten by subsequent integration updates.

Payroll Processing

By default, employee deductions set up through the BIC integration are flagged during payroll processing. This gives users an opportunity to review automatically created deductions and make changes if necessary before posting payroll. Once reviewed, users can remove the flag if no further changes are needed.

Supplier Assignment for BIC Deductions

When a BIC deduction or enrollment is created or updated without a SupplierGUID, the system automatically resolves the supplier using the following logic:

  • If the talent has an active assignment, the supplier associated with that assignment is used.
  • If there is no active assignment, the talent's home office supplier is used as a fallback.
Note: This supplier resolution logic applies only at the time a deduction or enrollment is created or updated. It does not retroactively reassign existing deductions if a talent later transfers to a different supplier. If a talent moves to a new supplier after a deduction is established, the deduction supplier will not change automatically — manual review and correction may be needed.

Flagging Configuration

A configuration option (FlagPartnerBenefitEnrollmentDeductionAndContribution) controls the automatic flagging behavior. When set to False, BIC deductions will not be flagged during payroll processing, eliminating the need for manual unflagging and streamlining your payroll workflow. The default setting is True, which preserves the automatic flagging behavior.

Back Office configuration screen showing FlagPartnerBenefitEnrollmentDeductionAndContribution set to True

To modify this setting:

  1. Navigate to Back Office configuration settings.
  2. Locate the FlagPartnerBenefitEnrollmentDeductionAndContribution option.
  3. Set to True to automatically flag BIC deductions during payroll (default).
  4. Set to False to prevent automatic flagging.
Note: Configuration changes apply to new enrollments and updates only; existing deduction records are not modified.

Posting Payroll

Once payroll is processed, BIC deductions are withheld for the employee based on the setup. When you post the payroll, deduction information is automatically sent to BIC for further processing.

Payroll processing screen showing BIC deductions withheld

Monitoring with DRMs

Even when supplier resolution runs correctly at enrollment time, a talent's pay supplier can change after the fact (for example, following a reassignment). If the deduction supplier and pay supplier no longer match, a Deduction Mismatch DRM will fire in DRMs Payroll. Treat this as a prompt to manually review and correct the deduction supplier as needed.

Articles in this section

Was this article helpful?
0 out of 0 found this helpful
Share

Comments

0 comments

Please sign in to leave a comment.