Loading
Ongoing maintenance for Salesforce HelpRead More
Salesforce Enforces New Security Requirements in Summer 2026Read More

Salesforce Nonprofit Cloud: Account Subledger job fails with writeback error

Publish Date: Jul 15, 2026
Description

When you run the Account Subledger job in Salesforce Nonprofit Cloud (NPC), the Data Processing Engine (DPE) definition may fail.

The system returns the following error: "This run of the Data Processing Engine definition couldn't process the data. The user doesn't have the required writeback permission. Make sure the user has the required permissions and try again. Error Code: USER_ERROR, Error Type: USER_ERROR, Definition Validate Failure."

This error occurs because the DPE writeback target requires the running user to hold both the Data Pipelines permission set license and object/field-level write access to the target object. This requirement applies even when the user has the Financial Services Cloud (FSC) or NPC feature license.

This missing access also affects a related symptom where you cannot activate a Data Processing Engine definition, including cloned out-of-the-box definitions with no changes. Affected users typically run the job manually or schedule it under a dedicated integration or admin user.

Resolution

Grant the running user (the user who runs or schedules the job) the correct Data Pipelines access and writeback permissions based on the specific cause below.

Cause 1: Missing Data Pipelines permission set license

  1. Navigate to Setup.

  2. Go to Users and select Users.

  3. Open the record of the user who runs the Account Subledger job.

  4. In the Permission Set License Assignments related list, click Edit Assignments.

  5. Enable Data Pipelines and click Save.

  6. In the Permission Set Assignments related list, click Edit Assignments.

  7. Add the permission set that grants Data Pipelines access (the permission set containing the "Data Pipelines" and "Author Apex" / writeback system permissions).

  8. Click Save.

Cause 2: Missing write access to DPE writeback target object

  1. Identify the writeback target object by navigating to Setup.

  2. Go to Data Processing Engine and open the Account Subledger definition.

  3. Note each object named in the Writeback nodes (for example, Account Financial Summary and related subledger objects).

  4. Navigate back to Setup and go to Permission Sets.

  5. Open the permission set assigned to the running user and click Object Settings.

  6. Set Object Permissions to Read and Edit for each writeback target object. Set it to Create if the job inserts new records.

  7. In the same Object Settings screen, set Field Permissions to Read Access and Edit Access for every field the definition writes to.

  8. Click Save.

Cause 3: Cannot activate the DPE definition

  1. Confirm the user activating the definition has the Data Pipelines permission set license and permission set outlined in Cause 1.

  2. Navigate to Setup and go to Data Processing Engine.

  3. Open the definition and click Activate. Activation will succeed once the Data Pipelines access is in place, and the DPE will appear as a selectable action in Flow.

Cause 4: Insufficient Data Pipelines licenses

  1. Assign the Data Pipelines permission set license and writeback permission set only to the single dedicated user who runs or schedules the job. Permission set licenses are limited and should not be assigned to every system admin.

  2. Set that specific user as the running user on any scheduled run so the job executes with the licensed identity.

Verify the Solution

  1. Navigate to Setup and go to Data Processing Engine.

  2. Open the Account Subledger definition and click Run.

  3. Verify the run completes with a Success status and writes records to the target object without the writeback permission error.

Knowledge Article Number

005389016

 
Loading
Salesforce Help | Article