TABLE OF CONTENTS

• What “Missing Payroll Item” means
• Where to see the problem
• Step 1: Check employee TK configuration
  • Open TK configuration (Desktop)
  • Check Additional Classifier
  • Recommended fix (not only on one employee)
• Step 2: Check effective date on employee TK config
• Step 3: Check TK Cost Type mapping
  • Mapping attributes used by the system
  • How to find the missing combination
• Step 4: Apply fixes and recalculate
• Closed periods: use period Cost Types snapshot
  • When to edit period Cost Types table
  • Update cost mapping (Desktop)
• Recalculate payroll period (Open periods only)
• Quick troubleshooting checklist

Sometimes during payroll period closure, Fieldclix cannot determine a Payroll Item (pay code / earning code / external code) for some hours.

When this happens, you see indicators such as Missing Payroll Item on time cards or incomplete allocation during closure review.

This guide helps you find and fix the root cause.

What “Missing Payroll Item” means

Fieldclix assigns a Payroll Item to each payroll allocation line based on:

• cost type,
• wage type (regular / overtime / double),
• prevailing wage flag,
• employee classifier,
• and other optional mapping attributes.

If no matching mapping exists, Payroll Item stays empty and the time card is flagged as Missing Payroll Item.

Where to see the problem

In FCX Web

1. Open Payroll Periods.
2. Open the affected payroll period.
3. Go to Time Cards (Status view is useful during closure).
4. Check the Missing Payroll Item column.
5. For line-level detail, open the Details tab and review External Code (Payroll Item). Filter for empty / not assigned values.

Step 1: Check employee TK configuration

Usually start with employees who have missing payroll items.

Open TK configuration (Desktop)

1. Open the Employee card using the Employees dashboard (Web) or reference (Desktop).
2. Click Open TK Configuration at the bottom of the employee card.

Check Additional Classifier

Many companies map hours differently for groups such as hourly vs salary using Additional Classifier.

Rules:

• classifier on employee TK config must match mapping tables exactly (case-sensitive),
• missing or mismatched classifier often causes missing payroll item.

Recommended fix (not only on one employee)

If classifier is missing in employee config, fix it in the Employee Category TK Config template:

1. Open the employee’s Employee Category (Ctrl+F4 from category field).
2. On category card: Home → TK Config → Open Config.
3. Correct Additional Classifier.
4. Save category TK config.
5. Click Apply for All Employees and confirm.
6. Then verify/fix effective dates for affected employees (see below).

Step 2: Check effective date on employee TK config

A common cause: the period includes a time card dated before the TK config effective date.

Typical scenario:

• employee worked before onboarding was fully completed,
• first-day time card was added later,
• TK config effective date was set to onboarding date (not first work date),
• for early dates, classifier is empty → payroll item cannot be resolved.

Fix

1. On employee TK config, click Change near Start Date.
2. Set date on or before the first affected time card date.
3. In Desktop, run Recalculate Payroll Data on TK config ribbon.
4. Refresh period/time card views and confirm missing payroll item is cleared.

Step 3: Check TK Cost Type mapping

TK Cost Types (Drive, On-Site, Vacation, Sick, etc.) map hours to payroll items through a mapping table.

A missing payroll item usually means: hours exist for a cost type, but no table row matches the actual combination of attributes.

Mapping attributes used by the system

Required / commonly used:

• Wage Type (Regular / Overtime / Double)
• PW (Prevailing Wage: Yes/No)
• Payroll Item
• Employee Classifier (optional)

Also used in some setups (optional):

• State
• Tax Code
• Activity
• Shift Type

If your configuration uses these optional attributes, include them in troubleshooting.

How to find the missing combination

1. Open Payroll Periods dashboard and select the affected period.
2. On Status tab, confirm Missing Payroll Item count.
3. Switch to Details tab.
4. Filter External Code to Not Assigned.
5. For each row, note:
   • Cost Type
   • Wage Type
   • PW
   • State (and other attributes if used)
6. Compare with rows in the corresponding TK Cost Type mapping table (Desktop reference setup).
7. Add missing mapping row(s).

Access note

TK Cost Type reference setup is typically done by administrators.

If you do not have access, contact FCX Support or your implementation manager.

Step 4: Apply fixes and recalculate

Fixing cost type mapping alone may not immediately clear flags.

For each affected employee:

1. open employee card → Open TK Configuration (Desktop),
2. run Recalculate Payroll Data,
3. refresh period report / time card views.

Then confirm Missing Payroll Item counts are gone.

Closed periods: use period Cost Types snapshot

When a payroll period is closed, Fieldclix stores the cost type mapping snapshot on the payroll period (Cost Types tab on Desktop period card).

Important:

• for closed periods, mapping comes from the period snapshot, not only current global cost type setup,
• if payroll item mapping changed later, old periods may need snapshot-level correction.

When to edit period Cost Types table

Use this if:

• period is closed/paid,
• missing payroll item is caused by outdated or incomplete snapshot mapping,
• payroll sync/history expects mapping that existed at close time.

You can add missing rows directly in the period Cost Types table (similar to cost type card mapping, but combined for all cost types).

Update cost mapping (Desktop)

On payroll period card:

• use Update cost mapping (from current configuration or another period, depending on your process),
• then recalculate affected employee/period data as allowed.

Recalculate payroll period (Open periods only)

If issues remain, you can recalculate the whole payroll period:

1. Quick Launch → Payroll Periods reference.
2. Open the period card.
3. Home → Recalculate.

Important: period Recalculate works only while period stage is Open.

For closed/paid periods, use period cost mapping updates + employee recalculation and/or closure revise flow instead of period Recalculate.

Quick troubleshooting checklist

☐  Identify affected employees/time cards (Web Time Cards).

☐  Verify Additional Classifier on TK config (exact match, case-sensitive).

☐  Verify TK config effective date covers earliest affected TC date.

☐  Verify cost type mapping row exists for each real combination (including optional attributes).

☐  For closed periods, check period Cost Types snapshot mapping.

☐  Recalculate employee payroll data (Desktop).

☐  Recalculate period only if period is Open.

☐  Refresh UI and re-check Missing Payroll Item / closure audits.