---
title: "Workday PECI vs PICOF Effective Stack Exports — Kiweely"
description: "Compare Workday PECI effective-stack vs PICOF top-of-stack payroll connectors, change detection methods, and retro entry-dated export behavior for third-party…"
url: https://kiweely.com/guides/workday-peci-picof-payroll-connector-change-detection
---

# Workday PECI vs. PICOF Payroll Connectors: How Effective-Dated Stack and Retro Changes Export

PECI exports every effective-dated change in sequence with change flags; PICOF reports net top-of-stack payee changes via Get Payees. Pick the connector your vendor can consume, then configure change detection and last successful run dates carefully.

-   **Checked** against Workday on November 13
-   Applies to **Workday Integrations**
-   5 min read
-   Published November 13
-   By Kiweely

Pick **Payroll Effective Change Interface (PECI)** when your third-party payroll vendor must replay every effective-dated worker change in order. Pick **Payroll Interface Common Output File (PICOF)** (also called Payroll Interface / PI) when the vendor only accepts a net top-of-stack payee extract. The connectors share payroll framework concepts (pay groups, period schedules, run categories) but they do not export the same change story.

Workday’s Global Payroll Connect materials state the decision plainly: PECI uses **effective stack** processing and reports all changes in sequence; PI/PICOF uses **top of stack** processing via **Get Payees** and reports net changes only. Workday recommends PECI for detail, and continues essential maintenance on PI without enhancing that template. Some vendors still require PICOF because their intake cannot consume an effective stack.

## How Do PECI and PICOF Differ on Stack and Retro Behavior?

| Topic | PECI (Payroll Effective Change Interface) | PICOF / PI (Payroll Interface Common Output File) |
| --- | --- | --- |
| Stack model | Effective stack: every change in sequence | Top of stack: net result only |
| Primary engine | Data Initialization Service (DIS) | Get Payees web service |
| Mid-period events | Multiple staffing and data changes per worker | One staffing event view per worker (net) |
| Output annotations | Section/field flags such as isAdded, isUpdated, isDeleted, priorValue | Net payee payload without PECI’s effective-change sequence |
| Vendor fit | Engines that apply chronologies and retros carefully | Engines that overwrite current state from a snapshot |
| Workday roadmap note | Preferred for detailed payroll feeds | Essential maintenance only; not the enhancement path |

PECI structures each worker with a worker summary plus one or more effective-change sequences. Education materials describe each effective change with a derived event code, effective moment, entry moment, and only the impacted data sections (unless you enable the include-sections service). Sequence ordering follows how changes became effective in Workday.

PICOF remains the right label when you are configuring Payroll Interface outputs, field overrides for configurable personal information fields, or Studio samples that tag output documents for payroll interface processing. Do not invent vendor-specific column names; configure inclusion through the connector’s field attributes and field overrides.

## How Does PECI Change Detection Decide What Exports?

PECI change detection (and the shared method language used for PI) hinges on entry dates, effective dates, last successful run date (LSRD), and pay period bounds:

1.  **Include all changes effective in the pay period** — first launch in a period. Exports changes effective in the current period regardless of when they were entered. Future-period effective dates wait for that later period.
2.  **Include only changes entered since the last successful run** — incremental launches. Exports changes entered after LSRD that are effective in the current or a prior period.

Important edge behavior documented for PECI:

-   An all-effective run does **not** pick up entry-dated object changes made before LSRD even if they become effective in the current period.
-   Entry-dated changes generally must ride LSRD windows; you can enable the attribute that sets effective moment to entry date for non-effective-dated transactions without changing which data returns.
-   **Full Snapshot** seeds the vendor with workers active in the pay group window and does **not** perform change detection. With Transaction Log enabled, Full Snapshot can produce empty output. Full Snapshot also does not report one-time payments; those appear on standard change detection runs inside the entry and effective ranges.
-   Future terminations appear when the effective range includes the day after termination; attributes such as reporting termination on the last day of the pay period change that boundary.

Fails

```
# Wrong first-cycle cutover
1. Enable Transaction Log + Full Snapshot together
2. Expect a full employee seed file with change flags
3. Vendor receives empty or unusable output
```

Works

```
# Documented cutover pattern
1. Full Snapshot without Transaction Log to seed the vendor
2. Primary runs with All Effective for the first pay period launch
3. Later launches with changes since last successful run
4. Optional Effective Stack Sync sweeper when running frequently with Transaction Log
```

## Which PECI Services Change What the Vendor Sees?

Configure only the services you can explain to payroll operations:

-   **Transaction Log Service** — improves performance by limiting comparison; indirect changes (for example manager reassignment without a subscribed transaction) may not surface unless a qualifying subscribed transaction also occurs.
-   **Effective Stack - Expanded Effective Changes** — expands same-date collapses and can trace rescinds/corrections; enable Transaction Log data section fields or the run errors. Does not support entry data roll-up configurations.
-   **Include Sections Configuration Service** — outputs data sections even when unchanged.
-   **Effective Stack Sync Service** — for frequent primary runs (education materials describe up to every six hours) paired with Transaction Log, plus a daily sync-style run to catch indirect changes without duplicates.
-   **Event Driven Integration for Third Party Payroll** — one primary integration per pay group for near-real-time hire/termination style sends through a business process step (PECI otherwise supports only one business process attachment and does not support Orchestrate).

Documented PECI limits worth citing to sponsors: contingent workers are excluded (use Worker Effective Change Interface for contingents), soft ceiling around very large active populations, one-time payments beyond two years not reported, benefit elections with deduction begin before hire not reported, and no support for dynamic calculated compensation plans (prefer event-driven calculated plans).

## How Should Studio and Field Overrides Fit?

Use field overrides (not ad-hoc invented schema) to map Workday values to vendor codes on both PECI and PICOF, including configurable personal information fields. When you need transformation beyond the connector, follow the delivered pattern in [Steps: Run the Payroll Interface Sample](https://doc.workday.com/admin-guide/en-us/workday-studio/sample-assemblies/third-party-payroll-interface-sample/skx1534192339640.html): a PayData-style extract tagged for payroll interface processing, then a Studio assembly that streams and transforms event documents. Keep connector vs. Studio boundaries clear with [Studio vs EIB vs Cloud Connect](https://kiweely.com/guides/workday-studio-vs-eib-vs-cloud-connect) and debug failed runs with [Debug Workday Studio integrations](https://kiweely.com/guides/debug-workday-studio-integration).

## What Proves the Connector Choice and Run Mode Are Correct?

1.  Confirm the vendor contract: effective stack vs. net top-of-stack.
2.  Launch a controlled sandbox worker through Hire → mid-period compensation change → correction, and compare PECI multi-sequence output against PICOF net output for the same pay period.
3.  Verify LSRD and change detection method on the launch/schedule parameters for primary vs. incremental runs.
4.  For PECI, open the integration event and confirm derived event codes and change flags on impacted sections only (unless include-sections is on).
5.  Reconcile missed retros to entry vs. effective dating before rebuilding field overrides.

[Kiweely Vine](https://kiweely.com/vine) can help consultants inspect the live integration system configuration, field overrides, and Studio assemblies against the connected tenant with consent, then keep each client’s payroll connector notes isolated while you compare PECI and PICOF behavior on real events.

## Frequently asked questions

### Is PICOF the same thing as Payroll Interface?

In Workday documentation, Payroll Interface Common Output File (PICOF) is the Payroll Interface connector family that vendors often call PI or PICOF. It uses top-of-stack processing based on Get Payees and reports net changes, not the full effective-dated sequence PECI produces.

### When should a vendor insist on PECI instead of PICOF?

Choose PECI when the payroll engine must apply every effective-dated change in order, including mid-period stacks, derived event codes, and field-level change flags. Choose PICOF when the vendor only consumes a net payee snapshot and cannot process an effective stack.

### Why did a Full Snapshot PECI run return no changes when Transaction Log was enabled?

Full Snapshot does not provide change detection. When Transaction Log is enabled, that combination can yield an empty output. Use Full Snapshot to seed the vendor without Transaction Log, then switch to normal change detection runs.

### Do PECI and PICOF use the same change detection launch methods?

Change detection methods are described the same way for both families: include all changes effective in the pay period for the first run, then include only changes entered since the last successful run for incremental runs. What differs is the output shape: PECI emits the effective stack; PICOF emits net top-of-stack results.

## Sources checked

-   [Overview of Third-Party Payroll (PECI vs PI)](https://doc.workday.com/workday-education/en-us/course-manuals/creating-integrations-using-global-payroll-connect/overview-of-third-party-payroll.html)
-   [Creating PECI Integrations](https://doc.workday.com/workday-education/en-us/course-manuals/creating-integrations-using-global-payroll-connect/creating-peci-integrations.html)
-   [Change Detection (Global Payroll Connect)](https://doc.workday.com/workday-education/en-us/course-manuals/creating-integrations-using-global-payroll-connect/change-detection.html)
-   [Configurable Fields for Personal Information (PECI and PICOF)](https://doc.workday.com/admin-guide/en-us/human-capital-management/contact-and-personal-information/configurable-fields-for-personal-information.html)
-   [Steps: Run the Payroll Interface Sample](https://doc.workday.com/admin-guide/en-us/workday-studio/sample-assemblies/third-party-payroll-interface-sample/skx1534192339640.html)

## Related guides

[All guides](https://kiweely.com/guides)

-   [### Loading payroll input from Orchestrate with Import\_Payroll\_Input Use Import\_Payroll\_Input for bulk loads and Submit\_Payroll\_Input for small ones. Send many lines in one request under one Batch ID, give each line a unique Payroll\_Input\_ID, then check the batch in Workday.](https://kiweely.com/guides/workday-orchestrate-payroll-input-load)
-   [### Workday CCW: how Core Connector: Worker change detection decides which workers land in the file With the Transaction Log on, Core Connector: Worker (CCW) puts a worker in the change file only after a subscribed transaction, an eligibility pass, a newly entered or effective change in the launch window, and a changed output field.](https://kiweely.com/guides/workday-core-connector-worker-change-detection)
-   [### Workday Cloud Connect for Benefits and Payroll: field overrides, integration maps and unmapped value errors Packaged connectors can’t be edited, but four tasks customize them. Use Integration Maps to translate Workday values into vendor codes and Field Overrides for fields the template lacks. Workday warns calculated-field overrides can hurt performance; past 30 overrides, consider another integration.](https://kiweely.com/guides/workday-cloud-connect-field-overrides-maps)
-   [### How to Debug a Failing Workday Studio Integration, Step by Step When a Workday Studio integration fails, the error message alone rarely tells you enough. This guide walks through a structured debugging process: reading Integration Events, isolating the failing step, using Studio’s breakpoint and message-inspection tools, and resolving common error patterns.](https://kiweely.com/guides/debug-workday-studio-integration)
-   [### Workday EIB vs Core Connector vs Cloud Connect vs Studio: which to use Use an end-to-end Cloud Connect connector if one exists for the vendor, a Core Connector for a delivered template with change detection, EIB for simple guided loads, and Studio for multiple web service calls or complex error handling.](https://kiweely.com/guides/workday-studio-vs-eib-vs-cloud-connect)

### More guides on Integrations and APIs

[All 89 guides](https://kiweely.com/guides#integrations)

-   [Why does my Workday Accounting Journal EIB fail? Balancing, worktag and period errors](https://kiweely.com/guides/workday-financials-accounting-journal-eib-validation-errors)
-   [How to Find Every Domain and Web Service Permission an ISU Needs in Workday (Without Guesswork)](https://kiweely.com/guides/workday-isu-permissions-activate-pending-security-policy-changes)
-   [How to Fix The Load Contains a Duplicate Key and Invalid Reference ID Errors in Workday EIB](https://kiweely.com/guides/workday-eib-duplicate-key-reference-id-errors)
-   [How to Troubleshoot Workday Cloud Connect for Benefits (CCB) and Missing Dependents on 834 Feeds](https://kiweely.com/guides/workday-cloud-connect-for-benefits-834-errors)
-   [Why Workday Scheduled Reports and Integrations Shifted Dates After Local Time Zone Processing](https://kiweely.com/guides/workday-local-time-zone-processing-report-integration-impacts)
-   [Workday Mass Job Change Tables vs. Change Job EIB: Limits, Security, and When to Use Each](https://kiweely.com/guides/workday-mass-job-change-vs-eib)
-   [Workday Data Cloud vs. EIB, RaaS, and Prism: Which Data Path Should You Use?](https://kiweely.com/guides/workday-data-cloud-vs-eib-raas-prism)
-   [How to change job profile and compensation in one Change Job SOAP request](https://kiweely.com/guides/workday-change-job-soap-profile-compensation)

### From the blog on Integrations and APIs

[All posts](https://kiweely.com/blog)

-   [Does Workday Data Cloud Kill Outbound RaaS and Studio Extracts? A Consultant’s Reality Check](https://kiweely.com/blog/workday-data-cloud-live-data-query-for-consultants)
-   [I Used to Spend My Afternoon on One EIB File. Now I Hand It to Kiweely.](https://kiweely.com/blog/messy-spreadsheet-eib)
-   [How to Reconcile Workday Payroll Feeds in Studio Without Days of Manual XML Diffs](https://kiweely.com/blog/reconciling-workday-payroll-studio-feeds-with-ai)

## Let Workday check the work.

Kiweely writes WQL and builds orchestrations in your own tenant, and Workday, not Kiweely, says whether they passed.

[Start for free](https://kiweely.com/download) [See how it works](https://kiweely.com/vine/how-it-works)

## Get the next guide in your inbox.

One email a month with new guides and one Extend tip. Nothing else.
