> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Scheduler & Prefetch errors

> This document provides error codes and remedies for Scheduler and Prefetch operations, covering a range of issues from invalid job IDs to unsupported prefetch modes.

This document provides error codes and remedies for Scheduler and Prefetch operations, covering a range of issues from invalid job IDs to unsupported prefetch modes.

Error code range: 70002801–70002826

| Code     | Error Code                             | Error Message                                                                                                                                                              | Possible Remedy                                                                                                                   |
| -------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| 70002801 | TASK_ALREADY_RUNNING                   | This task is already running.                                                                                                                                              | Wait for the current task to complete.                                                                                            |
| 70002802 | INVALID_JOB_ID                         | The job ID is invalid. It must be exactly 32 characters.                                                                                                                   | Provide a valid 32-character job ID.                                                                                              |
| 70002803 | SCHEDULER_GOT_INVALID_PATH             | The input path pattern “\[Path Pattern]” is invalid.                                                                                                                       | Correct the path pattern syntax.                                                                                                  |
| 70002804 | PREFETCH_JOB_NOT_FOUND                 | The prefetch job “\[Job ID]” was not found. The job may have expired or been cleaned up.                                                                                   | Verify the job ID.                                                                                                                |
| 70002805 | PREFETCH_NOT_ENABLED                   | The prefetch feature is not enabled. Please contact support to enable it.                                                                                                  | Contact support to enable prefetch for your tenant.                                                                               |
| 70002806 | PREFETCH_MODE_NOT_SUPPORTED            | The prefetch mode “\[Mode]” is not supported.                                                                                                                              | Use a supported prefetch mode.                                                                                                    |
| 70002807 | PREFETCH_JOB_CANNOT_CANCEL             | The prefetch job “\[Job ID]” cannot be cancelled in its current state. The job may already be completing or in a final state. Refresh the page to check the latest status. | The job may already be completing or in a final state. Refresh the page to check the latest status.                               |
| 70002808 | PREFETCH_INVALID_CRON                  | The cron expression “\[Cron Expression]” is invalid.                                                                                                                       | Correct the cron expression syntax. Use a cron expression validator tool.                                                         |
| 70002809 | PREFETCH_FAILED_BEFORE_METER           | The prefetch step failed before the meter could run. Please try again.                                                                                                     | Trigger a new prefetch and wait for it to succeed before running the meter. Check the prefetch job details for the failure cause. |
| 70002810 | AUDIT_TRAIL_ANOTHER_EXPORT_IN_PROGRESS | Another export is already in progress. Please try again later.                                                                                                             | Wait for the current export to finish.                                                                                            |
| 70002811 | PREFETCH_ALREADY_RUNNING               | A prefetch job is already running. Please wait for it to complete.                                                                                                         | Wait for the current prefetch to finish.                                                                                          |
| 70002812 | PREFETCH_NO_CONFIGURATION              | Prefetch is not configured for “\[Configuration Name]”.                                                                                                                    | Configure a prefetch definition for this resource.                                                                                |
| 70002813 | PREFETCH_VERSION_INVALID               | The prefetch version is invalid.                                                                                                                                           | Provide a valid prefetch version.                                                                                                 |
| 70002814 | AUDIT_TRAIL_EXPORT_REQUEST_ID_INVALID  | The export request ID “\[Request ID]” is invalid.                                                                                                                          | Provide a valid request ID.                                                                                                       |
| 70002815 | AUDIT_TRAIL_EXPORT_FORMAT_INVALID      | The export format “\[Format]” is invalid.                                                                                                                                  | Use a supported export format.                                                                                                    |
| 70002816 | INVALID_RUN_STATUS                     | The run status “\[Status]” is invalid.                                                                                                                                     | Use a valid run status value.                                                                                                     |
| 70002817 | INVALID_RUN_TYPE                       | The run type “\[Run Type]” is invalid.                                                                                                                                     | Use a valid run type value.                                                                                                       |
| 70002818 | INVALID_TIME_FORMAT                    | The time format “\[Time Format]” is invalid.                                                                                                                               | Use a supported time format.                                                                                                      |
| 70002819 | INVALID_TIME_RANGE                     | The time range \[Start Time] to \[End Time] is invalid.                                                                                                                    | Ensure the start time is before the end time.                                                                                     |
| 70002820 | S3_FILE_NOT_FOUND                      | The S3 file “\[File Name]” was not found.                                                                                                                                  | Verify the S3 path and ensure the file exists. Check bucket name, region, and permissions.                                        |
| 70002821 | FAILED_TO_CREATE_AUDIT_TRAIL_WORKFLOW  | Failed to create the audit trail export job. Details: \[Error Details].                                                                                                    | Retry the export. If it persists, contact support.                                                                                |
| 70002822 | S3_URI_NOT_FILE                        | The S3 path “\[Path]” is not a file.                                                                                                                                       | Provide a path to a file, not a directory or prefix.                                                                              |
| 70002823 | PREFETCH_NOT_RUNNING                   | The job is not running. Please refresh the page.                                                                                                                           | Refresh the page to see the current job status.                                                                                   |
| 70002824 | PREFETCH_FAILED                        | The prefetch job failed. Please contact support for assistance.                                                                                                            | Check the prefetch job logs for error details. Contact support if the cause is unclear.                                           |
| 70002825 | FEATURE_NOT_ENABLED                    | The feature “\[Feature Name]” is not enabled. Please contact support to enable it.                                                                                         | Contact support to enable this feature for your tenant.                                                                           |
| 70002826 | S3_FILE_UPLOAD_FAILED                  | Failed to upload data to S3 path “\[Path]”.                                                                                                                                | Check S3 bucket permissions and available storage. Verify the path is writable.                                                   |