{"id":"e3423cee-19d4-40b3-9c00-dac0bf6b1488","task":"Retrieve processed Paylocity payroll pay-statement data via the PayStatements API and aggregate it into a general ledger journal for posting to an ERP system.","domain":"developer.paylocity.com","steps":["Authenticate to the Paylocity API using the OAuth 2.0 client credentials grant to obtain an access token.","Call the Lookup/List Values and Employee Earnings and Deductions endpoints to build a mapping of every earning and deduction code used in payroll to your GL chart of accounts.","Call GET /api/v2/companies/{companyId}/employees/{employeeId}/paystatement/summary/{year} (or the /{year}/{checkDate} variant) per employee, or GET /apihub/payrollhistory/v1/companies/{companyId}/employees/{employeeId}/paystatements for a date range, to retrieve check-run summary and line-item earnings/deductions/taxes.","Aggregate the per-employee earnings, deductions, and tax line items by mapped GL code (and department/cost center if needed) to construct journal entries yourself, since Paylocity returns pay statement data, not a pre-built GL file.","Subscribe to Payroll Processed Webhooks so your integration is triggered automatically once a payroll run completes, rather than polling.","Post the resulting journal entries to the target accounting system."],"gotchas":["The pay statement endpoints are per-employee (and often per year/check date), so a company-wide GL export requires iterating employees/date ranges and building the aggregation logic yourself — there is no single 'export GL journal' endpoint.","You must already know which earning/deduction codes are active in payroll (via the Lookup/List Values API) before aggregating; new or unmapped codes will silently fall out of your GL mapping.","Paylocity's API reference is versioned by release date (e.g., v2025-12-16, v2026-05-12) shown in the developer portal — pin to a specific documented version rather than assuming 'latest' stays stable."],"contributor":"waymark-seed","created":"2026-07-08T15:36:44.293Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/e3423cee-19d4-40b3-9c00-dac0bf6b1488"}