Technical Resources
Below are various resources to assist employers and direct authorization vendors (DAVs) with questions regarding CalPERS reporting, policies and procedures, and training opportunities. The sections include pertinent information such as technical toolkits, File Transfer Protocol (FTP) resources, Data Element Definitions, Electronic Funds Transfer (EFT) payment processing, and more.
Technical toolkits consist of documents and tools needed to develop XML files for reporting health, retirement enrollment, and payroll information to us. The contents are contained in a ZIP file, which can be extracted using PeaZip.
File Readiness Testing
Log in to myCalPERS to access the file readiness test environment. Select the appropriate login option based on your account status:
*If your production account was created on or after the first Friday of the current month, the file readiness test environment will not recognize your login and you will need to use the test environment access only link until the next monthly refresh.
Contact our Employer Technical Support team at Employer_Technical_Support@calpers.ca.gov with any issues or questions.
Employers
- Employer Technical Toolkit (ZIP, 10.4 MB) – Includes a glossary, download instructions, toolkit contents and file descriptions, flowcharts, etc.
- Employer Guide to the Technical Toolkit (PDF) – Provides an overview and instructions for extracting the toolkit files.
- Data Element Definitions Payroll - CalPERS Review XML File (PDF)
- Data Element Definitions Payroll - CalPERS Review CSV File (PDF, 1.3 MB)
- Common CalPERS Review CSV Report Errors and Resolutions (PDF) – Find resolutions to common error messages and learn how to change your Excel document to CSV format.
- CalPERS Review Report Template (CSV) – CSV file template
- Secure File Transfer Protocol (SFTP) Onboarding for Business Partners (PDF) – Learn the process and requirements to establish SFTP as a file submission method.
- Encryption/Decryption & File Naming (PDF) – Learn the proper encryption, decryption, and file naming requirements for file transport services.
- Data Element Definitions Public Agency & Schools Health Enrollment Reporting File (PDF)
- Data Element Definitions State Agency Health Enrollment Reporting File (PDF)
- Plans & Rates - Find three-digit plan codes and premiums for each health plan.
- Health Benefits - Review lists of ZIP codes for HMO and PPO plans available in each county by health plan.
- myCalPERS Health Benefits Guides - Find descriptions of the Health Event Type/Reason data elements by referring to the Health Event Reasons section within the appropriate guide.
- Comprehensive Health Event Information (PDF) – Review this spreadsheet for myCalPERS health reason descriptions and more.
- Other Post-Employment Benefits (OPEB) Census Report Information (PDF) – Refer to this guide for a list of data elements and definitions populated in the report.
- Data Element Definitions Payroll Contribution Reporting File (PDF, 1.0 MB)
- Common Payroll Errors and Resolutions (PDF) – Find resolutions to common payroll error messages and learn how to export XML files to Excel.
- myCalPERS Payroll Adjustments Student Guide (PDF, 2.4 MB) – Learn how to report retroactive payroll records and make corrections.
- myCalPERS Payroll Reporting Student Guide (PDF, 2.5 MB) – Learn how to create an earned period report, add and maintain records, process a report, and reconcile missing payroll.
- Creating a Payroll Adjustment Report (PDF) – Learn how to create a manual adjustment report from a regular earned period report XML file.
- Data Element Definitions Out-of-Class Validation Reporting (PDF)
- Sample CSV File (CSV) – An out-of-class file for reporting must be in .CSV (Comma Delimited) (*.csv) format. Use this sample file as a reference when creating the file for upload.
- myCalPERS Out-of-Class Reporting Student Guide (PDF, 1.1 MB) – Learn how to certify reportable out-of-class hours and the steps to submit records for employees who meet the reporting requirements.
- myCalPERS: Out-of-Class Reporting Computer Based Training Module – Get a step-by-step overview of the process by logging in to myCalPERS and selecting the Education tab to search for and access this course.
- Government Code Section 20480: Out-of-Class Reporting Frequently Asked Questions (PDF)
- Circular Letter 200-018-19 (PDF) – Reporting Out-of-Class Hours Worked (New myCalPERS Functionality)
- Data Element Definitions Public Agency & Schools Retirement Enrollment Reporting File (PDF)
- Data Element Definitions State Agency Retirement Enrollment Reporting File (PDF)
- myCalPERS Retirement Enrollment Student Guide (PDF, 2.5 MB) – Learn how to verify membership status, enroll employees into CalPERS membership, and reconcile and maintain appointment statuses.
- myCalPERS Retirement Appointment Reconciliation Student Guide (PDF, 1.7 MB) – Learn how to reconcile your agency's retirement appointments with missing payroll.
- Circular Letter 200-003-17 (PDF) – Retirement Appointment Reconciliation (New myCalPERS Functionality)
Direct Authorization Vendors
Download the DAV Technical Toolkit (ZIP, 29 MB) and refer to the documents below for additional information.
- Direct Authorization Glossary of Terms (PDF) - Find definitions of commonly used system terms.
- Quick Reference Guide to the Direct Authorization Vendor's Technical Toolkit (PDF) - Review brief descriptions of the elements within the toolkit and quickly locate the tool(s) you need.
- Direct Authorization Vendor's Guide to the Technical Toolkit (PDF) - Get an overview of the toolkit and instructions about how to extract the elements within.
- myCalPERS File Testing Instructions for Direct Authorization Vendors (PDF, 1.3 MB) - Review how to prepare and test deduction request files and register retrieval in the file readiness testing environment.
- myCalPERS Direct Authorization Vendor User Guide (PDF, 4.4 MB) - Learn about performing tasks within the system.
Follow the schedule below, based on your deduction processing method (file or online), to ensure your transactions are processed for the intended warrant issue date.
Warrant Issue Date | File Cutoff | Online Transaction Period |
---|---|---|
Jan. 1, 2025 | Dec. 09, 2024 | Nov. 11, 2024–Dec. 12, 2024 |
Warrant Issue Date | File Cutoff | Online Transaction Period |
---|---|---|
Feb. 1, 2025 | Jan. 13, 2025 | Dec. 16, 2024–Jan. 16, 2025 |
Mar. 1, 2025 | Feb. 10, 2025 | Jan. 20, 2025–Feb. 13, 2025 |
Apr. 1, 2025 | Mar. 10, 2025 | Feb. 27, 2025–Mar. 13, 2025 |
May 1, 2025 | Apr. 7, 2025 | Mar. 17, 2025–Apr. 10, 2025 |
Jun. 1, 2025 | May 12, 2025 | Apr. 14, 2025–May 15, 2025 |
Jul. 1, 2025 | Jun. 9, 2025 | May 19, 2025–Jun. 12, 2025 |
Aug. 1, 2025 | Jul. 14, 2025 | Jun. 16, 2025–Jul. 17, 2025 |
Sep. 1, 2025 | Aug. 11, 2025 | Jul. 21, 2025–Aug. 14, 2025 |
Oct. 1, 2025 | Sep. 8, 2025 | Aug. 18, 2025–Sep. 11, 2025 |
Nov. 1, 2025 | Oct. 13, 2025 | Sep. 15, 2025–Oct. 16, 2025 |
Dec. 1, 2025 | Nov. 10, 2025 | Oct. 20, 2025–Nov. 13, 2025 |
Jan. 1, 2026 | Dec. 8, 2025 | Nov. 17, 2025–Dec. 11, 2025 |
Making Payments
Electronic Funds Transfer (EFT)
The CalPERS ACH ID number is 1946207465.
As of July 1, 2017, contracting employers are required to submit payroll contributions for retirement using EFT. Refer to Circular Letter 200-006-17 (PDF) for more information.
If you pay by EFT, you must establish a new EFT account in myCalPERS and notify your bank that this CalPERS ACH ID number is assigned to an approved payee. Without this pre-approval, your EFT payment will not be processed by your bank. In the event you submitted an EFT using the incorrect CalPERS ACH ID, resubmit the EFT with the CalPERS ACH ID listed above.
Checks
Mail checks payable to:
Health Billing
CalPERS
P.O. Box 4032
Sacramento, CA 95812-4032
Overnight Payments
CalPERS
Financial Reporting & Accounting Services Division
400 Q Street
Sacramento, CA 95811
myCalPERS Technical Requirements
Resources
- DAV Technical Toolkit (ZIP, 29 MB)
- Employer's Technical Toolkit (ZIP, 10.4 MB)
- Reference & Health Guides
Frequently Asked Questions
- When are employers required to submit out-of-class appointments that meet the specific requirements outlined in Gov. Code 20480?
Employers shall track the hours worked by an employee serving in an out-of-class appointment and report that service to CalPERS no later than 30 days following the end of each fiscal year. CalPERS fiscal year starts on July 1 and ends June 30. This information is due to CalPERS by July 30 each year.
- Within myCalPERS, can we generate a detailed report of all our employees to verify participant information?
There are a number of Cognos reports available in my|CalPERS that provide data for your participants. For example, the Participant Appointment Details report displays employment and appointment information, member and employer rates, and the participant's pension formula. There are also reports that provide health summary and statement information. Visit my|CalPERS Employer Reports (Cognos) for additional samples.