KCSO Payroll Upload

pipeline v2
Pay period month
Year
TL Payup to 3 files per period
Non-TL Payup to 3 files per period
Benefitsup to 3 files per period
CrossWalksingle file · replaces previous
Taskssingle file · replaces previous
Paycode Mastersingle file · replaces previous

⚠ Overwrite Warning

The following files already exist in the pipeline. Uploading will replace the previously processed data:

Are you sure you want to replace these files?

Activity Log

Loading activity...
KCSO Payroll Pipeline
Help & User Guide
Levor Business Management Services
Overview

What changed and why

The payroll reporting system has been upgraded. The old process required a virtual machine (VM) to run manually each pay period. The new system runs in the cloud — your data is always current. Files are uploaded via this portal and processed by Levor BMS each pay period.

✓
Your Excel spreadsheets work exactly the same way. The only change is where the data comes from — a new server address. We can update that for you, or you can follow the steps in the Excel Connection section.
BeforeAfter
Files processed manually on a VMFiles uploaded via a web portal, processed by Levor BMS
VM had to be started and monitoredNo VM — always available, no startup needed
Processing took hoursProcessing runs several times daily — data is typically updated within a few hours of upload
Connection: 13.64.238.171Connection: kcso-synapse-ondemand.sql.azuresynapse.net

Overview

How it works

Each pay period, you upload your payroll export files through the upload portal. The system processes them automatically and your Excel data refreshes.

Step 1
Upload files
→
Step 2
Confirmation email
→
Step 3
Levor processes within 24hrs
→
Step 4
Refresh Excel

You upload three types of payroll files each pay period, plus optional CrossWalk, Tasks, and Paycode Master updates when needed. Levor BMS will process your files and confirm completion within 24 hours of your upload.


Upload Portal

Logging in

The upload portal is a secure web page. You sign in with your King County Microsoft account — the same account you use for email and Teams.

1
Open the portal
Go to the upload portal URL in your browser.
https://kcso.levorbms.com
2
Click "Go to uploads"
You will be prompted to sign in with your King County account (@kingcounty.gov). Only King County and Levor BMS accounts are accepted.
Upload portal login screen

The portal login screen — click "Go to uploads" to sign in with your King County account


Upload Portal

Uploading payroll files

Each pay period you upload up to three files per file type. Select the correct month and year first, then add your files.

1
Set the pay period month and year
Use the dropdowns at the top of the page to select the correct month and year for this upload.
Upload portal main screen

The main upload screen — set month and year, then add files for each type

2
Add your files
There are three payroll file types. Click "click to add" next to each slot to select your file. Use "+ add file" if you have more than one file for that type (up to 3 per period).
BadgeTypeYour file
TLTL PayTime & Labor pay exports (e.g. TL Pay March 1st.xls)
NonTLNon-TL PayNon-time & labor pay exports (e.g. Non TLPay March 1st.xls)
BENBenefitsBenefits pay exports (e.g. Benefits March 1st.xls)
File selected in upload portal

A file has been selected for TL Pay — it shows the filename and "ready" status

3
Click "Upload all files"
When all files are selected, click the blue "Upload all files" button at the bottom. If any files already exist for that period, you will see an overwrite warning.
⚠
If the button turns amber and says "Upload (replaces existing)" — one or more files already exist for this period. Review the warning carefully before confirming.
Portal showing overwrite warning

The amber button and warning appear when uploading files that already exist for the selected period

Overwrite confirmation dialog

Confirm the overwrite — the dialog shows exactly which files will be replaced


Upload Portal

Uploading CrossWalk & Tasks updates

CrossWalk and Tasks are mapping files that control how projects and task codes are classified in your reports. You only need to upload these when there are changes — they are not per-period uploads.

BadgeFileWhen to upload
XWKCrossWalkWhen a new project is added or project codes change
TSKTasksWhen task codes are added or updated (e.g. TaskCodes_4.14.26.xlsx)
ℹ
CrossWalk and Tasks are single file, replaces previous — uploading a new version automatically replaces the old one. You do not need to delete the old file first.

After uploading a CrossWalk or Tasks file, Levor BMS will validate and confirm processing. You will receive a confirmation email when your data has been updated.


Upload Portal

Confirmation email

After uploading, you receive an immediate confirmation showing which files were received. Once processing completes, you receive a second email with the processing results.

Upload confirmation email

The confirmation email lists each file uploaded, its type, and the period it covers

✓
You will receive an upload confirmation immediately. Levor BMS will then process your files and send a second confirmation once complete — within 24 hours of your upload.
⚠
If you do not receive an upload confirmation within a few minutes, or a processing confirmation within 24 hours, contact Levor BMS at support@levorbms.com.

Pay Codes & Mapping

Paycode Master

The Paycode Master controls how each pay code in your payroll data is classified in reports — for example, whether a code is counted as Regular Pay, Overtime, Benefits, or Other.

ColumnWhat it means
PayCodeThe pay code as it appears in your PSFT export files
DescriptionHuman-readable name for the pay code
TopLevelThe category shown in reports: Regular Pay, Overtime, Benefits, Other, Comp Time, or Unclassified
TL / NonTL / BenefitsWhether this code is included or excluded from each file type. Set to Include or Exclude.
ℹ
If a pay code appears as Unclassified in your reports, it exists in the payroll data but hasn’t been mapped yet. Download the Pay Code Master from the Sample Files tab, add the missing code with the correct classification, and re-upload it via the Upload tab.

The Paycode Master is uploaded via the portal using the PCM slot. It is a single file that replaces the previous version.


Pay Codes & Mapping

CrossWalk explained

The CrossWalk file maps project IDs from your payroll system to descriptive names and categories used in reports. When a new project is created in PSFT, it needs to be added to the CrossWalk so it appears correctly in your Excel reports.

⚠
If a project appears as unmapped or blank in your reports, it is likely missing from the CrossWalk. Upload an updated CrossWalk file with the new project added.

Upload your updated CrossWalk file via the XWK slot in the Upload tab. Processing runs several times daily — Levor BMS will send a confirmation email once your data has been updated.


Pay Codes & Mapping

Tasks explained

The Tasks file maps task codes (e.g. 001, 009) to task descriptions used in reports. Kathy uploads an updated Tasks file whenever task codes change — using the TaskCodes file from PSFT.

Upload the updated Tasks file via the TSK slot. The filename can be anything — the system identifies it by the upload slot, not the filename.


Excel Connection

Updating your Excel connection

Your existing Excel spreadsheets connect to a SQL database to pull payroll data. The database has moved to a new server. You need to update the server address in Excel — everything else (the query, the pivot tables, your report layout) stays exactly the same.

ℹ
Send your Excel file to Levor BMS at support@levorbms.com and we will update the connection for you and send it back ready to use. Or follow the steps below to do it yourself.
1
Open the Data tab in Excel
Click the Data tab in the Excel ribbon, then click Queries & Connections.
Excel Data tab showing existing connections

Click Data → Queries & Connections to see the workbook connections

2
Open the Payroll Summary query
In the Queries & Connections panel, right-click Payroll Summary and select Properties. Then click the Definition tab.
Excel Query Properties - Definition tab

The Definition tab shows the connection string and SQL command

3
Update the connection string
The Connection string field will contain the old server address. Replace it with the new one below. The rest of the connection string stays the same — only the server address changes.

Old server (to remove):

13.64.238.171

New server (to use):

kcso-synapse-ondemand.sql.azuresynapse.net
✓
The database name (KCSO_Rpt) and table name (Payroll Summary) stay exactly the same. Only the server address changes.
4
Click OK and refresh
Click OK to save the connection, then click Refresh All on the Data tab. Excel will connect to the new server and update your data. You will likely be prompted to sign in — when this happens, select Database as the authentication type (not Windows or Microsoft Account), and enter the username below along with the password.

Username:

kcso_reader
ℹ
The password is provided by Levor BMS separately — contact support@levorbms.com if you need it resent.
ℹ
If your credentials are "stuck" on the old server and Excel won't show the sign-in prompt, go to Data → Get Data → Data Source Settings, select the old server, and click Delete. Then retry the refresh.

Support

Frequently asked questions

What files do I upload each pay period?
Three file types: TL Pay, Non-TL Pay, and Benefits. Each pay period typically has 2 files per type (one for each pay date in the period). Upload all files together in one portal session.
When should I upload files?
Upload files as soon as you receive the payroll exports from PSFT. Levor BMS will process them within 24 hours and send you a confirmation when complete.
I uploaded the wrong file. What do I do?
Upload the correct file in the same slot. The portal will show an amber overwrite warning — confirm the replacement and the correct file will be processed. Contact Levor BMS if you are unsure.
A project is showing as unmapped or blank in my reports.
The project is missing from the CrossWalk file. Send Levor BMS the project ID and description and we will update it, or upload an updated CrossWalk file via the XWK slot in the portal.
A pay code is showing as Unclassified in my reports.
The pay code exists in your payroll data but hasn't been mapped in the Paycode Master. Contact Levor BMS with the pay code and we will classify it correctly.
My Excel data is not refreshing after I upload files.
First confirm you received the processing confirmation email. If you have, try clicking Refresh All in the Data tab. If the connection string has not been updated yet, follow the steps in the Excel Connection section above.

Understanding Mapping Files

Three mapping files control how payroll data is enriched and categorised in your reports. All three are maintained by KCSO and uploaded via the Upload tab. When you upload an updated file, all historical payroll data is automatically remapped — not just new records.

CrossWalk

Maps Project IDs to Department, Cost Center, and other organisational fields. If a Project ID in your payroll data has no CrossWalk row, those records will show blank department and cost center values in your Excel report — and the project will appear as an exception in the Mapping → CrossWalk tab.

To fix: Download your current CrossWalk from Sample Files, add a row for each missing Project ID with the correct department and cost center, then upload the updated file via the Upload tab.

Pay Code Master

Maps pay codes to reporting categories (Regular Pay, Overtime, Comp Time, Benefits, Other) and controls whether each code is included or excluded in reporting for TL, NonTL, and Benefits file types. Pay codes not in this file will appear as exceptions in the Mapping → Pay Codes tab.

The file has the following columns: PayCode, Description, TopLevel (category), Type, Component, PSFTAccount, TL, NonTL, Benefits (each set to Include or Exclude), and Notes.

To fix: Download the current Pay Code Master from Sample Files, add rows for each missing pay code, set the Include/Exclude flags for each file type, then upload via the Upload tab.

Tasks

Maps task codes to descriptions used in reporting. Task codes not in this file will appear as exceptions in the Mapping → Tasks tab.

To fix: Download your current Tasks file from Sample Files, add rows for any missing task codes, then upload via the Upload tab.

How remapping works

Mapping files are applied dynamically — every time you upload an updated file, the entire payroll dataset (up to 24 months of history) is remapped against the new version. This means you can progressively improve your mapping files over time and the corrections apply retroactively across all historical data.

After uploading a mapping file, allow a few minutes for processing to complete, then click Refresh All in Excel to see the updated data.

ion class="section" id="contact">
Support

Contact

For questions about the upload portal, your Excel connection, or payroll data, contact Levor Business Management Services.

support@levorbms.com

For urgent issues, include "KCSO Payroll" in the subject line.

Downloads

📊
Payroll Summary — Excel Template
Pre-configured Excel workbook connected to the Synapse database. Open, click Refresh All on the Data tab, then enter credentials when prompted. See Help tab for connection details.
⬇ Download
🗂
CrossWalk — Current Mapping
Your active project-to-department mapping file. Download, update with any missing projects, and re-upload via the Upload tab. How mapping works →
⬇ Download
✅
Tasks — Current Mapping
Your active task code mapping file. Download, update with any missing task codes, and re-upload via the Upload tab. How mapping works →
⬇ Download
💲
Pay Code Master
Maps pay codes to categories (Regular Pay, Overtime, Benefits, etc.) and controls which codes are included in reporting. Download, update, and re-upload via the Upload tab. How mapping works →
⬇ Download
Data Summary
Loading…
Mapping Exceptions
CrossWalk
Pay Codes
Tasks
Loading…